=== d13slideshow ===
Contributors: d13design
Donate link: http://www.d13design.co.uk/d13slideshow/
Tags: image, slideshow, promote, feature, promotion
Requires at least: 2.0.2
Tested up to: 2.6.2
Stable tag: 1.0.2

Add animated slideshows of your featured pages and posts.

== Description ==

D13Slideshow is a plugin that will create an animated promo slideshow as part of your WordPress blog. You can use it to promote any pages or posts in your site and it is fully customisable through the admin pages of your blog. Unlike some other slideshow components, D13Slideshow makes use of the script.aculo.us and Prototype JavaScript frameworks.

Once added, your slideshow will animate through each of your chosen features providing an image, an extract and a link. Once all featured stories have been shown, the slideshow will pause and provide 'next' and 'back' buttons allowing visitors to cycle through them.

= Fixes, features and additions =

Version 1.0.2 includes some requested additions and a few bug fixes:

1. A failsafe image if you incorrectly set your custom fields
1. Removal of HTML from post extracts
1. Some fixes made to excessive DB calls in the admin pages
1. Better use of absolute blog path URLs
1. Options to cycle once, cycle continuously or cycle manually
1. Options to automatically promote your last 5 or 10 posts
1. Use of permalinks rather than GUIDs for featured story links
	
== Installation ==

1. Begin by downloading the plugin file using the link above.
1. Extract the files to your local machine.
1. Upload the whole d13gallery folder (including the folder itself) to your plugins directory - typically http://www.yourblog.com/wp-content/plugins/
1. Activate the plugin using your Wordpress admin pages.
1. Familiarise yourself with the documentation under 'options > d13slideshow'
1. Get cracking!

== Frequently Asked Questions ==

= How do I add my slideshow to my theme? =

Adding slideshows to your themes is incredibly easy and just requires one line of PHP code. You can introduce your slideshow as part of any of your theme files using the following code:

<?php d13slideshow(); ?>

Some of the key places you could add your slideshow include:

1. Your home page - add the code to index.php
1. In your sidebar - add the code to sidebar.php
1. In your header - add the code to header.php

= How do I choose which posts to feature? =

Your slideshows can feature up to 10 different posts or pages and these can be set using the 'Features' section of your d13slideshow options page. In your WordPress admin pages choose 'settings > d13slideshow' and use the select boxes to choose which posts to feature.

= How do I set up images for my featured posts? =

D13Slideshows use custom fields within your posts or pages to determine which images to use. Just set up a custom field with the key 'promoimage' and the value as an absolute URL for an uploaded image.

For example...

KEY: promoimage

VALUE: http://www.d13design.co.uk/images/promoimage/d13gallery.jpg

Just be sure that your promo images are the same size as the slideshow (set in your options page).

== Screenshots ==

1. An example of a d13slideshow.
2. An example of a d13slideshow (full).
3. The d13slideshow admin screen.
4. The d13slideshow help content.
5. An example of adding a custom field to a post.