{"id":925,"date":"2008-08-21T02:47:12","date_gmt":"2008-08-21T00:47:12","guid":{"rendered":"http:\/\/planetozh.com\/blog\/?p=925"},"modified":"2008-08-21T20:58:05","modified_gmt":"2008-08-21T18:58:05","slug":"admin-drop-down-menu-more-goodness-an-api","status":"publish","type":"post","link":"https:\/\/planetozh.com\/blog\/2008\/08\/admin-drop-down-menu-more-goodness-an-api\/","title":{"rendered":"Admin Drop Down Menu: More Goodness & an API"},"content":{"rendered":"

Update:<\/strong> I've update the plugin doc<\/a> and added a page for plugin coders<\/a>.<\/p>\n

I've just committed version 2.3 of the mother of all admin menu plugins, Admin Drop Down Menu<\/a>, and there are some pretty hot stuff inside. Plugin coders, be sure to read this till the end.<\/p>\n

First, it's finally ready for translation. That's something I've been asked a few times, so now polyglots can rejoice since there is a .pot file included. I've also added CSS classes and id's to all menu elements so styling maniacs can hack their stylesheet to death.<\/p>\n

The most visible change will be optional menu icons. That's something I've been nagged about a gazillion times, and that I had never added because, well, I<\/em> don't need them :) So, why add them now, you ask? Because I had a fun idea to implement!<\/p>\n

The cool stuff with this release is there is sort of an API to play with. The function that builds the array that builds the menu is full of hooks so that if your plugin needs, for some reason, to modify menu entries, you don't have to write dirty patches, just throw some add_filters()<\/tt> in (hat tip to Kevin Behrens and his plugin Role Scoper<\/a> for inspiring this)<\/p>\n

But wait, there's more, and cooler!<\/p>\n

Icons are stolen from the awesome FamFamFam<\/a>, of course. By default, plugins get a cute green plugin icon, but this can get a bit boring when you have dozens of plugin entries looking the same. Plugin coders want their individuality!<\/p>\n

Well, they can have it: there's an awesomely super cool hook that allows plugins to have their own icon!<\/strong> (I'm pretty excited with this feature:)<\/p>\n

\"\"<\/p>\n

To do so, simply add the following in your plugin:<\/p>\n

\n\n\t\t
\n\n\t\t
\n\t\t\t\t\t\t< View plain text<\/span> ><\/a>\n\t\t\t\t\t<\/div>\n\n\t\t
php<\/div>\n\n\t\t\n\t\t
\n\n\t<\/div>\n\t\n\t
\n\t\t
  1. add_filter(<\/span>'ozh_adminmenu_icon'<\/span>,<\/span> 'myplugin_icon'<\/span>)<\/span>;<\/span><\/div><\/li>\n
  2.  <\/div><\/li>\n
  3. function<\/span> myplugin_icon(<\/span>$hook<\/span>)<\/span> {<\/span><\/div><\/li>\n
  4.     if<\/span> (<\/span>$hook<\/span> ==<\/span> 'myplugin'<\/span>)<\/span> return<\/span> 'http:\/\/url\/to\/cute\/icon.png'<\/span>;<\/span><\/div><\/li>\n
  5.     return<\/span> $hook<\/span>;<\/span><\/div><\/li>\n
  6. }<\/span><\/div><\/li>\n<\/ol>\t<\/div>\n\n<\/div>\n\n

    Where 'myplugin'<\/tt> is the $file<\/tt> argument used to add your administration page (for instance add_options_page('My Plugin', 'My Plugin', 10, 'myplugin<\/b>', 'myplugin_do_stuff')<\/tt>)<\/p>\n

    If you use this cool feature in your plugin (or need help to do so) be sure to let me know!<\/p>\n","protected":false},"excerpt":{"rendered":"

    Update: I've update the plugin doc and added a page for plugin coders. I've just committed version 2.3 of the mother of all admin menu plugins, Admin Drop Down Menu, and there are some pretty hot stuff inside. Plugin coders, be sure to read this till the end. First, it's finally ready for translation. That's […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[284,85,245],"class_list":["post-925","post","type-post","status-publish","format-standard","hentry","category-published","tag-admin-drop-down-menu","tag-plugins","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/925","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/comments?post=925"}],"version-history":[{"count":0,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/925\/revisions"}],"wp:attachment":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/media?parent=925"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/categories?post=925"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/tags?post=925"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}