Plugin Auto-Uninstall - Revision history

Dirk: Typo

2009-05-15T13:56:51Z

Typo

Dirk: typo

2009-03-02T15:13:22Z

typo

Dirk: Plugin Auto-Uninstall

2009-02-23T15:33:50Z

Plugin Auto-Uninstall

New page

Uninstalling a plugin usually requires a series of steps that are identical for most, if not all, plugins:

* drop plugin-specific tables
* remove plugin groups and permissions
* unregister plugin from Geeklog

For easy uninstallation of plugins, Geeklog provides the <tt>plugin_autouninstall_</tt> API function, where the plugin simply returns information about the data to be removed and Geeklog then does the rest. This also reduces the risk of any coding errors for the uninstall, which may lead the database in an undefined state.

<pre>function plugin_autouninstall_foo()</pre>

This function simply returns an array specifying the data to be removed from the database:

* 'tables': a list of the tables to be dropped
* 'groups': a list of the plugin's groups to be removed from the database
* 'features': a list of plugin features to be removed
* 'php_blocks': a list of blocks associated with the plugin and to be removed from the <tt>gl_blocks</tt> table
* 'vars': a list of names to be removed from the <tt>gl_vars</tt> table

As an example, here's the uninstall function for Geeklog' Calendar plugin:

<pre>function plugin_autouninstall_calendar ()
{
$out = array (
/* give the name of the tables, without $_TABLES[] */
'tables' => array('events', 'eventsubmission', 'personal_events'),

/* give the full name of the group, as in the db */
'groups' => array('Calendar Admin'),

/* give the full name of the feature, as in the db */
'features' => array('calendar.edit', 'calendar.moderate', 'calendar.submit'),

/* give the full name of the block, including 'phpblock_', etc */
'php_blocks' => array('phpblock_calendar'),

/* give all vars with their name */
'vars'=> array()
);

return $out;
}</pre>
Note that table names are given as their index into the <code>$_TABLES</code> array, not as the actual table name.

== Also see ==

* [[Plugin Autoinstall]]

[[Category:Plugin Development]]

@@ Line 17: / Line 17: @@
 * 'vars': a list of names to be removed from the <tt>gl_vars</tt> table
-As an example, here's the uninstall function for Geeklog' Calendar plugin:
+As an example, here's the uninstall function for Geeklog's [[Calendar Plugin]]:
 <pre>function plugin_autouninstall_calendar ()

@@ Line 5: / Line 5: @@
 * unregister plugin from Geeklog
-For easy uninstallation of plugins, Geeklog provides the <tt>plugin_autouninstall_</tt> API function, where the plugin simply returns information about the data to be removed and Geeklog then does the rest. This also reduces the risk of any coding errors for the uninstall, which may lead the database in an undefined state.
+For easy uninstallation of plugins, Geeklog provides the <tt>plugin_autouninstall_</tt> API function, where the plugin simply returns information about the data to be removed and Geeklog then does the rest. This also reduces the risk of any coding errors for the uninstall, which may leave the database in an undefined state.
 <pre>function plugin_autouninstall_foo()</pre>