thumber

Creates image thumbnails from PDF files.

Thumber generates thumbnails from your PDFs. You can call thumber using a single tag in your template.

Example usage:

{exp:thumber:create src='/uploads/documents/yourfile.pdf' page='2' extension='jpg' height='250' class='awesome' title='Click to download' link='yes'}

Parameters:

src: The source PDF [Required]
base: Server path for use with files under different domains, for instance, when using MSM [Optional]
width: The width of the generated thumbnail [Default: 84]
height: The height of the generated thumbnail [Default: 108]
page: The page of the PDF used to generate the thumbnail [Default: 1]
extension: The file type of the generated thumbnail [Default: png]
link: Wrap the thumbnail in a link to the PDF [Default: no]
crop: Where width and height are both specified, crop to preserve aspect ratio [Default: yes]
url_only: Return the url of the image only [Default: no]
path: Override the base path for images above the web root

Any other parameters will be added to the img tag in the the generated html snippet – so if you want to add an id or class, just add them as parameters.

Optional config overrides:

$config['thumber_cache_dir']: Cache dir relative to public root [Default: /images/thumber]
$config['thumber_gs_bin']: Ghostscript "gs" binary [Default: gs]
$config['thumber_convert_bin']: Imagemagick "convert" binary [Default: convert]

Homebrew users:

Imagemagick/Ghostscript installed with Homebrew will likely be located in /usr/local/bin. If so, use the config override like so: $config['thumber_convert_bin'] = '/usr/local/bin/convert'

MAMP users:

If you get errors complaining about incompatible DYLD libraries, try putting this somewhere before the plugin is loaded (e.g. config.php, index.php): putenv("DYLD_LIBRARY_PATH=");

Requirements:

This plugin requires ImageMagick (v6.3.8-2 or newer) and Ghostscript
You must create a directory for your cached thumbnails to live. Thumber must have permissions to write to this directory. The default directory is specified as /images/thumber

### Todos:

Automatically create required directories
Improve caching (e.g. add an expiry time to cached images, and run a cache cleanup)
Add more parameters, e.g. max_width, max_height
Allow for tag pairs as well as single tags
Generate thumbnails for remotely hosted PDFs

oss-contrib / Thumber