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