主なパラメータ主なパラメータ&configよく使うパラメータセットをconfigurationファイルとしてまとめておき、必要に応じて呼び出すことができます。このファイルは普通のphpファイルとして機能しますので、各パラメータの値を動的に生成するような使い方もできます。&dateFormat[+date+]プレースホルダの出力形式を指定します。関数の書式を用います。languageファイルで指定された書式が用いられます。[+date+]プレースホルダではなく[+createdon+]や[+editedon+]を使う場合はPHxモディファイアを通せば同じように使えます。[+createdon:date=`%Y年%m月%d日`+]というふうに記述します。&dateSource[+date+]プレースホルダと関連付けるフィールドを指定します。[*任意のテンプレート変数*]から選べます。timestamp形式で管理されているフィールドを指定する必要があります。そのため、テンプレート変数を指定する場合はUnixtimeウィジェットを設定してください。&debugデバッグコンソールを使えるようにします(どういうものかは、試してみると分かります)。文字化けのバグがありますが、MODX1.0.5J-r8で修正されました。0&depth取得対象とするリソースの階層数を指定。Wayfinderの&levelパラメータに相当します。デフォルトでは直下の1階層のみを取得します。0をセットすると階層無限です&display取得したリソースのうち、何件を表示するかを指定します。ページング制御をしている時に、ページあたり何件を表示するかを指定するパラメータです。all&ditto_baseDitto本体ファイルを置いているディレクトリを設定します。改造したDitto本体を使いたい場合にこのパラメータを用います。:末尾をスラッシュで閉じてください。(MODXのパス指定は基本的にスラッシュで閉じるスタイルです)&documents一覧表示したいリソースを静的に指定します。リソースIDはコンマで区切って複数指定します。このパラメータを指定すると&parentsの指定は無効になります。メニューの表示・非表示に関係なく取得します。&parentsの指定を無視します&extendersエクステンダーを組み込んでDittoの機能を拡張します。追加したい機能をこのパラメータで指定します。<name>.extender.inc.php&format出力フォーマットの指定。プリセット型のconfig・パターンの組み合わせのようなもので、ここでパラメータを指定するだけで、必要な出力を得ることができます。通常のDittoコールと違って、ヘッダ・フッタに相当するブロックの出力も行ないます。"";?>「html」フォーマットの実際の処理は上記のような空処理になっており、何も指定していないのと同等です。1&idページ内で複数のDittoインスタンスを実行する場合は、各インスタンスにIDを割り当てて処理を区別する必要があります。大文字小文字を区別します。MODXのグローバル設定でMETAタグ機能を有効にしている場合、keyword属性を取得します。MODX本体のMETAタグ機能は1.0.15Jで廃止されました。そのため当パラメータは動作しません。取得対象リソースがなかった場合の「記事はありません」や、ページ分割機能を有効にした場合の「戻る」「次へ」などで用いるDitto言語ファイルを指定します。デバッグメッセージ・エラーメッセージもこれに含まれます。:Dittoが自らの出力のために取得する各パラメータ値を、他のスニペットで用いることができるようにプレースホルダに代入します。オブジェクトとして代入するため、通常の[+プレースホルダ+]でアクセスすることはできません。$modx->placeholdersのprint_rを行なうスニペットを仮に作って、saveパラメータの値を0-3に設定して出力の違いを見ることでそれぞれの処理を確認できます。Ditto単体では難しい複雑なパターン出力を実装したい場合は、&save=3をセットし、Dittoで取得した値を他のスニペットで処理するとよいでしょう。慣れればDittoを拡張APIのように用いることができます。取得したリソースの値は$modx->getPlaceholder('ditto_resource')または$modx->placeholders['ditto_resource']で参照できます(&save=2または3)。