// $Id: README.txt

DESCRIPTION
-----------
This module provides the following features
* ajax based slideshow utilizing jquery transtion effects.
* node-based control on the contents of each slide.
* view-based control on the slides set (filtering) and the slides order (sorting).
* Optional tabs - enabling tab per slide (labels as node title or enumeration).
* Optional navigation buttons (previous / next).
* 4 different transition effects to choose from.
* Best performance - using ajax to load the slides gradually.
* preloader option to ensure smooth slides transitions.
* block enbabled and page enabled setups.


INSTALLATION
------------
- Place entire ajaxs_slideshow folder in the Drupal modules directory, or relevant site module directory.
- Enable the module inside the modules page using the admin account.
At this point your slideshow is already operational. under the path <www.my-domain.com>/slideshow-front you can view the slideshow. 
Initially it consists of all published nodes within your site.

To further control the slideshow do the following:  
- Under the views area, you will find a new view named ajax_slideshow_view. To better control the filtering and sorting of your slideshow use this view.
Do not change any other data element accept of the filters and sorting. 
- Open the ajax_slideshow admin page and adjust the slideshow by changing the settings as required.
- optionally use the ajax slideshow block available at the blocks admin page.


THEMEING
--------
Changing the slideshow layout can be done by implementing the following theme function: theme_ajax_slideshow()
As with any other theme function overide - implement the above function at your theme level optionally using the contents of the original function.


IMPORTANT NOTE
--------------
At this stage, the module does not support having more than one ajax slideshow on a page. Please ensure the slideshow exclusiveness when using the ajax slideshow block.


UPGRADE V1.X TO V2.X
--------------------
V2.x of the ajax slideshow is a complete rewrite of the module using the jquery_plugin module. However upgrade should be fairly straight forward.
1. Copy the new version of the module over the old one 
2. Empty the drupal's cache 
3. Empty the views cache
Your existing slideshow should be up and running.


EXTENSIBLE EFFECTS
------------------
It is possible to add your own js effects to the slideshow. Please check the addEffects function at ajax_slideshow.js to learn how to do that.


CREDIT
------
Ajax Slideshow V2.x is making intensive use of the JQuery Tools foundation http://flowplayer.org/tools/index.html
It makes use of the library provided, reuses html,css and js code and offers sample navigation buttons image provided by the Jquery Tools foundation.
Special thanks to the JQuery Tools foundation.



For any questions / comments please contact us at contact@dofinity.com

enjoy.   