「ウィジェットエリア管理」の版間の差分

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()をご覧ください。

　

テキスト寄贈：馬庭 吾一@株式会社ヒニアラタ