WebService::Bluga::Webthumb - fetch website thumbnails via webthumb.bluga.net
use WebService::Bluga::Webthumb; my $wt = WebService::Bluga::Webthumb->new( user => $user_id, api_key => $api_key, size => $size, # small, medium1, medium2, large (default: medium) cache => $cache_days, # optional - default 14 ); # get a thumbnail URL using the default settings my $thumb_url = wt->thumb_url($url); # Get a thumbnail URL overriding some settings: my $thumb_url = $wt->thumb_url($url, { size => 'large' });
Create a new WebService::Bluga::Webthumb object. Takes the following params:
Your webthumb user ID, available from your http://webthumb.bluga.net/user page.
Your webthumb API key. also available from your user page. (This is used to construct the hash of the thumbnail URL, but not sent directly.)
The size of the thumbnail to generate. Size can be:
small - 80x60
medium - 160x120
medium2 - 320x240
large - 640x480
How many days a generated thumbnail can be cached on the webthumb servers before a fresh one is generated. Generating a thumbnail uses a credit whereas serving up a cached one uses a fraction of a credit, so don't set this too low.
If not specified, defaults to 14 days.
Given an URL, and optionally size / cache params to override those from the object, returns an URL to the thumbnail, to use in an IMG tag.
size
cache
David Precious, <davidp at preshweb.co.uk>
<davidp at preshweb.co.uk>
Please report any bugs or feature requests to bug-webservice-bluga-webthumb at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-Bluga-Webthumb. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-webservice-bluga-webthumb at rt.cpan.org
See the API documentation at http://webthumb.bluga.net/api-easythumb
You can find documentation for this module with the perldoc command.
perldoc WebService::Bluga::Webthumb
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-Bluga-Webthumb
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WebService-Bluga-Webthumb
CPAN Ratings
http://cpanratings.perl.org/d/WebService-Bluga-Webthumb
Search CPAN
http://search.cpan.org/dist/WebService-Bluga-Webthumb/
Copyright 2011 David Precious.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install WebService::Bluga::Webthumb, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::Bluga::Webthumb
CPAN shell
perl -MCPAN -e shell install WebService::Bluga::Webthumb
For more information on module installation, please visit the detailed CPAN module installation guide.