URLコンテキストの指定

ここでは、URLコンテキストの指定方法を解説していきます。ACMS_POST_2GETを使ってURLコンテキストを生成することが可能です。合わせてご覧ください。

また、URLコンテキストを使ってモジュールの表示内容を指定するには、モジュールID化してそれぞれの項目に対応する引数にチェックをつける必要があります。

URLコンテキストで指定したい項目にチェックをつけます。

IDを使って指定する

通常URL（例： http://example.com/company/access.html ）でアクセスした場合、ブログコード、カテゴリーコード、エントリーコード（ファイル名）をもとに、登録データの解析を行い、ブログの情報やカテゴリーの情報やエントリー情報などを取得しています。

この他の書き方として、直接IDを指定してデータを取得する方法もあります。以下ではブログID（bid）、カテゴリーID（cid）、エントリーID（eid）を指定しています。

http://example.com/bid/1/cid/3/eid/16/

年月日を指定する

URLコンテキストを使ってエントリーの年月日を指定できます。

年月日については、yyyy-mm-dd、yyyy-mm、yyyyyの形式でURLコンテキストが記述されている場合に年月日として判定されます。

<!-- 日時を指定 -->
http://example.com/news/2017/ <!-- 2017年の記事 -->
http://example.com/news/2017/06/ <!-- 2017年6月の記事 -->
http://example.com/news/2017/06/23/ <!-- 2017年6月23日の記事 -->

<!-- 期間を指定 -->
http://example.com/news/2016/-/2017/ <!-- 2016, 2017年の記事 -->
http://example.com/news/2017-06-01/-/2017-06-30/ <!-- 2017年6月の記事 -->
http://example.com/news/2017-06-13/-/2017-06-23/ <!-- 2017年6月13日から23日の記事 -->

キーワードを指定する（キーワード検索）

URLコンテキストを使って検索を行います。以下がエントリーの検索対象となるデータになります。

• エントリーのタイトル
• テキストユニット、カスタムユニットのデータ
• カスタムフィールドを検索に入らないようにするをしていないこと

<!-- 検索キーワード「地図」でヒットした記事の一覧が表示されます。 -->
http://example.com/news/keyword/地図/

フィールドを指定（カスタムフィールド検索）

URLコンテキストを使って検索を行います。キーワード検索と違い、検索対象はカスタムフィールドの項目を指定した検索になります。

詳しくは カスタムフィールドの検索 をご覧ください。

<!-- カスタムフィールド「price」の値を「60000」で登録している記事が一覧ページに表示されます。 -->
http://example.com/realestate/field/price/60000/

<!-- カスタムフィールド「price」の値を登録している（空ではない）記事が一覧ページに表示されます。 -->
http://example.com/realestate/field/price/nem/

<!-- カスタムフィールド「price」の値を「60000」以下で登録している記事が一覧ページに表示されます。 -->
http://example.com/realestate/field/price/lte/60000/

並び順を指定する

一覧ページでは、並び順をURLコンテキストで指定することができます。指定できる値は、モジュールIDの表示設定にある、並び順の項目と同じになります。

<!-- 新しい日付順で表示します -->
http://example.com/order/datetime-desc/

<!-- 設定された表示順で表示します。（カテゴリ、ユーザごとのソート設定があるので注意） -->
http://example.com/order/sort-asc/

<!-- ランダムで表示します。（キャッシュされるとランダムで表示できないので注意） -->
http://example.com/order/random/

カスタムフィールドで並び替えを行う「field-asc」「field-desc」「intfield-asc」「intfield-desc」を使ったorder指定には注意が必要です。 例えば、下記のURLでは対象となるカスタムフィールドがないため、URLコンテキストで指定した並び替えは行われません。

http://example.com/realestate/order/intfield-asc/

次のように「field」を使ってカスタムフィールドを指定します。

http://example.com/field/price/nem/order/intfield-asc/

「price」の値を数値として昇順に並び替えた一覧ページを表示します。

注意点 その１：モジュールIDの設定でURLコンテキストのfield項目をチェックしていない場合、URLコンテキストで指定した並び替えも行われません。

注意点 その2：複数の項目をfield検索している場合、最初のfield(一番左側の）が並び替えに使用されます。

URLコンテキストとは異なるテンプレートを指定する

通常だと、URLコンテキストに沿ったテンプレートファイルが適用されますが、「tpl」を使って、異なるテンプレートを適用できます。

<!-- エントリーの詳細ページに custom.html というURLコンテキストとは異なるテンプレートを適用する -->
http://example.com/entry-21.html/tpl/include/custom.html

「tpl」を使って異なるテンプレートを適用する方法は、ポストインクルード機能と組み合わせてよく使われます。詳しくはポストインクルード機能をご覧ください。

private/cofig.system.yaml で以下項目が追加・変更されています。

forbid_tpl_inheritance_when_path_unresolved: on # on | off パス解決に失敗した時、テンプレートを継承しないようにする
forbid_tpl_url_context: on # on | off 読者以下のURLコンテキストのtplを許可しない。（例: https://example.com/news/tpl/custom.html）
allow_tpl_path: [] # forbid_tpl_inheritance_when_path_unresolved や forbid_tpl_url_context が on の場合、除外するパスを設定します。例: [news.html,hoge/custom.html] カンマ区切りで指定

forbid_tpl_url_context

デフォルトで、tplコンテキスト を無効に設定しました。理由として tplを指定すればクライアント側で、好きなテンプレートを指定することができてしまうため、 同一コンテンツの複数のページができてしまうためになります。

forbid_tpl_inheritance_when_path_unresolved

デフォルトで、パス解決失敗時のテンプレート継承を無効にしました。理由として forbid_tpl_url_context と同様、同一コンテンツの複数のページが表示できてしまうためになります。

allow_tpl_path

上記2つの設定の例外パスを設定できます。例えばpost includeしたい箇所などは、tplコンテキストを使いたい場合があるので、 そのような時は、ここで例がテンプレートのパスを記入します。

以上3つのオプションの設定を追加・変更いたしました。バージョンアップでは影響が出ないようになっていますので、Ver. 2.11.25 以上で新規インストールする場合はお気をつけください。

forbid_tpl_inheritance_when_path_unresolved と forbid_tpl_url_context を off に設定すれば、いままでと同じ動作になりますが、できればここの設定はONのまま、allow_tpl_path で例外設定をするようにお願いいたします。