baserCMS公式ガイド「テーマに関する用語」を編集中
提供: baserCMS公式ガイド
警告: ログインしていません。
編集すると、IPアドレスがこのページの編集履歴に記録されます。この編集を取り消せます。
下記の差分を確認して、本当に取り消していいか検証してください。よろしければ変更を保存して取り消しを完了してください。
| 最新版 | 編集中の文章 | ||
| 行11: | 行11: | ||
レイアウトテンプレートは、HTML全体（<html>から</html>まで）を担当するイメージで、このレイアウトテンプレート内で、エレメントファイル（後述）や[[関数リファレンス]]にある関数を利用します。なお、レイアウトテンプレートの設置場所は以下になります。 | レイアウトテンプレートは、HTML全体（<html>から</html>まで）を担当するイメージで、このレイアウトテンプレート内で、エレメントファイル（後述）や[[関数リファレンス]]にある関数を利用します。なお、レイアウトテンプレートの設置場所は以下になります。 | ||
| − | ####Ver. | + | ####Ver.4系統 |
| − | <pre> | + | <pre>/theme/（テーマのフォルダ）/Layouts/</pre> |
| − | + | ||
| − | + | ||
| − | + | ||
上記のフォルダ内に、通常「'''default.php'''」という名前で作成します。default.phpという名前で作成されたレイアウトテンプレートが、このテーマのデフォルトレイアウトテンプレートとして使用されます。baserCMS ver.2.1.0以降ならば、カテゴリ毎にレイアウトテンプレートを選択できる仕組みになっていますが、その仕組を利用する場合も、上記フォルダ内に複数のレイアウトテンプレートを用意しておくことで、管理画面からそれらを選択できるようになります。 | 上記のフォルダ内に、通常「'''default.php'''」という名前で作成します。default.phpという名前で作成されたレイアウトテンプレートが、このテーマのデフォルトレイアウトテンプレートとして使用されます。baserCMS ver.2.1.0以降ならば、カテゴリ毎にレイアウトテンプレートを選択できる仕組みになっていますが、その仕組を利用する場合も、上記フォルダ内に複数のレイアウトテンプレートを用意しておくことで、管理画面からそれらを選択できるようになります。 | ||
| 行28: | 行25: | ||
エレメントファイルは以下の場所に設置し、特に命名規則はありません。ただし、ヘッダ部分のファイル名にはheader.phpを、フッター部分にはfooter.phpを使えば、それらのエレメントを特別な関数で呼び出すことが出来るようになります。 | エレメントファイルは以下の場所に設置し、特に命名規則はありません。ただし、ヘッダ部分のファイル名にはheader.phpを、フッター部分にはfooter.phpを使えば、それらのエレメントを特別な関数で呼び出すことが出来るようになります。 | ||
| − | ####Ver. | + | ####Ver.4系統 |
| − | <pre> | + | <pre>/theme/（テーマのフォルダ）/Elements/</pre> |
| − | + | ||
| − | + | ||
| − | + | ||
エレメントの呼び出しについては[[関数リファレンス]]の[[エレメントファイルを呼び出す]]を参照してください。 | エレメントの呼び出しについては[[関数リファレンス]]の[[エレメントファイルを呼び出す]]を参照してください。 | ||
| 行44: | 行38: | ||
[[固定ページ管理#固定ページカテゴリ|固定ページカテゴリ]]のコンテンツテンプレートは、以下の場所にテンプレートとなるファイルを設置することで、固定ページカテゴリの作成・編集時に選択出来るようになります。 | [[固定ページ管理#固定ページカテゴリ|固定ページカテゴリ]]のコンテンツテンプレートは、以下の場所にテンプレートとなるファイルを設置することで、固定ページカテゴリの作成・編集時に選択出来るようになります。 | ||
| − | #####Ver. | + | #####Ver.4系統 |
| − | <pre> | + | <pre>/theme/（テーマのフォルダ）/Pages/templetes/</pre> |
| − | + | このテンプレートファイルはPHPファイルになり、Ver.4系統では<code>$this->BcPage->content()</code>と記述した場所にページの内容が出力されます。 | |
| − | + | ||
| − | このテンプレートファイルはPHPファイルになり、Ver. | + | |
==== プラグインのコンテンツテンプレート ==== | ==== プラグインのコンテンツテンプレート ==== | ||
| 行83: | 行75: | ||
上記のようにコントローラーが呼び出される前に設定を読み込むことで、この機能を実現しています。具体的な設定は以下のファイルを作成して、そこに記述を行えば、自動的に読み込まれるようになります。 | 上記のようにコントローラーが呼び出される前に設定を読み込むことで、この機能を実現しています。具体的な設定は以下のファイルを作成して、そこに記述を行えば、自動的に読み込まれるようになります。 | ||
| − | ####Ver. | + | #####Ver.4系統 |
| − | <pre>/ | + | <pre>/（テーマのフォルダ）/Config/bootstrap.php</pre> |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
=== テーマヘルパー === | === テーマヘルパー === | ||
テーマ内で使用できる[http://book.cakephp.org/1.2/ja/The-Manual/Developing-with-CakePHP/Helpers.html ヘルパー]です。ヘルパーはサイトの表示部分に関して、特定の機能を持った関数で、以下のフォルダに設置します。 | テーマ内で使用できる[http://book.cakephp.org/1.2/ja/The-Manual/Developing-with-CakePHP/Helpers.html ヘルパー]です。ヘルパーはサイトの表示部分に関して、特定の機能を持った関数で、以下のフォルダに設置します。 | ||
| − | ####Ver. | + | ####Ver.4系統における設置場所 |
| − | <pre> | + | <pre>/theme/（テーマフォルダ）/Helpers/</pre> |
| − | + | ||
| − | + | ||
| − | + | ||
なお、テーマヘルパーは以下のように「AppHelper」を継承して作成しますが、バージョンによってクラスの規則が異なります。例えばテーマ「hoge」で使うテーマヘルパーの場合、 | なお、テーマヘルパーは以下のように「AppHelper」を継承して作成しますが、バージョンによってクラスの規則が異なります。例えばテーマ「hoge」で使うテーマヘルパーの場合、 | ||
| − | ####Ver. | + | ####Ver.4系統におけるクラス名 |
| − | + | ||
| − | + | ||
| − | + | ||
<pre>class HogeHelper extends AppHelper {</pre> | <pre>class HogeHelper extends AppHelper {</pre> | ||
| − | |||
| − | + | こうしてHogeHelperクラスを作成し、その中に個別のヘルパーを記述していきます。こうして作られた個別のヘルパーは、レイアウトテンプレートやエレメントファイル、固定ページなどから呼び出すことが出来ます。例えば、 | |
<pre>function getBaserwiki(){}</pre> | <pre>function getBaserwiki(){}</pre> | ||
というヘルパーを呼び出すには、 | というヘルパーを呼び出すには、 | ||
| − | + | <pre><?php $this->Hoge->getBaserwiki(); ?></pre> | |
| − | + | ||
| − | <pre><?php $this-> | + | |
| − | + | ||
| − | + | ||
| − | + | ||
とします。 | とします。 | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== ウィジェットエリア === | === ウィジェットエリア === | ||
