#NAME

Mojolicious::Plugins - Plugin manager

#SYNOPSIS

use Mojolicious::Plugins;

my $plugins = Mojolicious::Plugins->new;
push @{$plugins->namespaces}, 'MyApp::Plugin';

#DESCRIPTION

Mojolicious::Plugins is the plugin manager of Mojolicious.

#PLUGINS

The following plugins are included in the Mojolicious distribution as examples.

#Mojolicious::Plugin::Config: Perl-ish configuration files.
#Mojolicious::Plugin::DefaultHelpers: General purpose helper collection, loaded automatically.
#Mojolicious::Plugin::EPLRenderer: Renderer for plain embedded Perl templates, loaded automatically.
#Mojolicious::Plugin::EPRenderer: Renderer for more sophisticated embedded Perl templates, loaded automatically.
#Mojolicious::Plugin::HeaderCondition: Route condition for all kinds of headers, loaded automatically.
#Mojolicious::Plugin::JSONConfig: JSON configuration files.
#Mojolicious::Plugin::Mount: Mount whole Mojolicious applications.
#Mojolicious::Plugin::NotYAMLConfig: YAML configuration files.
#Mojolicious::Plugin::TagHelpers: Template specific helper collection, loaded automatically.

#EVENTS

Mojolicious::Plugins inherits all events from Mojo::EventEmitter.

#ATTRIBUTES

Mojolicious::Plugins implements the following attributes.

#namespaces

my $namespaces = $plugins->namespaces;
$plugins       = $plugins->namespaces(['Mojolicious::Plugin']);

Namespaces to load plugins from, defaults to Mojolicious::Plugin.

# Add another namespace to load plugins from
push @{$plugins->namespaces}, 'MyApp::Plugin';

#METHODS

Mojolicious::Plugins inherits all methods from Mojo::EventEmitter and implements the following new ones.

#emit_chain

$plugins->emit_chain('foo');
$plugins->emit_chain(foo => 123);

Emit events as chained hooks.

#emit_hook

$plugins = $plugins->emit_hook('foo');
$plugins = $plugins->emit_hook(foo => 123);

Emit events as hooks.

#emit_hook_reverse

$plugins = $plugins->emit_hook_reverse('foo');
$plugins = $plugins->emit_hook_reverse(foo => 123);

Emit events as hooks in reverse order.

#load_plugin

my $plugin = $plugins->load_plugin('some_thing');
my $plugin = $plugins->load_plugin('SomeThing');
my $plugin = $plugins->load_plugin('MyApp::Plugin::SomeThing');

Load a plugin from the configured namespaces or by full module name.

#register_plugin

$plugins->register_plugin('some_thing', Mojolicious->new);
$plugins->register_plugin('some_thing', Mojolicious->new, foo => 23);
$plugins->register_plugin('some_thing', Mojolicious->new, {foo => 23});
$plugins->register_plugin('SomeThing', Mojolicious->new);
$plugins->register_plugin('SomeThing', Mojolicious->new, foo => 23);
$plugins->register_plugin('SomeThing', Mojolicious->new, {foo => 23});
$plugins->register_plugin('MyApp::Plugin::SomeThing', Mojolicious->new);
$plugins->register_plugin(
  'MyApp::Plugin::SomeThing', Mojolicious->new, foo => 23);
$plugins->register_plugin(
  'MyApp::Plugin::SomeThing', Mojolicious->new, {foo => 23});

Load a plugin from the configured namespaces or by full module name and run register, optional arguments are passed through.

CONTENTS