静的テンプレート

静的テンプレートは、テーマ内のテンプレートファイルだけで公開ページを作れる機能です。

コンテンツの内容によっては、管理画面でコンテンツを登録せずに、PCの任意のツール・エディターで作成したHTMLファイルをサーバーにアップロードするだけで公開したいという場合があります。そういうケースで静的テンプレート機能を活用することができます。 静的テンプレートでは Twig が使えるため、レイアウトテンプレートを継承したり、共通部品をインクルードすることができます。

静的テンプレートファイルはテーマの views/static/ ディレクトリ以下に保管します。 サンプルテーマの場合は、/themes/sample/views/static/ が静的テンプレートのディレクトリになります。

静的テンプレートファイルの拡張子は .twig です。たとえば、test.html.twig という名前の場合は、.twig を取り除いた test.html というファイル名で公開されます。 公開されるパスは、静的テンプレートディレクトリの static ディレクトリがドキュメントルートと対応する仕組みです。 具体的な見本として、サンプルテーマに静的テンプレートファイル(/themes/sample/views/static/test.html.twig )が用意されています。このテンプレートは https://exmple.com/test.html というパスで表示することができます。

注意事項:
  • パスが重複するページコンテンツがある場合は、ページコンテンツが優先されます。