Welcome !! Now 2008.07.25 16:21 (JST)

IncludeFile

[ スニペット ]

includeFileは、任意のファイルの内容をドキュメントやテンプレートに挿入するスニペットです。このスニペットを使用して、ローカルで作成したhtmlファイル（の内容）をテンプレート上に呼び出すことで、ローカル環境とサーバー上でのやりとりが、より、スムーズに行えるでしょう。

なお、このスニペットを利用せず、テンプレート変数を使って同じ結果を得る方法もあります（テンプレート変数（TV）を利用してファイルをインクルードする）。

参照ページ：includeFile

テスト環境

  • サーバ：さくらインターネット 　
    • PHP 4.4.4
    • MYSQL 4.0.27
  • MODX：0.9.5
  • IncludeFile

基本的な書式

[[includeFile? &file=`assets/template/sample/sample.html`]]

注意点

  • ドキュメントのキャッシュが「可」の場合、スニペットの書式を[[～]]にすると、インクルードされる側のファイルの内容を変更しても、「キャッシュのクリア」をするまで、変更がページに反映されません
  • [!～!]の場合、インクルードするファイルの中で[!～!]を利用していると、その部分のスニペットは動作しません（たぶんこちらが参考になります「スニペットでキャッシュ不可のスニペットを呼び出す方法」）。なお、インクルードするファイルの中のスニペットの書式が[[～]]なら動作します

コード

参照ページ：InculdeFile に掲載されています。

パラメータ

file

読み込みたいファイルの、サイトルートからのパスを指定します。

読み込む側のファイル

読み込む側のファイルに、特に制限はありません。普通にドキュメントやテンプレートを作成するように、MODxタグや、スニペットコールを含めることができます。

△ページトップ