As a widget
- Drag & Drop your widget in the widget-ready area of your choice
- Choose a title to be given to your news list (optional)
- Tick off the box if you want your title to be linked to the correspondent feed URL (optional)
- Localize your news (language/country) (mandatory, default: us)
- If you live in the Usa or Canada (eng only), you might want to enter a city, state or zipcode of the news you want to display (optional)
- Select EITHER a topic OR search word(s) (because of Google rules, if you define both, the keyword(s) will be ignored) (optional)
- Tick off the box if you want a publication date, time, excerpt (and how many chars of it) or mention of this plugin author displayed or not (all optionals)
- Select whether you want a dotted list or a numbered/ordered list (mandatory, default: dotted list)
- Select whether you want the linked news to open up in a new page (default) or in the same page (mandatory, default: new page)
- Click on ‘Save’ (and Close, if you want it).
As a shortcode
- In Posts/Pages->Add New/Edit of your wp admin page, select HTML in the entry form
where xx is any Google’s location-code of the news you wish to display. Here is a list of Google’s localization codes.
That’s the sole mandatory attribute. Optional attributes are:
- title: title to be given to the chosen news
- link: either true or false to make the title linkable to the correspondent feed URL
- local: city, state/province or zipcode (of usa or Canada english news only)
- 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
- 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
- pubdate: either true or false to display the publication date/not
- pubtime: either true or false to display the publication time/not
- pubauthor: either true or false to display a link to the author/not.
Please also note the following Google quirks:
- 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.
- 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”).
- Because of the above, if topic AND search-keys are both indicated, then the search-keys are ignored (but no, no error message).
- 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 search syntax is that indicated by Google. In other words, in the search results, if:
- 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)
- words need to be excluded, then precede words with a minus or dash key (-word1 -word2)
- the exact phrase needs to be present, then enter the phrase delimited by double quotes (“exact phrase”).
Wonder if these nerdy posts are related to my job, well, the answer is no. As a good friend once told me, "one never heals from programming!". It must be true in my case....