Dancer::Plugin - helper for writing Dancer plugins
Create plugins for Dancer
package Dancer::Plugin::LinkBlocker; use Dancer ':syntax'; use Dancer::Plugin; register block_links_from => sub { my $conf = plugin_setting(); my $re = join ('|', @{$conf->{hosts}}); before sub { if (request->referer && request->referer =~ /$re/) { status 403 || $conf->{http_code}; } }; }; register_plugin; 1;
And in your application:
package My::Webapp; use Dancer ':syntax'; use Dancer::Plugin::LinkBlocker; block_links_from; # this is exported by the plugin
You can extend Dancer by writing your own Plugin.
A plugin is a module that exports a bunch of symbols to the current namespace (the caller will see all the symbols defined via register).
register
Note that you have to use the plugin wherever you want to use its symbols. For instance, if you have Webapp::App1 and Webapp::App2, both loaded from your main application, they both need to use FooPlugin if they want to use the symbols exported by FooPlugin.
use
use FooPlugin
FooPlugin
Lets you define a keyword that will be exported by the plugin.
register my_symbol_to_export => sub { # ... some code };
A Dancer plugin must end with this statement. This lets the plugin register all the symbols define with register as exported symbols (via the Exporter module).
A Dancer plugin inherits from Dancer::Plugin and Exporter transparently.
Configuration for plugin should be structured like this in the config.yaml of the application:
plugins: plugin_name: key: value
If plugin_setting is called inside a plugin, the appropriate configuration will be returned. The plugin_name should be the name of the package, or, if the plugin name is under the Dancer::Plugin:: namespace, the end part of the plugin name.
This module has been written by Alexis Sukrieh and others.
This module is free software and is published under the same terms as Perl itself.
To install Dancer, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dancer
CPAN shell
perl -MCPAN -e shell install Dancer
For more information on module installation, please visit the detailed CPAN module installation guide.