フラットページ (flatpages) アプリLink to this heading#

URLconf を使うLink to this heading#

フラットページをURLconfに含める方法はいくつかあります。以下のように、特定のパスをフラットページに割り当てることができます:

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

もう1つの一般的な設定方法は、フラットページを特定のページ数の限られたセットに使用し、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"),
]

ミドルウェア を使うLink to this heading#

FlatpageFallbackMiddleware は全ての作業を行うことができます。

class FlatpageFallbackMiddlewareLink to this definition#

Django アプリケーションが 404 エラーを出すたびに、このミドルウェアは最後の手段 して、リクエストされた URL があるか flatpages データベースをチェックします。具体的には、 SITE_ID 設定に対応するサイト ID を持つ、指定された URL のフラットページをチェックします。

もしマッチが見つかった場合、次のアルゴリズムに従います:

• もし flatpage にカスタムテンプレートがあれば、そのテンプレートを読み込みます。そうでなければ、 flatpages/default.html テンプレートを読み込みます。

• このテンプレートにはコンテキスト変数 flatpage が渡されます。テンプレートのレンダリングには RequestContext を使用します。

ミドルウェアは結果のURLが有効なフラットページを参照している場合にのみ、末尾のスラッシュを追加してリダイレクトします (APPEND_SLASH 設定を参照します) 。リダイレクトは永続的です(301ステータスコード)。

マッチするものが見つからない場合は、リクエストは通常通り処理されます。

ミドルウェアは、404 エラーにのみアクティブ化され、500 エラーや他のステータスコードのレスポンスには適用されません。

MIDDLEWARE の順番は重要であることに注意してください。一般的には FlatpageFallbackMiddleware をリストの最後に記述します。これは、レスポンスを処理するときに最初に実行されることを意味し、 他のレスポンス処理ミドルウェアが 404 ではなく本当のフラットページのレスポンスを見ることを保証します。

ミドルウェアについての詳細は ミドルウェアのドキュメント を参照してください。

admin インターフェイス経由Link to this heading#

Django の自動管理インターフェイスを有効にしていれば、管理インデックスページに "Flatpages" セクションがあるはずです。システムの他のオブジェクトを編集するのと同じように、 flatpages を編集してください。

フラットページ FlatPage モデルには enable_comments フィールドがあります。これは contrib.flatpages では使用されませんが、あなたのプロジェクトやサードパーティアプリでは役に立つかもしれません。admin アプリケーションには表示されませんが、カスタム 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)

Python API 経由Link to this heading#

class FlatPageLink to this definition#

フラットページは標準の Django モデル で表現され、 django/contrib/flatpages/models.py にあります。 Django データベース API を使ってフラットページオブジェクトにアクセスできます。

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