Catalyst::Plugin::Images - Generate image tags for static files.
use Catalyst qw/ Images /; # ... somewhere in your templates [% c.image_tag("foo.png" => "alt text") %];
This plugin aims to assist you in generating image tags that contain alt text, a properly escaped src attribute, height and width info, without worrying too much.
This method generates an image tag for the image named $basename, with the extra tags %attr.
Retrieve the information about the image either from the cache or by searching for it.
Look inside all the search paths (see "CONFIGURATION") for an image named $basename, and return the full path to it, as a <Path::Class::File> object..
Given the full path, as a Path::Class::File object, return the attributes to be added to the image. This returns a list with width and height, using Image::Size.
width
height
Image::Size
Generates a URI using "uri_for" in Catalyst, with the absolute path $path relativized to uri_base. See </CONFIGURATION>.
$path
uri_base
see "CACHING IMAGE DATA" below.
Overridden to seed configuration defaults.
All configuration information is stored under the images key.
images
This should be an array reference of Path::Class::Dir objects (easily generated with "path_to" in Catalyst) in which to search for images.
It defaults to root/static, root/images, root/static/images by default.
root/static
root/images
root/static/images
This is the "base" prefix path for URI generation. For example, if an image was found at /www/static/images/foo.png and uri_base is /www then the URI generated with Catalyst/uri_for will be for /static/images/foo.png.
/www/static/images/foo.png
/www
Catalyst/uri_for
/static/images/foo.png
The code will call get_cached_image_info and set_cached_image_info when appropriate. Currently both these operations are no op. You should override this if you care.
get_cached_image_info
set_cached_image_info
get_cached_image_info receives the base name, and should return the info hash.
set_cached_image_info receives the base name, and the info hash. It can use this data to expire the cache based on mtime, etc. The info hash contains the keys width, height, uri, and path.
uri
path
Catalyst, Catalyst::Plugin::Static::Simple, Image::Size
To install Catalyst::Plugin::Images, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Catalyst::Plugin::Images
CPAN shell
perl -MCPAN -e shell install Catalyst::Plugin::Images
For more information on module installation, please visit the detailed CPAN module installation guide.