👩🏻‍🍳 📩 🚀 MODx：リソース、チャンク、いくつかのテレビ 📏 🎊 ☀️

私の友人がテンプレートで使用されているテレビの種類について尋ねた後、私は夕方まですべてを延期してこの記事を書くことにしました。
MODxの構成要素、「調理」、「サーブ」、「消費」の改善方法についてです。

主に初心者向けに設計されています modxドライバーが知っておく必要のある基本的な最小値が含まれています。もちろん、興味がある人のためのものです。

この記事は主にRevolutionに焦点を当てており、その構文の前任者との主な違いを反映していますが、下位互換性のためにEvolutionとの類推を挿入することがあります。

資源

多くの場合、リソースはサイト上のページです。さらに、リンク、ファイル自体など、他のタイプのリソースがあります。既定では、新しいリソースの種類はドキュメントであり、サイトの1ページのプレゼンテーションです。

4種類のリソースがあります。

ドキュメントは、最も一般的なリソースであり、本質的にはWebサイトページです。バルクは、見出し、注釈、テキスト（長）、さまざまな日付、メタタグ、および追加フィールド（TVパラメーター）で構成されます。
Webリンク -外部リソースまたはWebページへのリンク。
シンボリックリンクは、別のリソースへの内部リンクです。
静的リソースはファイルです。

各リソースには、一意の識別子、つまり「リソース識別子」もあります。 2つのリソースをリンクする場合は、IDを使用する必要があります。このようにして、MODxはリンクを生成します。ページのアドレスやアドレスの種類を変更することを心配する必要はありません。
また、テンプレートを各リソースに割り当てることができ、テンプレートはこのリソースの追加フィールドを定義できます。
リソースはコンテナとして機能し、他のリソースを含むことができます。これがサイト構造の形成方法です。

テンプレート

テンプレートは、MODxでのページの表示を定義する基本的なエンティティです。テンプレートには通常、サイトの場所と外観を決定するHTMLマークアップタグが含まれています。サイトページが要求されると、MODxはドキュメントまたはリソースとそのテンプレートをロードし、MODxはテンプレート内のすべての追加フィールドを検索し、ユーザーのブラウザにページを送信する前にドキュメントの対応する値に置き換えます。
テンプレートは任意のリソースに割り当てることができ、基本的にこのリソースのコンテンツが表示されるWebページを定義します。
テンプレートを一部として別のテンプレートに含めることはできません。
テンプレートの例：

< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
< html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >

パラメータ

リソースフィールドの値を表示するために使用されます。
呼び出しは次のように実行されます。

進化	革命
[フィールド]	[[*フィールド]]

フィールドの完全なリストは、こちらのドキュメントに記載されています。

テレビのパラメーター

TV追加フィールドまたはテンプレート変数（TV）は、カスタムフィールド、またはMODxリソースのカスタムフィールドです。 TVパラメータは、標準のリソースフィールドを拡張するために使用されます。 MODxの各リソースには、デフォルトで特定の数のフィールドがあります。上記のリソースのセクションを参照してください。
タスクがページにいくつかの追加フィールドを追加する場合、たとえば、月の名前のドロップダウンリスト、追加の画像、または他のタイプのユーザーデータの場合、対応するタイプのTVパラメーターを追加することでこれを実行できます。 MODxを使用すると、ほぼ無制限の数のTVパラメーターを使用できます。
TVタグは、リソースの処理時にユーザーが入力した対応する値に置き換えられます。また、そのような各パラメーターは特定のテンプレートに関連付けられており、それと組み合わせてのみ使用できます。
呼び出しは次のように実行されます。

進化	革命
[* tv *]	[[* tv]]

TVパラメーターは、パラメーターを追加するチャンクとして使用できます。たとえば、値を持つTVパラメータ「intromsg」がある場合：

こんにちは[[+ name]]、[[+ messageCount]]が未読です。

次に、呼び出すときにデータを入力できます。

[[* intromsg？name = `Grisha`＆messageCount =` 123`]]

結果：

こんにちは、グリシャ、123件の未読メッセージがあります。

たとえば、出力にフィルターを適用して、出力文字列の長さを100文字に制限することもできます。

[[* bioMessage：limit = `100`]]

フィルターの完全なリストはここにあります。さらに、フィルターをチャンクとスニペットに適用できます。

[[＃テンプレートにコメントを残すことが許可されています。このコードは、レンダリング後にページから削除されます。 ]]

チャンク

チャンク-テンプレート、別のチャンク、またはスニペットで呼び出すことができる静的テキスト。チャンクにはテンプレートと同じプロパティがありますが、TVパラメーターが含まれておらず、リソースに直接割り当てることはできません。
チャンクには実行可能コードを含めることはできませんが、スニペットを呼び出して動的コンテンツを表示できます。
チャンクは次のように呼び出されます。

進化	革命
{{チャンク}}	[[$チャンク]]

パラメーターをチャンクに転送できます。たとえば、次のコンテンツを含むチャンクを作成します。

こんにちは、[[+ name]]。 [[+ messageCount]]件の未読メッセージがあります。

そのようなチャンクは、後で内部で渡されるパラメーターで呼び出すことができます。

[[$イントロ？＆name = `Basil`＆messageCount =` 12`]]

このコードは次を出力します：

こんにちは、ヴァシリー。 12件の未読メッセージがあります。

静的データに加えて、追加の一般的なリソースパラメータをチャンクコールに配置できます。次に例を示します。

[[！$ intro？＆name = `[[* usersName]]`＆messageCount = `[[* messageCount]]`]]

スニペット

スニペット-MODxテンプレートの処理中に実行されるPHPコード。彼の作業の結果は、その出力の場所、またはプレースホルダー、これらまたは結果をどこに配置するかを決定する特別なタグのいずれかに配置できます。

スニペットは次のように呼び出されます。

進化	革命
[[スニペット]]	[[スニペット]]

プレースホルダーの配置：

進化	革命
[+プレースホルダー+]	[[+プレースホルダー]]

チャンクと同様に、次のようにパラメーターをスニペットに渡すことができます。

[[！Wayfinder？＆startId = `0`＆level =` 1`]]

転送されたパラメーターは、いわゆるデフォルトパラメーター（プロパティセット）にグループ化できます。これは、グループの名前を指定することでスニペットに転送できるパラメーターの動的グループです。
デフォルトのパラメーターは、スニペットの[設定]タブの管理パネルで設定されます。チャンクに対してデフォルトのパラメーターを作成することもできます。
たとえば、パラメータ「startId」= 0および「level」= 1でグループ「Menu」を作成し、次のようにスニペットを呼び出します。

[[！Wayfinder @ Menu]]

似ているでしょう、なぜならパラメータは自動的に置き換えられます：

[[！Wayfinder＆startId = `0`＆level =` 1`]]

デフォルト設定はすべて書き換え可能です。次の例では、 `level`パラメーターの値は1に等しいが、2に置き換えられます。

[[！Wayfinder @ Menu？＆level = `2`]]

スニペットをキャッシュしないようにシステムに指示するには、名前の前に感嘆符を追加する必要があります。

[ [ ！ noCacheSnippet ] ]

タグの構文

各MODx Revolutionタグには、他のMODxタグを含めることができます。コードを多少読みやすくするために、このような一般的な形式に準拠した複数行にタグコードを配置することが許可されています（かっこ内は、=を記述する必要のない私のコメントです）。

[[（開始タグ）
！（オプション、キャッシュ禁止シンボル）
elementToken（オプション、パラメーターのタイプを指定する文字。スニペットでない場合、$ =チャンク、* =通常/追加のリソースフィールド、+ =プレースホルダーなど）
elementName（要素名）
@propertyset（オプション、PropertySet識別子）
：filterName = `modifier`：...（オプションのフィルター、1つ以上）
？（オプション、パラメーターで行の始まりを定義）
＆propertyName = `propertyValue`＆...（＆で区切られたオプションのパラメーター）
]]（終了タグ）

MODxタグ構文ダッシュボード

アイテム	進化	革命	例
TVパラメーター	[* templatevar *]	[[* templatevar]]	[[* pagetitle]]
チャンク	{{チャンク}}	[[$チャンク]]	[[$ header]]
スニペット（PHPコードの一部）	[[スニペット]]	[[snippet]]または[[！snippet]]	[[getResources]]
プレースホルダー	[+プレースホルダー+]	[[+プレースホルダー]]	[[+ modx.user.id]]
リソースリンク	[〜リンク〜]	[[〜リンク]]	[[〜13]]
システム設定	[（system_setting）]	[[++ system_setting]]	[[++ site_start]]

MODx：リソース、チャンク、いくつかのテレビ

資源