# jQuery News Ticker

- jQuery News Ticker now has support for multiple tickers per page!
- jQuery News Ticker now has support for right-to-left languages!
- jQuery News Ticker now has support for loading content via an RSS feed!
- jQuery News Ticker now has an optional fade effect between items!
- New updates have been made to jQuery News Ticker! Check below for more details!
- jQuery News Ticker is now compatible with jQuery 1.3.2! See below for further details and for latest download.
- Further updates to jQuery News Ticker are coming soon!

### Ok, what else?

That's everything to get the news ticker working! If you get stuck have a look at the source of the example on this page to see what's what.

You'll probably want to dive into the CSS to change the visual style to your liking, but you're on your own with that one!

### Ok, that's great and everything but I want to fiddle with the settings...

Ok, so here are the settings that can be changed, shown with their default values:

    $(function () {
        $('#js-news').ticker(
            speed: 0.10,           // The speed of the reveal
            ajaxFeed: false,       // Populate jQuery News Ticker via a feed
            feedUrl: false,        // The URL of the feed
    	                       // MUST BE ON THE SAME DOMAIN AS THE TICKER
            feedType: 'xml',       // Currently only XML
            htmlFeed: true,        // Populate jQuery News Ticker via HTML
            debugMode: true,       // Show some helpful errors in the console or as alerts
      	                       // SHOULD BE SET TO FALSE FOR PRODUCTION SITES!
            controls: true,        // Whether or not to show the jQuery News Ticker controls
            titleText: 'Latest',   // To remove the title set this to an empty String
            displayType: 'reveal', // Animation type - current options are 'reveal' or 'fade'
            direction: 'ltr'       // Ticker direction - current options are 'ltr' or 'rtl'
            pauseOnItems: 2000,    // The pause on a news item before being replaced
            fadeInSpeed: 600,      // Speed of fade in animation
            fadeOutSpeed: 300      // Speed of fade out animation
        );
    });

### Woah, that made no sense, how do I use these settings?

Any changes you want to make to the default settings are passed in to the call of the news ticker, like so:

    <script type="text/javascript">
        $(function () {
            $('#js-news').ticker({
                speed: 0.10,
                htmlFeed: false,
                fadeInSpeed: 600,
                titleText: 'Latest News'
            });
        });
    </script>

### Which browsers does this work with?

So far this plugin had been tested as working with: IE6+, FF 3.6+, Chrome, Safari, Safari Mobile and Opera.

If you do find any bugs, or any further browser compatibility, head over to GitHub and let me know.

### What license is this released under?

GPL v2 - read more here: http://www.gnu.org/licenses/gpl-2.0.html

## What about loading content from a feed?!

Yeah, well the population of news items will be from HTML only for now I'm afraid...

You're in luck! The latest update to jQuery News Ticker introduced support for loading content of an RSS feed via ajax!

The basic code you want for using an RSS feed is something like:

    <script type="text/javascript">
        $(function () {
            $('#js-news').ticker({
                htmlFeed: false,
                ajaxFeed: true,
                feedUrl: 'PUT THE URL OF THE RSS FEED HERE - e.g. http://example.com/rss.xml',
                feedType: 'xml'
            });
        });
    </script>

What should the XML look like? The standard RSS format found here will work just fine.

It's worth noting at this point that the RSS feed must be on the same domain that the news ticker as jQuery does not allow cross-domain requests.

If you want to use a feed from a different domain you'll need to either implement a server-side solution or use something like a JSON proxy.

Further support for loading new items from different feed sources will be coming in a future release, so stay tuned!