简单页面应用Link to this heading#

使用 URLconfLink to this heading#

有几种方法可以在你的 URLconf 中包含简单页面。你可以为简单页面指定一个特定的路径：

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

你也可以把它设置成一个“catchall”模式。在这种情况下，重要的是将该模式放在其他 urlpatterns 的最后：

from django.contrib.flatpages import views

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

Another common setup is to use flat pages for a limited set of known pages and to hard code their URLs in the URLconf:

from django.contrib.flatpages import views

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

The kwargs argument sets the url value used for the FlatPage model lookup in the flatpage view.

The name argument allows the URL to be reversed in templates, for example using the url template tag.

使用中间件Link to this heading#

FlatpageFallbackMiddleware 可以完成所有的工作。

class FlatpageFallbackMiddlewareLink to this definition#

每当任何 Django 应用出现 404 错误时，这个中间件都会检查简单页面数据库中所请求的 URL，作为最后的手段。具体来说，它检查给定 URL 的简单页面，其网站 ID 对应于:setting:SITE_ID 配置。

如果它找到了一个匹配，就按照这个算法：

• 如果简单页面有自定义模板，它就加载该模板。否则，它会加载模板 flatpages/default.html。

• 它给该模板传递了一个上下文变量 flatpage，也就是简单页面对象。它使用 RequestContext 来渲染模板。

如果产生的 URL 指向有效的简单页面，中间件只会添加尾部的斜线和重定向（通过查看 APPEND_SLASH 配置）。重定向是永久性的（301 状态码）。

如果没有找到匹配的请求，则继续照常处理。

中间件只有在 404 时才会被激活——而不是 500 或任何其他状态码的响应。

注意 MIDDLEWARE 的顺序很重要。一般来说，你可以把 FlatpageFallbackMiddleware 放在列表的最后。这意味着它将在处理响应时首先运行，并确保任何其他响应处理中间件看到的是真正的简单页面响应而不是 404。

关于中间件的更多内容，请阅读 中间件文档。

通过管理界面Link to this heading#

如果你已经激活了 Django 的自动管理界面，你应该会在管理索引页上看到一个“简单页面”栏目。编辑简单页面就像编辑系统中的其他对象一样。

FlatPage 模型有一个 enable_comments 字段，contrib.flatpages 没有使用，但对你的项目或第三方应用程序可能有用。它不会出现在管理界面中，但你可以通过为 FlatPage 注册一个自定义的 ModelAdmin 来添加它：

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)

通过 Python APILink to this heading#

Flatpages are represented by a standard Django model, FlatPage. You can access flatpage objects via the Django database API.

字段Link to this heading#

FlatPage objects have the following fields:

class models.FlatPage

urlLink to this definition#

Required. 100 characters or fewer. Indexed for faster lookups.

titleLink to this definition#

Required. 200 characters or fewer.

contentLink to this definition#

Optional (blank=True). TextField that typically, contains the HTML content of the page.

enable_commentsLink to this definition#

Boolean. This field is not used by flatpages by default and does not appear in the admin interface. Please see flatpages admin interface section for a detailed explanation.

template_nameLink to this definition#

Optional (blank=True). 70 characters or fewer. Specifies the template used to render the page. Defaults to flatpages/default.html if not provided.

sitesLink to this definition#

Many-to-many relationship to Site, which determines the sites the flatpage is available on.

方法Link to this heading#

class models.FlatPage

get_absolute_url()Link to this definition#

Returns the relative URL path of the page based on the url attribute.

显示 registration_required 简单页面Link to this heading#

默认情况下，get_flatpages 模板标签只显示标记为 registration_required = False 的页面。如果你想显示受注册保护的页面，你需要使用 for 子句指定一个经过认证的用户。

例如：

{% get_flatpages for someuser as about_pages %}

如果你提供了一个匿名用户， get_flatpages 将与你没有提供用户的行为相同——即，它将只向你显示公共的简单页面。

通过基础 URL 限制简单页面Link to this heading#

一个可选的参数，starts_with，可以用来限制返回的页面以特定的基本 URL 开头。这个参数可以以字符串的形式传递，也可以以一个变量的形式从上下文中解析。

例如：

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

例如Link to this heading#

下面是一个使用 FlatPageSitemap 的 URLconf 的例子：

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",
    ),
]