=== Fortunate ===
Contributors: mickdakota
Donate link: http://www.redcross.org.au
Tags: fortune, random, quote, quotation, plugin, widget
Requires at least: 2.7
Tested up to: 2.7
Stable tag: 1.2

Fortunate provides a random quotation (fortune cookie). 

== Description ==

Fortunate displays a random quotation (fortune cookie) 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 

* specific database name or random choice based on language
* safe (default) or 'offensive' which may include sexual and off-colour content
* maximum length in bytes
* a specific number of text lines

Quotations are retrieved via the net from a fortune cookie database appliance (at http://fortunemod.com) so there is no local storage or database setup required. Over 100,000 quotations are currently provided in over 200 distinct databases including  English, Spanish, French, German, and Russian. The quotation language may be configured on the setup page.

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). 

== Screenshots ==

No screenshots available at this time.