「ウィジェットエリア管理」の版間の差分
提供: baserCMS公式ガイド
(→ウィジェットエリアの表示) |
|||
行45: | 行45: | ||
表示させる際には以下の関数を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「No.」を指定する必要があります。エリアの「No.」はウィジェットエリア一覧で確認できます。 | 表示させる際には以下の関数を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「No.」を指定する必要があります。エリアの「No.」はウィジェットエリア一覧で確認できます。 | ||
− | 例えば、No. | + | 例えば、No.1のウィジェットエリアを出力する場合は以下のように記述します(バージョンによって多少異なります)。 |
+ | ###ウィジェットの呼び出し | ||
+ | ####Ver.3系統 | ||
+ | <pre> | ||
+ | $this->BcBaser->element('widget_area', array('no'=> 1 )) | ||
+ | </pre> | ||
+ | ####Ver.2系統 | ||
<pre> | <pre> | ||
$bcBaser->element('widget_area', array('no'=> 1 )) | $bcBaser->element('widget_area', array('no'=> 1 )) | ||
</pre> | </pre> | ||
− | この関数の実体は[[テーマに関する用語#エレメントファイル|エレメントファイル]]を呼び出す<code> | + | この関数の実体は[[テーマに関する用語#エレメントファイル|エレメントファイル]]を呼び出す<code>$this->BcBaser->element()</code>です。詳細は[[関数リファレンス/element|element()]]をご覧ください。 |
<br /><br /> | <br /><br /> | ||
''テキスト寄贈:[http://hiniarata.jp/ 馬庭 吾一@株式会社ヒニアラタ]'' | ''テキスト寄贈:[http://hiniarata.jp/ 馬庭 吾一@株式会社ヒニアラタ]'' |
2014年11月2日 (日) 11:06時点における版
baserCMSのウィジェット管理について説明しています。
目次
機能の概要
レイアウトテンプレートで利用するウィジェットエリアの設定を行います。ウィジェットとは、ある特定の機能をもった表示用のパーツの事で、baserCMSが標準で持っているものと、プラグインなどのインストールによって利用できるようになるものとがあります。(ウィジェットの詳しい説明はテーマに関する用語#ウィジェットエリアを参照してください)
ウィジェットエリアの登録
ウィジェットエリアの新規登録で入力できる項目は「ウィジェットエリア名」のみになります。これは、まず空のウィジェットエリアを作成し、後に中身となるウィジェットを追加していくためです。
ウィジェットの登録
ウィジェットエリアの一覧から、編集したいウィジェットエリア名をクリックするか、左側の編集アイコンをクリックすると、ウィジェットの登録画面に入ります。左側に「利用できるウィジェット」、右側に「利用中のウィジェット」が並びます。
左側の「利用できるウィジェット」から利用したいウィジェットを、右側の「利用中のウィジェット」へドラッグ&ドロップすると、ウィジェットが登録できます。
デフォルトで選べるウィジェットの種類
baserCMSがデフォルトで持っているウィジェットは以下の通りです。
コアウィジェット
- ローカルナビゲーション ・・・同カテゴリ内のページを一覧表示するウィジェットです。サイドメニューなどの用途で利用します。
- PHPテンプレート ・・・予め用意しておいたPHPファイルを読み込み、ウィジェット内で実行・表示します。
- サイト内検索 ・・・サイト内検索の検索窓を表示します。
- テキスト ・・・自由にテキストやHTMLを記述できます。
ブログウィジェット
- ブログ投稿者一覧 ・・・ブログ記事の投稿者を一覧表示します。投稿者毎の記事一覧を表示できます。
- ブログカレンダー ・・・ブログのカレンダーを表示します。
- ブログカテゴリ一覧 ・・・ブログのカテゴリを一覧表示します。カテゴリ毎の記事一覧を表示できます。
- 月別アーカイブ一覧 ・・・月別のアーカイブを表示します。月ごとの記事一覧を表示できます。
- 最近の投稿 ・・・間近の投稿記事を一覧表示します。
- 年別アーカイブ一覧 ・・・年別のアーカイブを表示します。年ごとの記事一覧を表示できます。
ウィジェットエリアの表示
登録したウィジェットエリアはレイアウトテンプレートで表示させます。
表示させる際には以下の関数を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「No.」を指定する必要があります。エリアの「No.」はウィジェットエリア一覧で確認できます。
例えば、No.1のウィジェットエリアを出力する場合は以下のように記述します(バージョンによって多少異なります)。
ウィジェットの呼び出し
Ver.3系統
$this->BcBaser->element('widget_area', array('no'=> 1 ))
Ver.2系統
$bcBaser->element('widget_area', array('no'=> 1 ))
この関数の実体はエレメントファイルを呼び出す$this->BcBaser->element()
です。詳細はelement()をご覧ください。
テキスト寄贈:馬庭 吾一@株式会社ヒニアラタ