=== Plugin Name ===
Contributors: Jean-François “Jeff” VIAL
Donate link: http://www.modulaweb.fr/blog/wp-plugins-en/
Tags: frontpage, slideshow, pictures, no-flash, css, javascript, XHTML,
Requires at least: 2.7.0
Tested up to: 2.8.5
Stable tag: 0.8

Frontpage Slideshow provides a slide show like you can see in linux.com front page

== Description ==

This plugin allows you to put a slideshow on your Wordpress front-page. like the one on linux.com

The slide is made of a clickable picture zone, some buttons with title and specific comment allowing to display a particular slide and a text zone to add a comment on slide.

pictures are pre-loaded and the default design is elegant and clean with a black background, transparencies ans rounded corners (except for IE).

Transitions are faded to add more eye-candy and sweetness.

By default, the only 4 latest slides are displayed, but you can modify that with admin page.

Via its administration page, you can tune up the look and feel of the slider

== Installation ==

1. Upload `frontpage-slideshow.zip` to the `/wp-content/plugins/` directory and uncompress it.
1. Go to the plugin's administration page and configure it as you want it
1. Activate the plugin when you are ready to

When installed : make sure you have read the <a href="../other_notes/">"how to use" section</a>

== Frequently Asked Questions ==

= How to use this plugin ? =

See the <a href="../other_notes/">"how to use" section</a>
 
= May I use more than one slideshow on my site ? =

Of course ! you just have to enable the shortcode way to display the slideshow then use as many shortcodes you want. See the <a href="../other_notes/">"how to use" section</a> for more infos.

= The plugin is messing up my Wordpress admin page ! What can I do ? =

The plugin just cant do that ! De-activate all plugins then re-activate them one by one and shoot the guilty !

= Another plugin or my theme is coded with feet and messes up with your plugin ! Could you help me ? =

I could give you some free advises but if you really want me to take precious time to debug your plugins or theme... consider to donate (I takes 45€/h)

= Hey ! Your plugin is messing up my beautiful website ! Can you fix it now ? =

This plugin uses the Wordpress API to include the javascript frameworks properly, so that this plugin does not cause problems if other plugins or themes you use are properly encoded. 

Otherwise, you got to troubleshoot by yourself (de-activate all plugins then re-active them one by one to determine if its the theme or a plugin, and wich plugin is messing up) then contact the guilty's author and ask him to use the Wordpress API to include javascript frameworks.

If you added those javascript files by yourself, consider having a look at the <a href="http://codex.wordpress.org/Function_Reference/wp_enqueue_script">wp_enqueue_script</a> function.

I could give you some free advises but if you really want me to take precious time to debug your plugins or theme... consider to donate (I takes 45€/h)

= I got a super idea ! I want you to implement it in your plugin ! Can you do it ? =

Yep ! Send me some interesting code and I will be pleased to add it to the plugin ! (and you could be co-author of the plugin!) but if you dont send code or if your demand is too far from my goals : I will not implement your suggestions.

If you really want me to implement some partcular features... consider to donate or hire me (You'll get invoice with VAT etc... I takes 45€/h)


== Changelog ==

* v 0.1 : very first release usable but no option page
* v 0.2 : some terrible graphic bugs fixed : option page under construction and preview
* v 0.3 : some minor javascript and CSS bugs fixed : now the plugin is ready for the option-page and fine tunes.
* v 0.4 : fully functional administration page with preview, reset to default
* v 0.5 : important bug fix when the plugin is loaded before jQuery and some CSS improvement
* v 0.6 : improving the loading of javascript frameworks needed, the shortcode functionality added, alternative picture option added, when no link is set, the URL of the post can be used
* v 0.6.1 : minor bug correction (replacing php short tags by long ones)
* v 0.7 : allow to use the WP Text Widget to display the slideshow by inserting the shortcode onto the text itself, modify the original WP Text Widget to allow the use of all other shortcodes
* v 0.7.1 : changes made on the admin page ; adding the plugins unique ID system to allow faster troubleshoot ; possibility to view the complete shortcode string
* v 0.7.2 : uses javascript to include specific css rather than plain html allowing to validate to XHTML
* v 0.7.3 : fixing bug introduced in 0.7.2 that was messing up the slideshow display in IE + XHTML validation improvements
* v 0.7.4 : fixing bugs introduced in 0.7.3 that causes no start of the slideshow sometimes + possibility to change slide transitions + order of slides + putting a different title on slides + option to hide the comment zone
* v 0.8 : Adding an admin zone to easily add or modify options for posts into the edit post page. + adding the complete shortcode under the preview + modifying the "How to use / Getting help section" + if no picture is available, display a default picture (a 1x1 transparent pixel GIF)

== Screenshots ==

1. live at http://wwww.modulaweb.fr French web agency
2. live at http://www.smartyweb.org

== How to use ==

There are 2 ways to use this plugin:

1. If you are using a static page as the front-page, use the front-page mode
      With this mode, the slideshow will be automatically added in top of the front-page content, before all other content. You don't have anything else to do.
1. If you are not using a static page as the front-page, use the shortcode mode
      With this mode, you got to put a shortcode (like [FrontpageSlideshow]) where you want the slideshow to be displayed :
	2. Somewhere into your posts content
	2. Somewhere into some sidebar text-box
	2. Everywhere else into the pages by inserting the following code snippet into your theme's .php files where you want the slideshow to be displayed:

`<?php
// added by <yourname> in order to add the slideshow using the frontpage-slideshow plugin 
echo do_shortcode('[FrontpageSlideshow]');
?>`

Note that this plugin is using the Wordpress API In order to include its needed Javascript files. Some other plugins or themes that are not using that API could mess up with this plugin.

= Creating different slideshows with different parameters: =

You can use different slideshows with different parameters easily ! Simply use the shortcode way to insert slideshows, save this options, then configure the slider, make a preview, copy the shortcode relulting of those parameters, and insert this shortcode everywhere you want a slideshow to be displayed ! You can create as many different slideshow as you got posts and pages into your blog. Remember that only the fist slideshow displayed on a page will work.

= In case of trouble: =

* Make sure you have read the "How to use": http://wordpress.org/extend/plugins/frontpage-slideshow/other_notes/
* Read this page: http://wordpress.org/support/topic/322689
* Look at the other support questions there: http://wordpress.org/tags/frontpage-slideshow
* If you want to post a support question, create a new topic by using this link: http://wordpress.org/tags/frontpage-slideshow#postform

= Plugin unique ID =

In order to faster bug reports, troubleshoot and for some statistics, some informations are collected and sent to this plugin:'s author.
The informations that are sent are this site URL, this site admin email address, the Wordpress version, the used theme and its URI, and the used version of this plugin.
If you need help to troubleshoot, don't forget to transmit your plugin unique ID.
You can find this plugin unique ID by visiting the plugin admin page at the very end of the "How to use / Getting help" section