.. _ref-contrib-flatpages: =========================== flatpages アプリケーション =========================== :revision-up-to: 11321 (1.1) unfinished .. module:: django.contrib.flatpages :synopsis: ?フラットな? HTML コンテンツをデータベース上で管理するための簡単なアプリケーションです。 Django にはオプションのアプリケーション、 "flatpages" が付属しています。 "flatpages" を使うと、データベースに素 ("flat") の HTML コンテンツを Django の admin インタフェースや Python API から保存して管理できるようになります。 flatpage オブジェクトは、 URL、タイトル、内容だけからなる単純なオブジェクトです。 flatpage は一回限りしかレンダリングされないような、特殊なケースのページ、例えば "About" や "Privacy Policy" のようなページで、データベースに保存しておきたいがカスタムのアプリケーションを組むほどではないようなものに使って下さい。 flatpage ではカスタムのテンプレートも使えますし、デフォルトのシステム全体で使われるフラットページテンプレートも使えます。フラットページは単一のサイトにも、複数のサイトにも関連づけできます。 .. versionadded:: 1.0 自作のテンプレートにコンテンツを入れる場合、 ``content`` フィールドを空 (blank) にしておいてもよくなりました。 Django で構築されたサイトの中にも、 flatpages を使っているものがあります: * http://www.chicagocrime.org/about/ * http://www.everyblock.com/about/ * http://www.lawrence.com/about/contact/ インストール ============ flatpages アプリケーションをインストールするには、以下の手順に従って下さい: 1. ``'django.contrib.sites'`` がまだ :setting:`INSTALLED_APPS` 設定に追追加されていなければ追加し、 :mod:`sites フレームワーク ` をインストールします。 Also make sure you've correctly set :setting:`SITE_ID` to the ID of the site the settings file represents. This will usually be ``1`` (i.e. ``SITE_ID = 1``, but if you're not using the sites framework to manage multiple sites, it could be the ID of a different site. 2. ``'django.contrib.flatpages'`` を :setting:`INSTALLED_APPS` に加えます。 3. ``'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware'`` を :setting:`MIDDLEWARE_CLASSES` に加えます。 4. :djadmin:`python manage.py syncdb ` を実行します。 flatpages の仕組み ================== ``manage.py syncdb`` を実行すると、データベースには ``django_flatpages`` と ``django_flatpages_sites`` という二つのテーブルが作成されます。 ``django_flatpages`` は、 URL をタイトルとテキストコンテンツに関連づける単純な検索テーブルです。 ``django_flatpages_sites`` は flatpage をサイトに関連づけます。全てのからくりは :class:`~django.contrib.flatpages.middleware.FlatpageFallbackMiddleware` の中にあります。 Django アプリケーションのいずれかが 404 エラーを送出すると、このミドルウェアが最後の試みとして、該当する URL がないかデータベースをチェックします。もっと詳しく言えば、ミドルウェアは、該当 URL に対応し、かつサイト ID が :setting:`SITE_ID` に対応しているような flatpage がないか調べます。一致するオブジェクトが見つかると、 flatpages ミドルウェアは以下のアルゴリズムに従って応答します: * flatpage にカスタムのテンプレートがある場合、テンプレートを読み込みます。それ以外の場合には、:file:`flatpages/default.html` という名のテンプレートを読み込みます。 * flatpage はテンプレートに唯一のコンテキスト変数、 :data:`flatpage` を渡します。この変数は、flatpage オブジェクトです。テンプレートのレンダリングには :class:`~django.template.context.RequestContext` を使います。条件に一致するオブジェクトがなければ、リクエストは通常通りに処理されます。ミドルウェアが有効になるのは 404 レスポンスの場合だけです。 500 など、他の HTTP 状態コードでは有効になりません。 :class:`MIDDLEWARE_CLASSES` の順番には注意が必要です。通常、このミドルウェアはリクエストを処理する最後の段階なので、 :class:`~django.contrib.flatpages.middleware.FlatpageFallbackMiddleware` はリストの末尾において下さい。ミドルウェアの詳細は :ref:`ミドルウェアのドキュメント ` を参照してください。 .. admonition:: 404 テンプレートがあるか確かめましょう Django が :class:`~django.contrib.flatpages.middleware.FlatpageFallbackMiddleware` ビューを踏むのは、別のビューが 404 応答を生成したときだけだということに注意しましょう。他のビューやミドルウェアで 404 を生成させようとして、実際には別の例外を送出してしまった場合 (例えば、 404 例外に対応する適切なテンプレートを用意していなかった場合は、 ``TemplateDoesNotExist`` が送出されます) には、応答は HTTP 500 ("Internal Server Error") であり、 :class:`~django.contrib.flatpages.middleware.FlatpageFallbackMiddleware` はフラットページを提供しようとしません flatpage の追加、変更、削除 =========================== admin インタフェースからの操作 ------------------------------ Django 自動管理インタフェースを有効にしていれば、 "Flatpages" セクションが admin インデクスページに表示されます。他のオブジェクトと同じように flatpages を編集してください。 Python API からの操作 --------------------- .. class:: models.FlatPage flatpage は標準の :ref:`Django モデル ` で表現されており、コードは `django/contrib/flatpages/models.py`_ にあります。 flatpage オブジェクトには :ref:`Django データベース API ` を介してアクセスできます。 .. _django/contrib/flatpages/models.py: http://code.djangoproject.com/browser/django/trunk/django/contrib/flatpages/models.py flatpage のテンプレート ======================= デフォルトでは、 flatpages は :file:`flatpages/default.html` テンプレートを使ってレンダリングされますが、このテンプレートはオーバライドできます。オーバライドを行うには、 :file:`flatpages/default.html` テンプレートを自分で作成する必要があります。 :file:`flatpages` ディレクトリを作成し、その下に :file:`default.html` という名のテンプレートファイルを置いて下さい。 flatpage テンプレートに渡されるコンテキスト変数は :data:`flatpage` の一つだけです。この変数は flatpage オブジェクトを表します。簡単な :file:`flatpages/default.html` テンプレートの例を示しましょう: .. code-block:: html+django {{ flatpage.title }} {{ flatpage.content }} flatpage の管理ページでは、生の HTML を入力しています。従って、 ``flatpage.title`` と ``flatpage.content`` は、テンプレート上で :ref:`自動 HTML エスケープ ` が必要なコンテンツとして **扱われません** 。