新しいWordPress 3.1管理バーはプラグイン可能ですか？どのように拡張できますか？

プラグインでWordPress 3.1管理バーの機能を拡張するにはどうすればよいですか？

リンクやその他の機能を管理バーに追加するときに使用する特定のフックとフィルターを探しています。

すでに行われていることの良い例は、Yoast WordPress SEO（Wordpress Plugin）です。

現在、管理バーの拡張に関する利用可能なドキュメントはありません。コーデックスによると、それをオフにするか表示しないための2つのフィルターがあります：

no_admin_bar() ＆ show_admin_bar()

Yoastのプラグインは、メニューを追加することだけが目的の場合、実際には非常に良い例です。基本的に、管理バーは、サイドバーにある同じプラグイン管理ページへのリンクの代替セットにすぎません。トップレベルのSEOメニューを追加するために、Yoastは次のことを行います。

$wp_admin_bar->add_menu( array( 'id' => 'wpseo-menu', 'title' => __( 'SEO' ), 'href' => get_admin_url('admin.php?page=wpseo_dashboard'), ) );

これにより、管理バーに「wpseo-menu」という名前のメニューが追加され、ユーザーがリンクをクリックするとプラグインのダッシュボードに移動します。子リンクも同様の方法で追加されます。

$wp_admin_bar->add_menu( array( 'parent' => 'wpseo-menu', 'id' => 'wpseo-kwresearch', 'title' => __( 'Keyword Research' ), '#', ) );

追加するメニューの「親」を指定するだけです。

その後、$wp_admin_bar->add_menu()必要なときに深く呼び出し、必要なときに呼び出して、適切な情報を指定できます。

参考までに、変数$wp_admin_barはWP_Admin_Bar()WordPress内のクラスのインスタンスです。いくつかの異なるメソッドとプロパティがありますが、ここで最も興味のあるものは、明らかにadd_menu()です。このメソッドは特定のパラメーターを受け入れます。

• タイトル -デフォルトはfalse
• href-デフォルトはfalse、
• parent-デフォルトはfalse-そのメニューのサブメニューのID値を渡します
• id-デフォルトはサニタイズされたタイトル値です。
• meta-デフォルトはfalse-次のオプションの配列：array( 'html' => '', 'class' => '', 'onclick' => '', target => '' );

しかし、WP_Admin_Bar()クラスの残りの部分はプラグ可能です。それはまさにあなたが何をしようとしているのか、そしてあなたがそれをどのようにしたいのかに依存します。

関連項目：

• YoastのプラグインのSVN：ファイルの途中を読んで、メニュー定義を見つけますwpseo_admin_bar()
• クラスのPHPXref WP_Admin_Bar()

小さな例、私はこれを視聴日の前にwp-hackersリストにも書いていた

function wp_codex_search_form() {
    global $wp_admin_bar, $wpdb;

    if ( !is_super_admin() || !is_admin_bar_showing() )
        return;

    $codex_search = '<form target="_blank" method="get" action="http://wordpress.org/search/do-search.php" style="margin:2px 0 0;">
        <input type="text" onblur="this.value=(this.value==\'\') ? \'Search the Codex\' : this.value;" onfocus="this.value=(this.value==\'Search the Codex\') ? \'\' : this.value;" maxlength="100" value="Search the Codex" name="search" class="adminbar-input">
        <button type="submit" class="adminbar-button">
            <span>Go</span>
        </button>
    </form>';

    /* Add the main siteadmin menu item */
    $wp_admin_bar->add_menu( array( 'id' => 'codex_search', 'title' => 'Search Codex', 'href' => FALSE ) );
    $wp_admin_bar->add_menu( array( 'parent' => 'codex_search', 'title' => $codex_search, 'href' => FALSE ) );
}
add_action( 'admin_bar_menu', 'wp_codex_search_form', 1000 );

ナイトリービルドをダウンロードして、これらの2つのファイルをチェックしてください。

• wp-includes / admin-bar.php
• wp-includes / class-wp-admin-bar.php

クラスWP_Admin_Barは基本的に「API」ですが、ファイルadmin-bar.phpはそれを使用してデフォルトのバーを構築し、フックのロードを開始します。

function my_admin_bar()
{
    global $wp_admin_bar;
    $wp_admin_bar->add_menu(array(
        'parent' => 'my-account', // optional
        'id'     => 'my-unique-id',
        'title'  => '',
        'href'   => ''
    ));
}
add_action('admin_bar_menu', 'my_admin_bar');

これは基本的なことです-これは私が自分で簡単に調べたすべてです（正直に言うと、フックadmin_bar_menuがインスタンスを返さないのは少し面倒ですWP_Admin_Bar-これらのグローバルはすべて嫌いです！）