TagsPlugin

Full strength Tagging system

Usage

TagsPlugin allows users to tag resources of differing types - and so the TML used to access the tags specifies this information too.

TagsPluginViews defines the common Tag widgets that can be re-used via Sectional includes.

Tag Filters

step 1: add ?tagfilter=Tag,More+Tags will thus use that filter instead of the web as a context??

There are session settable 'Filters' that will reduce the set of topics in a similar way to 'Webs' - they are session based - at least until I can work out howto save a filter to a Name, that can be used as a Pseudo-Web.

TAGLIST

Lists the tags for the requested resource

TAGENTRY

allows users to add, remove and manipulate tags for a resource

TAGCLOUD

WebTwoyGoodness.

SEARCHing

To search for topics that are tagged with (or not tagged with), use a QuerySearch with the taggedwith(tagname) operator

Examples

list of all user's tags on the current topic

%TAGLIST{show="user"}%

edit (the current user's) the tags on the current topic

%TAGENTRY%

tag cloud of all user's tags on the current topic

%TAGCLOUD%

Installation Instructions

1. set {DbiContrib}{DBI_dsn}, {DbiContrib}{DBI_username} and {DbiContrib}{DBI_password}
   • currently only tested using MySQL - dbi:mysql:example_com_tags:localhost
2. create the database in MySQL server and add the user with permission to create tables
3. initialise the tag database and to tag each topic with the webname it is in, goto
   • http://translate.foswiki.org/bin/rest/TagsPlugin/initialiseDatabase

to automatically add a tag entry to each topic, add tagsplugin to your skin path

eg Set SKIN=tagsplugin,pattern

If you want to preload the tags database with Country Names, you need to install CPAN:Geo::GeoNames and click http://translate.foswiki.org/bin/rest/TagsPlugin/updateGeoTags

• uses the CC licenced http://www.geonames.org (http://download.geonames.org/export/dump/allCountries.zip)

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Plugin Info

This Plugin uses DbiContrib to store the tagmap in a database for fast querying.

Schema & design inspired from MySQL Forge, but treating Tags as Items, so that you can tag a tag (creating a heirarchy of tags)

Plugin Author(s):	Foswiki:Main.SvenDowideit
Copyright:	© SvenDowideit@fosiki.com
License:	GPL (Gnu General Public License 3)
Plugin Version:	$Rev$
Change History:
Dependencies:	Name Version Description Geo::GeoNames Optional Foswiki::Contrib::DbiContrib Required
Plugin Home:	http://foswiki.org/Extensions/TagsPlugin

Related Topics: InstalledPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, SitePreferences

• Intranet Applications for Tagging and Folksonomies