logo
 

Dittoスニペットで新着情報表示するには

MODXには、複数の記事を新着順に表示するDittoというスニペットがあります。

このスニペットを使うと、このサイトのトップページの「新着記事」欄のように記事の時系列リンクを表示することができます。

Dittoスニペットの新着情報表示

上記のように特定の親リソースから5件の新着記事を新着順に表示する手順をまとめます。

記事のタイトルと投稿日をリスト表示するテンプレートをチャンクで作成します。(例:チャンク名「ditto_links」)

Dittoスニペット用テンプレートの例

チャンクには繰り返し表示する部分だけを記述します。リスト表示の場合は、<ul>タグと<li>タグを使いますが、繰り返さない<ul>は含めません。テーブル表示の場合は、<table>タグ、<tr>タグ、<td>タグを使いますが、同様に繰り返さない<table>タグは含めません。

必要に応じて「プロパティ」タブを開いて、チャンクの説明を書き込んで「更新」します。

Dittoスニペット用テンプレートの例

上記のチャンクを使って、特定の親リソースから新着5件を表示するスニペットコールをテンプレートまたはリソースに記述します。

<ul>
[!Ditto? &parents=`3,4,5,6,7,8` &display=`5` &orderBy=`publishedon DESC` &dateSource=`publishedon` &dateFormat=`%x` &tpl=`ditto_links`!]
</ul>

上記のパラメータの内容は下表の通りです。

パラメータ説明
&parents 表示対象のリソースを含む親リソース。IDで指定。カンマで区切って複数指定可能。
&display 表示するリソース数。上記の例は「3件」。
&orderBy ソートのキーとするフィールドとソート順。詳しい設定方法については、orderByパラメータ一覧へ。
&dateFormat プレイスホルダ[+date+]の表示形式。上記の例では「2000年01月01日」の形式で表示。日付を表示するときのみ使用。
&dateSource プレイスホルダ[+date+]のソース。上記の例は「公開日」。 日付を表示するときのみ使用。
&tpl 出力用のテンプレートとなるチャンク。予めチャンクを作っておき、そのチャンク名を指定。上記の例は「ditto_links」。

詳しい設定方法は、Dittoスニペットでよく使うパラメータをご参照ください。

参考

MODXとは

新着情報

 
RSS