PluginProbe ʕ •ᴥ•ʔ
Menu Icons by Themeisle – Add Icons to Navigation Menus / 0.13.24
Menu Icons by Themeisle – Add Icons to Navigation Menus v0.13.24
0.13.24 trunk 0.1.0 0.1.1 0.1.2 0.1.3 0.1.4 0.1.5 0.10.0 0.10.1 0.10.2 0.11.0 0.11.1 0.11.2 0.11.3 0.11.4 0.11.5 0.12.0 0.12.1 0.12.10 0.12.11 0.12.12 0.12.2 0.12.3 0.12.4 0.12.5 0.12.6 0.12.7 0.12.8 0.12.9 0.13.0 0.13.1 0.13.10 0.13.11 0.13.12 0.13.13 0.13.14 0.13.15 0.13.16 0.13.17 0.13.18 0.13.19 0.13.2 0.13.20 0.13.21 0.13.22 0.13.23 0.13.3 0.13.4 0.13.5 0.13.6 0.13.7 0.13.8 0.13.9 0.2.0 0.2.1 0.2.2 0.2.3 0.3.0 0.3.1 0.3.2 0.4.0 0.5.0 0.5.1 0.6.0 0.7.0 0.8.0 0.8.1 0.9.0 0.9.2
menu-icons / readme.txt
menu-icons Last commit date
css 3 years ago images 4 years ago includes 4 months ago js 4 years ago languages 6 years ago vendor 5 days ago CHANGELOG.md 5 days ago LICENSE 12 years ago mailin.php 7 years ago menu-icons.php 5 days ago readme.md 2 years ago readme.txt 5 days ago
readme.txt
632 lines
1 === Menu Icons by Themeisle – Add Icons to Navigation Menus ===
2 Contributors: codeinwp, themeisle
3 Tags: menu icons, navigation menu, font awesome, dashicons, image icons
4 Requires at least: 4.7
5 Tested up to: 7.1
6 Stable tag: trunk
7 License: GPLv2
8 License URI: http://www.gnu.org/licenses/gpl-2.0.html
9
10 Add icons to WordPress navigation menus easily — pick from Font Awesome, Dashicons, image icons & more. Style menu items with custom colors & sizes.
11
12
13 == Description ==
14
15 This plugin gives you the ability to add icons to your menu items, similar to the look of the latest dashboard menu.
16
17 https://www.youtube.com/watch?v=YcSotWXIczI
18
19 = Usage =
20 1. After the plugin is activated, go to *Appearance* > *Menus* to edit your menus
21 1. Enable/Disable icon types in "Menu Icons Settings" meta box
22 1. Set default settings for current nav menu; these settings will be inherited by the newly added menu items
23 1. Select icon by clicking on the "Select icon" link
24 1. Save the menu
25
26 = Supported icon types =
27 - Dashicons (WordPress core icons)
28 - [Elusive Icons](http://shoestrap.org/downloads/elusive-icons-webfont/) by [Aristeides Stathopoulos](http://shoestrap.org/blog/author/aristath/)
29 - [Font Awesome](http://fontawesome.io/) by [Dave Gandy](http://twitter.com/davegandy)
30 - [Foundation Icons](http://zurb.com/playground/foundation-icon-fonts-3/) by [Zurb](http://zurb.com/)
31 - [Genericons](http://genericons.com/) by [Automattic](http://automattic.com/)
32 - [Fontello](http://fontello.com/) icon packs
33 - [TI Icons](http://themeisle.com/free-icons/) icon pack by [ThemeIsle](http://twitter.com/themeisle)
34 - Image (attachments)
35 - SVG (attachments)
36
37 = Planned supported icon types =
38 - Image (URL)
39
40 = Compatible themes =
41 Menu icons works with most of the themes out there, especially with popular ones like Twenty Seventeen or [Hestia](https://themeisle.com/themes/hestia/).
42
43 Development of this plugin is done on [GitHub](https://github.com/codeinwp/wp-menu-icons). **Pull requests welcome**. Please see [issues reported](https://github.com/codeinwp/wp-menu-icons/issues) there before going to the plugin forum.
44
45 == If you like this plugin, then consider checking out our other projects: ==
46
47 [CodeinWP Blog](https://www.codeinwp.com/blog/) – Designer's Guide To WordPress
48 [Revive.Social](https://revive.social) – Social Media Tools
49 [JustFreeThemes](https://justfreethemes.com) - Free WordPress Themes directory
50
51
52
53
54 == Screenshots ==
55 1. Menu Editor
56 2. Icon selection
57 3. Twenty Fourteen with Dashicons
58 4. Twenty Fourteen with Genericons
59 5. Twenty Thirteen with Dashicons
60 6. Twenty Thirteen with Genericons
61 7. Settings Meta Box (Global)
62 8. Settings Meta Box (Menu)
63
64
65 == Installation ==
66
67 1. Upload `menu-icons` to the `/wp-content/plugins/` directory
68 1. Activate the plugin through the *Plugins* menu in WordPress
69
70
71 == Frequently Asked Questions ==
72
73 = The icons are not showing! =
74 Make sure that your active theme is using the default walker for displaying the nav menu. If it's using its own custom walker, make sure that the menu item titles are filterable (please consult your theme author about this).
75
76 = The icon positions don't look right =
77 If you're comfortable with editing your theme stylesheet, then you can override the styles from there.
78 If you have [Jetpack](http://wordpress.org/plugins/jetpack) installed, you can also use its **Custom CSS** module.
79 Otherwise, I recommend you to use the [Advanced CSS plugin](https://wordpress.org/plugins/advanced-css-editor/).
80
81 = Some font icons are not rendering correctly =
82 This is a bug with the font icon itself. When the font is updated, this plugin will update its font too.
83
84 = How do I use css file from CDN? =
85 You can use the `icon_picker_icon_type_stylesheet_uri` filter, eg:
86 `
87 /**
88 * Load Font Awesome's CSS from CDN
89 *
90 * @param string $stylesheet_uri Icon type's stylesheet URI.
91 * @param string $icon_type_id Icon type's ID.
92 * @param Icon_Picker_Type_Font $icon_type Icon type's instance.
93 *
94 * @return string
95 */
96 function myprefix_font_awesome_css_from_cdn( $stylesheet_uri, $icon_type_id, $icon_type ) {
97 if ( 'fa' === $icon_type_id ) {
98 $stylesheet_uri = sprintf(
99 'https://maxcdn.bootstrapcdn.com/font-awesome/%s/css/font-awesome.min.css',
100 $icon_type->version
101 );
102 }
103
104 return $stylesheet_uri;
105 }
106 add_filter( 'icon_picker_icon_type_stylesheet_uri', 'myprefix_font_awesome_css_from_cdn', 10, 3 );
107 `
108
109 = Is this plugin extendable? =
110 **Certainly!** Here's how you can remove an icon type from your plugin/theme:
111 `
112 /**
113 * Remove one or more icon types
114 *
115 * Uncomment one or more line to remove icon types
116 *
117 * @param array $types Registered icon types.
118 * @return array
119 */
120 function my_remove_menu_icons_type( $types ) {
121 // Dashicons
122 //unset( $types['dashicons'] );
123
124 // Elusive
125 //unset( $types['elusive'] );
126
127 // Font Awesome
128 //unset( $types['fa'] );
129
130 // Foundation
131 //unset( $types['foundation-icons'] );
132
133 // Genericons
134 //unset( $types['genericon'] );
135
136 // Image
137 //unset( $types['image'] );
138
139 return $types;
140 }
141 add_filter( 'menu_icons_types', 'my_remove_menu_icons_type' );
142 `
143
144 To add a new icon type, take a look at the files inside the `includes/library/icon-picker/includes/types` directory of this plugin.
145
146 = I don't want the settings meta box. How do I remove/disable it? =
147 Add this block of code to your [mu-plugin file](http://codex.wordpress.org/Must_Use_Plugins):
148 `
149 add_filter( 'menu_icons_disable_settings', '__return_true' );
150 `
151
152 = How can I change the CSS class for hiding the menu item labels? =
153 Add this block of code to your [mu-plugin file](http://codex.wordpress.org/Must_Use_Plugins):
154 `
155 /**
156 * Override hidden label class
157 *
158 * @param string $class Hidden label class.
159 * @return string
160 */
161 function my_menu_icons_hidden_label_class( $class ) {
162 $class = 'hidden';
163
164 return $class;
165 }
166 add_filter( 'menu_icons_hidden_label_class', 'my_menu_icons_hidden_label_class' );
167 `
168
169 = How can I modify the markup the menu items? =
170 Add this block of code to your [mu-plugin file](http://codex.wordpress.org/Must_Use_Plugins):
171 `
172 /**
173 * Override menu item markup
174 *
175 * @param string $markup Menu item title markup.
176 * @param integer $id Menu item ID.
177 * @param array $meta Menu item meta values.
178 * @param string $title Menu item title.
179 *
180 * @return string
181 */
182 function my_menu_icons_override_markup( $markup, $id, $meta, $title ) {
183 // Do your thing.
184
185 return $markup;
186 }
187 add_filter( 'menu_icons_item_title', 'my_menu_icons_override_markup', 10, 4 );
188 `
189
190 = Can you please add X icon font? =
191 Let me know via [GitHub issues](https://github.com/codeinw/wp-menu-icons/issues) and I'll see what I can do.
192
193 = How do I disable menu icons for a certain menu? =
194 Add this block of code to your [mu-plugin file](http://codex.wordpress.org/Must_Use_Plugins):
195 `
196 /**
197 * Disable menu icons for a menu
198 *
199 * @param array $menu_settings Menu Settings.
200 * @param int $menu_id Menu ID.
201 *
202 * @return array
203 */
204 function my_menu_icons_menu_settings( $menu_settings, $menu_id ) {
205 if ( 13 === $menu_id ) {
206 $menu_settings['disabled'] = true;
207 }
208
209 return $menu_settings;
210 }
211 add_filter( 'menu_icons_menu_settings', 'my_menu_icons_menu_settings', 10, 2 );
212 `
213
214 = How do I add an icon pack from Fontello? =
215 1. Create a new directory called `fontpacks` in `wp-content`.
216 1. Grab the zip of the pack, extract, and upload it to the newly created directory.
217 1. Enable the icon type from the Settings meta box.
218
219
220 = I can't select a custom image size from the *Image Size* dropdown =
221 Read [this blog post](http://kucrut.org/add-custom-image-sizes-right-way/).
222
223 = How to report a security issue? =
224
225 Plugin security is a core priority for us. If you identify a potential vulnerability, we ask that you disclose it responsibly.
226 Please follow the reporting protocols outlined on our [Security Page](https://themeisle.com/security/).
227
228 == Changelog ==
229
230 ##### [Version 0.13.24](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.23...v0.13.24) (2026-09-02)
231
232 - Updated dependencies
233
234
235
236
237 ##### [Version 0.13.23](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.22...v0.13.23) (2026-04-23)
238
239 - Fixed issue with SVG menu icons rendering too small
240 - Fixed issue with vertical alignment not working on frontend
241
242
243
244
245 ##### [Version 0.13.22](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.21...v0.13.22) (2026-04-09)
246
247 - Updated dependencies
248
249
250
251
252 ##### [Version 0.13.21](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.20...v0.13.21) (2026-02-03)
253
254 - Enhanced security
255
256
257
258
259 ##### [Version 0.13.20](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.19...v0.13.20) (2025-12-15)
260
261 - Fixed compatibility with PHP 8.1+ versions
262 - Updated dependencies
263
264
265
266
267 ##### [Version 0.13.19](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.18...v0.13.19) (2025-09-05)
268
269 - Updated dependencies
270
271
272
273
274 ##### [Version 0.13.18](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.17...v0.13.18) (2025-05-23)
275
276 - Updated dependencies
277
278
279
280
281 ##### [Version 0.13.17](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.16...v0.13.17) (2025-04-17)
282
283 - Updated dependencies
284
285
286
287
288 ##### [Version 0.13.16](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.15...v0.13.16) (2024-11-07)
289
290 - Updated dependencies
291
292
293
294
295 ##### [Version 0.13.15](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.14...v0.13.15) (2024-07-10)
296
297 - Removed recommendations of unsupported plugins
298 - Fixed conditions for theme recommendation
299
300
301
302
303 ##### [Version 0.13.14](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.13...v0.13.14) (2024-05-14)
304
305 - Enhanced security
306
307
308
309
310 ##### [Version 0.13.13](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.12...v0.13.13) (2024-04-18)
311
312 ### Improvements
313 ​- **Updated internal dependencies:​​** Enhanced performance and security.
314
315
316
317
318 ##### [Version 0.13.12](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.11...v0.13.12) (2024-04-01)
319
320 ### Improvements
321 - **Updated internal dependencies**
322
323
324
325
326 ##### [Version 0.13.11](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.10...v0.13.11) (2024-03-29)
327
328 ### Fixes
329 - Updated internal dependencies
330 - Enhanced security
331
332
333
334
335 ##### [Version 0.13.10](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.9...v0.13.10) (2024-03-26)
336
337 ### Improvements
338 - Updated internal dependencies
339 - Improved readme to link to the public source files
340 - Filter promotions
341
342
343
344
345 ##### [Version 0.13.9](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.8...v0.13.9) (2024-02-23)
346
347 ### Fixes
348 - Updated dependencies
349 - Harden security
350
351
352
353
354 ##### [Version 0.13.8](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.7...v0.13.8) (2023-12-19)
355
356 - SDK Updates
357 - Fixed global hide label issue
358
359
360
361
362 ##### [Version 0.13.7](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.6...v0.13.7) (2023-08-17)
363
364 - Updated dependencies
365 - Fixed broken button layout issues in other languages
366
367
368
369
370 ##### [Version 0.13.6](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.5...v0.13.6) (2023-07-07)
371
372 - Updated composer dependencies to address warning in the widgets section
373
374
375
376
377 ##### [Version 0.13.5](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.4...v0.13.5) (2023-03-30)
378
379 - Updated Dependencies and WordPress core tested up to version 6.2
380
381
382
383
384 ##### [Version 0.13.4](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.3...v0.13.4) (2023-03-01)
385
386 Update dependencies
387
388
389
390
391 ##### [Version 0.13.3](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.2...v0.13.3) (2023-02-25)
392
393 - Fix img width/height value, props @Htbaa
394 - Update dependencies
395
396
397
398
399 ##### [Version 0.13.2](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.1...v0.13.2) (2022-11-24)
400
401 * Fix - update dependencies
402
403
404
405
406 ##### [Version 0.13.1](https://github.com/codeinwp/wp-menu-icons/compare/v0.13.0...v0.13.1) (2022-11-04)
407
408 Tested with the WordPress 6.1 version
409
410
411
412
413 #### [Version 0.13.0](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.12...v0.13.0) (2022-08-23)
414
415 * Fix Neve upsells showing up inconsistently on edge cases
416 * Fix inconsistency with Font Awesome 5 and adds compatibility with 6th version
417 * Fix compatibility with JupiterX
418 * Update dependencies
419
420
421
422
423 ##### [Version 0.12.12](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.11...v0.12.12) (2022-05-27)
424
425 - Fix the style handler conflict issue which breaks the arrow icon of the submenus on some themes
426 - Fix dismiss dashboard notice issue on some edge cases
427 - Fix compatibility with the Max Mega Menu plugin
428
429
430
431
432 ##### [Version 0.12.11](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.10...v0.12.11) (2022-03-16)
433
434 Add font awesome 5 support
435 Enhance compatibility with Otter/Neve
436
437
438
439
440 ##### [Version 0.12.10](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.9...v0.12.10) (2022-02-07)
441
442 - [Fix] Add support for alt attribute for SVG icons
443 - Tested up with WordPress 5.9
444
445
446
447
448 ##### [Version 0.12.9](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.8...v0.12.9) (2021-08-04)
449
450 * Tested compatibility with WordPress 5.8
451
452
453
454
455 ##### [Version 0.12.8](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.7...v0.12.8) (2021-05-12)
456
457 * Fix issue when the image is not accessible to fetch the width/height metadata.
458
459
460
461
462 ##### [Version 0.12.7](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.6...v0.12.7) (2021-05-07)
463
464 Fix PHP fatal error when uploading SVG with the image uploader
465
466
467
468
469 ##### [Version 0.12.6](https://github.com/codeinwp/wp-menu-icons/compare/v0.12.5...v0.12.6) (2021-05-05)
470
471 * Adds explicit width/height to icons to prevent layout shifts issues
472
473
474 = 0.12.4 - 2020-07-13 =
475
476 * Fix Font Awesome not loading
477
478
479 = 0.12.3 - 2020-07-13 =
480
481 * Fixed Menu Icons in Block Editor not working
482 * Fixed CWP links.
483
484
485 = 0.12.2 - 2019-11-15 =
486
487
488
489 = 0.12.1 - 2019-11-15 =
490
491 * Improve legacy compatibility
492
493
494 = 0.12.0 - 2019-11-15 =
495
496 * Fix issues with WordPress 5.3.
497
498
499 = 0.11.5 - 2019-05-23 =
500
501 * Sync composer dependencies with the latest version
502
503
504 = 0.11.4 - 2018-12-10 =
505
506 * fix issue with composer libraries.
507
508
509 = 0.11.3 - 2018-12-10 =
510
511 * Tested with WP 5.0
512
513
514 = 0.11.2 - 2018-03-05 =
515
516 * Improve popup sidebar layout.
517
518
519 = 0.11.1 - 2018-02-24 =
520
521 * Add recommendation boxes in the menu icon popup.
522
523
524 = 0.11.0 - 2018-01-05 =
525
526 * Change ownership to ThemeIsle.
527 * Improves compatibility with various ThemeIsle products.
528
529
530 = 0.10.2 =
531 * Compatibility with WordPress 4.7.0, props [Aaron K](https://github.com/aaronkirkham).
532
533 = 0.10.1 =
534 * Support RTL, props [ybspost](https://wordpress.org/support/profile/ybspost).
535
536 = 0.10.0 =
537 * Icon Picker 0.4.0
538 * Font Awesome 4.6.1
539 * Introduce `icon_picker_icon_type_stylesheet_uri` filter hook.
540 * Add `aria-hidden="true"` attribute to icon element
541
542 = 0.9.3 =
543 * Fix CSS conflicts
544
545 = 0.9.2 =
546 * Update Icon Picker to [0.1.1](https://github.com/kucrut/wp-icon-picker/releases/tag/v0.1.1).
547
548 = 0.9.1 =
549 * Fix support for Composer.
550
551 = 0.9.0 =
552 * Performance optimization.
553 * Modularisation. Developers: Take a look at the [Icon Picker](https://github.com/kucrut/wp-icon-picker) library.
554 * Bug fixes.
555 * Removed `menu_icons_{type_id}_props` filter.
556
557 = 0.8.1 =
558 * Fix disappearing icons from front-end when not logged-in, props [jj9617](http://profiles.wordpress.org/jj9617/)
559
560 = 0.8.0 =
561 * Update Dashicons
562 * Update Genericons to 3.4
563 * Update Font Awesome to 4.4.0
564 * Allow the plugin to be disabled for a certain menu
565 * Add new icon type: SVG, props [Ethan Clevenger](https://github.com/ethanclevenger91)
566 * Add new filter: `menu_icons_hidden_label_class`
567 * Add new filter: `menu_icons_item_title`
568
569 = 0.7.0 =
570 * Update Dashicons
571 * Fix annoying browser popup when navigating away from Nav Menus screen
572 * Work-around settings update with ajax
573
574 = 0.6.0 =
575 * Update Genericons to [3.2](http://genericons.com/2014/10/03/3-2/)
576 * Update Font Awesome to [4.2.0](http://fontawesome.io/whats-new/)
577
578 = 0.5.1 =
579 * Update Menu Item Custom Fields to play nice with other plugins.
580 * Add missing Foundation Icons stylesheet, props [John](http://wordpress.org/support/profile/dsl225)
581 * JS & CSS fixes
582
583 = 0.5.0 =
584 * New Icon type: Foundation Icons
585 * Add new Dashicons icons
586 * Various fixes & enhancements
587
588 = 0.4.0 =
589 * Fontello icon packs support
590 * New icon type: Image (attachments)
591
592 = 0.3.2 =
593 * Add missing minified CSS for Elusive font icon, props [zazou83](http://profiles.wordpress.org/zazou83)
594
595 = 0.3.1 =
596 * Fix fatal error on outdated PHP versions, props [dellos](http://profiles.wordpress.org/dellos)
597
598 = 0.3.0 =
599 * Add Settings meta box on Menu screen
600 * New feature: Settings inheritance (nav menu > menu items)
601 * New feature: Hide menu item labels
602 * New Icon type: Elusive Icons
603 * Update Font Awesome to 4.1.0
604
605 = 0.2.3 =
606 * Add new group for Dashicons: Media
607
608 = 0.2.1 =
609 * Fix icon selector compatibility with WP 3.9
610
611 = 0.2.0 =
612 * Media frame for icon selection
613 * New font icon: Font Awesome
614
615 = 0.1.5 =
616 * Invisible, but important fixes and improvements
617
618 = 0.1.4 =
619 * Fix menu saving
620
621 = 0.1.3 =
622 * Provide icon selection fields on newly added menu items
623
624 = 0.1.2 =
625 * Improve extra stylesheet
626
627 = 0.1.1 =
628 * Improve icon selection UX
629
630 = 0.1.0 =
631 * Initial public release
632