An exif data tooltip Plugin for Textpattern

Brings EXIF Data to your slimbox Gallery.

What does it do

This is yet another Gallery plugin for TExtpattern. It implements custom filtering by Image category along with Christophe Beyl's Slimbox Implementation which is a LightBox Clone, based on the mootools Framework.

Most of the other Gallery plugins are probably much superior to this one. This plugin mainly tries to package up different features, that I need implemented on my Gallery Site.

I want, that my friends and family members, can see the Exif Data in a convenient way along with the thumbnails and I want to see this information myself, while I review or browse these Images.

There are other ways to do this. For instance Flickr, provides this Data as an XML file, but that doesn't fit my needs, as I wish to manage my Images with TXP and not an external Service like Flickr.

While building a Gallery Site, I wanted a way to display the EXIF Image Data along with the Image thumbanails, which will show up in a custom styled Tooltip. This is done using the Exifer Include Files by Jake Olefsky.

Modern Digital Cameras contain a respective amount of Image data inside this Files, and this draw my Attention to the PHP Exifer Library, which seemed to be the only reliable Tool, to extract most of this Data in a reasonable way.

The Implementation is based on the mootools library using the Tips, and Extendtips extension by Patrick Kollitsch.

In General the default behavior of the plugin, is to display the caption data in the Footer part of the Slimbox popup, while the EXIF Data shows up in the Tooltip.

What and how much to display, can be configured with the plugin attributes.

Requirements

It is worthwhile to keep in mind, that some Gallery plugins, that use the PHP GD library, will strip off this Data extension from the Image files during upload or resizing and even Photoshop does, using the Save for Web feature.

In case, there is no Exif data available for an Image, the default behavior of the plugin, is to display a message instead, that EXIF DATA is not available for this Image.

Installation

Exifer
Upload the Exifer Folder to your Textpattern root Folder
Styles
Upload the Styles Folder into your public Site root Folder. The Styles are called by a custom plugin Tag. See for Tag usage below.
Mootools, Slimbox , ExtendTips and Dependencies
You do not need to upload the mootools Library, since it is already included, with all the necessary dependencies in the plugin. Instead, call the script library with a custom tag in the Header of your page template. See for tag Usage below.
Extendtips script call.
It is important that the script tag is placed as low as possible in the markup. That would be usually before the closing tag of the body element. See for tag usage below.

Tag Usage

Required Tags

<txp:mrs_smartbox_js />

Place the above tag inside the Header Tag of your Page Template to be used for your Gallery section.

<txp:mrs_style_header />

Place the above tag inside the Header Tag of your Page Template.

<txp:mrs_script_tag />

Place the above Tag inside the body Tag of your Page Template, right above the closing tag of the body element.

Gallery Main Tag

<txp:mrs_exif_smart />

This tag displays the Gallery Thumbnail and all the required markup, that is necessary. Can be used in either Page or Form. By default, this tag will display images from all Image Categories, if no Categories are specified.

Optional Custom Gallery Attributes

category="Imagecategory"
The Image category name to filter against. Defaults to root. (Images from all categories in Ascending order). Do not specify multiple categories! The plugin will throw Error messages in this Case.
limit="Int"
The maximum number of Images to display. Defaults to 10, if not specified.
offset="Int"
The number of Images to skip from the query result. Defaults to 0.
capt="custom filter string"
This is a sort option, you can use to filter the Images against a Custom Filter string. By Default, the Field used, to filter from, is the caption Field. and the Filter String defaults to "p". Can be specified to anything.
wraptag="div"
The tag, that the whole gallery is wrapped with. Can be set to anything that makes sense and is valid. Defaults to "div"
wrapclass="gallery"
The Thumbnail gallery is wrapped in a division Tag. Use this attribute to specify the class attribute's value. Defaults to gallery.

Exif Data Attributes

exif_on="on"
not implemented yet. Do not use. The default behavior of the Tag is to display Exif Data whenever it is found, and a message, that no exif data is availabble otherwise.
tip_on="on"
This attribute is used, to disable the default tooltip, that shows up along with the EXIF Tooltip. Defaults to on, if unset. Set this to "off", to disable the default ToolTip, if you don't want this. Caveat: You will loose all the Caption Data of the popup Image window. This might be fixed in the Future, but requires some changes of The DOM.
exif_tags="all"
A comma separated list of 16 possible values without spaces, or the value "all". This attribute lets you specify from a maximum of 16 possible human_readable IFD0 and SuB_IFD exif properties, which you would like to be displayed in the tooltip. It will display the 5 most important ones by default, if unset or all of them, if set to: "all". See for a List of possible values blow.
brand
The Camera manufacturer's Trademark
model
The model Number of the Camera. Note: Not all Cameras are supported.
width, height
Size in pixels
exposure
The stored Exposure Time of the Image.
aperture
The Aperture Value of the Image.
iso
The ISO setting of the Image.
focal_length
The focal Length
mode
The focus-mode of the shot.If it was set to shutter, aperture or automatic, or manual.
lens
The Type of the Lens used
fnumber
The fnumber of the Lens in Use.
noise_reduction
whether noise_reduction was enabled or disabled during the shot.
color_mode
The color mode the camara was set to
color_space
The colo_space or Gammut used from the CAmera prefs of the stored Image
date_time
The date and Time the Imaage was shot.
orientation
This is the angle of the camera orientation in Degrees.(Weather it was portrait or Landscape)
all
Use this attribute value, to diplay all the possible keys together

Supported Cameras

These Cameras are officialy supported by EXIFER.

  1. Nikon CoolPix 700
  2. Nikon CoolPix 4500
  3. Nikon CoolPix 950
  4. Nikon Coolpix 5700
  5. Canon PowerShot S200
  6. Canon PowerShot S110
  7. Olympus C2040Z
  8. Olympus C960
  9. Canon Ixus
  10. Canon EOS 300D
  11. Canon Digital Rebel
  12. Canon EOS 10D
  13. Canon PowerShot G2
  14. FujiFilm DX 10
  15. FujiFilm MX-1200
  16. FujiFilm FinePix2400
  17. FujiFilm FinePix2600
  18. FujiFilm FinePix S602
  19. FujiFilm FinePix40i
  20. Sony D700
  21. Sony Cybershot
  22. Kodak DC210
  23. Kodak DC240
  24. Kodak DC4800
  25. Kodak DX3215
  26. Ricoh RDC-5300
  27. Sanyo VPC-G250
  28. Sanyo VPC-SX550
  29. Epson 3100z

I have tested the plugin on these two Cameras

  • Nikon D-70s
  • Fujifilm 6800 Z

Of particular maybe Interest are the UserComments and IPTC Fields. This remains untested from my side, as I haven't use these fields yet and unfortunately the corresponding filter attributes are not among the options.

Credits

    The following software is used with this plugin:

Example Gallery

Here is a small Example Gallery, to see the plugin in action.

In this Example. I have enabled Brand, model, aperture and Shutter.

Download version 0.1 Package

Download mrs_exif_lab v0.1

TXP plugin mrs_exif_lab    Ⓧ   DOWNLOAD for Textpattern

Last modified:    Mon 19 Feb 22:26:44 2007

Total amount of downloads: 1512 times

Download version 0.2 TXP Plugin

This is an updated version to the plugin, that fixes the IE6/7 Issues, plus a couple of other things.

Note, that this download contains only the plugin file. If this is the first time you are using this, then you need the above original download as well.

Some z-index display Issues still remain, in case there are form elements on the page.This will be looked into the next time. Enjoy, regards.

Download mrs_exif_lab v0.2

TXP plugin mrs_exif_lab    Ⓧ   DOWNLOAD for Textpattern

Last modified:    Thu 8 Feb 05:21:29 2007

Total amount of downloads: 1157 times