Mojolicious::Plugins - Plugins
use Mojolicious::Plugins;
Mojolicous::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.
add_hook
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.
Mojolicious::Plugins inherits all methods from Mojo::Base and implements the following new ones.
$plugins = $plugins->add_hook(event => sub {...});
Hook into an event. The following events are available and run in the listed order.
Runs right after the transaction is built and before the HTTP request gets parsed. One usage case would be upload progress bars. (Passed the transaction instance)
$plugins->add_hook(before_request => sub { my ($self, $tx) = @_; });
Runs before the dispatchers determines what action to run. (Passed the default controller instance)
$plugins->add_hook(before_dispatch => sub { my ($self, $c) = @_; });
Runs after the static dispatcher determines if a static file should be served. (Passed the default controller instance) Note that the callbacks of this hook run in reverse order.
$plugins->add_hook(after_static_dispatch => sub { my ($self, $c) = @_; });
Runs after the dispatchers determines what action to run. (Passed the default controller instance) Note that the callbacks of this hook run in reverse order.
$plugins->add_hook(after_dispatch => sub { my ($self, $c) = @_; });
You could also add custom events by using run_hook and run_hook_reverse in your application.
run_hook
run_hook_reverse
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. Note that this method is EXPERIMENTAL and might change without warning!
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. Note that this method is EXPERIMENTAL and might change without warning!
register
$plugins = $plugins->run_hook('foo'); $plugins = $plugins->run_hook(foo => 123);
Runs a hook.
$plugins = $plugins->run_hook_reverse('foo'); $plugins = $plugins->run_hook_reverse(foo => 123);
Runs a hook in reverse order.
Mojolicious, Mojolicious::Guides, http://mojolicious.org.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.