=== Folder Gallery === Contributors: vjalby Tags: gallery, folder, lightbox Requires at least: 3.5 Tested up to: 3.9 Stable tag: 1.5b3 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Donate link: http://jalby.org/wordpress/donate/ This plugin generates picture galleries from a folder using a shortcode. == Description == This plugin creates picture galleries from a folder. The pictures folder must be uploaded (using FTP) somewhere on the server (e.g. wp-content/upload). It must be writable (chmod 777). To include a gallery in a post or a page, you have to use the following shortcode : [foldergallery folder="local_path_to_folder" title="Gallery title"] For each gallery, a subfolder cache_[width]x[height] is created inside the pictures folder when the page is accessed for the first time. An Options page allow to set the default paramaters of the galleries : * Lightbox JS Engine: Lightbox 2, Fancybox 2 (if installed), Lightview 3 (if installed), Easy Fancybox Plugin (if available), Responsive Lightbox Plugin (if available) or none * Display Thumbnails (thumbnails): all = standard Gallery, single = displays a single thumbnail linked to the lightbox gallery, none = displays a link to the lightbox gallery * Sort pictures by (sort) : pictures are sorted by filename (filename) or in reverse order (filename_desc) or by modification date (date or date_desc) or randomly (random) * Number of images per row (columns) * Thumbnails width and height (width & height) * Picture border (border) * Padding and Margin (padding & margin) * Caption Format (caption): default (title + picture number), filename, filenamewithoutextension, smartfilename (filename with underscores and front numbers removed), none * Show Thumbnail Captions (show_thumbnail_captions): yes (true) or no (false). Display (or not) the caption under the picture thumbnail. * Fancybox Caption Style: Inside, Outside, Over, Float, None. Available with Fancybox 2 engine only (if installed). * Fancybox Transition: Elastic, Fade. Available with Fancybox 2 engine only (if installed). * Autoplay Speed: Slideshow speed in seconds. 0 to turn autoplay off. Available with Fancybox 2 engine only (if installed). * Misc settings - Permissions: force 777 permissions on cache folder. Leave it uncheck unless you really know what you do! Most of theses settings can be overridden using the corresponding shortcode : [foldergallery folder="path" title="title" columns=1 width=150 height=90 border=1 padding=2 margin=10 thumbnails=single] This plugin uses Lightbox v2.7.1 by Lokesh Dhakar - http://www.lokeshdhakar.com Sample, contact available at http://jalby.org/wordpress/ == Installation == 1. Unzip the archive foldergallery.zip 2. Upload the directory 'foldergallery' to the '/wp-content/plugins/' directory 3. Activate the plugin through the 'Plugins' menu in WordPress 4. Go to Settings / Folder Gallery to change the default settings 5. Upload a folder of pictures to 'wp-content/upload/MyPictures' 6. Insert the following short code in post or page : [foldergallery folder="wp-content/upload/MyPictures" title="My Picture Gallery"] 7. To use Fancybox 2 engine, see FAQ == Frequently Asked Questions == = How to use Fancybox 2 instead of Lightbox 2? = 1. Download fancybox 2 from http://fancyapps.com/fancybox/#license 2. Unzip the archive then rename the directory to 'fancybox'. 3. Upload the directory 'fancybox' to '/wp-content'. 4. Go To Wordpress > Settings > Folder Gallery and select Fancybox 2 as Gallery Engine. 5. Done! = Can I use Easy Fancybox plugin along with Folder Gallery? = Yes! First install and activate Easy Fancybox plugin. In Wordpress > Settings > Media > Fancybox > Images > Gallery, Disabled Autogllery. Then, in Wordpress > Settings > Folder Gallery, select "Easy Fancybox (plugin)" as Gallery Engine. = Can I use lightview 3 instead of Lightbox 2? = Yes! However, you have to download and install lightview 3 by hand. Here's how: 1. Download lightview from http://projects.nickstakenburg.com/lightview/download 2. Unzip the archive then rename the directory to 'lightview' (i.e., remove version number). 3. Upload the directory 'lightview' to '/wp-content'. 4. Go To Settings / Folder Gallery and select Lightview as Gallery Engine. 5. Done! You can specify lightview options with the shortcode attribute 'options': [foldergallery folder="path" title="My Gallery" options="controls: { slider: false }, skin: 'mac'"] You can set default options in Folder Gallery Options Page. See http://projects.nickstakenburg.com/lightview/documentation for details about Lightview options. = Can I use Folder Gallery along with another Lightbox plugin? = Folder Gallery has built-in support for "Easy Fancybox" plugin by RavanH and "Responsive Lightbox" plugin by dFactory. After activating the plugin, select it in Folder Gallery Settings (Gallery Engine). Otherwise, if your Lightbox plugin automatically handles images, you may set the lightbox engine to 'None' in Folder Gallery Options. This should work with * Fancybox 1.0.7+ by Kevin Sylvestre * jQuery Colorbox 4.5+ by Arne Franken * Lightview Plus 3.1.3+ by Puzich * Maybe other = I'd like to display a single thumbnail instead of the full thumbnails list = Add the attribute `thumbnails` in the shortcode with value `single` to display only the first thumbnail. [foldergallery folder="path" title="My Gallery" thumbnails="single"] If you want to use a different picture (than the first) as the single thumbnail for the gallery, add a picture with name !!! (e.g., `!!!.jpg`) to your gallery. This picture will be used as thumbnail, but won't be included in the (lightbox) gallery. Another option is to use the shortcode attribute `thumbnails=-n` where `n`is the picture number (in the gallery) you want to use as single thumbnail. To hide gallery title under the thumbnail, add `title=""`. You then should set `caption' to something else than `default`, e.g., `caption="filename"`. = I'd like to display only the n first thumbnails instead of the full thumbnails list = Add the attribute `thumbnails` in the shortcode with value `n` to display only the n first thumbnails. [foldergallery folder="path" title="My Gallery" thumbnails=3] = I'd like to display a (sub)title under each thumbnail = You have to set show_thumbnail_captions to 1 (or change the global option in Folder Gallery Settings) using [foldergallery folder="path" title="My Gallery" show_thumbnail_captions=true] The caption format is set with the attribute `caption`. It can be set to `filename`, `filenamewithoutextension` or `smartfilename` which displays the filename without extension, front number removed and underscores (_) replaced with spaces. [foldergallery folder="path" title="My Gallery" show_thumbnail_captions=1 caption='smartfilename'] == Screenshots == 1. Folder Gallery Options 2. Folder Gallery in a post 3. Folder Gallery Lightbox == Changelog == = 1.5b3 [2014-06-30] = * Update Lightbox 2 JS to 2.7.1 * Reorganize Settings page * Add an option to force 777 permissions to cache folders = 1.5b2 [2014-02-22] = * Rewrite directory scan : support for gif, bmp pictures ; sort by date option = 1.5b1 [2014-02-14] = * Because of license compatibility, Fancybox 2 is not included in Folder Gallery anymore. You have to install it yourself or use a Fancybox plugin (see FAQ) * Change the location of Lightview 3 installation (see FAQ) * Support for Responsive Lightbox Plugin * Support for Easy Fancybox Plugin * Global option to set transition effect when Fancybox 2 engine is selected * Option (and attribute) to sort pictures randomly = 1.4 [2013-08-31] = * Global option to display the caption under the picture thumbnail. * Several changes in layout and CSS. Hopefully it breaks nothing! * New 'smartfilename' option for caption style * Option (and attribute) to sort pictures by filename in reverse order * Improved captions support * Compatibility with PhotoSwipe WP plugin * Minor bug fixes = 1.3 [2013-08-05] = * Update Lightbox 2 JS to 2.6 (JQuery/Wordpress 3.6 compatibility) * Update Fancybox JS to 2.1.5 * Global option to set picture's caption style (default, filename, filenamewithoutextension, none) * Global option to set autoplay speed when Fancy Box engine is selected. * Option to display the thumbnails of the first pictures only. Read the FAQ! * Several changes and improvements related to single-thumbnail-gallery (thumbnails="single"). Read the FAQ! * Misc bug corrections = 1.2 [2013-03-16] = * Pictures are now sorted alphabetically * Global option to change title style when fancybox engine is selected * Misc changes to support a forthcoming plugin = 1.1 [2013-02-18] = * Add a 'thumbnails' option/attribute to set how many thumbnails should be displayed in the gallery : all (default), single or none (display a link instead). * Improved error messages * Update FAQ = 1.0 [2013-02-03] = * Fix a problem with case of file extension of thumbnails. * Update Fancybox to 2.1.4 = 0.97 [2013-01-16] = * Scripts are only loaded on pages with galleries * Add support for fancybox (included) * Add an option to change gallery 'engine' (Lightbox, Fancybox, Lightview when installed or None) * Misc changes = 0.95 [2013-01-10] = * Internationalization (English, French) * Support for Lightview 3 (see FAQ) * Code cleaning * Small improvements = 0.92 [2013-01-05] = * Add a 0-column option (When 'Images per Row' is set to 0, the number of columns is set automatically.) * Misc changes = 0.90 [2013-01-05] = * First released version