NAME

Plack::Middleware::FileWrap - Wrap file with headers/footers in Plack

VERSION

version 0.01

SYNOPSIS

    use Plack::Builder;

    # with text
    mount '/static/docs/' => builder {
        enable 'FileWrap', headers => [\'TEST HEAD'], footers => [\'TEST FOOT'];
        Plack::App::File->new( root => "/path/to/static/docs" )->to_app;
    },
    
    # with file
    builder {
        enable 'FileWrap', headers => ['/path/to/headerA.html', '/path/to/headerB.html'], footers => ['/path/to/footer.html'];
        $app;
    },

DESCRIPTION

Enable this middleware to allow your Plack-based application to have common header/footer.

CONFIGURATIONS

headers, footers

Arrayref. Text ref or file paths. can be mixed like

    headers => [ \'<!-- blabla -->', '/path/to/file/header.html' ]

EXAMPLES with enable_if

If you have images or other files under the same directory and you don't want to apply the changes, please use enable_if:

    mount '/static/docs/' => builder {
        enable_if { $_[0]->{PATH_INFO} =~ /\.html/ } 'FileWrap',
            headers => ["$root/static/docs/header.html"], footers => ["$root/static/docs/footer.html"];
        Plack::App::File->new( root => "$root/static/docs" )->to_app;
    },

AUTHOR

Fayland Lam <fayland@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Fayland Lam.

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