After reading the comments on my first uninstallation plugin attempt, and the WordPress Trac, it become clear that the approach of using an external file probably wasn’t going to cut it. So I have taken that on board and produced a revised version.
I think version 0.2 is a significant step forward, not least because it solves the problem of needing a separate file.
The plugin author needs to do two things. The first is to add an uninstall option at the top of the plugin file, somthing like this:
[php]
if ( !is_plugin_active( __FILE__ ) ) {
class my_plugin{
function uninstall(){
}
}
return;
}
What this does is to only expose the uninstall methods if the plugin is not active, and further, the addition of the return at the end stops the rest of the plugin being loaded.
Important Note: An inactive plugin is only loaded if it is in the process of being uninstalled. It will not be loaded at any other time and so won’t impact on performance or security any more than they already do.
The second thing the plugin author needs to do is to register the uninstall function. This should be done when the plugin is activated. The function that needs to be called is:
[php]
register_uninstall_hook( 'uninstall_sample' , __FILE__ , array( 'my_plugin' , 'uninstall' ) );
The first argument is a friendly name, the second is the plugin url, the third is the uninstall function itself. It is essential to remember that the class is not the main plugin class, but the one inside the block that runs if the plugin in not installed, so using &$this isn’t going to work.
when the plugin is activated it is added to a list of uninstallable plugins in a database option.
The plugins page checks whether a plugin is active, if it is not and it is in the list of uninstallable plugins it offers the uninstall option.
If you select the unstall option it loads the plugin, activates the hook, and removes the plugin from the list of uninstallable plugins so that the option to uninstall is no longer shown.
The zip file below includes 0.2 of the plugin and another sample plugin that has the uninstall instructions. On activation it creates a database table, and cleans it up when it is uninstalled.
You can download it here: Fun with uninstallation 2
Update I am most of the way through version 0.3. 0.3 will emulate the patch I intend to submit to the trac later on today. It will work a little differently to this, automating more of the uninstallation process. Full details will follow later on.
Details of version three can be found here
[...] process was documented in three posts: Fun with uninstallation part 1, part 2 and part 3. Note that the sample plugins that are linked to in these posts have been removed as [...]
[...] Andrew Rickmann – An Uninstall tool that adds an uninstallation option on the plugins page. The uninstall option will only show up if the plugin has been deactivated and if the plugin author has created an uninstall file. Check out the second iteration of his tool, here. [...]
Great idea! Keep up the great work. I hate looking at my localhost DB and seeing the mess that is left after looking for a great plugin.
=-)
[...] the plugins page. Update Jan 11: Andrew has released a second iteration of the uninstall tool. Click here to check it out. (18 votes, average: 4.94 out of 5) Loading … Sphere: Related [...]
[...] 2: This has now been superseded by this post, fun with uninstallation 2 [...]