=== Google News Widget === Contributors: stefsoton Donate link: http://www.stefaniamarchisio.com/donations/ Tags: RSS, Atom, feed, XML, Google News, Googlenews, news, widget, shortcode Requires at least: 2.8 Tested up to: 2.9.2 Stable tag: 0.2 It shows news by Google given: localization, searchword(s) or topic and the number of news. It works as a widget or shortcode (in post/pages). == Description == With this plugin, you can display a list of the latest news (by Google News) given localization (country/language), search word(s) or topic and the number of latest news you want to show. The list look & feel is customizable too. It works as a widget or shortcode (in post/pages), so you can show your news in any widget-ready are of your wordpress blog or any post or page of your choice. == Installation == 1. Download this plugin from [Stefania's blog] (http://www.stefaniamarchisio.com/wp-content/uploads/2010/02/google-news-widget.zip), unzip it (you will have a directory with 2 files: the plugin php file and this readme.txt you are reading, upload it to the `/wp-content/plugins/` directory of your wordpress. OR 2. From Plugins->Installed of your wordpress administration, select "Add new", search for "google news widget" into the search text-box and select 'Install' when prompted with this plugin. 3. Activate the plugin through the Plugins-> Installed page into your WordPress administration page 4. See Usage below for instruction on how to use it. == Frequently Asked Questions == = Why the heck would I need/want it? = Well, it provides the latest news on any subject you want to choose in real time: can you imagine what boost of traffic can it bring to your blog? Let's pretend you write about volleyball, knitting or lactose-intolerance. You just need to enter the relevant words in the Keyword(s) field or select a topic and wait for google to display the latest news on your subject. = Hey, I cannot find any configuration page in 'Settings' How does it work? = As a widget, you drag and drop the widget to any widget-ready area of your theme, open the widget form, choose localization, key(s)/topic, list type, target and news number and click on 'Save' button. That's all. As a shortcode, you select the HTML view of your post/page form editor and == Screenshots == 1. Widget details. == Changelog == = 0.2 = * Fixed a bug which prevented to show news, if no search-word was defined * added topic, list and target parameters to the selected news * enabled a shortcode version (to add news to posts/pages) * updated readme.txt file * updated description in the php file (made consistent with readme.txt) * introduced donation page = 0.1 = * First release of google-news-widget == Upgrade Notice == = 0.2 = * if you want to avoid to enter a keyword or want to show news by-topic or in a post/page then download it. It also allows some list customizations. == Usage == As a widget: * Drag & Drop your widget in the widget-ready area; * Choose a title to be given to this news list; * Choose the location of the news you wish to display; * Select either the topic you need to cover or search word(s) (if you define both, the search keys will be ignored); * Select whether you want a dotted list (default) or a numbered/ordered list; * Select whether you want the linked news pages to open up in a new page (default) or in the same page; * Click on 'Save' (and Close, if you want). That's all. As a shortcode: * In Posts/Pages->Add New/Edit of your wp admin page, select HTML in the entry form; * enter [gnews location="xx"] where xx is any Google's location-code of the news you wish to display.A list of [Google's localization codes] (http://www.stefaniamarchisio.com/2010/02/21/google-news-localization-codes/) is here. That's the sole mandatory attribute. Optional attributes are: * search: search-words according to google search syntax (see the description above) (default: none); * topic: any of Google's topic-codes (default: Top Stories). Here is a [list of topic codes](http://www.stefaniamarchisio.com/2010/02/21/google-news-topic-codes/); * num: number of news to be displayed (default: 3); * list: either "UL" or "OL" to get unordered or ordered lists; * target: either "_blank" or "_self" to get links opened in new/the same windows. Example: [gnews location="es" topic="" search="sport" topic="e" num="8" list="UL" target="_self"] Please note the following Google quirks: 1. Not all topics are set for all country/language. If you select a topic for a country where this is not provided (as yet?) then the "Top stories" (the default) will be displayed instead. 2. Google (not me!) allows to search by topic OR by search-word(s). The two "filters" cannot apparently work together (i.e. you cannot search for "hockey" in topic "Sport"). 2. Because of the above, if topic AND search-keys are both indicated, then the search-keys are ignored (but no, no error message). 3. The search syntax is that indicated by Google. In other words, if in the search results: * all the words need to be present, then enter space-separated words (word1 word2 etc); * any of the words can be present, then enter words separated by OR (word1 OR word2); * the exact phrase needs to be present, then enter the phrase delimited by double quotes ("exact phrase"). 4. The maximum number of displayable articles depends on the number of articles stored into the XML page (RSS feed page) of Google news website (i.e. if you wish to display the latest 15 news and the XML page contains 10 news only, then only 10 will be displayed). == The Future == * Better error messaging; * Being able to display "excerpts" too; * Less-nerdy attributes values. == Interaction == * Would you like to see a new feature in this plugin? Please write me here: mywizardwebs@gmail.com; * Would you like to see a broken/orphan plugin working again? Write me anyhow, I might (hey, MIGHT not will/shall) find the time to give it a look.