Extension:FrequentPatternTagCloud

This extension provides a tag cloud based on Semantic MediaWiki properties which are defined in the manner Property::Value. FrequentPatternTagCloud supports all datatypes of properties except of the types "text" and "code". More detailed information about possible data types can be found in the list of datatypes. For every single property the extension shows similar property values computed by a frequent pattern mining algorithm. As a special case, the property category is supported, which is expressed in the slightly different syntax Category:Value. In addition these frequent patterns are integrated in the search functionality.



For further information also see the document below the topic References.

Download and Installation

 * 1) Please download the zip file via the link "Download snapshot" and extract it into your MediaWiki's extensions directory. Equally you can check out the source code from MediaWiki subversion.
 * 2) To install the extension, add the following to LocalSettings.php:
 * 3) Only for users with MediaWiki version <= 1.16: Activate jQuery (if not done already) via pasting the following code at the bottom of LocalSettings.php (see also JQuery).
 * 4) Initialize the database using update.php. If you already used an older version than revision r115462, you have to delete the database tables "fptc_associationrules" and "fptc_items" before the update.
 * 5) Login as admin user.
 * 6) Run the algorithm for the first time using the Special Page Special:FreqPatternTagCloudMaintenance.

Configuration Parameters
In order to configure your Frequent Pattern Tag Cloud, you may add the following to LocalSettings.php (the shown values represent the default values):

Settings concerning tag cloud appearance (all values are in pixels):

Settings concerning frequent pattern algorithm (all values are between 0.1 and 1):

The association rules (like X -> Y) are computed based on the two parameters. The support is the number of occurrences of the complete itemset (X and Y) normalized by the number of all pages. With this parameter you define a threshold above which an itemset is called frequent. The confidence describes the part of transactions that contain a searched itemset (here: Y), in the subset of all transactions that contain the defined itemset (here: X).

Setting concerning native wiki search:

For further information about the Configuration Parameters also see the document below the topic References.

In order to change the appearance of the search or the tag cloud, there are several CSS stylesheets in the following directory:

Usage
For the usage of the extension Frequent Pattern Tag Cloud the Extension Semantic MediaWiki is required. After installing the extensions you can go to page Special:FreqPatternTagCloud. Then you may enter a desired property‘s name of the wiki in the edit field and click the button “Submit”. After that you will get the tag cloud containing all existing values for the given property. When the property is not available in the wiki you can choose one of the suggested properties below the edit field. To search for similar property values just open the context menu (right click) of a tag in the tag cloud or use the standard search function on the left side. By typing the corresponding property value the extension will suggest similar values for the identified property. For maintenance reasons it is necessary to rerun the frequent pattern algorithm via Special:FreqPatternTagCloudMaintenance.

Embedding
The extension Frequent Pattern Tag Cloud supports embedding in other wiki pages using the following code:

We recommend providing the Frequent Pattern Tag Cloud with a property, i.e., replacing "property" in the code above with, e.g., "Author" or sth. This results in the embedded Frequent Pattern Tag Cloud of the specified property. Please note that the Frequent Pattern Tag Cloud omits the form for choosing a property if in embedded-mode and a property is given.

Version
All versions work with Media Wiki 1.15 (or higher) and Semantic MediaWiki 1.5.6. If you encounter any problems, please leave a comment on the dicussion page (or feel free to create your own fix).


 * tested with MW 1.21.0 and SMW 1.8.04: o.k.