A nova barra de administração do WordPress 3.1 é conectável e como posso estendê-la?

Como posso estender as funções da barra de administração do WordPress 3.1 nos meus plugins?

Estou procurando por ganchos e filtros específicos para adicionar links ou outros recursos à barra de administração.

Um bom exemplo do que já foi feito é o Yoast WordPress SEO (Wordpress Plugin) .

Atualmente, não há documentação disponível para estender a barra de administração. De acordo com o The Codex, existem dois filtros para desativá-lo ou não mostrá-lo:

no_admin_bar() & show_admin_bar()

O plug-in do Yoast é realmente um exemplo muito bom se tudo o que você quer fazer é adicionar menus. Basicamente, a barra de administrador é apenas um conjunto alternativo de links para as mesmas páginas de administrador de plug-in que você possui na barra lateral. Para adicionar o menu SEO de nível superior, o Yoast faz o seguinte:

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

Isso adiciona um menu chamado "wpseo-menu" à barra de administrador e direciona os usuários para o painel do plug-in quando eles clicam no link. Links filho são adicionados de maneira semelhante:

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

Você acabou de especificar o "pai" do menu que está adicionando.

Depois, você pode ir o mais fundo possível, ligando $wp_admin_bar->add_menu()quando necessário e especificando as informações apropriadas.

Para referência, a variável, $wp_admin_baré uma instância da classe WP_Admin_Bar()no WordPress. Ele tem vários métodos e propriedades diferentes, mas o que mais lhe interessa aqui é, obviamente add_menu(),. Este método aceita certos parâmetros:

• title - padrão false
• href - padrão false,
• pai - padrão falso - transmita o valor do ID para um submenu desse menu
• id - o padrão é um valor de título higienizado.
• meta - default false - array de qualquer uma das seguintes opções:array( 'html' => '', 'class' => '', 'onclick' => '', target => '' );

Mas o resto da WP_Admin_Bar()classe é conectável. Depende apenas do que exatamente você está tentando fazer e como deseja fazê-lo.

Veja também:

• SVN do plug-in do Yoast : leia no meio do arquivo para encontrar as definições de menu emwpseo_admin_bar()
• PHPXref da classe WP_Admin_Bar()

pequeno exemplo, eu escrevi isso também na lista wp-hackers antes de ver os dias

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 );

Faça o download da compilação noturna e verifique esses dois arquivos;

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

A classe WP_Admin_Baré essencialmente a 'API', enquanto o arquivo a admin-bar.phputiliza para criar a barra padrão e disparar uma carga de ganchos.

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');

Isso é basicamente o básico - isso é tudo o que eu reuni de uma olhada rápida (para ser honesto, é um pouco irritante o gancho admin_bar_menunão retribuir a instância de WP_Admin_Bar- eu odeio todos esses globais!)