随着WP-Admin的改进,WordPress 3.8还带来了一组名为Dashicons的全新图标。 Dashicons是由Mel Choyce设计的字体图标,主要是为了容纳新的WP-Admin UI(从内容屏幕编辑器到管理菜单)而创建的,如下面的屏幕截图所示。
由于WordPress现在使用它在WP-Admin中交付图标,因此您还应该在主题和插件中使用它。 通过使用字体图标集(例如Dashicons),您可以轻松地通过CSS定制输出 。 如果您是要根据最新的WordPress设计以及使用其新属性来更新插件或主题的开发人员,则本文绝对适合您。
管理菜单中的Dashicon
假设您将“ 自定义帖子类型”合并到主题或插件中,则可以通过以下方式使用Dashicons。 自定义帖子类型使用menu_icon
来显示图标。 在WordPress 3.8之前,您可以在其中添加图像图标路径。 在版本3.8中,此参数还可用于从Dashicons声明图标。
首先,访问Dashicons网站 。 单击其中一个图标。 您会看到所选图标反映在标题上,并且显示了图标名称,并带有用于以多种格式复制图标的选项:CSS,HTML和Glyph。
复制图标的名称,然后将其添加到“自定义帖子类型”功能的menu_icon
中。 请注意,为了使本文简短,我删除了代码。 完整的代码可以在这里找到 。
$args = array(
'label' => __( 'book', 'book' ),
'description' => __( 'Post Type Description', 'book' ),
'labels' => $labels,
'supports' => array( ),
'taxonomies' => array( 'category', 'post_tag' ),
'menu_position' => 20,
'menu_icon' => 'dashicons-book',
'capability_type' => 'post',
);
在此示例中,我创建了一个自定义帖子类型来发布图书。 就像您在下面看到的那样,书本图标显示在它旁边。
菜单页
插件还可以使用add_page_menu
函数添加管理菜单 。 对于这种情况,您可以简单地将Dashicons图标名称指定为第六个参数。 在以下示例中,我们将在“选项”页面中显示“扳手”图标。
function hkdc_custom_menu_page() {
add_menu_page(
'Options Page',
'Options',
'manage_options',
'myplugin/option.php',
'',
'dashicons-admin-tools', 81
);
}
add_action( 'admin_menu', 'hkdc_custom_menu_page' );
转到WP-Admin,您应该看到如图所示的图标。
后备
永远不要以为您的所有用户都会更新到最新的WordPress。 在某些情况下,他们没有。 他们可能已经安装了插件来关闭自动更新。 因此,有必要提供支持较旧WordPress版本的后备广告。 如果我们不这样做,图标的一面将显示为残破的图像(例如此图像中发生的事情,靠近书本)。
在继续之前,请确保已将图像图标放置在主题或插件目录中。 然后,我们可以使用条件函数指定图标,如下所示:
首先,我们设置默认值,即使用Dashicons。
$icon = 'dashicons-book-alt';
如果在WordPress 3.7及以下版本中,我们将替换$ icon变量的值。
if( version_compare( $GLOBALS['wp_version'], '3.8', '<' ) ) {
$icon = get_template_directory_uri() . '/extra/img/book-brown.png';
}
将自定义帖子类型(以及add_menu_page
函数)中的图标参数替换为$icon
变量。
$args = array(
'label' => __( 'book', 'book' ),
'description' => __( 'Post Type Description', 'book' ),
'labels' => $labels,
'supports' => array( ),
'menu_position' => 20,
'menu_icon' => $icon,
);
register_post_type( 'book', $args );
我们完成了。 它将在WordPress 3.8中使用Dashicons,同时在旧版本中显示“图像”图标。