In your httpd.conf you set the global options for the gallery. You can also override each of the options
in .htaccess files in your gallery directories.
The options are set in the httpd.conf/.htaccess file using the syntax: PerlSetVarOptionName'value'
Example: PerlSetVarGalleryCacheDir'/var/cache/www/'GalleryAutoRotate
Some cameras, like the Canon G3, can detect the orientation of a the pictures you take and will save
this information in the 'Orientation' EXIF field. Apache::Gallery will then automatically rotate your
images.
This behavior is default but can be disabled by setting GalleryAutoRotate to 0.
GalleryCacheDir
Directory where Apache::Gallery should create its cache with scaled pictures. The default is
/var/cache/www/ . Here, a directory for each virtualhost or location will be created automatically.
Make sure your webserver has write access to the CacheDir.
GalleryTemplateDir
Full path to the directory where you placed the templates. This option can be used both in your
global configuration and in .htaccess files, this way you can have different layouts in different
parts of your gallery.
No default value, this option is required.
GalleryInfo
With this option you can define which EXIF information you would like to present from the image. The
format is: '<MyName => KeyInEXIF, MyOtherName => OtherKeyInEXIF'
Examples of keys: ShutterSpeedValue, ApertureValue, SubjectDistance, and Camera
You can view all the keys from the EXIF header using this perl-oneliner:
perl "-e" 'use Data::Dumper; use Image::Info qw(image_info); print Dumper(image_info(shift));'
filename.jpg
Default is: 'Picture Taken => DateTimeOriginal, Flash => Flash'
GallerySizes
Defines which widths images can be scaled to. Images cannot be scaled to other widths than the ones
you define with this option.
The default is '640 800 1024 1600'
GalleryThumbnailSize
Defines the width and height of the thumbnail images.
Defaults to '100x75'
GalleryThumbnailSizeLS
If set to '1', GalleryThumbnailSize is the long and the short side of the thumbnail image instead of
the width and height.
Defaults to '0'.
GalleryCopyrightImage
Image you want to blend into your images in the lower right corner. This could be a transparent png
saying "copyright my name 2001".
Optional.
GalleryWrapNavigation
Make the navigation in the picture view wrap around (So Next at the end displays the first picture,
etc.)
Set to 1 or 0, default is 0
GalleryAllowOriginal
Allow the user to download the Original picture without resizing or putting the CopyrightImage on it.
Set to 1 or 0, default is 0
GalleryAllowThumbOnly
If true, GalleryAllowThumbOnly allows fooimg.jpg?thumbonly urls to output the thumbnail of the image.
This is useful when including images in a blog (or similar).
Defaults to '0' (false).
GallerySlideshowIntervals
With this option you can configure which intervals can be selected for a slideshow. The default is '3
5 10 15 30'
GallerySortBy
Instead of the default filename ordering you can sort by any stat attribute. For example size, atime,
mtime, ctime.
GalleryDirSortBy
Set this variable to sort directories differently than other items, can be set to size, atime, mtime
and ctime; setting any other value will revert to sorting by name.
GalleryMemoize
Cache EXIF data using Memoize - this will make Apache::Gallery faster when many people access the
same images, but it will also cache EXIF data until the current Apache child dies.
GalleryUseFileDate
Set this option to 1 to make A::G show the files timestamp instead of the EXIF value for "Picture
taken".
GallerySelectionMode
Enable the selection mode. Select images with checkboxes and get a list of filenames.
GalleryEXIFMode
You can choose how Apache::Gallery should display EXIF info from your images.
The default setting is 'namevalue'. This setting will make Apache::Gallery print out the names and
values of the EXIF values you configure with GalleryInfo. The information will be parsed into $INFO
in pictureinfo.tpl.
You can also set it to 'values' which will make A::G parse the configured values into the var
$EXIFVALUES as 'value | value | value'
If you set this option to 'variables' the items you configure in GalleryInfo will be available to
your templates as $EXIF_<KEYNAME> (in all uppercase). That means that with the default setting
"Picture Taken => DateTimeOriginal, Flash => Flash" you will have the variables
$EXIF_DATETIMEORIGINAL and $EXIF_FLASH available to your templates. You can place them anywhere you
want.
GalleryRootPath
Change the location of gallery root. The default is ""
GalleryRootText
Change the name that appears as the root element in the menu. The default is "root:"
GalleryMaxThumbnailsPerPage
This options controls how many thumbnails should be displayed in a page. It requires $BROWSELINKS to
be in the index.tpl template file.
GalleryImgFile
Pattern matching the files you want Apache::Gallery to view in the index as thumbnails.
The default is '\.(jpe?g|png|tiff?|ppm)$'
GalleryDocFile
Pattern matching the files you want Apache::Gallery to view in the index as normal files. All other
filetypes will still be served by Apache::Gallery but are not visible in the index.
The default is '\.(mpe?g|avi|mov|asf|wmv|doc|mp3|mp4|ogg|pdf|rtf|wav|dlt|txt|html?|csv|eps)$'
GalleryTTFDir
To use the GalleryCopyrightText feature you must set this option to the directory where your True
Type fonts are stored. No default is set.
Example:
PerlSetVar GalleryTTFDir '/usr/share/fonts/'
GalleryTTFFile
To use the GalleryCopyrightText feature this option must be set to the name of the True Type font you
wish to use. Example:
PerlSetVar GalleryTTFFile 'verdanab.ttf'
GalleryTTFSize
Configure the size of the CopyrightText that will be inserted as copyright notice in the corner of
your pictures.
Example:
PerlSetVar GalleryTTFSize '10'
GalleryCopyrightText
The text that will be inserted as copyright notice.
Example:
PerlSetVar GalleryCopyrightText '(c) Michael Legart'
GalleryCopyrightColor
The text color of your copyright notice.
Examples:
White:
PerlSetVar GalleryCopyrightColor '255,255,255,255'
Black:
PerlSetVar GalleryCopyrightColor '0,0,0,255'
Red:
PerlSetVar GalleryCopyrightColor '255,0,0,255'
Green:
PerlSetVar GalleryCopyrightColor '0,255,0,255'
Blue:
PerlSetVar GalleryCopyrightColor '0,0,255,255'
Transparent orange:
PerlSetVar GalleryCopyrightColor '255,127,0,127'
GalleryCopyrightBackgroundColor
The background-color of a GalleryCopyrightText
r,g,b,a - for examples, see GalleryCopyrightColor
GalleryQuality
The quality (1-100) of scaled images
This setting affects the quality of the scaled images. Set this to a low number to reduce the size
of the scaled images. Remember to clear out your cache if you change this setting. Quality seems to
default to 75, at least in the jpeg and png loader code in Imlib2 1.1.0.
Examples:
Quality at 50:
PerlSetVar GalleryQuality '50'
GalleryUnderscoresToSpaces
Set this option to 1 to convert underscores to spaces in the listing of directory and file names, as
well as in the alt attribute for HTML <img> tags.
GalleryCommentExifKey
Set this option to e.g. ImageDescription to use this field as comments for images.
GalleryEnableMediaRss
Set this option to 1 to enable generation of a media RSS feed. This can be used e.g. together with
the PicLens plugin from http://piclens.com