Приложение Flatpages (статические страницы) ¶

Использование конфигурации URL ¶

Есть несколько способов включить статические страницы в конфигурацию URL. Вы можете выделить определенный путь для статических страниц:

urlpatterns = [
    path('pages/', include('django.contrib.flatpages.urls')),
]

Вы также можете настроить его как универсальный шаблон. В этом случае важно разместить узор в конце остальных urlpatterns :

from django.contrib.flatpages import views

# Your other patterns here
urlpatterns += [
    re_path(r'^(?P<url>.*/)$', views.flatpage),
]

Другая распространенная установка - использовать статические страницы для ограниченного числа страниц, известных заранее, и заморозить их URL-адреса, чтобы на них можно было ссылаться с помощью тега шаблона url :

from django.contrib.flatpages import views

urlpatterns += [
    path('about-us/', views.flatpage, {'url': '/about-us/'}, name='about'),
    path('license/', views.flatpage, {'url': '/license/'}, name='license'),
]

Использование промежуточного программного обеспечения ¶

Промежуточное ПО FlatpageFallbackMiddleware может делать всю работу.

класс FlatpageFallbackMiddleware¶

Каждый раз, когда приложение Django выдает ошибку 404, это промежуточное ПО проверяет, содержит ли база данных плоских страниц запрошенный URL-адрес в крайнем случае. В частности, он ищет плоскую страницу с заданным URL и идентификатором сайта, который соответствует настройке SITE_ID .

Если он находит совпадение, он следует этому алгоритму:

• Если на плоской странице есть настраиваемый шаблон, он загружает этот шаблон. В противном случае загружает шаблон flatpages/default.html .
• Он передает уникальную переменную контекста этому шаблону flatpage , который является объектом плоской страницы. Используется RequestContext при рендеринге трафарета.

Промежуточное ПО добавит косую черту и перенаправит (в зависимости от настройки APPEND_SLASH ) только в том случае, если полученный URL-адрес относится к действительной плоской странице. Перенаправления постоянные (код 301).

Если совпадений не найдено, обработка запроса продолжается в обычном режиме.

Промежуточное ПО активируется только для 404 ошибок - не для 500 ошибок или ответов с любым другим кодом состояния.

Обратите внимание, что порядок MIDDLEWARE важен. Обычно вы можете поместить его FlatpageFallbackMiddleware в конец списка. Это означает, что он будет запускаться первым при обработке ответа и гарантирует, что любое другое промежуточное ПО, которое обрабатывает ответ, увидит ответ с плоской страницы, а не с 404.

Дополнительные сведения об этом промежуточном программном обеспечении см. В документации промежуточного программного обеспечения .

Через интерфейс администрирования ¶

Если вы включили автоматический интерфейс администратора Django, вы должны увидеть раздел «Плоские страницы» на главной странице администратора. Плоские страницы можно редактировать, как и любой другой объект в системе.

В шаблоне FlatPage есть поле enable_comments , которое не используется contrib.flatpages , но может быть полезно для вашего проекта или сторонних приложений. Он не отображается в интерфейсе администрирования, но вы можете добавить его, зарегистрировав ModelAdmin кастом для FlatPage :

from django.contrib import admin
from django.contrib.flatpages.admin import FlatPageAdmin
from django.contrib.flatpages.models import FlatPage
from django.utils.translation import gettext_lazy as _

# Define a new FlatPageAdmin
class FlatPageAdmin(FlatPageAdmin):
    fieldsets = (
        (None, {'fields': ('url', 'title', 'content', 'sites')}),
        (_('Advanced options'), {
            'classes': ('collapse',),
            'fields': (
                'enable_comments',
                'registration_required',
                'template_name',
            ),
        }),
    )

# Re-register FlatPageAdmin
admin.site.unregister(FlatPage)
admin.site.register(FlatPage, FlatPageAdmin)

Через API Python ¶

класс FlatPage¶

Плоские страницы представлены стандартной моделью Django, определенной в django / contrib / flatpages / models.py . Вы можете получить доступ к объектам плоских страниц через API базы данных Django .

Отображение плоских страниц с registration_required (требуется авторизация) ¶

По умолчанию тег шаблона get_flatpages отображает только плоские страницы с расширением . Если вы хотите отображать плоские страницы только для вошедших в систему пользователей, вы должны указать аутентифицированного пользователя с помощью предложения .registration_required = False for

Например :

{% get_flatpages for someuser as about_pages %}

Если вы указываете анонимного пользователя, get_flatpages ведет себя так, как если бы вы не указали пользователя, то есть показывает только общедоступные плоские страницы.

Фильтрация плоских страниц на основе базового URL ¶

Необязательный параметр ,, starts_with можно применить, чтобы ограничить отображаемые страницы теми, которые начинаются с определенного базового URL. Этот параметр может быть передан как строка или как переменная, которая разрешается контекстом.

Например :

{% get_flatpages '/about/' as about_pages %}
{% get_flatpages about_prefix as about_pages %}
{% get_flatpages '/about/' for someuser as about_pages %}

Пример ¶

Вот пример конфигурации URL с использованием FlatPageSitemap :

from django.contrib.flatpages.sitemaps import FlatPageSitemap
from django.contrib.sitemaps.views import sitemap
from django.urls import path

urlpatterns = [
    # ...

    # the sitemap
    path('sitemap.xml', sitemap,
        {'sitemaps': {'flatpages': FlatPageSitemap}},
        name='django.contrib.sitemaps.views.sitemap'),
]