まいにち@ぐだぐだ

明日と言わず、今日から…ぐだぐだ(^_^;

Ditto2.1.x ジェネレータ

Ditto2.1.x ジェネレータ

『リセット』ボタンでフォームをすべて初期化します。貼り付けたコードも初期化されますので、貼り付けるところからやり直してください。
オプションの変更などは、このページの最後のテキストボックスに、リアルタイムにコードを書き出します。
テキストボックスの内容を選択してコピーしてお使いください。
このジェネレータは完全な動作を保証するレベルのモノではありません。
ご利用に際して、思わぬエラーを引き起こす可能性も十分考えられます。また、作成されたコードでは正しく動作しない場合も考えられます。
いずれにしても、完全な保証をすることは出来ません。
このジェネレータを使用して得られたコードをMODxに適応する場合は、自己責任において行ってください。
それによる損傷および損害等に対しては一切責任を負いません。


このテキストエリアに現在お使いのコードを貼り付けて『コードセット』ボタンをクリックすると、ジェネレータに反映されます。
ただし、このジェネレータのリストに存在しないパラメータ(過去のバージョンで利用されていたパラメータなど)はそのまま出力されます。

パラメータ(セッティングと拡張)

  • ditto_base= (assets/snippets/ditto/)
    Ditto の外部リソースの場所を指定します。
  • id= ("")
    ユニークIDを指定します。「Reflect」スニペットで、アーカイブを出力する場合にこのIDを利用します。1ページに複数個のDitto を設置する場合にも有効です。
    また、Ditto でページ分割する場合、ページナビゲーション関係のプレイスホルダにもこのIDが必要になります(「Ditto でページ分割する場合」参照)。
  • language= 言語ファイルを指定します。
  • format= 出力フォーマットを指定します。
  • config=
    Ditto2でも、Wayfinder2.0 や MaxiGallery で採用されている config パラメータを使った簡潔なスニペットコールの記述が可能です。
  • debug= (しない)
    デバックインフォメーションを出力するかどうかを指定します。
  • phk=(する) PHx ファンクションを利用するかどうかを指定します。
  • extenders
    Ditto を機能拡張します。
  • save=
    Ditto オブジェクト及び結果を他のスニペットで利用できるように、プレイスホルダに代入するかどうかを指定します。ちょっと意味がわかりません。
  • removeChunk=
    取得するコンテンツから、取り去るチャンクを指定します。カンマで区切って複数指定可能です。
    一般的には、「NewsPublisher」による投稿によって付加された「comment」チャンクを取り去るために利用します。

パラメータ(データの取得と表示)

  • parents=
    取得したいドキュメント群の親ドキュメントをIDで指定します。カンマで区切って複数指定可能です。
    「メニューに表示・非表示」に関係なく、公開ドキュメントをすべて取得します。また、ここで指定したドキュメントが非公開であってもその下のドキュメントが公開されていれば表示します。
    取得する階層は、「1階層」です
  • documents=
    取得したいドキュメントのIDを指定します。カンマで区切って複数指定可能です。
    「メニューに表示・非表示」に関係なく、公開ドキュメントをすべて取得します。
    「documents」を指定すると「parents」で指定した値は無効になります。
  • depth= (1)
    何階層まで取得するかを「1」以上の整数で指定します。「1」以上の整数以外を指定するとすべての階層を取得します。
  • dateFormat= (「言語ファイルから読み込み($_lang['dateFormat'])」)
    プレイスホルダの表示形式を指定します。phpのstrftime関数の値を利用できます。
    ※パラメータの値に2バイト文字を含めると出力結果が文字化けします。
  • display= (3) all
    取得したドキュメントのうち、何件表示するかを指定します。「all」を指定するとすべてのドキュメントを表示します。
  • total= (all)
    何件取得するかを指定します。
  • showPublishedOnly= (はい)
    公開ドキュメントのみを表示対象するかどうかを指定します。デフォルト「はい(1)」。非公開ドキュメントも表示対象にしたい場合「0」を指定します。
  • showInMenuOnly= (いいえ)
    メニューに表示しているドキュメントのみを表示対象とするかどうかを指定します。デフォルト「いいえ(0)=メニューに非表示ドキュメントも表示」。
    メニューに表示していないドキュメントはDittoの表示対象から外したい場合は「1」を指定します。
  • hideFolders= (外さない)
    フォルダ(親ドキュメント)を表示対象から外すかどうかを指定します。デフォルト「外さない(0)=表示する」。
  • hidePrivate= (外す)
    「private」ドキュメントを表示対象から外すかどうかを指定します。デフォルト「外す(1)=表示しない」。
  • seeThruUnpub= (する)
    「hideFolders」が「1」で「depth」が「1」より大きい場合、非公開親ドキュメントの子ドキュメントを表示するかどうかを指定します。デフォルト「する(1)」。
  • sortDir= (降順)
    昇順でソートするか降順でソートするかを指定します。デフォルト「降順(DESC)」。昇順にする場合は「ASC」です。
  • sortBy= (作成日(createdon))
    ソートの基準になるフィールドを指定します。すべてのドキュメントオブジェクトまたはテンプレート変数を指定できます。デフォルト「作成日(createdon)」。
  • randomize= (しない)
    出力順序をランダムに変更するかどうかを指定します。デフォルト「しない(0)」
  • start= (なし)
    表示する際のオフセット値を指定します。1、2件目は表示せず、3件目から表示したいなら「2(= 2件スキップする)」を指定します。デフォルト「なし(0)」。
  • dateSource= (createdon)
    プレイスホルダのソースを指定します。unix タイムスタンプを持つすべてのMODx フィールドや、以下のような テンプレート変数を指定できます。
  • keywords= 関連するキーワードを、それぞれのドキュメントのために取得するかどうかを指定します(ウソかも)。「tagData」やのソースにできます。 ※「keywords=`1`」にしてテンプレートにを書いても表示されず。使い方間違ってる?METAタグとキーワードで設定したキーワードが入るんじゃないの?※
  • queryLimit= (自動)
    データベースから何件取得するかを指定します。MySQL の LIMIT と同等です。デフォルト「自動(0)」
  • where= (Null)
    MYSQL の where ステートメントを指定します。利用できるのは、ドキュメントオブジェクトのみで、テンプレート変数は利用できません。デフォルト「Null」
  • noResults= (「言語ファイルから読み込み($_lang['no_documents'])」)
    表示する結果がないときに、表示するテキストを、テキストかチャンクで指定します。デフォルト「言語ファイルから読み込み($_lang['no_documents'])」
  • hiddenFields= (Null)
    テンプレートパーサが処理できない、ネストされたプレイスホルダや、[fields]を取得する場合に指定します(ウソかも)。MODxフィールド名またはテンプレート変数をカンマで区切って複数指定可能です。デフォルト「Null」

パラメータ(ページング)

  • paginate= (しない))
    ページ分割するかどうかを指定します。デフォルト「しない(0)」。「1」を指定した場合、「display」で指定した値で分割します。
    ページ分割する場合は、スニペットコールを non-cache 形式で書く必要があります。
    また、ドキュメント内にページナビゲーション関係のプレイスホルダが必要です
  • paginateAlwaysShowLinks= (しない)
    常に「次へ()」「前へ()」のリンクを表示するかどうかを指定します。デフォルト「しない(0)」。
  • paginateSplitterCharacter= (「言語ファイルから読み込み($_lang['button_splitter'])」)
    「前へ()」「次へ()」へのリンクが機能しているとき表示される、スプリッタキャラクタ()を指定します。
    デフォルト「言語ファイルから読み込み($_lang['button_splitter'])」
キャッシュあり キャッシュ無し
ジェネレータの状態を初期状態に戻します。

このジェネレータはLet's enjoy MODx | Ditto 2.1ページから引用しています。また、ジェネレータに合わせるために一部の文章を変更させていただいております。