Mojolicious::Plugin::Export - Export a Mojolicious website to static files

version 0.008

use Mojolicious::Lite;
get '/' => 'index';
get '/secret' => 'secret';
plugin Export => {
    pages => [qw( / /secret )],
};
app->start;

Deploy a Mojolicious webapp to static files.

Default values for the command's options can be specified in the configuration using one of Mojolicious's configuration plugins.

# myapp.conf
{
    export => {
        # Configure the default pages to export
        pages => [ '/', '/hidden' ],
        # The directory to export to
        to => '/var/www/html',
        # Rewrite URLs to include base directory
        base => '/',
    }
}

The pages to export by default. This can be overridden by the arguments to "export".

# Add pages to export by default
push @{ $app->export->pages }, '/blog';

The path to export to by default.

The base URL, if URLs need to be rewritten.

If true, will not report every action taken by the plugin. Defaults to true.

app->export->export( $override );

Export the site. $override is a hash reference to override the object attributes (keys are attribute names, values are the overridden value).

The export helper returns the Mojolicious::Plugin::Export object.

Emitted after all the content has been loaded and prepared for export. The event is given two arguments: The Mojolicious::Plugin::Export object and a hashref of paths mapped to content to be exported. The content can be either a Mojo::DOM object for HTML pages or the content to be exported. This event may modify the hashref or the DOM objects to change the content before it is written.

app->export->on( before_write => sub {
    my ( $export, $pages ) = @_;
    for my $path ( keys %$pages ) {
        my $content = $pages->{ $path };
        # ...
    }
} );

Mojolicious::Command::export, Mojolicious::Plugin::Export::Git, Mojolicious::Plugin

Doug Bell [email protected]

This software is copyright (c) 2018 by Doug Bell.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.