ページコンテンツ

ページコンテンツは、URLが割り当てられ、カスタムフィールドを利用できるコンテンツです。

コレクション・モジュール・カレンダーなどのコンテンツ単体ではURLを持たないため、ページコンテンツやそのテンプレートから呼び出されることになります。 そのため、ページコンテンツはこのCMSの中でもっとも中心的なコンテンツになります。

カスタムフィールド・アクション・テンプレートなどの設定を組み合わせて独自のタイプを用意することで、ブログやお知らせのような記事ページや、アーカイブページやサイトトップページなどのさまざまなページに対応させることができます。

標準フィールド

ページコンテンツは次の標準フィールドを持ちます。 標準フィールドの設定を変更したい場合は、標準フィールドのカスタマイズを参考にしてください。

ページコンテンツ設定

ページコンテンツの設定ファイルは system/config/pages.php です。 この設定ファイルはPHPの配列で定義されます。配列のキーがコンテンツタイプ名になります。

設定ファイルのフォーマットと設定項目について説明します。
設定ファイルフォーマット：

<?php

return [
    'コンテンツタイプ名' => [
        // コンテンツタイプの設定項目
        'inputs' => [
            '標準フィールド名' => [
                // 標準フィールドの設定項目
            ],
            // ... 以降の標準フィールド設定
        ],
        'fields' => [
            'フィールド名' => [
                // フィールドタイプの設定項目
            ],
            // ... 以降のフィールドタイプ設定
        ],
    ],
    // ... 以降のコンテンツタイプ設定
];

コンテンツタイプの設定項目

[
    'お知らせ'=>'info.twig',
    'リリース'=>'release.twig',
],

[
    'pref' => 'pref.select',
],

設定例：

    'page' => [ // コンテンツタイプ名
        'label' => 'ページ',
        'outline' => '汎用ページです',
        'templates' => [
            'ページ' => 'page.twig',
        ],
        'fields' => [
            'content' => [
                'label' => 'コンテンツ',
                'type' => 'content',
            ],
        ],
    ],

ページテンプレート

ページコンテンツを表示するためのページテンプレートは、public/themes/{テーマ名}/views/page/ ディレクトリに保存します。 ページコンテンツはページ全体に対応するため、HTML全体をレンダリングできるテンプレートを用意します。

ページコンテンツを表示する際に使用するテンプレートはコンテンツタイプ名から決定されます。 たとえば、"product_item" というコンテンツタイプの場合は、"product_item.twig" が使用されます。 ただし、コンテンツタイプ設定の templates 項目を設定した場合には、ページ編集画面で利用するテンプレートを選択できるようになります。

プレビューテンプレート

ページ編集画面のプレビューパネルでは、ページテンプレートを使ってレンダリングされます。 他のコンテンツタイプとは異なり、ページテンプレートがHTML全体出力できるため、プレビュー用テンプレートはありません。 ページテンプレートがプレビューテンプレートを兼ねることになります。