This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



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 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 2.2.0 includes changes to support the requests from users:

  1. Better selection of featured images, not just custom fields
  2. Better resizing and positioning of featured images

Version 2.0.0 includes numerous feature requests and general fixes:

  1. The ability to select posts by dropdown or text entry
  2. Improved HTML and CSS
  3. Improved support for Internet Explorer (if you can test in IE6 or IE8 then let me know!)
  4. Improved embedding of Javascript libraries
  5. Refined admin screens
  6. Customisable CSS
  7. Use post excerpts if available
  8. Feature sticky posts
  9. Feature posts from a specified category (thanks to Jordan at
  10. Override system settings and specify posts to feature when adding the PHP code

Version 1.1.0 includes some long overdue features, primarily:

  1. Automatic inclusion of the Scriptaculous and Prototype javascript files
  2. Optional include files (d13slideshow.php lines 118 and 119) for choosing posts by dropdown or text field – fixes the “non-loading admin page” bug when you have lots of posts

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

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


  • An example of a d13slideshow.
  • An example of a d13slideshow (full).
  • The d13slideshow admin screen.
  • The d13slideshow help content.
  • An example of adding custom fields to a post.


  1. Begin by downloading the plugin file using the link above.
  2. Extract the files to your local machine.
  3. Edit lines 15 and 16 of “d13slideshow.php” to determine how posts will be selected
  4. Upload the whole d13slideshow folder (including the folder itself) to your plugins directory (typically
  5. Activate the plugin using your WordPress admin pages.
  6. Familiarise yourself with the documentation under settings > d13slideshow’
  7. Get cracking!


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
  2. In your sidebar – add the code to sidebar.php
  3. 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


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

How do I link to external sites from my slides?

As of version 2.0.0 external links can be supplied for the slideshow to use rather than the permalink of the featured post. These external links are added using an extra custom field.

For example:

KEY: promourl


How do I define a specific playlist each time I use the d13slideshow() command?

As of version 2.0.0 you can add additional arguments when you embed the slideshow command within your theme. If, for example, you want your homepage slidehow to run on your admin settings, feature posts 3, 7 and 9 on your pages and posts 5, 19 and 22 on single post pages you could add:

<?php d13slideshow(); ?> to index.php,

<?php d13slideshow( array(3,7,9) ); ?> to page.php and

<?php d13slideshow( array(5,19,22) ); ?> to single.php.

How do I add the Scriptaculous Javascript to my theme?

As of plugin version 1.1.0 you no longer need to do this manually. WordPress comes with these Javascript libraries and the plugin now adds these to your theme automatically.

The admin page never fully loads – how do I use the plugin?

This is generally an issue for blogs with a lot of posts. The admin screen loads all of your posts into a dropdown list for you to select them from, if you have lots of posts then the database connection times out and the page never loads.

Version 2.0.0 of the plugin contains 2 options for selecting posts – dropdown lists and text entry for manually adding post or page IDs.

On lines 15 and 16 of d13slideshow.php you’ll find 2 statements, just comment out the one you don’t want to use.

Contributors & Developers

“d13slideshow” is open source software. The following people have contributed to this plugin.


Translate “d13slideshow” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.