「ウィジェットエリア管理」を編集中

baserCMSのウィジェット管理について説明しています。


== 機能の概要 ==
[[テーマに関する用語#レイアウトテンプレート|レイアウトテンプレート]]で利用するウィジェットエリアの設定を行います。ウィジェットとは、ある特定の機能をもった表示用のパーツの事で、baserCMSが標準で持っているものと、プラグインなどのインストールによって利用できるようになるものとがあります。（ウィジェットの詳しい説明は[[テーマに関する用語#ウィジェットエリア]]を参照してください）

　

== ウィジェットエリアの登録 ==
ウィジェットエリアの新規登録で入力できる項目は「ウィジェットエリア名」のみになります。これは、まず空のウィジェットエリアを作成し、後に中身となるウィジェットを追加していくためです。

　

=== ウィジェットの登録 ===
ウィジェットエリアの一覧から、編集したいウィジェットエリア名をクリックするか、左側の編集アイコンをクリックすると、ウィジェットの登録画面に入ります。左側に「利用できるウィジェット」、右側に「利用中のウィジェット」が並びます。

左側の「利用できるウィジェット」から利用したいウィジェットを、右側の「利用中のウィジェット」へドラッグ＆ドロップすると、ウィジェットが登録できます。

　

=== デフォルトで選べるウィジェットの種類 ===
baserCMSがデフォルトで持っているウィジェットは以下の通りです。


====コアウィジェット====
*ローカルナビゲーション　・・・同カテゴリ内のページを一覧表示するウィジェットです。サイドメニューなどの用途で利用します。
*PHPテンプレート　・・・予め用意しておいたPHPファイルを読み込み、ウィジェット内で実行・表示します。
*サイト内検索　・・・サイト内検索の検索窓を表示します。
*テキスト　・・・自由にテキストやHTMLを記述できます。


==== ブログウィジェット====
*ブログ投稿者一覧　・・・ブログ記事の投稿者を一覧表示します。投稿者毎の記事一覧を表示できます。
*ブログカレンダー　・・・ブログのカレンダーを表示します。
*ブログカテゴリ一覧　・・・ブログのカテゴリを一覧表示します。カテゴリ毎の記事一覧を表示できます。
*月別アーカイブ一覧　・・・月別のアーカイブを表示します。月ごとの記事一覧を表示できます。
*最近の投稿　・・・間近の投稿記事を一覧表示します。
*年別アーカイブ一覧　・・・年別のアーカイブを表示します。年ごとの記事一覧を表示できます。

　

== ウィジェットエリアの表示 ==
登録したウィジェットエリアは[[テーマに関する用語#レイアウトテンプレート|レイアウトテンプレート]]で表示させます。

表示させる際には以下の関数を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「No.」を指定する必要があります。エリアの「No.」はウィジェットエリア一覧で確認できます。

例えば、No.1のウィジェットエリアを出力する場合は以下のように記述します（バージョンによって多少異なります）。
###ウィジェットの呼び出し
####Ver.3系統
<pre>
$this->BcBaser->element('widget_area', array('no'=> 1 ))
</pre>
####Ver.2系統
<pre>
$bcBaser->element('widget_area', array('no'=> 1 ))
</pre>
この関数の実体は[[テーマに関する用語#エレメントファイル|エレメントファイル]]を呼び出す<code>$this->BcBaser->element()</code>です。詳細は[[関数リファレンス/element|element()]]をご覧ください。

　
<br /><br />
''テキスト寄贈：[http://hiniarata.jp/ 馬庭 吾一@株式会社ヒニアラタ]''