Slideshow plugin

The Slideshow plugin gives you a shortcode called [slideshow], which pulls any image attachments for a post (or any post type) and formats them into a elegantly-designed slideshow.

The Slideshow plugin was originally developed as a feature of the News theme (if you're using that theme, please don't install this plugin). Realizing that users sometimes switch themes, we wanted to give those users a way to continue using their slideshows with other themes. This also allows us to make the slideshow feature something that anyone can use, even if they're not using one of our themes.

Installation

Download and unzip the slideshow.zip file.
Upload slideshow to the /wp-content/plugins/ directory.
Activate the plugin through the Plugins menu in WordPress.

Usage

Using the plugin is extremely simple. You only need to have a shortcode-ready area such as the post editor. Most people will simply need to follow these steps to show a slideshow:

Create a new post in your WordPress admin.
Upload some images using the image uploader for the post.
Add image captions (optional) in either the "description" or "caption" box for the image.
Add the [slideshow] shortcode to this page.
Save the post. And, you're done!

Additional shortcode options

The shortcode has a few extra options if you wish to use them:

order: You can use an ascending (ASC) or descending (DESC). The shortcode defaults to ASC.
orderby: What criteria to order the posts by. By default, they are ordered by the menu_order, which is the order you drag your uploaded images in via the image uploader..
size: The size of the images to show. You can use any valid image size created by WordPress, your theme, or another plugin. This defaults to the large size.
include: A comma-separated list of image attachment IDs to include. This is empty by default.
exclude: A comma-separated list of image attachment IDs to exclude. This is empty by default.
numberposts: The number of images to show. By default, this is -1 and shows all images uploaded to the post. Most themes will not be able to properly display more than approximately 10 images.

Example showing 5 images:

[slideshow numberposts="5"]

Example showing a custom image size called "extra-large":

[slideshow size="extra-large"]

Example showing images in descending order:

[slideshow order="DESC"]

Plugin support

Support for the Slideshow plugin is not offered on the WordPress support forums. We have a community called DevPress where we offer support of all our themes and plugins. We encourage you to sign up to the site to use its support forums and become a part of our community.

JavaScript

The jQuery Cycle plugin is used to create the slideshow cycle. This script is licensed under the GPL and MIT license:

Copyright & license

Slideshow is licensed under the GNU General Public License, version 2 (GPL).