***********************************************************
     AJAX Scroller
     2.5 (28.05.2013)
     Module for Joomla Content Management System

     Copyright (C) Emir Sakic, 2008-2013.

     Developer: Emir Sakic - http://www.sakic.net
     First release: 15.12.2008
***********************************************************

AJAX Scroller is a Web 2.0 module for Joomla! that displays and scrolls your site's articles, banners, remote RSS feeds, Twitter updates, Virtuemart products or K2 items which are loaded dynamically using different animation effects.

The module is higly optimized, hundreds of articles can be displayed and scrolled without any additional load on your site. It uses AJAX technology to pre-load the next article in advance so it's ready for scrolling without delay. Once all articles are loaded the remote requests are automatically turned off. The whole process is performed without page refresh, quickly, smoothly and user friendly.

AJAX Scroller can be used to present newsflashes, testimonials, latest news, banners, RSS feeds, Twitter updates, web-shop products or any other content with autoplay or manual scroll. You can even duplicate the module and show different slideshows on same page.
It is simple to install and use yet powerful in terms of configurations.


Requirements
------------
AJAX Scroller is a module for Joomla! Content Management System. You will need either of those installed and running on your server.
Joomla! is available at http://www.joomla.org


Installation
------------
Install AJAX Scroller by uploading the mod_ajaxscroller.zip file to Modules Installer of your Joomla! administration.
After the installation you can publish the module and assign it to pages of your site that you want the module to appear on.


Parameters
----------
Configurations of the module parameters can be done as you edit the module.
The following parameter settings are available:

- "Type" - select the type of content you want to display. Available options are Content articles, Banners, RSS feed, Twitter updates and Virtuemart products.

- "Shown at once" - number of items displayed and scrolled at once.
- "Max number of items" - limits number of fetched items to this value.
- "Remember last item" - if set to Yes, on page refresh the scroller will start with last viewed item
- "Display title" - displays the article title.
- "Linked title" - links the title to the article.
- "Display date" - displays the article creation date.
- "Date format" - format of the displayed date according to PHP strftime() function.
- "Display text" - displays the article text.
- "Char limit" - limits articles length by number of characters.
- "Strip tags" - strips HTML tags from the article.
- "Display read more" - displays the "read more" link to the article.
- "Open in new window" - open links in new window
- "Display image" - display the article image.
- "Linked image" - link the displayed image.
- "Max image width" - resizes the leading image to this width.
- "Link attribute" - optional attribute to be added to links, (e.g. rel to open link in a lightbox).
- "Display page nr." - displays the slide page number.
- "Turn off AJAX" - display all items at page load instead of fetching them asynchronously. Use only when having a few items and only if you need JS like Auto-translate or Lightbox to work on all items.
- "Include Mootools" - if your template excludes Mootools library include it by setting this to Yes
- "JS for AJAX" - javascript code to execute after each completed AJAX call. Can be used to reinitialize lightbox.
- "Cache" - cache the feed file locally to increase the speed and reduce impact on remote server.
- "Cache time" - cache time in seconds. Use shorter time for Twitter updates. Optimal values: 3600 for RSS and 60 for Twitter.

- "Limit by category" - select categories which articles will be displayed.
- "Order" - the display order of the articles.
- "Text to display" - display article intro, full text or both.
- "With featured" - how to handle featured articles.

- "Limit by category" - select categories which banners will be displayed.
- "Limit by client" - select clients which banners will be displayed.
- "Order" - the display order of the banners.

- "RSS feed URL" - address of the RSS feed (example: http://www.sakic.net/rss/).
- "Filter by image" - display only feeds that contain images.

- "Twitter keys" - register at dev.twitter.com. Instructions here: http://www.sakic.net/news/ajax_scroller_ready_for_twitter_api_1.1/
- "Twitter timeline" - choose which kind of twitter listing you want to display (your own updates, updates from a specific list or search by a keyword).
- "Twitter username" - your Twitter username.
- "Twitter list" - show tweet timeline for members of this specified list name.
- "Twitter keyword" - keyword to pull the feeds by if search selected (e.g #joomla).
- "Display screen name" - display Twitter screen name.
- "Nr of Tweets" - how many tweets to pull from Twitter. Default 20, max. 200.

- "Virtuemart category" - select Virtuemart categories which products will be displayed.
- "Featured only" - show only featured products.
- "Products ordering" - how to order displayed products.

- "Scroll direction" - how the articles will be scrolled: vertical, horizontal and fade scroll is available.
- "Switch effect" - various animation effects to be applied on article switch: linear, expo, bounce, back and elastic are available.
- "Transition speed" - the speed of effect transition (slow, normal or fast).
- "Show navigation" - show prev / next navigation buttons.
- "Show loading image" - show loading image while AJAX is loading next article.
- "Auto play" - automatically scrolls the articles.
- "Show autoplay control" - if autoplay turned on show the play control button.
- "Pause between transitions" - pause between two transitions in auto play, in seconds.

- "Module Class Suffix" - optional suffix to be added for CSS styling.


Styling
-------
To change the module's width and height, its background, navigation buttons position and do other styling edit the file:
modules/mod_ajaxscroller/assets/css/style.css (Joomla 3 / 2.5 / 1.5)
modules/mod_ajaxscroller/style.css (Joomla 1.0)
If you run multiple instances of the module you can do individual styling by creating and uploading a css file with module ID:
modules/mod_ajaxscroller/assets/css/styleID.css (Joomla 3 / 2.5 / 1.5)
modules/mod_ajaxscroller/styleID.css (Joomla 1.0)
For example, if your module ID is 51 you would name the file create file "style51.css"
There is an example css file (styleID.css) included that you can edit for this purpose.


Navigation icons
----------------
You can change the navigation icons by simply replacing the png file: modules/mod_ajaxscroller/assets/images/navigation.png


Problems
--------
For questions and support please refer to the FAQ section at:
http://www.sakic.net/support/faq/
If you don't find the answer there you may send an email using the contact form at:
http://www.sakic.net/contact/
Any feedback is highly welcome too.


Visit http://www.sakic.net for more exciting Components and Modules for Joomla! CMS.

High quality Joomla! components by one of the original core developers of Joomla! and Mambo.

Testimonials
I tested half a dozen different modules and this one is by far the best. Also, the price is too low. ;P
Dimosthenis Chatzipanteliadis, medi-gene.gr


Subscribe to our RSS feed Follow us on Twitter