NAME

Plack::Middleware::Favicon - deliver common favicon images

SYNOPSIS

    use Plack::Builder;

    builder {
        enable 'Favicon',
            src_image_file => 'src_favicon.png';
    };

DESCRIPTION

You don't need to prepare favicon images any more if you use this module.

METHODS

prepare_app

call

MIDDLEWARE OPTIONS

cache

If you'd like this module to cache images for response, provide the cache option with an object supporting the Cache API (e.g. Cache::FileCache, Cache::Memory::Simple). Specifically, an object that supports get($key) and set($key, $value, $expires) methods.

    use Cache::Memory::Simple;

    builder {
        enable 'Favicon',
            src_image_file  => 'src_favicon.png',
            cache => Cache::Memory::Simple->new;
    };

custom_favicons

If you'd provide custom favicon images, set the custom_favicons option.

    builder {
        enable 'Favicon',
            src_image_file  => 'src_favicon.png',
            custom_favicons => [
                { path => qr!^/foo\.png!, size => [32, 32],
                  type => 'png', mime_type => 'image/png' },
            ];
    };

callback

If you'd want to filter image, set the callback option as code ref.

    builder {
        enable 'Favicon',
            src_image_file  => 'src_favicon.png',
            callback => sub {
                my ($self, $f, $img) = @_;
                $img->filter(type => "unsharpmask", stddev => 1, scale => 0.5);
            };
    };

REPOSITORY

Plack::Middleware::Favicon is hosted on github: http://github.com/bayashi/Plack-Middleware-Favicon

I appreciate any feedback :D

AUTHOR

Dai Okabayashi <bayashi@cpan.org>

SEE ALSO

http://itexp.hateblo.jp/entry/website-needs-21-favicons

http://ja.wikipedia.org/wiki/Favicon

LICENSE

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.