WordPress: How to rename the main php plugin base file?

There is no safe reliable way to do this, wether it is or is not on wordpress.org, and .org may get upset if you do this. You might also break automations on .org and on your customers sites.

Is there a way to specify the new base name for a plugin so that I can rename my main php file?

No there is no mechanism for this.

There is an ultra hacky workaround that will p*ss off all your users, break lots of things, but do the job for a minority of users who update regularly and are lucky.

The only “way” to do it would be to introduce a version of the plugin that has 2 main plugin files, and a filter to transfer from one to the other.

However:

  • users will see 2 plugins listed when on this version
  • users who don’t update to this version or update to the next version will not be migrated
  • security plugins may see this as an attack
  • users may then reactivate the old plugin
  • any filters users have made to auto-activate the plugin will be crippled, you will have broken their website
  • any users who put your plugin in a non-standard place then include it with an include or require will have their sites broken
  • the built in updater may upgrade the old plugin file to the newer version that has only your new basefile, get confused, and deactivate the plugin, or rollback the update assuming it had failed
  • in theory your new base file is actually a brand new plugin, there may be consequences in terms of your plugins listing and how the WP updater handles it

The cost to doing this is extremely high, with a minimal chance of success, all to satisfy a personal preference. Expect lots of upset users and support burden.

Related Posts:

  1. What’s the difference between term_id and term_taxonomy_id
  2. How are bulk actions handled in custom list table classes?
  3. How do I programatically insert a new menu item?
  4. When would I use either function for plugins?
  5. Creating Settings Page with dropdowns for Plugin
  6. Test to see if jQuery or Prototype is queued by another plugin?
  7. Empty POST data on server on AJAX request using Angular $http
  8. Custom Nav Menu items default to ‘menu-item-type’ => ‘custom’. How to make a “page” menu item?
  9. How to tell if an option has been created vs an empty option?
  10. jQuery in header or footer
  11. Notice: _usort_terms_by_ID is deprecated since version 4.7.0! Use wp_list_sort instead
  12. How to add a new plugin page under desired Options page?
  13. Plugin screenshots not showing in the repository
  14. How to make WordPress use non-greedy shortcode parsing?
  15. Multiple Parameters for a Shortcode
  16. How to get current page name in my wordpress plugin
  17. WP Cron doesn’t save or in post body
  18. Use register_taxonomy() in register_activation_hook()
  19. Pages 404 in wordpress
  20. How to properly load text domain of custom mu plugin
  21. Post from front-end with post types, categories and taxonomies
  22. Calling apply_filters on non-documented hooks
  23. Multiple entries in get_option results? or why is _multiwidget set to 1?
  24. Check if I am in the Admin Panel (wp-admin)?
  25. Fully automated theme install and activation via a plugin
  26. Using Ajax call in jQuery doesn’t work in widget
  27. Commit changes to WordPress Plugin SVN with TortoiseSVN
  28. Why is WP_Mock not used instead of WP_UnitTestCase for writing unit tests by most plugins?
  29. Metabox Not Showing on Custom Post Type But On Pages and Post
  30. Using Checkboxes on Plugin Options Page for Custom Plugin
  31. Create a Page via plugin
  32. Generating User(s) with Settings API
  33. How to redirect to action on custom page within admin section
  34. Processing shortcodes in groups (separated by line breaks)?
  35. How to get the post content after WordPress post processing?
  36. Including a JS source with an admin page
  37. Should action callbacks start with a verb?
  38. How insert negative values in Gutenberg box-control
  39. What filter should I use to insert a button inside on Media>Add New
  40. is user logged in not working
  41. Override class inside $atts shortcode_atts in WordPress
  42. Global State During an Admin Post
  43. How to use a hook to override an update_post_meta call in a plugin?
  44. External Authentication, session_tokens not destroyed on logout
  45. Display custom fields in frontside user profile
  46. Strange issue saving custom field data for a WooCommerce order
  47. How to programmatically add a custom template that appears in Site Editor from a plugin?
  48. In woocommerce cart item we can add custom text but how can i add custom link? [closed]
  49. Is it possible to restrict all admin pages except theme customisation and storefront using plugin?
  50. Build a translation correcter plugin
  51. Secure REST with nonce works only when not logged
  52. template_include filter does not render the custom template
  53. How to set a cookie for logged in users to md5($user->ID . “my_secret”)?
  54. WordPress plugin enqueue scripts working for js, but not css files
  55. Meta box on options page save form problem
  56. my basic php code producing unexpected results
  57. Update variable value via add_filter
  58. Do I need to create an endpoint?
  59. Run uninstall.php if a checkbox is checked from settings page
  60. How to check whether checkbox is checked in WordPress customizer
  61. Gravity Forms Anchor only on Front Page?
  62. How to find list of all functions bind to a particular hook from my plugin?
  63. Multiple page plugin settings
  64. how to get the top 10 popular blogs
  65. How to output CSS to the beginning of the stylesheet in a WordPress Plugin
  66. Set page to draft on plugin deactivation
  67. Can one plugin activate another plugin via script?
  68. Insert and read media from the WordPress library and call in the plugin
  69. How to create dynamic content with get_post_meta?
  70. Override woocommerce loop-start.php from theme using plugin?
  71. Get value of custom checkbox from Gutenberg sidebar in plugin
  72. Enable a role named ‘backend_user’ to access my plugin pages
  73. Hiding class namespace from plugin’s extensions
  74. How to trigger WooCommerce user profile edit change?
  75. Return raw image proxy for wordpress plugin
  76. Relational / Associate tables using native WordPress functionality
  77. Stop unauthorised file access
  78. Changed media upload path for plugin, but generates error & shows wrong url
  79. How to pass a more variable with page/subpage in Wordprees URL?
  80. Use a page as a template for a custom post type
  81. Pull commentdata for pre_comment_on_post from comment_post_ID
  82. Dynamic sidebar areas not working on the Theme Customizer
  83. Woo-commerce: Adding additional page sections using a child theme
  84. Plugin dev: How to multiply instances of a plugin in the same metabox?
  85. Merge Codes using redux framework
  86. How to get html tag ids from template?
  87. Getting Plugin to read all script files
  88. How to Rewrite WordPress URL for a Plugin
  89. How to Prove Ownership of plugin [closed]
  90. WordPress, GIT, Renamed Plugin Dir + files – Working Code now Broken [closed]
  91. get_term_by() returning null on plugin
  92. Remove default wordpress roles
  93. What is the meta_query key name for the woo product average rating? [closed]
  94. how to catch a data from a array in WordPress
  95. get the queried_object of an url
  96. Why my admin-ajax url returns 0 even after adding echo and die() at the end of function?
  97. External api call using wordpress
  98. Set link dialog to open in blank by default
  99. plugabble wp_authenticate function not works from wp-login.php
  100. How to get recent one post from each category on home page?
tech