私がこの答えを始めたとき、それはほんの小さなメモであるべきです。まあ、私は失敗しました。ごめんなさい！私と一緒にいて、奥深くに隠れた良いものがあります…
WordPressウィジェットの保存方法
ウィジェットのリストはというオプションに保存されます'sidebars_widgets'。A var_export()は次のようなものを与えます：
array (
'wp_inactive_widgets' =>
array (
),
'top-widget' =>
array (
),
'bottom-widget' =>
array (
),
'array_version' => 3,
)
無視'wp_inactive_widgets'し'array_version'ます。それらを気にする必要はありません。
他のキーは、登録されたサイドバーの識別子です。この場合、サイドバーは次のコードで登録されている可能性があります。
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
デフォルトでは、登録後、サイドバーは空です。もちろん。
登録されたウィジェットクラスごとに、必要なすべてのオプションを含む個別のオプションが作成されます。オプションの先頭には文字列が付きますwidget_。すべてのアクティブなRSSウィジェットのオプションを取得するには、調査する必要があります…
get_option( 'widget_rss' );
可能な出力：
array (
2 =>
array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 5,
'show_summary' => 1,
'show_author' => 0,
'show_date' => 0,
),
)
番号2に注意してください。複数のインスタンスの引数はすべて、番号でソートされたこの1つのオプションに格納されます。
WordPressが既に認識しているウィジェットクラスを確認wp-admin/options.phpするには、次のように表示されるまで下にスクロールします。
はい、シリアル化されたデータ。いいえ、ここでは読むことができません。心配しないで、あなたはする必要はありません。
デモウィジェット
内部の仕組みをよりよく説明するために、非常に単純なデモウィジェットを作成しました。
/**
* Super simple widget.
*/
class T5_Demo_Widget extends WP_Widget
{
public function __construct()
{ // id_base , visible name
parent::__construct( 't5_demo_widget', 'T5 Demo Widget' );
}
public function widget( $args, $instance )
{
echo $args['before_widget'], wpautop( $instance['text'] ), $args['after_widget'];
}
public function form( $instance )
{
$text = isset ( $instance['text'] )
? esc_textarea( $instance['text'] ) : '';
printf(
'<textarea class="widefat" rows="7" cols="20" id="%1$s" name="%2$s">%3$s</textarea>',
$this->get_field_id( 'text' ),
$this->get_field_name( 'text' ),
$text
);
}
}
コンストラクタに注意してください：'t5_demo_widget'は、$id_baseこのウィジェットの識別子です。スクリーンショットでわかるように、引数はオプションに保存されていますwidget_t5_demo_widget。すべてのカスタムウィジェットはこのように扱われます。名前を推測する必要はありません。ので、あなたがあなたのウィジェットを書かれている（おそらく）あなたのクラスのすべての引数から知っている$instanceパラメータを。
テーマの基本
最初に、いくつかのサイドバーとカスタムウィジェットを登録する必要があります。これに対する適切なアクションは覚えやすい：'widgets_init'。すべてをコンテナに入れます–クラスまたは関数。簡単にするために、という名前の関数を使用しますt5_default_widget_demo()。
次のコードはすべてになりますfunctions.php。クラスT5_Demo_Widgetはすでにロードされているはずです。同じファイルに入れただけです…
add_action( 'widgets_init', 't5_default_widget_demo' );
function t5_default_widget_demo()
{
// Register our own widget.
register_widget( 'T5_Demo_Widget' );
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
これまでのところ、とても簡単です。これでウィジェットの準備が整いました。デモウィジェットは既知です。今から楽しみ。
$active_widgets = get_option( 'sidebars_widgets' );
if ( ! empty ( $active_widgets[ $sidebars['a'] ] )
or ! empty ( $active_widgets[ $sidebars['b'] ] )
)
{ // Okay, no fun anymore. There is already some content.
return;
}
あなたは本当にユーザー設定を破壊したくありません。すでにサイドバーにコンテンツがある場合は、コードを実行しないでください。そのため、この場合は停止します。
さて、サイドバーが空であると仮定して...カウンターが必要です：
$counter = 1;
ウィジェットには番号が付けられています。これらの番号は、WordPressの2番目の識別子です。
変更する配列を取得しましょう：
$active_widgets = get_option( 'sidebars_widgets' );
カウンターも必要です（これについては後で説明します）。
$counter = 1;
そして、カウンター、サイドバー名、ウィジェット引数の使用方法を以下に示します（引数は1つだけですtext）。
// Add a 'demo' widget to the top sidebar …
$active_widgets[ $sidebars['a'] ][0] = 't5_demo_widget-' . $counter;
// … and write some text into it:
$demo_widget_content[ $counter ] = array ( 'text' => "This works!\n\nAmazing!" );
$counter++;
ウィジェット識別子の作成方法に注意してください：、id_baseマイナス-、カウンター。ウィジェットのコンテンツは別の変数に保存されます$demo_widget_content。キーとウィジェットの引数が配列に格納されているカウンターは次のとおりです。
衝突を避けるために完了したら、カウンターを1つ増やします。
それは簡単でした。RSSウィジェットになりました。より多くのフィールド、もっと楽しく！
$active_widgets[ $sidebars['a'] ][] = 'rss-' . $counter;
// The latest 15 questions from WordPress Stack Exchange.
$rss_content[ $counter ] = array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 15,
'show_summary' => 0,
'show_author' => 1,
'show_date' => 1,
);
update_option( 'widget_rss', $rss_content );
$counter++;
ここに何か新しいものがあります：update_option()これはRSSウィジェットの引数を別のオプションに保存します。WordPressはこれらを後で自動的に見つけます。
2番目のサイドバーに2番目のインスタンスを追加したため、デモウィジェットの引数は保存しませんでした…
// Okay, now to our second sidebar. We make it short.
$active_widgets[ $sidebars['b'] ][] = 't5_demo_widget-' . $counter;
#$demo_widget_content = get_option( 'widget_t5_demo_widget', array() );
$demo_widget_content[ $counter ] = array ( 'text' => 'The second instance of our amazing demo widget.' );
update_option( 'widget_t5_demo_widget', $demo_widget_content );
...そして、すべての引数をまとめて保存しますt5_demo_widget。同じオプションを2回更新する必要はありません。
さて、今日のための十分なウィジェットsidebars_widgetsも保存しましょう。
update_option( 'sidebars_widgets', $active_widgets );
これで、WordPressは、登録されたウィジェットがいくつかあり、各ウィジェットの引数が保存されていることを認識します。var_export()sidebar_widgetsのA は次のようになります。
array (
'wp_inactive_widgets' =>
array (
),
'top-widget' =>
array (
0 => 't5_demo_widget-1',
1 => 'rss-2',
),
'bottom-widget' =>
array (
0 => 't5_demo_widget-3',
),
'array_version' => 3,
)
完全な コードの再：
add_action( 'widgets_init', 't5_default_widget_demo' );
function t5_default_widget_demo()
{
// Register our own widget.
register_widget( 'T5_Demo_Widget' );
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
// Okay, now the funny part.
// We don't want to undo user changes, so we look for changes first.
$active_widgets = get_option( 'sidebars_widgets' );
if ( ! empty ( $active_widgets[ $sidebars['a'] ] )
or ! empty ( $active_widgets[ $sidebars['b'] ] )
)
{ // Okay, no fun anymore. There is already some content.
return;
}
// The sidebars are empty, let's put something into them.
// How about a RSS widget and two instances of our demo widget?
// Note that widgets are numbered. We need a counter:
$counter = 1;
// Add a 'demo' widget to the top sidebar …
$active_widgets[ $sidebars['a'] ][0] = 't5_demo_widget-' . $counter;
// … and write some text into it:
$demo_widget_content[ $counter ] = array ( 'text' => "This works!\n\nAmazing!" );
#update_option( 'widget_t5_demo_widget', $demo_widget_content );
$counter++;
// That was easy. Now a RSS widget. More fields, more fun!
$active_widgets[ $sidebars['a'] ][] = 'rss-' . $counter;
// The latest 15 questions from WordPress Stack Exchange.
$rss_content[ $counter ] = array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 15,
'show_summary' => 0,
'show_author' => 1,
'show_date' => 1,
);
update_option( 'widget_rss', $rss_content );
$counter++;
// Okay, now to our second sidebar. We make it short.
$active_widgets[ $sidebars['b'] ][] = 't5_demo_widget-' . $counter;
#$demo_widget_content = get_option( 'widget_t5_demo_widget', array() );
$demo_widget_content[ $counter ] = array ( 'text' => 'The second instance of our amazing demo widget.' );
update_option( 'widget_t5_demo_widget', $demo_widget_content );
// Now save the $active_widgets array.
update_option( 'sidebars_widgets', $active_widgets );
}
ここに行くと、wp-admin/widgets.php3つのプリセットウィジェットが表示されます。
以上です。つかいます …
dynamic_sidebar( 'top-widget' );
dynamic_sidebar( 'bottom-widget' );
…ウィジェットを印刷します。
小さな不具合があります：初期登録のためにフロントエンドを2回ロードする必要があります。誰かがここで手伝うことができれば、私は非常に感謝します。