My first Wordpress plugin is alive!!!
It is called WP-SimplestSlideShow, and it enables you to insert a simple jquery-based slideshow anywhere in your theme.
Description
WP-SimplestSlideShow is a simple slide show based on jQuery.
It enables the user to insert a simple slide show anywhere in their theme. The HTML markup is pretty bare with only the necessary tags to make it work. That gives the user flexibility to style it further, if one so desires. The functionality of the plugin is also very simple, but it requires a minimum amount of settings to work properly. If you complete all fields in the plugin options’ page with correct values, nothing will go wrong. Users will also have the option to choose if their images will have links or not.
What makes this plugin stand out of already released slide show plugins is that it implements and renders the slide show in a much simpler manner… It can be limiting for some, so I recommend WP-SimplestSlideShow only for those wanting to have an easy to administrate plugin with minimal HTML markup — that will validate as well!
WP-SimplestSlideShow was initially designed for a personal project, but after extensive testing I decided that it was stable enough to be released for the public.
Contributors: dreamyguy
Donate link: http://www.dreamyguy.com/wordpress/wp-simplest-slide-show
Tags: javascript, jquery, slideshow, sss
Requires at least: 2.8
Tested up to: 2.8
Stable tag: 1.0
Installation
- You may install the plugin by unzipping the file locally in your computer and uploading the folder “wp-sss” and all its contents to the “/wp-content/plugins/” folder in your server. You may as well browse to it in the plugins directory in wordpress.org and install it from your admin panel.
- Once you have done either of the two, install and activate the plugin here: “–your-site—/wp-admin/plugins.php”.
- Once the plugin is installed and activated, browse to your settings page here: “–your-site—/wp-admin/options-general.php”. Click on the link “Simplest Slide Show” (that will take you to this page: “–your-site—/wp-admin/options-general.php?page=wp-sss/wp-sss-options.php”
- Fill in the necessary fields. If you complete all fields correctly nothing will go wrong… Note that the plugin options page is quite straight forward and very well commented.
- Insert the following code in your theme: <?php if(function_exists(’wp_sss’)) { wp_sss(); } ?>
Observations:
- Dimensions for the slideshow must be defined after installation, otherwise you may not see the plugin in action.
- Remember to define all the default 6 images for the slideshow to work properly. If you only have 3 images, repeat them.
- If you choose to use links (by typing “1″ in the first field on the options page), you must define a “Link” to each image. A “Link” is also called an “URL”. The URL can be relative as well.
- ‘Link “title” text’ are not obligatory, but can improve accessibility and SEO.
Customization:
If you want to have less than / more than the 6 images (set by default) in your slide show, you will have to open “wp-sss.php” file (under the “/wp-content/plugins/wp-sss/” folder) and comment/uncomment the respective lines, which are already there. The plugin does not support more than 9 images in total.
If you want to tweak it to your needs, some HTML/CSS/PHP/jQuery knowledge may be required. WP-SimplestSlideShow is released “as is” and will work within its own limitations.
I’m not a full-time developer but will be available for support requests whenever my schedule allows.
Frequently Asked Questions
Where is the slideshow?
Please, spare me from this kind of question… Provide as much detail as possible if you want support.
Can I have more than one slideshow per page?
The short answer is no. The long answer is yes, but you would have to change the markup so the CSS calls a class (.) instead of an id (#), in all files except for “wp-sss-options.php”. However, there is no point in doing so because you would end up with two instances of the same slideshow with the same dimensions. Unless you are having a very odd page I don’t see why you would want to do that.
Can I have the slideshow inside a post?
I haven’t tested it, but I designed this slideshow to be put directly into the markup, outside the loop. In short, no.
I’m wondering about something else. Where can I find answers?
At the moment I’m providing support for this plugin on this page only, whenever my schedule allows. Please look at the comments for solutions to your problems. Note that this plugin is still very recent…
Screenshots
Coming soon…
Changelog
1.0
- The plugin is released on the 2nd June, 2009.
Cheers,
Wallace
Wallace Rodrigues 02.07.2009 at 7:22 pm
Just so it is said: I’ll provide support as my time allows. I’m always busy, but will be thrilled to hear your feedback.
Note as well that this plugin is in no way advanced, so feel welcome to tweak it to your needs.
Don’t forget to share the love and promote this post in your favorite bookmarking network. Diggs are most welcome!
Benjie 15.07.2009 at 6:38 pm
Please put a demo so that we can see what it looks like before we try it……
Wallace Rodrigues 20.07.2009 at 3:18 pm
Hi Benjie,
I’ll put a demo up soon, perhaps on this very page before the loop. I’m having some problems with my PC, hardware malfunctioning. I’m hoping to get it sorted asap, but until then I won’t be able to do much.
That’s the only reason why the plugin is not listed in the official plugin directory yet. I got access to the subversion and will be uploading it right after I get my machine back from service.