Search »

Installation Method

Module Development (Form Tools 3)

Your installation method takes a single parameter: the $module_id, passed to it from the core code. You don't have to use the value if you don't need it, but your method definition will need to include it. The module ID is unique and is the primary key in the [prefix]modules table.

namespace FormTools\Modules\MyModule;

use FormTools\Module as FormToolsModule;

class MyModule extends FormToolsModule
{
    // ...

    /**
     * My Module's installation method. This is automatically called by Form Tools
     * when the user installs the module.
     *
     * @param integer $module_id
     * @return array [0] true / false
     *               [1] success or error message
     */
    public function install($module_id)
    {
        // do anything you want here

        $success = true;
        $message = "";

        return array($success, $message);
    }

    // ...
}

The return value is important. It needs to be an array with two indexes. The first indicates whether the installation was successful or not. If it's set to false, Form Tools will halt the installation. The second parameter is what should be displayed to the user - this is either a success or error message, depending on the first parameter. Note: this second parameter does not need to be included for success messages. By default, a successfully installed module will automatically display a message informing the user of this with a "select this module" link. The second parameter, if included, will override this default message. So to rely on the default message, just pass an empty string as the second parameter, like so:

return array(true, "");

DOCUMENTATION

Module Development (Form Tools 3)