How to redirect to settings page once the plugin is activated?

Maybe using the wp_redirect() function in the activation hook. In the following example myplugin_settings is a placeholder. Normally this simply is the $hook_suffix you get back from $hook_suffix = add_menu_page( /* etc. */ ); and similar functions.

THIS CODE DOESN’T WORK, READ BELOW

register_activation_hook(__FILE__, 'cyb_activation');
function cyb_activation()
{
    // Don't forget to exit() because wp_redirect doesn't exit automatically
    exit( wp_redirect( admin_url( 'options-general.php?page=myplugin_settings' ) ) );
}

References:

  1. Register activation hook
  2. admin_url()

EDIT

The redirect inside the activation hook seems to be performed before the plugin is effectively activated, maybe because of the call of exit() before the activation is executed. This code seems to work well using activated_plugin action hook:

function cyb_activation_redirect( $plugin ) {
    if( $plugin == plugin_basename( __FILE__ ) ) {
        exit( wp_redirect( admin_url( 'options-general.php?page=myplugin_settings' ) ) );
    }
}
add_action( 'activated_plugin', 'cyb_activation_redirect' );

If you use this code outside the main plugin file you will need to replace __FILE__ with path of the main plugin file.

THOUGHT

Redirecting the user after your plugin has been activated is not a very good approach. In WordPress you can activate plugins in bulk. What happen then if you perform a redirect in this situation? You will break the activation of some plugins, maybe not if your plugin is the last being activated, but definitely you are breaking the user experience.

Related Posts:

  1. How to output message during plugin activation
  2. Prevent network activation of plugin
  3. Inserting Taxonomy Terms During a Plugin Activation?
  4. Using wp_cron with custom time interval and the register activation hook
  5. Call activation hook multiple times
  6. Only allow plugin to be activated on root site of multisite
  7. why creating tables using $wpdb is not being executed while installing plugins?
  8. Override pluggable functions in a plugin?
  9. Plugin activation error due to unexpected output
  10. Settings not set after calling register_setting()
  11. Insert terms for custom taxonomy on plugin activation, or each page load (init hook)
  12. Add Link Category on Activation?
  13. WordPress Plugin Activate / Deactive Failing
  14. Multiple array for post_content on plugin activation
  15. Class cannot be found, but it’s available in the file, I get: Fatal Error: Uncaught Error: Class ‘Blocks\Base\Activation’ not found
  16. Plugin can’t be activated [closed]
  17. Clean way to initialize plugin in newly-added site when plugin has been network activated?
  18. Activate / Deactivate plugin
  19. WordPress Fatal error: Uncaught Error: Call to undefined function dbDelta()
  20. Custom Plugin activation error in Multisite
  21. How to store in the database directly the translation?
  22. Unable to show a message after plugin activation
  23. Refresh or redirect page after activate my plugin
  24. I can install my plugin in localhost but not in my server
  25. WordPress plugin tables become corrupt
  26. Deactivate plugin on registration
  27. how can a plugin return an error message on activation?
  28. Is there a canonical way for a plugin to install a mu-plugin or drop-in?
  29. My activator class isn’t running the code inside
  30. Is it mandatory to use $wpdb->prefix in custom tables
  31. add_action hook for completely new post?
  32. Methods of Integrating Plugin Data with Themes
  33. Getting a peer review for my new plugin?
  34. PHPUnit testing WordPress Plugin
  35. Why does WordPress create two transients with the same name when I specify timeout value?
  36. How to Rewrite WordPress URL for a Plugin
  37. Proper way to use apply_filters() with class functions?
  38. In a plugin, why is add_action(‘init’) not executed before the plugin is activated?
  39. Determine which theme location a wp_get_nav_menu_items is for
  40. How to use wp_set_password in a plugin?
  41. How to init an addon correctly after the main plugin?
  42. Endpoint on Specific Page Slug
  43. How can I free up the memory used by update_post_meta?
  44. Best practice for creating a custom archive template for a custom taxonomy which works on all themes?
  45. URL rewriting must be activated manually for my plugin
  46. Getting Details Of Uploaded Image
  47. how to activate plugin network-wide, and save setting across sites
  48. PHP logging framework to be used with WordPress
  49. What is difference between blog id and site id?
  50. How to Load Plugin JS in theme’s footer section
  51. Show dialog box in TinyMCE plugin and use WordPress php functions in it
  52. wp_transition_post_status does not change the status of the post
  53. Add notification bubble notice in navigation using transients
  54. How to print raw query from WP_Query class just like in CodeIgniter
  55. Custom plugin – $post_id in wp_head
  56. WooCommerce registration password field not displaying
  57. wordpress plugin php file processing form
  58. 403 Error when text is pasted in Custom Metabox Textarea
  59. Enqueueing stylesheets on particular plugin admin pages using WordPress Plugin Boilerplate
  60. How To Change Post Author Default?
  61. Editing options pages?
  62. is it recommended to use WP_List_Table?
  63. Multiple Plugin best practice in Multisite
  64. wp-cron and execution of code in is_admin() included script
  65. use of do_action() without any functions attached
  66. json_decode does not work on WordPress
  67. Delist entries in the_loop
  68. esc_html__() and __() not working within arrays
  69. Uploaded attachment not set as featured image
  70. WordPress – manually relate a post to page(s)?
  71. Styles don’t load correctly. Insecure content
  72. How to use apiFetch to get author information in Gutenberg properly?
  73. Gutenberg blocks error: Each child in a list should have a unique “key” prop
  74. Can we use a library under MIT license in a WooCommerce plugin?
  75. How to display the specific post content by using POST ID
  76. Soap web service request from wordpress plugin
  77. How to list all images used on a specific page?
  78. Create fixed static pages
  79. Use options to control jQuery plugin
  80. Including template in shortcodes
  81. Is there anything special required to make a plugin work in a multisite environment?
  82. How to exclude categories from get_categories() select list inside a widget admin panel
  83. How to exclude “uncategorized” from custom categories widget?
  84. Using custom IDP with WP
  85. Trying to run a Ajax request from a checkout form in woocommerce via a custom plugin
  86. Using WordPress Boilerplate (WPBP) for WP Multisite Plugin
  87. WordPress5.2.3: Better File Download Plugin validation issue
  88. How do I make secure API calls from my WordPress plugin?
  89. esc_attr() on hard coded string
  90. Creating a return url for getting data from external api
  91. WordPress Plugin Boilerplate – add actions and/or filters based on user’s role
  92. How to use functions from Woocommerce documentation?
  93. Is it possible to restore an expired transient?
  94. WP API users per page
  95. action callback, for action dispatched as reported by hook sniffer, not called
  96. variable created in page.php is null inside of header.php
  97. Access WordPress Tag Function From Modal
  98. Problem with Poedit [closed]
  99. Insert plugin html content to a specific spot in the frontpage
  100. Is Explicit Versioning a better alternative to Semantic Versioning for wordpress?

Leave a Comment