{"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

\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. $actions<\/span> =<\/span> array<\/span>(<\/span><\/div><\/li>\n
  2.     'post-new.php'<\/span> =><\/span> array<\/span>(<\/span>__(<\/span>'Add New Post'<\/span>)<\/span>,<\/span> 'edit_posts'<\/span>)<\/span>,<\/span><\/div><\/li>\n
  3.     'page-new.php'<\/span> =><\/span> array<\/span>(<\/span>__(<\/span>'Add New Page'<\/span>)<\/span>,<\/span> 'edit_pages'<\/span>)<\/span>,<\/span><\/div><\/li>\n
  4.     'edit-comments.php'<\/span> =><\/span> array<\/span>(<\/span>__(<\/span>'Manage Comments'<\/span>)<\/span>,<\/span> 'moderate_comments'<\/span>)<\/span><\/div><\/li>\n
  5. )<\/span>;<\/span><\/div><\/li>\n<\/ol>\t<\/div>\n\n<\/div>\n\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

    \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. <?php<\/span><\/div><\/li>\n
    2. \/*<\/span><\/div><\/li>\n
    3. Plugin Name: Sample Favorite Actions<\/span><\/div><\/li>\n
    4. Plugin URI: http:\/\/planetozh.com\/blog\/<\/span><\/div><\/li>\n
    5. Description: Example plugin showing how to modify the favorite actions<\/span><\/div><\/li>\n
    6. Author: Ozh<\/span><\/div><\/li>\n
    7. Author URI: http:\/\/planetozh.com\/<\/span><\/div><\/li>\n
    8. *\/<\/span><\/div><\/li>\n
    9.  <\/div><\/li>\n
    10. add_filter(<\/span>'favorite_actions'<\/span>,<\/span> 'ozh_sample_fav'<\/span>)<\/span>;<\/span><\/div><\/li>\n
    11.  <\/div><\/li>\n
    12. function<\/span> ozh_sample_fav(<\/span>$actions<\/span>)<\/span> {<\/span><\/div><\/li>\n
    13.     \/\/ remove the "Add new page" link<\/span><\/div><\/li>\n
    14.     unset<\/span>(<\/span>$actions<\/span>&<\/span>#91;'page-new.php'&#93;);<\/span><\/div><\/li>\n
    15.     \/\/ add quick link to our favorite plugin<\/span><\/div><\/li>\n
    16.     $actions<\/span>&<\/span>#91;'admin.php?page=blah\/blah.php'&#93; = array('Some plugin', 'manage_options');<\/span><\/div><\/li>\n
    17.     return<\/span> $actions<\/span>;<\/span><\/div><\/li>\n
    18. }<\/span><\/div><\/li>\n
    19.  <\/div><\/li>\n
    20. ?><\/span><\/div><\/li>\n<\/ol>\t<\/div>\n\n<\/div>\n\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 […]<\/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}]}}