﻿=== WP TennisNews ===
Contributors: Hartl
Donate link: 
Tags: widget, rss, feed, feeds, sidebar, widgets, atom, xml, rss2, news, sport, sports, tennis, related, posts
Requires at least: 2.0
Tested up to: 2.7.1


Extends the default Wordpress RSS Import Widget for implenting the latest Tennis news from [Tennis Weblog](http://www.tennis-weblog.de/) with user-friendly customization options.


== Description ==

This Widget Plugin enables you to display [Tennis Weblog](http://www.tennis-weblog.de/) News on your WordPress website without knowing anything about the format of the feeds.
Just activate and optionally customize its appearance as you like inside the boundaries of the presentation options. If there are no news or there would be a problem with the feed, the widget shows nothing in the frontend so your website don't get broken then.

* You can set an optional individual title (heading).
* You can set how many items were shown.

It is an adaption of the RSS Import Plugin by [Frank Bueltge](http://bueltge.de/) and the KB Advanced RSS Widget by [Adam R. Brown](http://adambrown.info/).

== Installation ==

You MUST be using a widgets-enabled theme. If you are using pre-2.2 WordPress, you'll also need the [sidebar widgets plugin](http://wordpress.org/extend/plugins/widgets/).

1. Upload the folder `wp-tennisnews` to either `/wp-content/plugins/widgets/` or `/wp-content/plugins/`.
1. Activate the widget through the 'Plugins' menu in WordPress.
1. Add the new Tennis Weblog widget to your sidebar through the 'Design => Widgets' menu in WordPress.
1. Got to 'Options' menu and optionally configure the plugin.

The design is automatically given by your theme CSS design but can be individualised.

More on the [Tennis News widget website](http://www.tennis-weblog.de/widget/ "WP TennisNews Widget").


== Screenshots ==
http://www.tennis-weblog.de/wp-content/tennisnews-w0.jpg
http://www.tennis-weblog.de/wp-content/tennisnews-w1.jpg
http://www.tennis-weblog.de/wp-content/tennisnews-w3.jpg
1. Have a look at the [Tennis News widget website](http://www.tennis-weblog.de/widget/ "WP TennisNews Widget").



== Frequently Asked Questions ==

= What code do I need to place in my sidebar? =

None. This is a widget. If you are using pre-WP v2.2, you need to have the [widgets plugin](http://wordpress.org/extend/plugins/widgets/) running. No matter what version of WP you're using, you need to be using a widgets-enabled theme.

= The feeds don't update =

They update only once per hour (as coded in `wordpress/includes/rss.php`). If they don't update after more than a couple hours, look in the top of `wp-tennisnews.php` for this line:

`define('SGRSS_FORCECACHE', false);`

and change it to true. This will manually delete the cache if it's more than 1 hour old. In newer versions of Wordpress, manually deleting the cache in this manner might cause a small error next time you load the page. Just reload the page.

= I add the widget to my sidebar, but it doesn't show up =

In the widget's options, make sure the option to hide the widget when the feed is down is **not** checked. Go back to your website and reload.

= The feed is probably down =

This widget relies on Wordpress's feed parsing abilities (look in `wordpress/includes/rss.php`). Wordpress grabs the requested feed then passes it to this widget for formatting. If you are seeing this error, it means one of three things:

1. The feed really is down. Wait a while and try again.
1. Your host is blocking Wordpress from fetching the feed (very likely). [Read more here](http://wordpress.org/support/topic/120458?replies=24#post-602781).
1. Wordpress's feed parser isn't working. Try updating to the most recent version of Wordpress.
1. Some users of this widget have suggested additional solutions to this problem. Check out the comments on [this blog post](http://adambrown.info/b/widgets/2007/08/20/an-error-has-occured-the-feed-is-probably-down/).

In any case, you may want to first try using Wordpress's built-in RSS widget. If neither it nor this widget can display the feed, then you know for certain that it's one of those three reasons--and not the widget itself--causing the failure.


