The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Mojolicious::Plugin::DefaultHelpers - Default helpers plugin

SYNOPSIS

# Mojolicious
$self->plugin('DefaultHelpers');

# Mojolicious::Lite
plugin 'DefaultHelpers';

DESCRIPTION

Mojolicious::Plugin::DefaultHelpers is a collection of renderer helpers for Mojolicious.

This is a core plugin, that means it is always enabled and its code a good example for learning to build new plugins, you're welcome to fork it.

HELPERS

Mojolicious::Plugin::DefaultHelpers implements the following helpers.

app

%= app->secret

Alias for "app" in Mojolicious::Controller.

config

%= config 'something'

Alias for "config" in Mojo.

content

%= content foo => begin
  test
% end
%= content bar => 'Hello World!'
%= content 'foo'
%= content 'bar'
%= content

Store partial rendered content and retrieve it.

content_for

% content_for foo => begin
  test
% end
%= content_for 'foo'

Append content to named buffer and retrieve it.

% content_for message => begin
  Hello
% end
% content_for message => begin
  world!
% end
%= content_for 'message'

current_route

% if (current_route 'login') {
  Welcome to Mojolicious!
% }
%= current_route

Check or get name of current route.

dumper

%= dumper {some => 'data'}

Dump a Perl data structure with Data::Dumper.

extends

% extends 'blue';
% extends 'blue', title => 'Blue!';

Extend a template. All additional values get merged into the stash.

flash

%= flash 'foo'

Alias for "flash" in Mojolicious::Controller.

include

%= include 'menubar'
%= include 'menubar', format => 'txt'

Include a partial template, all arguments get localized automatically and are only available in the partial template.

layout

% layout 'green';
% layout 'green', title => 'Green!';

Render this template with a layout. All additional values get merged into the stash.

memorize

%= memorize begin
  %= time
% end
%= memorize {expires => time + 1} => begin
  %= time
% end
%= memorize foo => begin
  %= time
% end
%= memorize foo => {expires => time + 1} => begin
  %= time
% end

Memorize block result in memory and prevent future execution.

param

%= param 'foo'

Alias for "param" in Mojolicious::Controller.

session

%= session 'foo'

Alias for "session" in Mojolicious::Controller.

stash

%= stash 'foo'
% stash foo => 'bar';

Alias for "stash" in Mojolicious::Controller.

%= stash 'name' // 'Somebody'

title

% title 'Welcome!';
% title 'Welcome!', foo => 'bar';
%= title

Page title. All additional values get merged into the stash.

url_for

%= url_for 'named', controller => 'bar', action => 'baz'

Alias for "url_for" in Mojolicious::Controller.

url_with

%= url_with 'named', controller => 'bar', action => 'baz'

Does the same as url_for, but inherits query parameters from the current request.

%= url_with->query([page => 2])

METHODS

Mojolicious::Plugin::DefaultHelpers inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

$plugin->register(Mojolicious->new);

Register helpers in Mojolicious application.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.