Follow for free plugins, new theme releases and theme news
Plugin Description
This plugin allows authors to turn a WordPress gallery into a slideshow.
To activate slideshow mode set the “GSS Slideshow” option to “Yes” when editing a gallery in the WordPress Media Manager. Alternatively you can manually add the “gss” attribute to a WordPress gallery shortcode:
See here to view an example slideshow.
The plugin supports six optional shortcode attributes:
size: The size of the slideshow images (included in “Gallery Settings”).
link: The default link for slideshow images (included in “Gallery Settings”). Custom links can be set via the “GSS Link” metadata on individual images.
options: This attribute can be used to override default slideshow options or set custom options. Attribute value uses query string format, e.g.: ‘option1=value1&option2=value2’ etc. Option names are in standard Cycle2 format without ‘data-cycle-‘ prefix. See the Cycle2 website for documentation and supported options.
name: Use this attribute to give slideshow(s) unique ids (applied to container <div>). Give each slideshow a unique name / id when displaying multiple slideshows on a single page.
style: Inline CSS styles applied to the slideshow container. Outputted string is prefaced with “style=” and must contain standard “property:value;” syntax.
carousel: Set ‘fx=carousel’ value in this attribute to include a carousel pager navigation (thumbnails) in a slideshow. See the Cycle2 Carousel for documentation and supported options. Carousel options follow the same string format as the options attribute above.
Support
Plugin author is no longer able to respond to new threads in the “Support” forum. Plugin users are encouraged to provide support to others.
Notes
Slideshows perform best if images are sized to desired slideshow width / container.
Slideshow captions are taken from each image’s “Caption” field. Upload and use unique versions of any images that are reused elsewhere on your site with different captions.
Slideshow widths should automatically adjust to the smaller of: 1) the width of the largest image in the slideshow or 2) the width of its container.
Default Display: Height / width of slideshow image area is set by the first image; images appear at full size or are scaled down to fit container; smaller images are horizontally centered; images are bottom aligned to caption area; some white space may appear at the top of slideshows that contain both horizontally and vertically aligned images.
Default CSS ids begin with “gss_”, classes with “cycle-“. Default slideshow id is “gslideshow”. Default CSS styles were created using the Twenty Thirteen theme — some CSS customization may be necessary for other themes.
In addition to the options attribute mentioned above, slideshows can be customized by placing a “gss-custom.js” file inside the Gallery Slideshow plugin directory. An example “gss-custom.js” can be found in the /assets/ directory.
This plugin uses jQuery Cycle2. Cycle2 may conflict with previous versions of Cycle if used on the same page.
Embed Slideshow (Experimental; requires version 1.3+)
To embed a slideshow on another site:
-
Move the ’embed.js’ and ’embed.php’ files out of the plugin’s /assets/ directory and into the main /gallery-slideshow/ directory.
-
While editing a post/page with a slideshow, locate the slideshow’s embed key in the “Custom Fields” meta box . (If the embed key isn’t shown make sure the [gss …] shortcode exists in the visual editor and update the page/post.)
-
Replace the all caps text below with 1) your site’s URL/domain name and 2) the embed key to produce the embed code:
‘data-target’ attribute (optional): Add this attribute to the embed code to target a specific div by id (use unique ids if multiple slideshows are embedded on a page):
<script src="YOUR_SITES_DOMAIN/wp-content/plugins/gallery-slideshow/embed.js" data-embed="GSS_EMBED_KEY" data-target="UNIQUE_TARGET_NAME" type="text/javascript"></script><div id="UNIQUE_TARGET_NAME"></div>
Screenshots
The WordPress Media Manager in “Edit Gallery” mode; GSS related options are outlined in red. The “Link To” option applies to all images; “Caption” and “GSS Link” are specific to individual images.
A screen capture of a basic GSS slideshow.
An “Edit Page” admin screen showing the WP editor in text mode and a sample GSS shortcode.
