Rasade: /* Autoinstall Feature */

2010-04-21T20:21:59Z

‎Autoinstall Feature

New page

From Geeklog 1.6 onwards, plugins have an alternate installation method, the 'Autoinstall'. This is implemented in the form of a file named <tt>autoinstall.php</tt> in the same location within the plugin directory as the <tt>functions.inc</tt> file. To install a plugin using the Autoinstall function, all users need to do is go to the 'Plugins' section of the Admin panel and choose the relevant tarball for the plugin and upload it. The Autoinstall function will take care of the rest, as in creation of database tables, new plugin-specific user groups, as well as moving the required plugin files to the relevant locations within the Geeklog installation. However, this only works with Geeklog 1.6 and above.
For backward compatibility, plugin developers might feel the need to include the old <tt>install.php</tt> script along with their plugins as well.
The main function included in <tt>autoinstall.php</tt> is <tt>plugin_autoinstall_{plugin}</tt>, where {plugin} is replaced by the name of the plugin. There are optional functions available for inclusion within <tt>authoinstall.php</tt>. You can read about them in the [documentation : http://wiki.geeklog.net/index.php/Plugin_Autoinstall]. As an example we will take a look at the <tt>autoinstall.php</tt> file written by Javed Khan for the Boilerplate plugin:
<pre>
<?php

/**
* Plugin autoinstall function
*
* @param string $pi_name Plugin name
* @return array Plugin information
*
*/
function plugin_autoinstall_sample($pi_name)
{
$pi_name = 'sample';
$pi_display_name = 'Boilerplate Plugin';

$info = array(
'pi_name' => $pi_name,
'pi_display_name' => $pi_display_name,
'pi_version' => '1.6.3',
'pi_gl_version' => '1.6.1',
'pi_homepage' => 'http://www.geeklog.net/'
);

$tables = array(
'base',
'financialData'
);

$inst_parms = array(
'info' => $info,
'tables' => $tables
);

return $inst_parms;
}

?>
</pre>

As you can see, it's fairly simple. For further clarification, we will take a look at each set of values implemented here.

----

<pre>
$info = array(
'pi_name' => $pi_name,
'pi_display_name' => $pi_display_name,
'pi_version' => '1.6.3',
'pi_gl_version' => '1.6.1',
'pi_homepage' => 'http://www.geeklog.net/'
);
</pre>
This array holds general information regarding the plugin and should be fairly self-explanatory.

----
<pre>
$tables = array(
'base',
'financialData'
);
</pre>

This array holds the table names that should be created in the database when the plugin is installed. The table creation scripts would normally be included in <tt>/admin/install.php</tt>. For the Boilerplate plugin, the table creation scripts are included in special install files based on the type of database query language being used. (The Boilerplate plugin has been built to demonstrate compatibility with different query languages)

----
<pre>
$inst_parms = array(
'info' => $info,
'tables' => $tables
);
</pre>

This is the array in the autoinstall script which holds all the parameters that the plugin refers to. It assigns all the variables defined above to special array keys which are recognized by Geeklog during installation.

----
Of course, more parameters could be added for usergroups, features, permissions etc.

As always, the best way to get a good idea about how Geeklog handles plugins would be to take a good look at <tt>lib-plugins.php</tt>.

Autoinstall Feature - Revision history

Rasade: /* Autoinstall Feature */