Image: image nodes, attached images, and galleries
Last modified: October 28, 2009 - 21:56
The image module is used to create and administer images for your site. Each image is stored as a node, with reduced derivatives of the original generated automatically.
There are two default derivative sizes, 'thumbnail' and 'preview'. The thumbnail size is shown with the teaser for image posts and when browsing image galleries. The preview is the default size when first displaying an image node. The sizes can be altered, and further derivative sizes can also be defined. A maximum filesize and a pixel size to resize to can be set for new uploads.
Components
Further modules packaged with the image module let you do more with your images:
- The Image gallery module lets you organize and display images in galleries. The list tab allows users to edit existing image gallery names, descriptions, parents and relative position, known as a weight. The add galleries tab allows you to create a new image gallery defining name, description, parent and weight. Support for the Views module is included.
- The Image attach module allows an image to be attached to other nodes: pages, stories, or custom content types. You can specify which derivative size is shown in the node in both teaser and full view, and also the weight of the image among the node's content. The attached image is linked to the node for the actual image, allowing readers to see the full size image. Support for the Views module is included.
- The Image import module allows mass importing of images from a directory on your webserver.
Other modules
Other modules that work with image module and its components include:
Getting started
You can:
- view image handling messages in administer >> settings.
- view lists and add image galleries at administer >> image galleries.
- configure image sizes and file directories at administer >> settings >> image.
- use the image assist module to upload and insert images into posts.
- file issues, read about known bugs, and download the latest version on the Image project page.
Source of code?
Which and where is the *.PHP or whatever script that generates an image gallery?
I want to get rid of the H3 under the thumbnails rather than changing it's corresponding CSS.
I didn't find any H3 in the image.module so it must be somewhere else.
Why isn't it standard policy in Drupal to offer the list of the related files and their location with every module instead of only the set up instructions. This would avoid a lot of lost hours of search for all Drupal community or at least the newbies like me.
Image Gallery functionality has its own module
Try the Devel module and active its Theme Developer sub-module (D6 only). It allows you to click just about any element and have its theme function/template shown to you, along with the theming parents and alternate files or functions suggested in the code so you know what to implement in order to override the output.
For example, clicking the an image in a gallery, Theme Developer tells me theme_image_gallery_img() was used to render it. It can be found in /sites/*/modules/image/contrib/image_gallery/image_gallery.module. I'm also given the alternate theming functions Drupal searches for, highest priority first; test_image_gallery_img < phptemplate_image_gallery_img < zen_image_gallery_img < theme_image_gallery_img. I'm using a Zen theme named 'test' here, so I could simply implement test_image_gallery_img() in my template.php to override the markup, using the original function as a reference.