Displays news items from selectable CNN News RSS feeds, inline, as a widget or in a theme. Multiple feeds allowed. Caching.
This plugin works both as a widget, as inline content replacement and can be called from themes. Any number of inline replacements or theme calls allowed, but only one widget instance is supported in this release.
For widget use, simply use the widget as any other after selecting which feed it should display. For inline content replacement, insert the one or more of the following strings in your content and they will be replaced by the relevant news feed. For theme use, add the do_action function call described below.
<!--cnn-news-->for the default feed
Shortcodes can be used if you have WordPress 2.5 or above, in which case these replacement methods are also available.
[cnn-news]for the default feed
Calling the plugin from a theme is done with the WP do_action() system. This will degrade gracefully and not produce errors or output if plugin is disabled or removed.
<?php do_action('cnn_news'); ?>for the default feed
<?php do_action('cnn_news', 'feedname'); ?>
Enable plugin, go to the CNN News page under Dashboard->Settings and read the initial information. Then go to the CNN News page under Dashboard->Manage and configure one or more feeds. Then use a widget or insert relevant strings in your content or theme.
The available options are as follows.
Name: Optional feed name, that can be used in the widget or the inline replacement string to reference a specific feed. Any feed without a name is considered "default" and will be used if the replacement strings do not reference a specific feed. If there are more than one feed with the same name, a random of these is picked every time it is used. This also applies to the default feed(s).
Title: Optional, which when set will be used in the widget title or as a header above the news items when inline. If the title is empty, then a default title of "CNN News : <region> : <feed type>" is used. Note that as per CNN Terms of Service it is a requirement to state that the news come from CNN.
Feed: A dropdown list of the current feeds provided by CNN. This list is hard coded into the plugin, presumably CNN does not change the list too often. The [INTL], [MONEY] and [SI] after the feed name indicate that the feed is from CNN International, CNN Money or Sports Illustrated respectively.
News item length: Short or long. The short version is really just the news item title as a one liner but probably the one most WP admins will use. The long version is the title followed by a 3-4 line teaser. For the short version, the long text is available as a mouse rollover/tooltip.
Max items to show: As the title says, if the feed has sufficient entries to fulfil the request.
Cache time: The feeds are now fetched using WordPress builtin MagpieRSS system, which allows for caching of feeds a specific number of seconds. Cached feeds are stored in the backend database.
If you want to change the look&feel, the inline table is wrapped in a div with the id "cnn-news-inline" and the widget is wrapped in an li with id "cnn-news". Let me know if you need more to properly skin it.
Note that if you get the message "CNN News unavailable" then the WordPress internal RSS feed fetcher failed to get the feed. Reasons for this are firewalls blocking outbound traffic, CNN RSS being down or feed missing/wrong URL. Try again with a different feed to see if that helps.