A simplistic gallery plugin for WordPress that stores images in a hierarchical folder structure.
Images are stored in hierarchical folders, as you normally would. To add new images, you can either put them directly into the folders or upload them through the web interface (Todo). If loaded directly into the folder, a rescan must be initiated to find the new images.
When new images are loaded, the plugin can rotate and resize according to the EXIF data. An image title, comment and tags will also be extracted from the image's EXIF and XMP data. The folder names can also be added as tags to the images - useful, for example, if you are organising the images into locations.
Once loaded, images can be searched by dates, tags, folders, or search terms. You can then insert thumbnails, single images, or fancier albums into posts and pages either using your search query, a single id or a list of ids.
This plugin contains no styling for the inserted images, so it is up to you or your theme to style them how you want.
If enabled, when an image is added to the database, the name of each folder that the image is in will be added to the tags of the image in the database. Folders can be excluded by adding a '-' to the start of the name.
The plugin has the following shortcodes:
ghalbum- for fancy albums
ghthumbnail- for single or multiple thumbnails (shortcut for
ghimage- for a single image
The following shortcode attributes are available for the included shortcodes
id="<id1>,<id2>,..."- list of images (some sort of query or list - see Image Selection below (
group="<group1>"- id for linking images to scroll through with lightbox (
class="<class1> <class2> ...- additional classes to put on the images (
caption="(none|title|comment)"- Type of caption to show. Default set in plugin options (
popup_caption="(none|title|comment)"- Type of caption to show on popup. Default set in plugin options (
link="(none|popup|<url>)"- URL link on image, by default it will be the image url and will cause a lightbox popup
size="<width>x<height>"- size of image (
type="<type1>"- of album (
include_excluded="(0|1)" - include excluded images in the query result. Default is to not (ghalbum
[ghalbum id="123,145" group="1" caption="comment" link="http://www.example.com"]
Will produce an album showing two images, 123 & 145, with the images' comments below. When the user clicks on the images, they will be taken to http://www.example.com.
[ghimage id="123" class="float-left" link="none"]
Will produce a full-sized image with the float-left class on it and no url link.
Gallery Hierarchy allows you to select individual images and/or use filters to select the images you want to include. The image selection string (the id attribute) should be a comma-separated list of image ids and filters.
The following filters are available:
folder=<id1>|<id2>- Specifies what folders to look in by their ids, separated with
rfolder=<id1>|<id2>- Specifies what folders and their sub-directories to look in by their ids, separated with
taken=<date1>|<date2>- Specifies when the image was taken/created.
<date1>specifies after what date the photo should have been taken.
<date1>specifies before what date the photo should have been taken. Either date can be omitted. The dates must be in the format
YYYY-MM-DD HH:MM:SS. The time can be omitted. If only a date is given, only images taken/created on that day will be selected. For example,
taken=|2012-03-12will match all images taken/created before the 12th of March, 2012.
taken=2012-03-12 12:00:00|will match all images taken/created after midday on that day.
taken=2012-03-12|2012-03-17will match all images taken between the 12th and the 17th of March, 2012.
tags=- Specifies what tags the images should have (see below)
title=- Specifies what words should be in the image titles (see below)
comment=- Specifies what words should be in the image comments (see below)
comment= can contain logic and grouping of tags/words.
& specifies AND, and
) can be used to group logic.
will select images that have either the
tag or both the
new zealand tags.