Bliki plugin

Description

This plugin is for use with wordpress in combination mediawiki and Ultimate Tag Warrior. Bliki is a plugin which looks if there are Ultimate Tag Warrior tags for a post that also appear as topics in a local installation of mediawiki. The found wikitopics can then be inserted in your post as a linked comma separated list.

Current Version: 0.9

Requirements

This plugin depends on Ultimate Tag Warrior to handle the tag management. First ultimate tag warrior should be activated and configured before the bliki plugin can be used. When a post is saved or changed, ultimate tag warrior will be called first to do stuff with the tags. Then the bliki plugin will use these tags and compare them to the wikitopics.

Compatibility

This plugin has been tested and works with:

• php 4 and php 5
• wordpress 1.5.2 and wordpress 2.x

Installation

Place the files in your plugin directory and activate the plugin. Go to wp-admin, manage, bliki and Install the database tables and default options. Go to wp-admin, options, bliki and verify the settings. Go back to wp-admin, manage, bliki and click 'Update Old Posts' if you want to fill the database.

Now place something like this in the part of your template which displays the post:

<?php 
   if(function_exists('bliki_showTagsForCurrentPost')) {
      $bliki = bliki_ShowTagsForCurrentPost();
      if($wikiwords != "") { echo "Blikilinks: ".$bliki; }
   }
?>

The output will be a comma separated list of linked wikitopics. If nothing is found nothing is returned.

Options: Configuration

Bliki Settings

• What is the full Url to the wiki index?
  Here you should fill in the url to reach your wiki.
• What is the prefix of the wikitables?
  Fill in the table prefix for the wiki here.
• What is the database name?
  It is assumed that the wikidatabase has the same username, password and host as the wordpress database. Leave this option blank if the wiki is in the same database as wordpress.

Cache Settings

It is possible that another weblog wants to link to your wiki as well. Most of the time you don't want to give those users an sql login. Therefore you can cache the list of wikitopics to a textfile which is reachable through the web.

• Make a cachefile of wikitopics so that others can use it to link to your wiki?
  When this is checked, everytime 'update old posts' is executed, the cache file is updated for remote retrieval.
• Where should this cache file be written to?
  This should be a loctation on your server (path from the root) that is also reachable through http. This file should be writable by the webserver.
• Use a cachefile of wikitopics instead of using a wiki in a local database?
  Use this if you want to use a remote cachefile (so from another website which has a commaseparated list of wikitopics available).
• What is the location of this cachefile?
  This should be a url.

Notes:

• You cannot use the two options at the same time.
• When you use a remote cachefile for the wiki to be linked to, the cachefile is localy stored for one day or until you click on 'update old posts'.

Manage

• Install
  installs the database tables. Also sets the defaultvalues if those haven't been set or changed yet.
• Update old posts
  When a wikitopic is added or removed we have inaccurate information in our (wordpress) database. Also, the bliki links in our post will not be accurate anymore. Therefor, when a wikitopic is added or removed, you will have to rescan all the post(tag)s.

Sites using the plugin

• http://www.denieuwereporter.nl - see the link 'Achtergronden:'

Code

The source code is the ultimate documentation

You can download the plugin here: bliki.zip.

To do / wishlist

• Other output possibilities (instead of only a comma separated linklist)
• Automatically link words in the post to the wiki (easy with php5, hard with php4)

Acknowledgements

• Loads of code of the Ultimate Tag Warrior plugin has been (re-)used. Thanks!
• denieuwereporter.nl for paying me to make this plugin
• wordpress for making a great blogging system and wp-plugins.net for spreading my work.

For comments and suggestions please mail me.