テンプレート編集はじめの一歩
提供: baserCMS公式ガイド
「テンプレート編集はじめの一歩」は、baserCMS初心者向けのテンプレート逆引きリファレンスとなっています。
テーマ「nada-icon」を例にとって、テンプレートのどこを触ればいいのかを説明していきたいと思います。
目次
オーバーライド機能とコアファイルのカスタマイズ
baserCMSのオーバーライド機能
baserCMSのファイル読み込みの優先順位について、オーバーライド機能というものがあります。
例えば、プラグインを何も導入していない状態だとすると、
/app/Plugin/ 以下は空になっているかemptyファイルが存在するだけになっています。
しかし管理画面に入ってプラグイン管理をクリックすると、「Blog」「Feed」「Mail」という3つのプラグインが存在していると思います。
管理画面のログイン方法については こちら を御覧ください。
baserCMSのファイル呼び出しの優先順位は、まず/app/以下にあるファイルが優先されます。
次に/lib/Baser/以下のコアファイルが呼び出されます。
プラグインの場合には、
/app/Plugin/以下にプラグインが存在していなくても、/lib/Baser/Plugin/以下にある「Blog」「Feed」「Mail」が呼び出されます。
例えば、/app/Plugin/以下と/lib/Baser/Plugin/以下に同じ名前のプラグイン「testBaser」が存在しているとすると、/app/Plugin/以下の「testBaser」が優先的に呼び出され、/lib/Baser/Plugin/以下の「testBaser」の機能を上書きすることとなります。
このbaserCMSのオーバーライド機能は他のファイルでも同様です。
コアファイルのカスタマイズ
baserCMSにおいて/lib/Baser/以下にあるコアファイルを変更したい場合には、/lib/Baser/以下から対応のコアファイルをコピーして、/app/以下にて/lib/Baser/以下と同じディレクトリ構造で設置します。
コアファイルに直接変更を加えるとbaserCMSの動作自体に不具合が出る可能性や、baserCMSのバージョンアップを行う際にコアファイルでの変更が上書きされてしまうので、注意してください。コアファイルの変更は自己責任でお願いします。
コアテンプレートのカスタマイズについては こちら も御覧ください。