新しい管理バー項目にアイコンを追加するにはどうすればよいですか？

10

WordPressツールバーにアイテムを追加する機能があります。例えば：

$args2 = array(
    'id'    => 'conversations_unread',
    'title' => $visitor['conversations_unread'] . ' &nbsp ',
    'href'  => XenForo_Application::get('options')->boardUrl . '/conversations'
);

この新しいアイテムの左側にアイコンを表示するにはどうすればよいですか？

「メタ」を使用しようとしましたが、アイコンが表示されません。

'meta' => array( 'class' => 'ib-icon' ),

「タイトル」に画像を追加するためのリファレンスを読みましたが、このアイコンをコメントの吹き出しのようにしたいです。

admin-bar

— LPH
ソース

13

完全な例

例としての簡単な（mu-）プラグイン：

<?php
/** Plugin Name: Add Admin Bar Icon */
add_action( 'admin_bar_menu', function( \WP_Admin_Bar $bar )
{
    $bar->add_menu( array(
        'id'     => 'wpse',
        'parent' => null,
        'group'  => null,
        'title'  => __( 'Example', 'some-textdomain' ),
        'href'   => get_edit_profile_url( get_current_user_id() ),
        'meta'   => array(
            'target'   => '_self',
            'title'    => __( 'Hello', 'some-textdomain' ),
            'html'     => '<p>Hello</p>',
            'class'    => 'wpse--item',
            'rel'      => 'friend',
            'onclick'  => "alert('Hello');",
            'tabindex' => PHP_INT_MAX,
        ),
    ) );
} );

これにより、次のHTMLが最初の要素としてレンダリングされます（したがって、管理バーも役に立たなくなりますが、この例の目的ではありません）。

<li id="wp-admin-bar-wpse" class="wpse--item">
    <a class="ab-item" tabindex="9223372036854775807" href="http://astro.dev/wp-admin/profile.php" onclick="alert(\'Hello\');" target="_self" title="Hello" rel="friend">Example</a>
    <p>Hello</p>
</li>

これでベースができたので、気にすることができます...

アイコンを追加する

悲しいニュース：簡単な方法はありません。少なくとも、独自のスタイルシートを追加せずに。（コードで）読み取れるように、いくつかのことが起こっています。実際のアイテムの前にDashiconをラップするために必要なHTMLを付加しました。次に、非常に大きな整数を最後の数値としてアクションに追加しました。これにより、管理バーでのアイテムの位置が決まります。

<?php
/** Plugin Name: Add Admin Bar Icon */
add_action( 'admin_bar_menu', function( \WP_Admin_Bar $bar )
{
    $bar->add_menu( array(
        'id'     => 'wpse',
        'title'  => '<span class="ab-icon"></span>'.__( 'Example', 'some-textdomain' ),
        'href'   => get_edit_profile_url( get_current_user_id() ),
        'meta'   => array(
            'target'   => '_self',
            'title'    => __( 'Ahoi!', 'some-textdomain' ),
            'html'     => '<!-- Custom HTML that goes below the item -->',
        ),
    ) );
}, 210 ); // <-- THIS INTEGER DECIDES WHERE THE ITEM GETS ADDED (Low = left, High = right)

add_action( 'wp_enqueue_scripts', function()
{
    wp_enqueue_style( /* register your stylesheet */ );
}

最後に、独自のスタイルシートにCSSルールを追加する必要があります。唯一の可動部分はwpseの#/idです。残りは一定で、すべての管理バー項目/ノードで同じです。topダシコンに合わせて位置を調整する必要がある場合もあります。彼らのサイトからDashiconを選択し、fXXX以下のCSSにコードを追加するだけです。

#wpadminbar #wp-admin-bar-wpse .ab-icon:before {
    content: '\f306';
    top: 3px;
}

— カイザー
ソース

2

kaiserの答えを拡張するには、アイコンをカスタム画像のURLでオーバーライドして、スタイルをインラインに配置することもできます（または、必要に応じて個別に追加することもできます）。22px x 22pxアイコン...

$iconurl = '/images/custom-icon.png';

$iconspan = '<span class="custom-icon" style="
    float:left; width:22px !important; height:22px !important;
    margin-left: 5px !important; margin-top: 5px !important;
    background-image:url(\''.$iconurl.'\');"></span>';

$title = __( 'Example', 'some-textdomain' ),

次に、タイトル値に使用します。

'title' => $iconspan.$title,

— majick
ソース