WordPress: Add plugin settings link to Plugins page

by Posted on

When building a plugin that has its own settings page, it’s often handy to create a link to the settings page straight from the Plugins list – this saves users the time it takes to find where exactly your plugin appears in the admin menu. Here is a simple code snippet that creates the settings link for you – all you need to do is tell it where to go:

<?php
function plugin_add_settings_link( $links ) {
$settings_link = '<a href="options-general.php?page=plugin_name">' . __( 'Settings' ) . '</a>';
array_push( $links, $settings_link );
return $links;
}
$plugin = plugin_basename( __FILE__ );
add_filter( "plugin_action_links_$plugin", 'plugin_add_settings_link' );
?>

view raw
function.php
hosted with ❤ by GitHub

Simply replace the href attribute with the link to the plugin settings page and rename the function to something slightly more unique (preferably all wrapped in an if(!function_exists()) conditional).

16 Thoughts

  1. Pingback: Widget embed latest tweets version 0.5 | Arnaud BanvilletArnaud Banvillet

  3. Thanks for the nice post.
    however i recommend this little change to make Settings as the first link

    array_unshift($links, $settings_link);

    Reply

  5. Hi: I really appreciate this post. It will allow me to (optionally) remove one page from the Admin menu, however, when I click the link, I get the “You do not have sufficient permissions to access this page” message. Any idea what would cause this?

    Reply
  6. Pingback: New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation – WordPress Tavern
  7. Pingback: New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation – Just Hippo
  8. Pingback: WordPress Support UK • WPTavern: New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation at WP Support Services
  9. Pingback: WPTavern: New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation | WPFire

  10. Hugh, I’ve been trying to figure this out forever now and kept putting it on the back burner because I was getting frustrated trying to Frankenstein code in from other plugins. You’re my hero.

    Reply
  12. Pingback: New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation - PressSearch

Leave a Reply