Приложение Flatpages ¶

Использование URLconf ¶

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

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

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

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¶

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

Отображение registration_requiredплоских страниц ¶

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

Например:

{% 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 %}

Пример ¶

Вот пример использования URLconf 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'),
]