参照機能

概要

参照機能を利用すると、1箇所に入力した内容を複数箇所で表示することができます。

例えば、見出しとして入力した内容をパンくずリストにも表示する、というような使い方ができます。
参照機能使用例

MEタグに用意された参照関連属性(ref_id, ref_page_id, ref_link)を指定すると、様々なパターンで他のMEタグが持つデータを参照できます。
参照のパターン別に指定方法を説明します。

ページ内参照

ページ内の別のMEタグの内容を表示します。テンプレート新規作詞・編集画面のタグ生成機能で、参照ID（ref_id）を指定するとそのidの内容を出力することができます。

ページ内参照

例えば、このようにidに"me1"を指定したMEタグを使用している場合。（上の画像では見出し部分）

<!--{text id="me1"}--> … <!--{/text}-->
MEタグの ref_id 項目に "me1" を指定することでその値を表示することができます。（上の画像ではパンくずリスト部分） 
<!--{text id="me2" ref_id="me1"}--> … <!--{/text}-->

参照元と参照先は同じタイプのタグである必要があります。

ページ内参照（リピート領域）

リピート領域も参照できます。

リピート領域は、参照する側もされる側もリピートタグ(repeat)を使います。
参照する側のリピートタグで参照したいリピートタグのIDをref_idに指定します。そうすると参照する側のリピートタグ内で、参照したリピートタグ内のMEタグを参照できます。

例：
  • 参照される側
    <!--{repeat id="item_list"}-->
<ul>
<li><!--{text id="me1"}--><!--{/text}--></li>
</ul>
<!--{/repeat}-->
  • 参照する側 
    <!--{repeat id="me3" ref_id="item_list"}-->
<ul>
<li><!--{text id="me2" ref_id="me1"}--><!--{/text}--></li>
</ul>
<!--{/repeat}-->

別ページ参照

別ページのMEタグの内容を表示します。

テンプレート新規作詞・編集画面のタグ生成機能で、参照ページID（ref_page_id）を指定して、そのページ内のタグを参照ID（ref_id）で指定することで、参照先の内容を出力できます。

例：
  • ページパス：/product.html
    ページID: 2
    <!--{text id="main_title"}--> … <!--{/text}-->
  • ページパス：/index.html
    ページID: 1
    <!--{text id="me1" ref_id="main_title" ref_page_id="2"}--> … <!--{/text}-->
    このように、ref_page_idとref_idを指定することで、product.htmlのMEタグの内容をindex.htmlで表示できます。

別ページのマルチタイプ参照

マルチタイプの別ページの内容を出力します。

例えば、ニュースリリースの詳細ページをマルチタイプでつくって、それをホームに表示するようなケースで利用できます。

マルチタイプは複数のデータを持っているので、参照元のシングルタイプのページではリピートタグを使って出力します。

リピートタグの参照テンプレートID（ref_template_id）に参照先のマルチタイプのテンプレートIDを指定します。

リピート内のタグの参照ID（ref_id）には参照先のタグのIDを指定します。

参照先へのリンクが必要な場合は、参照先へのリンク機能（ref_link）を有効に設定します。

例：
  • ニュースリリースページ
    テンプレートID：1
    テンプレートタイプ：multi
    ...
<h2><!--{text id="news_title"}-->News Title<!--{/text}--></h2>
...
    ニュースリリースページは、multiタイプのテンプレートを作成する。
  • ホーム
    テンプレートID：2
    テンプレートタイプ；single
    ...
<div>
<h3>News</h3>
<ul>
<!--{repeat id="me2" ref_template_id="1"}-->
<li><!--{text id="me5" ref_id="news_title" ref_link="on"}-->News Title<!--{/text}--></li>
<!--{/repeat}-->
</ul>
</div>
...
    ホームでは、ニュースリリースのタイトルを一覧表示するために、repeatタグを使いref_template_id属性にニュースリリースページのテンプレートIDを指定する。
    リピートタグ内はニュースリリースページのMEタグを参照できるので、textタグを使いref_id属性に"news_title"を指定する。
    news_titleをクリックすると該当するニュースリリースページに遷移させるために、ref_link属性に"on"を指定する。

注意点

非公開ページのデータは参照できません。

1.4 マニュアル