home | career | drupal | java | mac | mysql | perl | php | scala | uml | unix

Drupal 6 imagecache Project Source Code Files/Examples

These Drupal 6 imagecache files are included here as part of our Drupal source code examples project. (Please see that project page, including our promise to donate back to the Drupal open source community.)

Drupal 6 imagecache Project README File

This content is from the Drupal 6 imagecache project README file:

ImageCache is a dynamic image manipulation and cache tool. It allows you to
 create a namespace that corresponds to a set of image manipulation actions. It
 generates a derivative image the first time it is requested from a namespace
 until the namespace or the entire imagecache is flushed.
 
 Getting Started:
 
 1. Upload and enable both the ImageCache and ImageCache UI modules.
 
 2. Go to Administer -> Site Building -> ImageCache. Click on the local task tab
 labeled "Add New Preset" to build a new set of image manipulation actions.
 
 3. Enter a descriptive name of your choice (e.g. 'product_thumbnail') into the
 "Preset Namespace" box and click "Create New Preset".
 
 4. Add actions to your preset that tell ImageCache how to manipulate the
 original image when it is rendered for display. Available actions include
 crop, scale, desaturate (grey scale), resize, and rotate. Multiple actions
 may be added to a preset.
 
 5. Each action is configured in its own form, and the actions may be reordered
 from the preset's configuration form. If you need to make any changes to the
 order of actions in a preset, remember to click "Update Preset" when you're
 finished.
 
 Viewing Manipulated Images:
 
 Your modified image can be viewed by visiting a URL in this format:
 
 http://example.com/files/imagecache/preset-name/files/image-name.jpg
 
 For example, if your preset is named 'product_thumbnail' and your image is
 named 'green-widget.jpg', you could view your modified image at:
 
 http://example.com/files/imagecache/product_thumbnail/files/green-widget...
 
 NOTE: Each role that wishes to view the images generated by a
 particular preset must be given permission on the admin/user/permissions
 page.
 
 ImageCache also defines a theme function that you can use in your modules and
 themes to automatically display a manipulated image. For example, to use the
 theme function in a .tpl.php file, add the following line where you would like
 the image to appear:
 
 <?php
 print theme('imagecache', 'preset_namespace', $image_filepath, $alt, $title, $attributes);
 ?>
 
 Change 'preset_namespace' to the name of your imagecache preset and make sure
 that $image_filepath or some other variable contains the actual filepath to
 the image you would like to display.
 
 $alt, $title and $attributes are optional parameters that specify ALT/TITLE
 text for the image element in the HTML or other attributes as specified in the
 $attributes array.
 
 Using ImageCache with Contributed Modules:
 
 ImageCache presets can be put to use in various other modules. For example, when
 using CCK with the Imagefield module, you can use the "Display fields" local
 task tab to choose a preset to apply to images in that field. Similarly, you
 can specify a preset when displaying images attached to nodes using Imagefield
 in a View through the Views UI.
 
 For more information, refer to http://drupal.org/node/163561.
 
 (Images, page names, and form field names may refer to previous versions of
 ImageCache, but the concepts are the same.)

Drupal 6 imagecache Project Source Code Files

These are direct links to the Drupal 6 imagecache project source code files included in this project: