=== Fortunate === Contributors: mickdakota Donate link: http://mickdakota.com/wordpress-fortune-plugin Tags: fortune, random, quote, quotation, plugin, widget Requires at least: 2.7 Tested up to: 2.7 Stable tag: 1.3.3 Fortunate provides a random quotation (fortune cookie). == Description == Fortunate provides a hassle free random quotation on your blog. There are no databases to download or configure and you do not need to come up with your own witty sayings. It provides instant access to one of the largest collections of random quotes, witticisms, sayings, jokes and trivia on the net and displays one of them on your page. You may select where to display it. Currently supported are * Header - after or in place of the blog description * Footer * At the end of the page content (e.g. at the end of The Loop) * As a sidebar widget When configured as a widget, the title can also be set. A configuration page also allows for the selection of different quotations based on criteria such as * language - English, Spanish, Italian, French, German, and Russian are currently supported * safe (default) or 'offensive' which may include sexual and off-colour content * maximum length in bytes * maximum number of text lines * Those containing a specific word Fortunate is designed to silently fail in the event of network delays or congestion which prevent a quotation being promptly returned. Configurable timeouts are provided to display your blog pages in a reasonable amount of time (without Fortunate) even if the network is totally whacked. You get to choose what is 'reasonable'. Fortunate may work on WordPress releases prior to 2.7 but this has not been tested. == Installation == 1. Unzip the fortunate.zip archive in your `wp-content/plugins` directory or unzip on your desktop and upload the resultant `fortunate` folder and contents to your `wp-content/plugins` directory. 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Visit the Fortunate configuration page from the 'Settings' menu and make any desired changes. == Frequently Asked Questions == = Where should I display the quotations? = This is entirely up to you, however some page locations may interact in a negative way with your theme. The safest place to display is in a sidebar widget and should work with any widget enabled theme. The default location is at the end of the main loop, which should place the fortune at the bottom of the content region in your pages. If you use the header, the fortune will display beneath your blog description, assuming your theme provides the blog description. You should choose 1 as 'Specific number of text lines' in the options to avoid messing up your banner with long quotations. You may also use the page footer, but be aware that many themes place the footer content outside the themed region. In some cases you may need to change the included fortunate.css file to fit the results into your chosen theme (and also change the options to include the .css file). = Why don't I see any quotations? = It is quite possible to provide search parameters which do not match any quotations at all. Fortunate does not provide any error messages when there are no matching results. Check your settings to see if you may be too specific through use of a search term or quotation size. Fortunate works best without any specific search limitations. Also be aware that the adult/offensive ratings are currently only valid for English, Spanish, and Italian. For all other languages please use 'normal (no adult/offensive content)'. == Screenshots == No screenshots available at this time.