TagApplication

Tag Application

Tag pages with keywords and then navigate your wiki using these keywords. Also get RSS feeds on Tags to be notified when a new page is tagged with a specific keyword.

XWiki's tag feature lets you add keywords to your pages and retrieve all pages to which the keyword is associated. What is more, XWiki supports 2 different kinds of tagging: structured and unstructured tagging.

Unstrucured tagging is of the like of Del.icio.us: any user can freely enter tags he considers suits a given page better, whether those tags have already been used by others or not. Structured tagging resuires the definition of a primary set of tags amongst which users will be able to choose when willing to tag a page.

Tagging a page in unstructured mode

This is the tagging mode setup by default in a new XWiki instance. It is quite easy to add a tag to a page or a document, using the Tags field on the side of the page. This allows the creation of your own folksonomy on your XWiki through the use of tags.

Tagging a page in structured mode

To access this feature, it is first necessary to define the set of tags to be used on the wiki. To do so, you need to go to the http://<server>/xwiki/bin/view/XWiki/TagClass page, edit it in class edition mode and enter the tags you want to use in the "Values" field. You can separate the tags using the "|" symbol (recommended), but also with a space or a ",".

Once this is done, you can choose between 2 ways of displaying those tags on a page in edit mode.

Checkbox Display

To setup the Checkbox display, you need to select "checkbox" on the TagClass page. Once this is done, users will be able to assign a tag to a given page by ticking the relevant box.

Select Display

If you would rather use the Select display, you need to choose "select" on the TagClass page. THis way, users can select tags by clicking on them, selected tags for a page being shown highlighted in blue.

Accessing Tags

Once you have chosen to use one of the 2 tagging modes, you can get access to the list of tags and subscribe to them through RSS.

Retrieve a tag

Once a set of pages is tagged, you can retrieve them on the Tags Summary page of your wiki (http://<server>/xwiki/bin/view/Main/Tags). The page displays the list of all available tags.

View Pages For a Tag

Once you have selected (clicked on) a tag, you get the list of all pages tagged with the chosen keyword. What's more, you can even choose to get a RSS feed on a tag. Everytime someone adds the given tag to a page or changes a page tagged with the keyword, you will receive a notification. Find out more about RSS Feeds here.