README

贡献者: codeinwp, themeisle
标签: 菜单, 导航菜单, 图标, 导航
至少需要 4.3
测试到 5.4
稳定标签: trunk
许可: GPLv2
许可 URI: https://gnu.ac.cn/licenses/gpl-2.0.html

轻松地为您的导航菜单添加漂亮的图标。

描述

此插件允许您向菜单项添加图标，类似于最新仪表板的菜单外观。

https://www.youtube.com/watch?v=YcSotWXIczI

使用方法

激活插件后，转到外观 > 菜单来编辑您的菜单
在“菜单图标设置”元框中启用/禁用图标类型
设置当前导航菜单的默认设置；这些设置将继承到新添加的菜单项中
通过点击“选择图标”链接选择图标
保存菜单

支持的图标类型

Dashicons（WordPress 核心图标）
Elusive Icons by Aristeides Stathopoulos
Font Awesome by Dave Gandy
Foundation Icons by Zurb
Genericons by Automattic
Fontello 图标包
TI Icons 图标包 by ThemeIsle
图像（附件）
SVG（附件）

计划支持的图标类型

图像（URL）

扩展

IcoMoon by IcoMoon.io

兼容主题

菜单图标与大多数主题兼容，特别是与流行的 Twenty Seventeen 或 Hestia 主题。

此插件的开发在 GitHub 上进行。 欢迎拉取请求。在前往插件论坛之前，请先查看那里报告的问题 issues reported。

此插件的所有代码和源代码都在 GitHub/wp-menu-icons 上公开，以及 SDK SDK。

如果您喜欢这个插件，那么请考虑查看我们的其他项目

CodeinWP 博客 – WordPress 设计师指南 Revive.Social – 社交媒体工具 JustFreeThemes - 免费WordPress主题目录

屏幕截图

菜单编辑器
图标选择
Twenty Fourteen 与 Dashicons
Twenty Fourteen 与 Genericons
Twenty Thirteen 与 Dashicons
Twenty Thirteen 与 Genericons
设置元框（全局）
设置元框（菜单）

安装

将 menu-icons 上传到 /wp-content/plugins/ 目录
通过 WordPress 中的插件菜单激活插件

常见问题解答

图标没有显示！

确保您当前的主题正在使用默认的导航菜单显示器。如果它使用自己的自定义导航菜单显示器，请确保菜单项标题是可过滤的（请咨询您的主题作者）。

图标位置看起来不正确

如果您熟悉编辑主题样式表，则可以从中覆盖样式。如果您已安装 Jetpack，您还可以使用其 自定义 CSS 模块。否则，我建议您使用高级 CSS 插件。

某些字体图标渲染不正确

这是字体图标本身的错误。当字体更新时，此插件也会更新其字体。

我该如何使用 CDN 中的 CSS 文件？

您可以使用 icon_picker_icon_type_stylesheet_uri 过滤器，例如

/**
 * Load Font Awesome's CSS from CDN
 *
 * @param  string                $stylesheet_uri Icon type's stylesheet URI.
 * @param  string                $icon_type_id   Icon type's ID.
 * @param  Icon_Picker_Type_Font $icon_type      Icon type's instance.
 *
 * @return string
 */
function myprefix_font_awesome_css_from_cdn( $stylesheet_uri, $icon_type_id, $icon_type ) {
	if ( 'fa' === $icon_type_id ) {
		$stylesheet_uri = sprintf(
			'https://maxcdn.bootstrap.ac.cn/font-awesome/%s/css/font-awesome.min.css',
			$icon_type->version
		);
	}

	return $stylesheet_uri;
}
add_filter( 'icon_picker_icon_type_stylesheet_uri', 'myprefix_font_awesome_css_from_cdn', 10, 3 );

此插件可扩展吗？

当然可以！以下是您如何从插件/主题中删除图标类型的方法

/**
 * Remove one or more icon types
 *
 * Uncomment one or more line to remove icon types
 *
 * @param  array $types Registered icon types.
 * @return array
 */
function my_remove_menu_icons_type( $types ) {
	// Dashicons
	//unset( $types['dashicons'] );

	// Elusive
	//unset( $types['elusive'] );

	// Font Awesome
	//unset( $types['fa'] );

	// Foundation
	//unset( $types['foundation-icons'] );

	// Genericons
	//unset( $types['genericon'] );

	// Image
	//unset( $types['image'] );

	return $types;
}
add_filter( 'menu_icons_types', 'my_remove_menu_icons_type' );

要添加新的图标类型，请查看此插件 includes/library/icon-picker/includes/types 目录中的文件。

我不想显示设置元框。我该如何移除/禁用它？

将此代码块添加到您的 mu-plugin 文件

add_filter( 'menu_icons_disable_settings', '__return_true' );

我该如何更改用于隐藏菜单项标签的 CSS 类？

将此代码块添加到您的 mu-plugin 文件

/**
 * Override hidden label class
 *
 * @param  string $class Hidden label class.
 * @return string
 */
function my_menu_icons_hidden_label_class( $class ) {
	$class = 'hidden';

	return $class;
}
add_filter( 'menu_icons_hidden_label_class', 'my_menu_icons_hidden_label_class' );

我该如何修改菜单项的标记？

将此代码块添加到您的 mu-plugin 文件

/**
 * Override menu item markup
 *
 * @param string  $markup  Menu item title markup.
 * @param integer $id      Menu item ID.
 * @param array   $meta    Menu item meta values.
 * @param string  $title   Menu item title.
 *
 * @return string
 */
function my_menu_icons_override_markup( $markup, $id, $meta, $title ) {
	// Do your thing.

	return $markup;
}
add_filter( 'menu_icons_item_title', 'my_menu_icons_override_markup', 10, 4 );

请问我能否添加 X 图标字体？

请通过 GitHub issues 告知我，我将看看能做什么。

我该如何禁用特定菜单的菜单图标？

将此代码块添加到您的 mu-plugin 文件

/**
 * Disable menu icons for a menu
 *
 * @param array $menu_settings Menu Settings.
 * @param int   $menu_id       Menu ID.
 *
 * @return array
 */
function my_menu_icons_menu_settings( $menu_settings, $menu_id ) {
	if ( 13 === $menu_id ) {
		$menu_settings['disabled'] = true;
	}

	return $menu_settings;
}
add_filter( 'menu_icons_menu_settings', 'my_menu_icons_menu_settings', 10, 2 );

我该如何从 Fontello 添加图标包？

在 wp-content 中创建一个名为 fontpacks 的新目录。
获取包的 zip 文件，解压，并将其上传到新创建的目录。
从设置元框启用图标类型。

我无法从图片大小下拉菜单中选择自定义图片大小

阅读这篇博客文章。

变更日志

0.12.5 - 2020-08-18

0.12.4 - 2020-07-13

修复 Font Awesome 无法加载的问题

0.12.3 - 2020-07-13

修复了块编辑器中的菜单图标不工作的问题
修复了 CWP 链接。

0.12.2 - 2019-11-15

0.12.1 - 2019-11-15

提高与旧版本的兼容性

0.12.0 - 2019-11-15

修复了与 WordPress 5.3 相关的问题。

0.11.5 - 2019-05-23

同步 composer 依赖项与最新版本

0.11.4 - 2018-12-10

修复了与 composer 库相关的问题。

0.11.3 - 2018-12-10

在 WP 5.0 上进行了测试

0.11.2 - 2018-03-05

改进弹出侧边栏布局。

0.11.1 - 2018-02-24

在菜单图标弹出窗口中添加推荐框。

0.11.0 - 2018-01-05

更改所有者到 ThemeIsle。
提高与各种 ThemeIsle 产品的兼容性。

0.10.2

兼容 WordPress 4.7.0，归功于 Aaron K。

0.10.1

支持 RTL，归功于 ybspost。

0.10.0

Icon Picker 0.4.0
- Font Awesome 4.6.1
- 引入 icon_picker_icon_type_stylesheet_uri 过滤器钩子。
将 aria-hidden="true" 属性添加到图标元素

0.9.3

修复 CSS 冲突

0.9.2

更新图标选择器至版本 0.1.1。

0.9.1

修复对Composer的支持。

0.9.0

性能优化。
模块化。开发者：请查看图标选择器库。
错误修复。
移除menu_icons_{type_id}_props过滤器。

0.8.1

修复未登录时前端图标消失的问题，props jj9617

0.8.0

更新Dashicons。
更新Genericons到3.4。
更新Font Awesome到4.4.0。
允许禁用特定菜单的插件。
添加新的图标类型：SVG，props Ethan Clevenger
添加新的过滤器：menu_icons_hidden_label_class
添加新的过滤器：menu_icons_item_title

0.7.0

更新Dashicons。
修复离开导航菜单屏幕时的恼人浏览器弹出。
使用ajax处理设置更新。

0.6.0

更新Genericons到3.2。
更新Font Awesome到4.2.0。

0.5.1

更新菜单项自定义字段，使其与其他插件兼容。
添加缺失的Foundation图标样式表，props John
JS & CSS修复。

0.5.0

新图标类型：Foundation图标。
添加新的Dashicons图标。
各种修复和增强。

0.4.0

支持Fontello图标包。
新图标类型：图像（附件）。

0.3.2

添加缺失的Elusive字体图标压缩CSS，props zazou83

0.3.1

修复旧PHP版本上的致命错误，props dellos

0.3.0

在菜单屏幕上添加设置元框。
新功能：设置继承（导航菜单 > 菜单项）。
新功能：隐藏菜单项标签。
新图标类型：Elusive图标。
更新Font Awesome到4.1.0。

0.2.3

为Dashicons添加新分组：媒体。

0.2.1

修复与WP 3.9的图标选择器兼容性。

0.2.0

图标选择的媒体框架。
新字体图标：Font Awesome。

0.1.5

隐形但重要的修复和改进。

0.1.4

修复菜单保存问题。

0.1.3

在新添加的菜单项上提供图标选择字段。

0.1.2

改进额外的样式表。

0.1.1

改进图标选择用户体验。

0.1.0

首次公开发布。

jankx / menu-icons

维护者

详细信息

README

描述

使用方法

支持的图标类型

计划支持的图标类型

扩展

兼容主题

如果您喜欢这个插件，那么请考虑查看我们的其他项目

屏幕截图

安装

常见问题解答

图标没有显示！

图标位置看起来不正确

某些字体图标渲染不正确

我该如何使用 CDN 中的 CSS 文件？

此插件可扩展吗？

我不想显示设置元框。我该如何移除/禁用它？

我该如何更改用于隐藏菜单项标签的 CSS 类？

我该如何修改菜单项的标记？

请问我能否添加 X 图标字体？

我该如何禁用特定菜单的菜单图标？

我该如何从 Fontello 添加图标包？

我无法从 图片大小 下拉菜单中选择自定义图片大小

变更日志

0.12.5 - 2020-08-18

0.12.4 - 2020-07-13

0.12.3 - 2020-07-13

0.12.2 - 2019-11-15

0.12.1 - 2019-11-15

0.12.0 - 2019-11-15

0.11.5 - 2019-05-23

0.11.4 - 2018-12-10

0.11.3 - 2018-12-10

0.11.2 - 2018-03-05

0.11.1 - 2018-02-24

0.11.0 - 2018-01-05

0.10.2

0.10.1

0.10.0

0.9.3

0.9.2

0.9.1

0.9.0

0.8.1

0.8.0

0.7.0

0.6.0

0.5.1

0.5.0

0.4.0

0.3.2

0.3.1

0.3.0

0.2.3

0.2.1

0.2.0

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

我无法从图片大小下拉菜单中选择自定义图片大小