{"id":1001,"date":"2008-10-27T12:45:43","date_gmt":"2008-10-27T10:45:43","guid":{"rendered":"http:\/\/planetozh.com\/blog\/?p=1001"},"modified":"2008-10-25T21:15:49","modified_gmt":"2008-10-25T19:15:49","slug":"wordpress-27-featuring-your-favorite-actions","status":"publish","type":"post","link":"https:\/\/planetozh.com\/blog\/2008\/10\/wordpress-27-featuring-your-favorite-actions\/","title":{"rendered":"WordPress 2.7 Featuring Your Favorite Actions"},"content":{"rendered":"

\"\"There's a very handy new function and feature in the upcoming WordPress 2.7: the favorite actions<\/strong>, showing a nice little drop down menu containing quick links to your, well, favorite tasks.<\/p>\n

By default, this drop down contains a link to "Add New Post", "Add New Page" and "Manage Comments". Hopefully and as usual, it's very easy to customize this menu and to add (or to remove) elements.<\/p>\n

Concept<\/h2>\n

The new function that draws this drop down box is the well named favorite_actions()<\/tt> which calls a similarly named filter. This filter wants you to play with an array with the following structure: array( url => array ( title, level ) )<\/tt>. For instance and by default, the links are drawn by the following array:<\/p>\n

$actions = array(\r\n\t'post-new.php' => array(__('Add New Post'), 'edit_posts'),\r\n\t'page-new.php' => array(__('Add New Page'), 'edit_pages'),\r\n\t'edit-comments.php' => array(__('Manage Comments'), 'moderate_comments')\r\n);<\/code><\/pre><\/div>\n
The 'level' parameter (here, 'edit_pages' or 'moderate_comments') is described and explained on the Codex: Roles and Capabilities<\/a>.<\/p>\n
Play with the filter<\/h2>\n
Now, let's modify the array, using the appropriate filter. All you need is to create a custom function that returns an array with the same structure as above.<\/p>\n
For instance, the following plugin would remove the link to "Add new page" from the favorite actions, and add a link to a fictional plugin:<\/p>\n
<?php\r\n\/*\r\nPlugin Name: Sample Favorite Actions\r\nPlugin URI: http:\/\/planetozh.com\/blog\/\r\nDescription: Example plugin showing how to modify the favorite actions\r\nAuthor: Ozh\r\nAuthor URI: http:\/\/planetozh.com\/\r\n*\/\r\n\r\nadd_filter('favorite_actions', 'ozh_sample_fav');\r\n\r\nfunction ozh_sample_fav($actions) {\r\n\t\/\/ remove the "Add new page" link\r\n\tunset($actions['page-new.php']);\r\n\t\/\/ add quick link to our favorite plugin\r\n\t$actions['admin.php?page=blah\/blah.php'] = array('Some plugin', 'manage_options');\r\n\treturn $actions;\r\n}\r\n\r\n?><\/code><\/pre><\/div>\n
(Or, get this file: sample_favorite_actions.php<\/a> and rename as .php before playing with it)<\/p>\n
Pushing further : plugin idea<\/h2>\n
Since this menu is called "favorite actions", it would be really cool to populate it with your true favorite ones. A plugin could rather easily monitor what admin pages are called and their frequency, and modify the drop down menu accordingly.<\/p>\n
Anyone fancy to code it?<\/p>\n","protected":false},"excerpt":{"rendered":"
There's a very handy new function and feature in the upcoming WordPress 2.7: the favorite actions, showing a nice little drop down menu containing quick links to your, well, favorite tasks. By default, this drop down contains a link to "Add New Post", "Add New Page" and "Manage Comments". Hopefully and as usual, it's very easy to customize this menu\u2026<\/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":[332,191,245],"class_list":["post-1001","post","type-post","status-publish","format-standard","hentry","category-published","tag-favorite_actions","tag-ideas","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/1001","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=1001"}],"version-history":[{"count":0,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/posts\/1001\/revisions"}],"wp:attachment":[{"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/media?parent=1001"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/categories?post=1001"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/planetozh.com\/blog\/wp-json\/wp\/v2\/tags?post=1001"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}