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
Generates a URI using "uri_for" in Catalyst, with the absolute path
$path relativized to
uri_base. See </CONFIGURATION>.
see "CACHING IMAGE DATA" below.
Overridden to seed configuration defaults.
All configuration information is stored under the
It defaults to
root/static/images by default.
This is the "base" prefix path for URI generation. For example, if an image was found at
/www then the URI generated with
Catalyst/uri_for will be for
The code will call
set_cached_image_info when appropriate. Currently both these operations are no op. You should override this if you care.
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