include」機能の基本設定について説明します。include機能は、フォームでpost(送信)した結果を、ページのリロードなしで表示する機能です。config.js内の設定/js/config.jsの以下の箇所に設定内容が記載されています。'slow'}],postIncludeOnsubmitMarkここで指定したセレクタのフォームは、送信ボタンを押した後に結果を表示します。付与されているform要素に適用されます。postIncludeOnreadyMarkここで指定したセレクタのフォームは、送信ボタンを押さなくてもページを読み込んだら自働的に送信されて結果を表示します。付与されているform要素に適用されます。postIncludeOnBottomMarkここで指定したセレクタのフォームは、送信ボタンを押さなくてもページの下部までスクロールしたら自働的に送信されて結果を表示します。付与されているform要素に適用されます。postIncludeOnIntervalMarkここで指定したセレクタのフォームは、送信ボタンを押さなくても一定時間ごとに自働的に送信されて結果を表示します。付与されているform要素に適用されます。指定なし:エフェクトなしpostIncludeEffectSpeedpostIncludeEffectでエフェクトが指定されている時のみ有効になります。指定されたセレクタのフォームの下部からの読み込み開始位置になります。指定されたセレクタのフォームの読み込み開始時間を遅くする設定になります。指定されたセレクタのフォームの読み込み時の更新頻度をミリ秒で設定します。postIncludeArray配列として複数の設定を記述できます。同じページ内で複数の設定を併用したい場合などに利用します。2.8.0よりpostIncludeEvalValueMarkの設定ではキャッシュさせないポストインクルードが動作しなくなりました。includeの結果をキャッシュさせない方法」の代替案をご覧ください。tplコンテキストが無効になりました。設定が無効になるような設定になりました。同一コンテンツの複数のページができてしまうためになります。そのため、ポストインクルードでテンプレートを指定が無視されてしまう事になります。この設定はログインしている際には指定が無効になっていますので開発中に気がつきづらいので注意が必要です。有効にならない事になります。ポストインクルードで利用するファイルを指定します。複数ある場合にはカンマで区切って設定します。cmsでは、フォーム送信後の結果を、ページを移動せずにAjaxを使用して表示できる機能が標準で実装されています。include機能を利用します。通常は検索フォームにデータを入力して送信ボタンを押すと、新しいページを読み込んで検索結果を表示しますが、この機能を利用するとページを移動せずに同じページ内で検索結果を表示することができます。ここでは例として、サイト内検索フォームから検索すると、ある特定のコンテンツエリアを書き換えて検索結果を表示する手順を説明します。検索結果の表示を用意する(1)フォームを送信した後に表示する内容をテンプレートとして用意します。ここではsearchResultSample.htmlというテンプレートを用意します。このテンプレートには検索結果の表示部分のみ記述しています。-->(2)手順1(1)で作成したモジュールをモジュールIDにし、引数設定の[keyword]にチェックを入れます。これで、フォームから送られたキーワードに合致するエントリーが表示されるようになります。フォームを用意する(1)サイト内検索フォームを用意します。/></form>(2)form要素にclass属性とtarget属性を追加します。「class="js-post_include"」はこのとおりに記述し、target属性は#の後に任意の名前を記述します。("#"はidを意味しています)このtarget属性は検索結果の表示を置き換える場所を指定しています。target属性がない場合は、form自体が検索結果表示に置き換わります。/></form>(3)検索結果を表示するテンプレートを参照します。いうテンプレートを参照する場合の例です。検索結果表示部分と関連付ける検索結果を表示したいコンテンツエリアに、form要素のtarget属性と同じ名前を付けます。手順2(2)で指定したtarget属性の値と同じ名前が付いている要素部分が、検索結果表示として置き換わります。target属性で指定した要素自身を置き換えるか、その中身を置き換えるかを設定することができます。includeの基本設定」の「postIncludeMethod」を参照してください。id="jsChangeContents"><p>この部分が置き換わります。</p></div>動作サンプル下の検索フォームに語句を入力して[検索]ボタンを押すと、「この部分が置き換わります。」が検索結果に置き換わって表示されます。この部分が置き換わります。<p>この部分が置き換わります。</p></div>これで、検索結果を別ページに移動せずに表示できるようになります。cmsでは、フォームの送信ボタンを押さずに検索結果をAjaxを使用して表示できる機能が標準で実装されています。通常は検索フォームにデータを入力して送信ボタンを押すと、新しいページを読み込んで検索結果を表示しますが、この機能を利用するとフォームの送信ボタンを押さずに同じページ内で検索結果を表示することができます。ここでは例として、ある特定のキーワードで検索した場合の検索結果を表示する手順を説明します。検索結果の表示を用意する(1)フォームを送信した後に表示する内容をテンプレートとして用意します。ここではsearchResultSample.htmlというテンプレートを用意するとします。このテンプレートには検索結果の表示部分のみ記述しています。-->(2)手順1(1)で作成したモジュールをモジュールIDにし、引数設定の[keyword]にチェックを入れます。これで、フォームから送られたキーワードに合致するエントリーが表示されるようになります。非表示のフォームを用意する(1)検索フォームを用意します。/></form>(2)form要素にclass属性を追加します。「class="js-post_include-ready"」はこのとおりに記述します。/></form>(3)検索結果を表示するテンプレートを参照します。いうテンプレートを参照する場合の例です。/></form>(4)検索キーワードを指定します。/></form>これで、送信ボタンを押さずに検索結果を表示するようになります。動作サンプル下のリストは、フォームで特定のキーワード「サマリー」で検索して合致したエントリーが検索結果として表示されています。フォーム自体は表示されず、検索結果が表示されます。include)位置情報を付加してポストインクルードするポストインクルードを使うことで、検索結果など別コンテンツをページを移動することなく引っ張ってくることができます。技術的にはAjaxを使って実現しています。このポストインクルードはJavaScriptで動いているため、端末の位置情報を取得して、ポストインクルード先に位置情報を渡すことができます。することで、現在位置から近い店舗を表示するなどといった、ユーザーに優しい機能を作ることができます。https(SSL/TLS対応)でないと、位置情報を取得できない事が多くなっています。この機能を使用する場合は、httpsの環境をご用意ください。最初にアクセスするときにブラウザが、位置情報を取得してもいいか、許可を求めてきます。ここでユーザーが許可を行わないと、位置情報の取得はできません。追加する事で、自動的に組み込みJSが自動で位置情報を取得してポストインクルードしてくれます。追加する事で、位置情報を付加して指定されたテンプレートにアクセスするのですが、以下のようにクエリストリングとして付加されます。することにより、位置情報が取得できます。サンプル以下、緯度・経度を表示するサンプルになります。%{lng}</li></ul>動作サンプル(緯度・経度を表示)Entry_GeoListとの組み合わせEntry_GeoListモジュールは、エントリーに位置情報を付加して、ある場所(エントリーや個別指定)から近い順番でエントリーを表示できるモジュールです。このEntry_GeoListと位置情報付きのポストインクルードを使うことで、現在位置から近いエントリーを引っ張ってくる事ができるようになります。実装方法Entry_GeoListモジュールIDを作成し、設定の基準点を「URLコンテキストを参照」から「URLクエリストリングを参照(?lat=xxx&lng=xxx)」に変更してください。これでモジュールは、エントリー基準ではなくURLの情報から基準点をとってくるようになります。URLクエリストリングを参照に変更そして、Entry_GeoListモジュールが書かれたテンプレートを、位置情報付きのポストインクルードで読み込めば、現在位置から近い順で表示する事ができるようになります。ポストインクルードで色々な情報を引っ張ってくるポストインクルードを使うことにより、現在表示しているURLとは関係ない情報を好きに引っ張ってくることができます。モジュールIDを使えば、同じようにURLと関係ない情報を出力することはできるのですが、エントリーの情報を使って、引っ張ってくる値が変わる場合はどは、ポストインクルードが便利です。エントリー詳細ページで、そのエントリーのカスタムフィールドの値を元に、関連する記事一覧を引っ張ってくるなど。実装方法POST_2GETモジュールを使用します。cmsの様々なパラメータを渡して送信すると、そのパラメータを元にURLを組み立て、好きなページを表示できるようになります。テンプレートを使って表示しています。IDに沿ったURLが生成されます。value="key2">このようなパラメータを使うことにより好きなページの情報を取得することができるようになります。実装に困った時は、一度ポストインクルードで出来ないか検討してみてください。いうモジュールとポストインクルード機能を組み合わせることで、ページの遷移無しに続き部分を読み込んでくる事ができるようになります。続きを読む部分を表示するテンプレートを準備します。部分を探してみて下さい。-->の部分を、以下のように修正します。-->以上のカスタマイズで「xxxの続きを読む」ボタンを押すと、ページ遷移なしで記事の続きが表示されるようにすることができます。