NAME
Mojolicious::Plugins - Plugins
SYNOPSIS
use Mojolicious::Plugins;
DESCRIPTION
Mojolicious::Plugins is the plugin manager of Mojolicious. In your application you will usually use it to load plugins. To implement your own plugins see Mojolicious::Plugin and the add_hook
method below.
ATTRIBUTES
Mojolicious::Plugins implements the following attributes.
hooks
my $hooks = $plugins->hooks;
$plugins = $plugins->hooks({foo => [sub {...}]});
Hash reference containing all hooks that have been registered by loaded plugins.
namespaces
my $namespaces = $plugins->namespaces;
$plugins = $plugins->namespaces(['Mojolicious::Plugin']);
Namespaces to load plugins from. You can add more namespaces to load application specific plugins.
METHODS
Mojolicious::Plugins inherits all methods from Mojo::Base and implements the following new ones.
add_hook
$plugins = $plugins->add_hook(event => sub {...});
Hook into an event. You can also add custom events by calling run_hook
and run_hook_reverse
from your application.
load_plugin
my $plugin = $plugins->load_plugin('something');
my $plugin = $plugins->load_plugin('Foo::Bar');
Load a plugin from the configured namespaces or by full module name.
register_plugin
$plugins->register_plugin('something', $app);
$plugins->register_plugin('something', $app, foo => 23);
$plugins->register_plugin('something', $app, {foo => 23});
$plugins->register_plugin('Foo::Bar', $app);
$plugins->register_plugin('Foo::Bar', $app, foo => 23);
$plugins->register_plugin('Foo::Bar', $app, {foo => 23});
Load a plugin from the configured namespaces or by full module name and run register
. Optional arguments are passed to register.
run_hook
$plugins = $plugins->run_hook('foo');
$plugins = $plugins->run_hook(foo => 123);
Runs a hook.
run_hook_reverse
$plugins = $plugins->run_hook_reverse('foo');
$plugins = $plugins->run_hook_reverse(foo => 123);
Runs a hook in reverse order.