A simple, no-frills (or, well, very-few-frills) image slideshow plugin, using a minimal amount of Javascript and CSS to get the job done and look good doing it.

download version 0.1
visit version 0.02
visit version 0.01

view slideshow demos

A note on upgrading: Both the CSS and the Javascript for this plugin have changed – be sure to update both from what’s provided in this plugin’s help page.

Usage

Tags

ike_slideshow
Renders the slideshow.

ike_slideshow_article
Version of ike_slideshow for use in article forms. Uses the field Article images to generate the slideshow.

Attributes

attribute	values	description
category	comma-delineated list of image categories	When set, pulls images based on category rather than ID
float	left or right (no default)	Aligns the slideshow to the right or left, letting text flow around it
ids	comma-delineated Textpattern image IDs, optional ranges	Sets which images to use with a slideshow instance
limit	numeric (default: 0)	Limit the number of images shown, for whatever reason (0 = no limit)
link	article, image, none (default: none)	Renders images as links to either the article URL or the image URL, respectively
loop	1 or 0 (default: 0)	Toggles looping of slideshow
mode	article_thumbnail, thumbnails, none (no default)	(see below)
show	comma-delineated selection of the following: pagination, category, caption (default: caption)	Choose which pieces of image information to display
textile	1 or 0 (default: 1)	Parse image caption for Textile
thumbnails	1 or 0 (default: 0)	Use image thumbnails instead of fullsize images

Note on ids/category
ids has precedence over category – if both attributes are set, images will be pulled based on the contents of ids. ids is optional if category is set.

Modes

Usage of a mode automatically sets a number of other attributes, saving the trouble of manually writing settings to achieve an effect. Use one of these modes with the mode attribute (e.g. <txp:ike_slideshow mode='thumbnails' />).

mode	attribute settings	description
article_thumbnail	limit=‘1’ link=‘article’ thumbnails=‘1’ show=’‘	Usually used only with ike_slideshow_article; renders the thumbnail for the first image specified in Article image with a link to the article itself
thumbnails	thumbnails=‘1’ link=‘image’	Uses thumbnails instead of full-size images; links thumbnails to the full-size versions
none	-	Leaves other attributes untouched (default)

Pre-Usage

For the slideshow to function properly, you’ll need to have a bit of Javascript and CSS in place. Both can be found in the plugin’s help page.

Updates

version 0.01

• New attributes: “loop”, “float”, “category”
• Improved pagination behavior

Support

If you find a bug or have contributions, leave a comment here or at the related Textpattern Forums thread. If something is horribly wrong, know that I posted this at three in the morning. This wasn’t a good idea for the last release, and it likely isn’t a good idea now. :)