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::Charset
- Change the application charset.
- 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::PODRenderer
- Renderer for turning POD into HTML and documentation browser for
Mojolicious::Guides.
- 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.
SEE ALSO¶
Mojolicious, Mojolicious::Guides, <
http://mojolicio.us>.