This is an old revision of the document!
Table of Contents
xfortune Plugin
Compatible with DokuWiki
2009-12-25
This plugin is able to read datafiles used by the popular Unix tool fortune and to display a random one. It then replaces the displayed one every few seconds with a new one using an AJAX request.
Download
Download and install the plugin either manually or through the plugin manager using the download link given above.
Changes
Usage
Just reference a textfile with the correct format with the following syntax:
{{xfortune>namespace:cookiefile.txt}}
You may specify the interval for changing the cookie in seconds:
{{xfortune>namespace:cookiefile.txt?15}}
The default is 30 seconds.
Input files
The cookie file needs to be a text file 1) where each cookie is separated by a % char on it's own line. You need to upload those files through the mediamanager.
Here is an example:
% My first cookie % Another cookie with multiple lines % Third cookie %
Known Shortcomings
- If your input files are not in UTF-8 this plugin will assume they are in latin1 and tries to convert them to UTF-8. If you get any charset problems, make sure the file is valid UTF-8.
- Using compiled fortune cookies would probably be more effective
- It is implied above, but I think it is better to state it explicitly: at least for DW Lemming and the latest version of the plugin, the fortune file must have UNIX line endings (
LF
). Windows line endings won't do. — ryan.chappelle 2011/02/07 02:48