{"id":21426,"date":"2013-01-05T06:00:29","date_gmt":"2013-01-05T06:00:29","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/folder-gallery\/"},"modified":"2017-11-18T07:18:46","modified_gmt":"2017-11-18T07:18:46","slug":"folder-gallery","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/folder-gallery\/","author":11385981,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.7.4","stable_tag":"1.7.4","tested":"4.9.0","requires":"4.0","requires_php":"","requires_plugins":"","header_name":"Folder Gallery","header_author":"Vincent Jalby","header_description":"","assets_banners_color":"","last_updated":"2017-11-18 07:18:46","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/jalby.org\/wordpress\/donate\/","header_plugin_uri":"http:\/\/www.jalby.org\/wordpress\/","header_author_uri":"http:\/\/www.jalby.org\/wordpress\/","rating":4.5,"author_block_rating":0,"active_installs":1000,"downloads":32783,"num_ratings":24,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":"2","2":0,"3":"1","4":"1","5":"19"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1712467","resolution":"128x128","location":"assets"}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.92","0.95","0.97","1.0","1.1","1.2","1.3","1.4","1.4.1","1.5b1","1.5b3","1.6","1.6b1","1.7","1.7.1","1.7.2","1.7.3","1.7.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1176268","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"648244","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"648244","resolution":"3","location":"assets"}},"screenshots":{"1":"Folder Gallery Options","2":"Folder Gallery in a post","3":"Folder Gallery Lightbox"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[17545,210,237],"plugin_category":[50],"plugin_contributors":[81616],"plugin_business_model":[],"class_list":["post-21426","plugin","type-plugin","status-closed","hentry","plugin_tags-folder","plugin_tags-gallery","plugin_tags-lightbox","plugin_category-media","plugin_contributors-vjalby","plugin_committers-vjalby"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/folder-gallery.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/folder-gallery\/assets\/screenshot-1.png?rev=1176268","caption":"Folder Gallery Options"},{"src":"https:\/\/ps.w.org\/folder-gallery\/assets\/screenshot-2.png?rev=648244","caption":"Folder Gallery in a post"},{"src":"https:\/\/ps.w.org\/folder-gallery\/assets\/screenshot-3.png?rev=648244","caption":"Folder Gallery Lightbox"}],"raw_content":"<!--section=description-->\n<p>This plugin creates picture galleries from a folder. \nThe pictures folder must be uploaded (using FTP) somewhere on the server (e.g. wp-content\/upload). It must be writable (chmod 777).<\/p>\n\n<p>Folder Gallery Plugin does not include any lightbox JS engine anymore. You have to install one or use a compatible lightbox plugin. See FAQ.<\/p>\n\n<p>To include a gallery in a post or a page, you have to use the following shortcode :<\/p>\n\n<pre><code>[foldergallery folder=\"local_path_to_folder\" title=\"Gallery title\"]\n<\/code><\/pre>\n\n<p>For each gallery, a subfolder cache_[width]x[height] is created inside the pictures folder when the page is accessed for the first time.<\/p>\n\n<p>An Options page allow to set the default paramaters of the galleries :<\/p>\n\n<ul>\n<li>Lightbox JS Engine: Lightbox 2 (if installed), Fancybox 2 (if installed), Fancybox 3 (if installed), Lightview 3 (if installed), Easy Fancybox Plugin (if available), Responsive Lightbox Plugin (if available) or none (default)<\/li>\n<li>Display Thumbnails (thumbnails): all = standard Gallery, single = displays a single thumbnail linked to the lightbox gallery, none = displays a link to the lightbox gallery<\/li>\n<li>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)<\/li>\n<li>Number of images per row (columns)<\/li>\n<li>Thumbnails width and height (width &amp; height)<\/li>\n<li>Picture border (border)<\/li>\n<li>Padding and Margin (padding &amp; margin)<\/li>\n<li>Caption Format (caption): default (title + picture number), filename, filenamewithoutextension, smartfilename (filename with underscores and front numbers removed), modificationdate, modificationdateandtime, modificationdater (RFC 2822), modificationdatec (ISO 8601), none<\/li>\n<li>Show Thumbnail Captions (show_thumbnail_captions): yes (true) or no (false). Display (or not) the caption under the picture thumbnail.<\/li>\n<li>Fancybox 2 Caption Style: Inside, Outside, Over, Float, None. Available with Fancybox 2 engine only (if installed).<\/li>\n<li>Fancybox 2 Transition: Elastic, Fade. Available with Fancybox 2 engine only (if installed).<\/li>\n<li>Fancybox 2 Autoplay Speed: Slideshow speed in seconds. 0 to turn autoplay off. Available with Fancybox 2 engine only (if installed).<\/li>\n<li>Fancybox 3 Options : Loop, Toolbar, Infobar, Arrows, Fullscreen, Slideshow, Slideshow speed. Available with Fancybox 3 engine only (if installed).<\/li>\n<li>Misc settings - Permissions: force 777 permissions on cache folder. Leave it uncheck unless you really know what you do!<\/li>\n<li>Misc settings - Orientation: Correct picture orientation according to EXIF tag. Rotated pictures will be overwritten. (Require EXIF library in PHP.) Delete the cache folder to apply to existing galleries.<\/li>\n<\/ul>\n\n<p>Most of theses settings can be overridden using the corresponding shortcode :<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"title\" columns=1 width=150 \n        height=90 border=1 padding=2 margin=10 thumbnails=single]\n<\/code><\/pre>\n\n<p>Sample, contact available at http:\/\/jalby.org\/wordpress\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Unzip the archive foldergallery.zip<\/li>\n<li>Upload the directory 'foldergallery' to the '\/wp-content\/plugins\/' directory<\/li>\n<li>Download and upload to '\/wp-content\/' directory at least on lightbox JS engine (see FAQ)<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to Settings \/ Folder Gallery to change the default settings<\/li>\n<li>Upload a folder of pictures to 'wp-content\/upload\/MyPictures'<\/li>\n<li><p>Insert the following short code in post or page :<\/p>\n\n<p>[foldergallery folder=\"wp-content\/upload\/MyPictures\" title=\"My Picture Gallery\"]<\/p><\/li>\n<li><p>To use Fancybox 2 engine, see FAQ<\/p><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Installation Instructions<\/dt>\n<dd><ol>\n<li>Unzip the archive foldergallery.zip<\/li>\n<li>Upload the directory 'foldergallery' to the '\/wp-content\/plugins\/' directory<\/li>\n<li>Download and upload to '\/wp-content\/' directory at least on lightbox JS engine (see FAQ)<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to Settings \/ Folder Gallery to change the default settings<\/li>\n<li>Upload a folder of pictures to 'wp-content\/upload\/MyPictures'<\/li>\n<li><p>Insert the following short code in post or page :<\/p>\n\n<p>[foldergallery folder=\"wp-content\/upload\/MyPictures\" title=\"My Picture Gallery\"]<\/p><\/li>\n<li><p>To use Fancybox 2 engine, see FAQ<\/p><\/li>\n<\/ol><\/dd>\n<dt>How to install Lightbox 2 JS engine?<\/dt>\n<dd><ol>\n<li>Download Lightbox 2 from http:\/\/lokeshdhakar.com\/projects\/lightbox2\/<\/li>\n<li>Unzip the archive<\/li>\n<li>Upload the directory 'dist' to '\/wp-content' and rename it to 'lightbox'<\/li>\n<li>Go To Wordpress &gt; Settings &gt; Folder Gallery and select Lightbox 2 as Gallery Engine.<\/li>\n<li>Done!<\/li>\n<\/ol><\/dd>\n<dt>How to install Fancybox 3?<\/dt>\n<dd><ol>\n<li>Download FancyBox 3 from http:\/\/fancyapps.com\/fancybox\/3\/<\/li>\n<li>Unzip the archive then rename the directory to 'fancybox3'.<\/li>\n<li>Upload the directory 'fancybox3' to '\/wp-content'.<\/li>\n<li>Go To Wordpress &gt; Settings &gt; Folder Gallery and select Fancybox 3 as Gallery Engine.<\/li>\n<li>Save Changes and set Fancybox options.<\/li>\n<li>Done!<\/li>\n<\/ol><\/dd>\n<dt>How to install Lightview 3?<\/dt>\n<dd><ol>\n<li>Download lightview from http:\/\/projects.nickstakenburg.com\/lightview\/download<\/li>\n<li>Unzip the archive then rename the directory to 'lightview' (i.e., remove version number).<\/li>\n<li>Upload the directory 'lightview' to '\/wp-content'.<\/li>\n<li>Go To Settings \/ Folder Gallery and select Lightview as Gallery Engine.<\/li>\n<li>Done!<\/li>\n<\/ol>\n\n<p>You can specify lightview options with the shortcode attribute 'options':<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"My Gallery\"\n    options=\"controls: { slider: false }, skin: 'mac'\"]\n<\/code><\/pre>\n\n<p>You can set default options in Folder Gallery Options Page.<\/p>\n\n<p>See http:\/\/projects.nickstakenburg.com\/lightview\/documentation for details about Lightview options.<\/p><\/dd>\n<dt>Can I use Folder Gallery along with another Lightbox plugin?<\/dt>\n<dd><p>Folder Gallery has built-in support for \"Easy Fancybox\" plugin by RavanH, \"Responsive Lightbox\" plugin by dFactory, and \"Slenderbox\" plugin by Matthew Petroff. After activating the plugin, select it in Folder Gallery Settings (Gallery Engine).<\/p>\n\n<p>Otherwise, if your Lightbox plugin automatically handles images, you may set the lightbox engine to 'None' in Folder Gallery Options.\nThis should work with<\/p>\n\n<ul>\n<li>jQuery Colorbox 4.6+ by Arne Franken<\/li>\n<li>Lightview Plus 3.1.3+ by Puzich<\/li>\n<li>Maybe other<\/li>\n<\/ul><\/dd>\n<dt>Can I use Easy Fancybox plugin along with Folder Gallery?<\/dt>\n<dd><p>Yes! First install and activate Easy Fancybox plugin. In Wordpress &gt; Settings &gt; Media &gt; Fancybox &gt; Images &gt; Gallery, Disabled Autogllery. Then, in Wordpress &gt; Settings &gt; Folder Gallery, select \"Easy Fancybox (plugin)\" as Gallery Engine.<\/p><\/dd>\n<dt>I'd like to display a single thumbnail instead of the full thumbnails list<\/dt>\n<dd><p>Add the attribute <code>thumbnails<\/code> in the shortcode with value <code>single<\/code> to display only the first thumbnail.<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"My Gallery\" thumbnails=\"single\"]\n<\/code><\/pre>\n\n<p>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., <code>!!!.jpg<\/code>) 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 <code>thumbnails=-n<\/code> where <code>n<\/code>is the picture number (in the gallery) you want to use as single thumbnail.<\/p>\n\n<p>To hide gallery title under the thumbnail, add <code>title=\"\"<\/code>. You then should set <code>caption' to something else than<\/code>default<code>, e.g.,<\/code>caption=\"filename\"`.<\/p><\/dd>\n<dt>I'd like to display only the n first thumbnails instead of the full thumbnails list<\/dt>\n<dd><p>Add the attribute <code>thumbnails<\/code> in the shortcode with value <code>n<\/code> to display only the n first thumbnails.<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"My Gallery\" thumbnails=3]\n<\/code><\/pre><\/dd>\n<dt>I'd like to display a (sub)title under each thumbnail<\/dt>\n<dd><p>You have to set show_thumbnail_captions to 1 (or change the global option in Folder Gallery Settings) using<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"My Gallery\" show_thumbnail_captions=true]\n<\/code><\/pre>\n\n<p>The caption format is set with the attribute <code>caption<\/code>. It can be set to <code>filename<\/code>, <code>filenamewithoutextension<\/code> or <code>smartfilename<\/code> which displays the filename without extension, front number removed and underscores (_) replaced with spaces.<\/p>\n\n<pre><code>[foldergallery folder=\"path\" title=\"My Gallery\" show_thumbnail_captions=1 caption='smartfilename']\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.7.4 [2017-11-18]<\/h4>\n\n<ul>\n<li>FancyBox 3 support (see FAQ)<\/li>\n<li>WPML fix option<\/li>\n<li>Misc bugs fixed<\/li>\n<\/ul>\n\n<h4>1.7.3 [2017-08-12]<\/h4>\n\n<ul>\n<li>PHP7 compatibility<\/li>\n<\/ul>\n\n<h4>1.7.2 [2014-12-21]<\/h4>\n\n<ul>\n<li>Support for Slenderbox plugin<\/li>\n<\/ul>\n\n<h4>1.7.1 [2014-11-28]<\/h4>\n\n<ul>\n<li>Compatibility with WPML plugin<\/li>\n<li>Date and time caption formats<\/li>\n<\/ul>\n\n<h4>1.7 [2014-09-04]<\/h4>\n\n<ul>\n<li>Option to correct picture orientation according to EXIF tag. Require PHP with EXIF library. Rotated pictures will be overwritten.<\/li>\n<li>Support for Nivo Lightbox in Responsive Lightbox Plugin<\/li>\n<\/ul>\n\n<h4>1.6 [2014-07-17]<\/h4>\n\n<ul>\n<li>Because of license issue, Lightbox 2 is not included in Folder Gallery anymore. You have to install it yourself (see FAQ)<\/li>\n<li>Folder Gallery doesn't include any JS lightbox engine anymore. You have to install one yourself (see FAQ)<\/li>\n<li>Reorganize Settings page<\/li>\n<li>Add an option to force 777 permissions to cache folders<\/li>\n<li>Workaround for unactive glob function<\/li>\n<\/ul>\n\n<h4>1.5b2 [2014-02-22]<\/h4>\n\n<ul>\n<li>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)<\/li>\n<li>Change the location of Lightview 3 installation (see FAQ)<\/li>\n<li>Support for Responsive Lightbox Plugin<\/li>\n<li>Support for Easy Fancybox Plugin<\/li>\n<li>Global option to set transition effect when Fancybox 2 engine is selected<\/li>\n<li>Option (and attribute) to sort pictures randomly<\/li>\n<li>Rewrite directory scan : support for gif, bmp pictures ; sort by date option<\/li>\n<\/ul>\n\n<h4>1.4 [2013-08-31]<\/h4>\n\n<ul>\n<li>Global option to display the caption under the picture thumbnail.<\/li>\n<li>Several changes in layout and CSS. Hopefully it breaks nothing!<\/li>\n<li>New 'smartfilename' option for caption style<\/li>\n<li>Option (and attribute) to sort pictures by filename in reverse order<\/li>\n<li>Improved captions support<\/li>\n<li>Compatibility with PhotoSwipe WP plugin<\/li>\n<li>Minor bug fixes<\/li>\n<\/ul>\n\n<h4>1.3 [2013-08-05]<\/h4>\n\n<ul>\n<li>Update Lightbox 2 JS to 2.6 (JQuery\/Wordpress 3.6 compatibility)<\/li>\n<li>Update Fancybox JS to 2.1.5<\/li>\n<li>Global option to set picture's caption style (default, filename, filenamewithoutextension, none)<\/li>\n<li>Global option to set autoplay speed when Fancy Box engine is selected.<\/li>\n<li>Option to display the thumbnails of the first pictures only. Read the FAQ!<\/li>\n<li>Several changes and improvements related to single-thumbnail-gallery (thumbnails=\"single\"). Read the FAQ!<\/li>\n<li>Misc bug corrections<\/li>\n<\/ul>\n\n<h4>1.2 [2013-03-16]<\/h4>\n\n<ul>\n<li>Pictures are now sorted alphabetically<\/li>\n<li>Global option to change title style when fancybox engine is selected<\/li>\n<li>Misc changes to support a forthcoming plugin<\/li>\n<\/ul>\n\n<h4>1.1 [2013-02-18]<\/h4>\n\n<ul>\n<li>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).<\/li>\n<li>Improved error messages<\/li>\n<li>Update FAQ<\/li>\n<\/ul>\n\n<h4>1.0 [2013-02-03]<\/h4>\n\n<ul>\n<li>Fix a problem with case of file extension of thumbnails.<\/li>\n<li>Update Fancybox to 2.1.4<\/li>\n<\/ul>\n\n<h4>0.97 [2013-01-16]<\/h4>\n\n<ul>\n<li>Scripts are only loaded on pages with galleries<\/li>\n<li>Add support for fancybox (included)<\/li>\n<li>Add an option to change gallery 'engine' (Lightbox, Fancybox, Lightview when installed or None)<\/li>\n<li>Misc changes <\/li>\n<\/ul>\n\n<h4>0.95 [2013-01-10]<\/h4>\n\n<ul>\n<li>Internationalization (English, French)<\/li>\n<li>Support for Lightview 3 (see FAQ)<\/li>\n<li>Code cleaning<\/li>\n<li>Small improvements<\/li>\n<\/ul>\n\n<h4>0.92 [2013-01-05]<\/h4>\n\n<ul>\n<li>Add a 0-column option (When 'Images per Row' is set to 0, the number of columns is set automatically.)<\/li>\n<li>Misc changes<\/li>\n<\/ul>\n\n<h4>0.90 [2013-01-05]<\/h4>\n\n<ul>\n<li>First released version<\/li>\n<\/ul>","raw_excerpt":"This plugin generates picture galleries from a folder using a shortcode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/21426","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=21426"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vjalby"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=21426"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=21426"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=21426"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=21426"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=21426"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=21426"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}