NAME

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

VERSION

version 0.008

SYNOPSIS

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

DESCRIPTION

Deploy a Mojolicious webapp to static files.

Configuration

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 => '/',
        }
    }

ATTRIBUTES

pages

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';

to

The path to export to by default.

base

The base URL, if URLs need to be rewritten.

quiet

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

METHODS

export

    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).

HELPERS

export

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

EVENTS

before_write

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 };
            # ...
        }
    } );

SEE ALSO

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

AUTHOR

Doug Bell <preaction@cpan.org>

COPYRIGHT AND LICENSE

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.

cpanm Mojolicious::Plugin::Export

perl -MCPAN -e shell
install Mojolicious::Plugin::Export