给WordPress的dashicons添加自定义图标

Dashicon是WordPress本身自带的一套图标系统,它满足了WordPress后台对小图标的需求,但也仅仅是满足了WP自身的后台使用而已。为了避免不必要的冗余,WordPress官方也并没有打算把它打造成一套丰富的图标,而是把这个空间留给了开发者和设计师。如果你开发的插件需要在WP的后台新建菜单,或者你的网站有着各种自定义的Post类型,那么你可能就需要添加自己的图标了,毕竟,WP自带的图标库中,去掉WP正在使用的那些,可选的真是不多。

生成新的Dashicon,可以借助一个网站 – Glyphter。网站本身就提供了一些图标给你添加,这些图标都是开源的,可以免费使用,其中就包含了Font Awesome以及众多其他有名的图标库:
给WordPress添加自定义Dashicon - Glyphter的图标库

使用方法也很简单,打开网站,从右侧直接拖图标到左侧的格子中。你也可以点击左侧空白的红色格子,从本地电脑里选择svg格式的图片上传。图中前四个图标是网站提供的,后三个图标是我本地上传的:
给WordPress添加自定义Dashicon - 整理图标

点击左上角的齿轮图标,设定Font Name和Class Prefix,这里的Class Prefix必须填写“dashicons-”,这是因为在WordPress后台调用图标的时候,一些后台接口参数中系统只会把“dashicons-”前缀的样式认作图标。

依次选定每个图标,在左侧的设置栏中填写每个图标的Class Name,每个图标对应一个不同的Class Name。建议要检查下WordPress现有的dashicon库,不要填写已有的名字。在这里你可能已经发现了:我上传的这个svg图片原本是蓝色的,这个网站会自动去掉颜色值,显示为白色。那是因为接下来要导出的图标文件是一个字体库,只需要矢量的字体轮廓信息即可,这个网站会帮你自动去除颜色信息。

图标准备完成后,点击上面的保存按钮,可以直接下载。当然如果你注册了账号并登录,这个网站可以保存你自定义的图标库以便多次使用修改。为了简化说明,我这里选择Just Download。

下载完毕后,在自己的主题目录下新建一个“dashicons”目录,然后把下载的文件解压到这个目录下,注意css文件的位置后面要用到。

打开css文件,修改圈出来的几行:

改为:

.dashicons-calculator:before,
.dashicons-camara:before,
.dashicons-thumb:before,
.dashicons-key:before,
.dashicons-cfg:before,
.dashicons-ble:before,
.dashicons-flight:before{
	display: inline-block;
	font-family: 'icn jennystudio'!important;
	font-style: normal;
	font-weight: normal;
	line-height: 1;
	-webkit-font-smoothing: antialiased;
	-moz-osx-font-smoothing: grayscale
}

这个修改的意义是限定这些自定义图标加载下载的字体文件,如果不做这个修改,系统原先的dashicons会显示不出来。

打开主题的function.php文件,添加如下代码,注意检查上传的icn-jennystudio.css文件路径必须正确

function brain1981_add_customized_dashicons() {
	wp_register_style('my_plugin_name_dashicons', get_template_directory_uri().'/dashicons/css/icn-jennystudio.css');
	wp_enqueue_style('my_plugin_name_dashicons');
}
//在网站前台加载图标字体
add_filter( 'wp_head', 'brain1981_add_customized_dashicons' );
//在网站后台加载图标字体
add_action( 'admin_print_styles', 'brain1981_add_customized_dashicons' );

自此,准备工作已经完成,下面举例如何调用这些图标。

给自定义文章类型指定图标举例:

//注册自定义类型product
register_post_type('product', array(
	'label' => 'Product',
	'public' => true,
	'show_ui' => true,
	'show_in_menu' => true,
	'capability_type' => 'post',
	....
	'menu_icon'   => 'dashicons-cfg', //这里就是我指定的图标
	)
);

效果如下

自定义的管理页面,比如自己开发的插件或主题的设定页面

add_action('admin_menu', 'options_admin_menu_b');
function options_admin_menu_b(){
	//注意最后的参数名称为自定义的图标
	add_menu_page('My Plugin Settings', 'My Plugin Name', 'administrator', 'my-plugin-slug', 'my_plugin_settings_page', 'dashicons-key');
}

总结:本文主要是依靠Glyphter这个网站生成了图标字体文件,并在WordPress站点追加引用这个字体,从而实现添加自定义dashicon的目的。Glyphter是个很不错的辅助工具,当然如果你有其他更好用的SVG转字体工具,也可以作为替代,本文只是抛砖引玉,记录一下自定义dashicon的思路。

本站所有文章均为原创,欢迎转载,请注明文章出处:https://blog.brain1981.com/2889.html。百度和各类采集站皆不可信,搜索请谨慎鉴别。技术类文章一般都有时效性,本人习惯不定期对自己的博文进行修正和更新,因此请访问出处以查看本文的最新版本。

关注我们的微信公众号-JennyStudio 本站记录了近几年的工作中遇到的一些技术问题和解决过程,“作品集”还收录了本人的大部分作品展示。除了本博客外,我们的工作室网站 – JennyStudio,内有更多作品回顾和展示。
您也可以扫描左边的二维码,关注我们的微信公众号,在微信上查看我们的案例。

1 关于 “给WordPress的dashicons添加自定义图标” 的评论

发表评论

您的电子邮箱地址不会被公开。