C.58.  $world->loadplugin

Abstract

$world->loadplugin function: LOADs a PLUGIN

$success = $world->loadplugin( name );
 
$success = $world->loadplugin( file );
 

Loads a plugin. You can either pass a full path for the file that defines the plugin, or just its name. If you provide only the name, a file with that name (and the extesion .pl, if the extension is not already provided) will be looked for in the directories specified by the @PLUGINDIRS array. By default, this array contain two directories: one where KildClient stores some of its files (generally /usr/local/share/kildclient/plugins) and one in the user's home directory (~/.kildclient/plugins), but feel free to add more directories to search plugins for.

This function returns true if the plugin was successfully loaded, and false otherwise (including the case in which the plugin was already loaded). See also $world->requireplugin for a way to load a plugin unless it is already loaded.