• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/register sidebars

提供: WordPress Codex 日本語版
< 関数リファレンス
2010年3月3日 (水) 22:11時点におけるBono (トーク | 投稿記録)による版 (整形、未翻訳)

移動先: 案内検索

このページ「関数リファレンス/register sidebars」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

Creates multiple sidebars.

Registers one or more sidebars to be used in the current theme. Most themes have only one sidebar. For this reason, the number parameter is optional and defaults to one.

The args array parameter can contain a 'name' which will be prepended to the sidebar number if there is more than one sidebar. If no name is specified, 'Sidebar' is used.

使い方

<?php register_sidebars( $number, $args ); ?>

Default Usage

<?php $args = array(
	'name'          => sprintf(__('Sidebar %d'), $i ),
	'id'            => 'sidebar-$i',
	'before_widget' => '<li id="%1$s" class="widget %2$s">',
	'after_widget'  => '</li>',
	'before_title'  => '<h2 class="widgettitle">',
	'after_title'   => '</h2>' ); ?>

パラメータ

$number
int) (必須) Number of sidebars to create.
初期値: なし
$args
string/array) (optional) Builds Sidebar based off of 'name' and 'id' values.
初期値: なし
  • name - Sidebar name.
  • id - Sidebar id.
  • before_widget - Text to place before every widget.
  • after_widget - Text to place after every widget.
  • before_title - Text to place before every title.
  • after_title - Text to place after every title.

The optional $args parameter is an associative array that will be passed as a first argument to every active widget callback. (If a string is passed instead of an array, it will be passed through parse_str() to generate an associative array.) The basic use for these arguments is to pass theme-specific HTML tags to wrap the widget and its title.

用例

This will register 1 sidebar named Sidebar:

register_sidebars();

This will create 2 sidebars named “Foobar 1″ and “Foobar 2″:

register_sidebars(2, array('name'=>'Foobar %d'));

This will create 2 sidebars with <h1> and </h1> before and after the title:

register_sidebars(2, array('before_title'=>'<h1>','after_title'=>'</h1>'));

変更履歴

ソースファイル

register_sidebars() is located in wp-includes/widgets.php.

最新英語版: WordPress Codex » Function Reference/register_sidebars最新版との差分

関連

ウィジェット API: is_active_widget(), the_widget(), register_widget(), unregister_widget() / en, wp_register_widget_control() / en, wp_unregister_widget_control() / en, wp_convert_widget_settings() / en, wp_get_widget_defaults() / en, wp_widget_description() / en



関数リファレンステンプレートタグ目次もご覧ください。