ike_slideshow
Introduction
ike_slideshow v0.1
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.
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.
Examples
Regular usage
<txp:ike_slideshow ids="620-625" />
Floating Thumbnails
<txp:ike_slideshow ids="620-625" mode="thumbnails" show="" float="right" />
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. In convallis cursus nisl. Nullam in felis. In hac habitasse platea dictumst. Morbi venenatis nisi pellentesque arcu. Aenean at nisi. Nunc id nisi. Maecenas dictum eros. Nulla bibendum mollis eros. Aliquam erat volutpat. Fusce nisl neque, pulvinar non, porta sed, rutrum non, metus. Fusce risus. Quisque eget turpis. In convallis justo quis elit. Sed pulvinar mi vel odio. Nam nunc. Nulla ac ligula vitae mauris tempus aliquet.
Nunc lectus enim, bibendum vitae, tempus vitae, dapibus rutrum, tellus. Ut vel enim quis augue ultricies semper. Fusce blandit, libero vel porttitor commodo, dolor risus ultrices mi, non pellentesque lorem massa nec diam. Sed elementum lorem bibendum tellus. Vivamus in lorem eget magna rutrum malesuada. Sed posuere feugiat elit. Suspendisse potenti. Nam a risus. Ut tellus. In in libero.
Looping, Categories & Pagination
<txp:ike_slideshow category="foo" loop="1" show="pagination" />
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. :)