NAME¶

Mojolicious::Plugins - Plugin manager

SYNOPSIS¶

  use Mojolicious::Plugins;
  my $plugins = Mojolicious::Plugin->new;
  $plugins->load_plugin('Config');

DESCRIPTION¶

Mojolicious::Plugins is the plugin manager of Mojolicious.

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 = $plugins->emit_chain('foo');
  $plugins = $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', $app);
  $plugins->register_plugin('some_thing', $app, foo => 23);
  $plugins->register_plugin('some_thing', $app, {foo => 23});
  $plugins->register_plugin('SomeThing', $app);
  $plugins->register_plugin('SomeThing', $app, foo => 23);
  $plugins->register_plugin('SomeThing', $app, {foo => 23});
  $plugins->register_plugin('MyApp::Plugin::SomeThing', $app);
  $plugins->register_plugin('MyApp::Plugin::SomeThing', $app, foo => 23);
  $plugins->register_plugin('MyApp::Plugin::SomeThing', $app, {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>.