This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

FortuneKookie Widget

Description

This WordPress plugin adds a sidebar widget to display a random fortune cookie fortune. The database hosted on FortuneKookie.com has over 1500 unique fortunes and each fortune includes the front message, the back word(s), and the lucky numbers.

In addition to the sidebar widget, random fortunes may also be displayed on your posts or pages using a shortcode.

PLEASE NOTE: You will need to register for your security code on http://wordpress.fortunekookie.com/#register Simply enter your email address and the code will be sent to you.

Features

  • Displays a random fortune cookie fortune on your sidebar from a database hosted on FortuneKookie.com.
  • Ability to show or hide the back word(s).
  • Ability to show or hide the lucky numbers.
  • View the fortune via a special fortune cookie graphic.
  • Display a random fortune cookie fortune from any Post or any Page.

Shortcode Catalog

[fortunekookie|random=1] – Displays a random fortune including the back word(s) and lucky numbers
[fortunekookie|random=2] – Displays a random fortune including the lucky numbers
[fortunekookie|random=3] – Displays a random fortune including the back word(s)
[fortunekookie|random=4] – Displays only the front of a random fortune

Resources

  • Homepage for this plugin: http://wordpress.fortunekookie.com/
  • Documentation: http://wordpress.fortunekookie.com/
  • Register for security code: http://wordpress.fortunekookie.com/#register

Screenshots

  • Fully Installed FortuneKookie widget - All options
  • Fully Installed FortuneKookie widget - Minimum options
  • Graphic version of the fortune cookie via cookie message link
  • View of the configuration screen

Installation

In order to complete the setup of this widget you must register for your security code on http://wordpress.fortunekookie.com/#register NOTE: Once you receive the email with the code, you must confirm the code by either clicking on the link or copying/pasting the URL into your browser.

  1. Upload the fortunekookie folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Enable the Widget through the Appearance –> Widgets menu (drag your Widget to the location you want it on your widget list)
  4. Copy and paste your FortuneKookie 32-digit code that you received when you registered on http://wordpress.fortunekookie.com
  5. Change any other configuration settings here such as Title or Display (Show back of fortune and/or show lucky numbers)
  6. Click “Save”

Congratulations! Your FortuneKookie widget is now working!

If you would like to see a random fortune cookie message on one of your Pages or one of your Posts, place this shortcode anywhere: [fortunekookie|random=2]

FortuneKookie may work on WordPress releases prior to 2.7 but this has not been tested.

FAQ

What does this widget do?

This widget interfaces with FortuneKookie.com and pulls a random fortune cookie message from its database. Then, displays the fortune on your sidebar of your blog.

Can I display more than one fortune at a time?

Not with this version of the widget. However, in addition to the sidebar widget, you can also get a random fortune message in a Post or a Page

How can I get a fortune cookie fortune in one of my posts?

Add this shortcode anywhere you’d like to see the fortune cookie fortune: [fortunekookie|random=2]

What is the security code?

This code allows the FortuneKookie servers to track the source of the API call. Please register for your security code on http://wordpress.fortunekookie.com/#register by simply using your e-mail address. The generic 32-digit security code does not functions.

What is FortuneKookie.com?

This is a site where one can save and share fortune cookie fortunes. The pool of fortunes that supply this plugin are not generated by FortuneKookie users, but only by the FortuneKookie Crew.

Contributors & Developers

“FortuneKookie Widget” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.1.0

  • Fixed bug with the configuration screen

1.0.0.0

  • Added ability to view a random fortune cookie fortune from a Post or a Page using this shortcode: [fortunekookie|random=2]
  • Optimized the code for faster load times

0.9.4.0

  • Generic security code no longer functions. Register on http://wordpress.fortunekookie.com/#register by simply using your e-mail address to request your own 32-digit security code.
  • Added additional error codes to the FortuneKookie server

0.9.3.1

  • Fixed another spelling error in the readme.txt file

0.9.3.0

  • Enhancements to back-end API call to allow for graphic display of fortune cookie
  • View fortune with cool fortune cookie background via clicking on the cookie message link
  • Added option to show / hide this fortune cookie message link

0.9.2.0

  • Description appears when viewing FortuneKookie widget in the “Available Widgets” screen
  • Completed the security code registration screens (available here: http://wordpress.fortunekookie.com/)
  • Streamlined code snippet, should be a bit more efficient
  • Started to Internationalize the screen text

0.9.1.1

  • Grammar fix in the readme.txt file

0.9.1.0

  • Added option to show / hide the “Powered by: FortuneKookie” link
  • Added option to show / hide the FortuneKookie.com logo

0.9.0.0

  • Support to toggle show / hide of fortune cookie back of message
  • Support to toggle show / hide of fortune cookie lucky numbers