Description
Breaking Change
Since version 1.0.0, the first parameter passed to the wp_nav_menu_item_custom_fields is the menu item ID, instead of the nav menu ID. This should not have a big impact, since the nav menu ID passed was always 0 (not used by core).
This is a library plugin. It doesn’t do anything visible on its own. It was written to allow other plugins/themes to add custom fields to menu items easily. See Installation.
Development of this plugin is done on GitHub. Pull requests welcome. Please see issues reported there before going to the plugin forum.
Installation
As regular plugin
- Upload
menu-item-custom-fieldsto the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
As library in your plugin/theme
Simply copy menu-item-custom-fields to your plugin directory and require the main plugin file, eg:
require_once dirname( __FILE__ ) . '/menu-item-custom-fields/menu-item-custom-fields.php';
Usage
Copy (and customize) and include the menu-item-custom-fields-example.php file found in the doc/ directory of this plugin into your plugin/theme.
Reviews
Well done
Can also easily be used as library. Anyhow: A bit more of documentation and examples on how to use it would be nice (e.g. how to retrieve the custom meta fields).
10/10
Fantastic plugin exactly what I was looking for.
useless
useless, what use is this plugin without instructions and some example code? if anyone has an example code let me know and I might be able to use it. Also, how do I put zero stars on this review?
Awesome
Works perfectly as a library in a theme. We appreciate the very light code.
It works… but there is no clear way to show the custom fields on the front end
I understand this is just a library plugin, and it is indeed very easy to add custom fields to the admin menu items, but without some kind of guidance on how to extend the Walker navigation and display your new fields on the front end, the plugin is limited unless you have a fair amount of experience in php.
It is unfortunate that there is so little guidance in this regard, and the information on the internet and in the codex makes for some pretty hard reading.
The plugin is a nice starting point I think, but is only worth a 3 star rating because it is so difficult to actually use.
A few examples of how to use the fields on the front end would make it worth 4 or 5 stars.
In particular, I would like to add custom attributes to my links by using the custom fields, which so far is proving to be quite difficult.
Display
Hi,
How can I display the fields I added in the menu?
Thanks,
Alex
Contributors & Developers
“Menu Item Custom Fields” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Menu Item Custom Fields” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Pass correct parameters to the
wp_nav_menu_item_custom_fieldshook, props @helgatheviking.
0.4.0
- Support WordPress 4.7, props rahulnever2far.
0.3.0
- Use
wp_nav_menu_item_custom_fieldsas walker hook. See this blog post. - Update example plugin
0.2.1
- Update compatibility info
0.2.0
- Improve walker class loader
0.1.1
- Move custom fields up (before
<p.field-move />)
0.1.0
- Initial public release
