ブログ テンプレート マークアップ

この記事では、ブログ テンプレート マークアップ、テンプレートのコンポーネント、カスタマイズオプションについて説明します。

リストページと記事ページの両方をレンダリングする1つのテンプレートを作成するには、テンプレートファイルの先頭にtemplateType: blogアノテーションを追加します。1つのテンプレートを両方のレンダリングに使用する場合は、if文を使用して、ユーザーがリストページと個別の記事のどちらを表示しているかを評価します。ドラッグ＆ドロップ デザイン マネージャー レイアウトを使用している場合、ブログ コンテンツ モジュール ボタンのUIにこのif文が組み込まれます。

または、ブログ記事とリストページに別個のテンプレートを作ることもできます。これにより、開発者にとってはコードが明確で読みやすくなり、制作担当者にとってはテンプレートを選びやすくなります。CMSボイラープレートには、別個のリストテンプレートと記事テンプレートがあります。記事テンプレートとリストテンプレートを分けて作成する場合、このis_listing_viewチェックは不要ですが、［設定］＞［ウェブサイト］＞［ブログ］＞［テンプレート］では別個のテンプレートを必ず選択してください。 

記事のリストは、記事を反復処理するforループによって生成されます。Contentsは、そのブログ内の全ての記事を含むコンテンツの事前定義済みシーケンスです。

ボイラープレート ブログ リスト ページのコンテンツのforループは、次のマークアップによってレンダリングされます。

執筆者リストページでのみ表示されるマークアップを定義するif blog_author文に加えて、ブログ トピック リスト ページのコードのみを表示するために使用できるtag変数もあります。以下に、ページタイトル変数を使用してタグ リスト ページ上部にタグ名を自動出力するスニペットの例を示します。このスニペットはご使用のブログ リスト コードにも追加できます。

forループ内には、シンプルリストと正規リストで何を表示するかを決定するif文があります。シンプルリストは、全ての記事のリストです。シンプルリストは、ブログ設定の記事数制限の影響を受けることなく、通常は直近200件のブログ記事へのリンクが格納されます。シンプルリストのページには、通常のリストビューのようにページ番号を付けることができます。標準のリストは、コンテンツ設定で指定された記事の数だけ繰り返され、ページ番号が付けられます。シンプル リスト ページのアドレスは、ブログURLのパスの末尾に/allを追加したものです。

以下のコードでは、このif文を単純化し、シンプル リスト ページでの反復処理を定義しています。このif文ではロジックが反転されている点に注意してください。つまりelseでシンプル リスト ビューが定義されます。必要に応じて、代わりにunless文を使用することもできます。

ブログ リスト ページではページ番号が自動生成されます。リストテンプレートには、訪問者がブログ記事のページを簡単に切り替えられるようにするロジックを含めることができます。ボイラープレートのブログでは、以下のマークアップを使って数値によるシンプルなページ送りを実現しています。

1つのブログ内の全ての記事は、共通のブログテンプレートによって生成されます。Contentは、リクエストされたブログ記事に関する情報を含む事前定義済みデータオブジェクトです。ボイラープレート記事は、次のマークアップを使ってレンダリングされます。

また、ブログ記事の執筆者情報もcontentデータの中に含まれます。