Django にはオプションで "flatpages" アプリケーションが付属しています。これを使えば、"フラットな" HTML コンテンツをデータベースに保存することができ、 Django のadmin インタフェースや Python API を使って管理できます。
\nフラットページは、URL、タイトル、コンテンツを持つオブジェクトです。これは、 "About" や "Privacy Policy" などのワンオフの特別なページに使用します。データベースに保存する必要はあるが、カスタムのDjangoアプリを開発する必要がない場合に利用します。
\nフラットページはカスタムテンプレートまたはデフォルトのシステム全体のフラットページテンプレートを使用できます。1 つまたは複数のサイトに関連付けることができます。
\nコンテンツフィールドは空のままにしておくこともできます。カスタムテンプレートにコンテンツを入れる場合に便利です。
\nflatpages アプリをインストールするには、以下の手順に従ってください:
\nもし設定にまだ含まれていない場合は、 'django.contrib.sites' をあなたの INSTALLED_APPS 設定に追加することで sites フレームワーク をインストールしてください。
また、 SITE_ID に設定ファイルが表すサイトのIDが正しく設定されていることを確認してください。これは通常 1 になります (つまり SITE_ID = 1 ですが、複数のサイトを管理するためにsitesフレームワークを使用している場合は、別のサイトのIDになる可能性があります) 。
INSTALLED_APPS 設定に 'django.contrib.flatpages' を追加してください。
そして、下記のいずれかを行います:
\nURLconf にエントリを追加します。例えば、次のようにします:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\nまたは:
\ndjango.contrib.flatpages.middleware.FlatpageFallbackMiddleware' を MIDDLEWARE 設定に追加します。
コマンド manage.py migrate を実行します。
manage.py migrate は、データベースに2つのテーブル、django_flatpage と django_flatpage_sites を作成します。django_flatpage は、URL をタイトルとテキストコンテンツのまとまりにマッピングするルックアップテーブルです。django_flatpage_sites はフラットページをサイトに関連付けます。
フラットページをURLconfに含める方法はいくつかあります。以下のように、特定のパスをフラットページに割り当てることができます:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\n「キャッチオール」パターンとして設定することもできます。この場合、そのパターンを他の urlpatterns の最後に配置することが重要です。
\nfrom django.contrib.flatpages import views\n\n# Your other patterns here\nurlpatterns += [\n re_path(r"^(?P<url>.*/)$", views.flatpage),\n]\nもう1つの一般的な設定方法は、フラットページを特定のページ数の限られたセットに使用し、URL をハードコーディングする方法です。これにより、url テンプレートタグを使用してそれらを参照できます:
from django.contrib.flatpages import views\n\nurlpatterns += [\n path("about-us/", views.flatpage, {"url": "/about-us/"}, name="about"),\n path("license/", views.flatpage, {"url": "/license/"}, name="license"),\n]\nFlatpageFallbackMiddleware は全ての作業を行うことができます。
Django アプリケーションが 404 エラーを出すたびに、このミドルウェアは最後の手段 して、リクエストされた URL があるか flatpages データベースをチェックします。具体的には、 SITE_ID 設定に対応するサイト ID を持つ、指定された URL のフラットページをチェックします。
もしマッチが見つかった場合、次のアルゴリズムに従います:
\nもし flatpage にカスタムテンプレートがあれば、そのテンプレートを読み込みます。そうでなければ、 flatpages/default.html テンプレートを読み込みます。
このテンプレートにはコンテキスト変数 flatpage が渡されます。テンプレートのレンダリングには RequestContext を使用します。
ミドルウェアは結果のURLが有効なフラットページを参照している場合にのみ、末尾のスラッシュを追加してリダイレクトします (APPEND_SLASH 設定を参照します) 。リダイレクトは永続的です(301ステータスコード)。
マッチするものが見つからない場合は、リクエストは通常通り処理されます。
\nミドルウェアは、404 エラーにのみアクティブ化され、500 エラーや他のステータスコードのレスポンスには適用されません。
\nMIDDLEWARE の順番は重要であることに注意してください。一般的には FlatpageFallbackMiddleware をリストの最後に記述します。これは、レスポンスを処理するときに最初に実行されることを意味し、 他のレスポンス処理ミドルウェアが 404 ではなく本当のフラットページのレスポンスを見ることを保証します。
ミドルウェアについての詳細は ミドルウェアのドキュメント を参照してください。
\n\nDjango の自動管理インターフェイスを有効にしていれば、管理インデックスページに "Flatpages" セクションがあるはずです。システムの他のオブジェクトを編集するのと同じように、 flatpages を編集してください。
\nフラットページ FlatPage モデルには enable_comments フィールドがあります。これは contrib.flatpages では使用されませんが、あなたのプロジェクトやサードパーティアプリでは役に立つかもしれません。admin アプリケーションには表示されませんが、カスタム ModelAdmin を FlatPage に登録することで追加できます:
from django.contrib import admin\nfrom django.contrib.flatpages.admin import FlatPageAdmin\nfrom django.contrib.flatpages.models import FlatPage\nfrom django.utils.translation import gettext_lazy as _\n\n\n# Define a new FlatPageAdmin\nclass FlatPageAdmin(FlatPageAdmin):\n fieldsets = [\n (None, {"fields": ["url", "title", "content", "sites"]}),\n (\n _("Advanced options"),\n {\n "classes": ["collapse"],\n "fields": [\n "enable_comments",\n "registration_required",\n "template_name",\n ],\n },\n ),\n ]\n\n\n# Re-register FlatPageAdmin\nadmin.site.unregister(FlatPage)\nadmin.site.register(FlatPage, FlatPageAdmin)\nフラットページは標準の Django モデル で表現され、 django/contrib/flatpages/models.py にあります。 Django データベース API を使ってフラットページオブジェクトにアクセスできます。
\nデフォルトでは、フラットページはテンプレート flatpages/default.html を使ってレンダリングされますが、特定のフラットページに対してそれを上書きできます。admin アプリケーションでは、"Advanced options" (クリックすると展開されます) というタイトルの折りたたんだフィールドセットにテンプレート名を指定するフィールドがあります。Python API を使ってフラットページを作成する場合は、 FlatPage オブジェクトの template_name フィールドにテンプレート名を設定できます。
flatpages/default.html テンプレートを作成するのはあなたの責任です。テンプレートディレクトリ内に、flatpages ディレクトリを作成し、その中に default.html ファイルを作成してください。
フラットページのテンプレートには、フラットページオブジェクトである flatpage という1つのコンテキスト変数が渡されます。
以下は、サンプルの flatpages/default.html テンプレートです:
<!DOCTYPE html>\n<html>\n<head>\n<title>{{ flatpage.title }}</title>\n</head>\n<body>\n{{ flatpage.content }}\n</body>\n</html>\nフラットページの admin アプリケーションにはすでに生のHTMLを入力しているので、flatpage.title と flatpage.content の両方は、テンプレート内で 自動HTMLエスケープ を 必要としない とマークされています。
FlatPage オブジェクトの一覧を取得するLink to this heading#flatpages アプリには、 現在のサイト で利用可能なすべてのフラットページをイテレートするためのテンプレートタグが提供されています。
\nすべてのカスタムテンプレートタグと同様に、使用する前にカスタムタグライブラリを 読み込む必要があります 。ライブラリを読み込んだ後、get_flatpages タグを通じてすべての現在のフラットページを取得できます。
{% load flatpages %}\n{% get_flatpages as flatpages %}\n<ul>\n {% for page in flatpages %}\n <li><a href="{{ page.url }}">{{ page.title }}</a></li>\n {% endfor %}\n</ul>\nregistration_required フラットページを表示するLink to this heading#デフォルトでは、 get_flatpages テンプレートタグは registration_required = False とマークされたフラットページのみを表示します。登録保護されたフラットページを表示したい場合は、for 節を使用して認証済みユーザーを指定する必要があります。
例:
\n{% get_flatpages for someuser as about_pages %}\n匿名ユーザーを提供すると、get_flatpages はユーザーを提供していない場合と同じように動作します。つまり、公開されているフラットページのみを表示します。
オプションの引数 starts_with を指定すると、返されるページを特定のベースURLで始まるものに限定できます。この引数は文字列として渡されるか、コンテキストから解決される変数として渡されます。
例:
\n{% get_flatpages '/about/' as about_pages %}\n{% get_flatpages about_prefix as about_pages %}\n{% get_flatpages '/about/' for someuser as about_pages %}\ndjango.contrib.sitemaps と統合するLink to this heading#sitemaps.FlatPageSitemap クラスは、現在の SITE_ID (詳細は sites ドキュメント を参照) に定義されたすべての公開されている flatpages を見て、サイトマップにエントリを作成します。これらのエントリには、 location 属性のみが含まれます。 lastmod や changefreq, priority は含まれません。
以下は FlatPageSitemap を使用したURLconfの例です:
from django.contrib.flatpages.sitemaps import FlatPageSitemap\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\n\nurlpatterns = [\n # ...\n # the sitemap\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": {"flatpages": FlatPageSitemap}},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\n