個人用ツール

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

提供: baserCMS公式ガイド

移動: 案内, 検索
(ウィジェットエリアの表示)
 
行9: 行9:
 
== ウィジェットエリアの登録 ==
 
== ウィジェットエリアの登録 ==
 
ウィジェットエリアの新規登録で入力できる項目は「ウィジェットエリア名」のみになります。これは、まず空のウィジェットエリアを作成し、後に中身となるウィジェットを追加していくためです。
 
ウィジェットエリアの新規登録で入力できる項目は「ウィジェットエリア名」のみになります。これは、まず空のウィジェットエリアを作成し、後に中身となるウィジェットを追加していくためです。
 
 
 
  
 
=== ウィジェットの登録 ===
 
=== ウィジェットの登録 ===
行16: 行14:
  
 
左側の「利用できるウィジェット」から利用したいウィジェットを、右側の「利用中のウィジェット」へドラッグ&ドロップすると、ウィジェットが登録できます。
 
左側の「利用できるウィジェット」から利用したいウィジェットを、右側の「利用中のウィジェット」へドラッグ&ドロップすると、ウィジェットが登録できます。
 
 
 
  
 
=== デフォルトで選べるウィジェットの種類 ===
 
=== デフォルトで選べるウィジェットの種類 ===
 
baserCMSがデフォルトで持っているウィジェットは以下の通りです。
 
baserCMSがデフォルトで持っているウィジェットは以下の通りです。
 
  
 
====コアウィジェット====
 
====コアウィジェット====
行28: 行23:
 
*サイト内検索 ・・・サイト内検索の検索窓を表示します。
 
*サイト内検索 ・・・サイト内検索の検索窓を表示します。
 
*テキスト ・・・自由にテキストやHTMLを記述できます。
 
*テキスト ・・・自由にテキストやHTMLを記述できます。
 
  
 
==== ブログウィジェット====
 
==== ブログウィジェット====
行37: 行31:
 
*最近の投稿 ・・・間近の投稿記事を一覧表示します。
 
*最近の投稿 ・・・間近の投稿記事を一覧表示します。
 
*年別アーカイブ一覧 ・・・年別のアーカイブを表示します。年ごとの記事一覧を表示できます。
 
*年別アーカイブ一覧 ・・・年別のアーカイブを表示します。年ごとの記事一覧を表示できます。
 
 
 
  
 
== ウィジェットエリアの表示 ==
 
== ウィジェットエリアの表示 ==
 
登録したウィジェットエリアは[[テーマに関する用語#レイアウトテンプレート|レイアウトテンプレート]]で表示させます。
 
登録したウィジェットエリアは[[テーマに関する用語#レイアウトテンプレート|レイアウトテンプレート]]で表示させます。
  
表示させる際には以下の関数を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「No.」を指定する必要があります。エリアの「No.」はウィジェットエリア一覧で確認できます。
+
表示させる際には[[ver4/関数リファレンス/widgetArea|widgetArea()]]を利用しますが、ウィジェットエリアは複数登録できるので、どのエリアを表示させるのか、エリアの「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/ 馬庭 吾一@株式会社ヒニアラタ]''
+

2016年9月18日 (日) 18:47時点における最新版

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

機能の概要[編集]

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

 

ウィジェットエリアの登録[編集]

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

ウィジェットの登録[編集]

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

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

デフォルトで選べるウィジェットの種類[編集]

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

コアウィジェット[編集]

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

ブログウィジェット[編集]

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

ウィジェットエリアの表示[編集]

登録したウィジェットエリアはレイアウトテンプレートで表示させます。

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