History: Tags

• «
• »

            !Tags
{DIV(float=right,width="200px")}^::Related Topics::
*
*
*((dev:Administration|Bugs and Wishes))^{DIV}
;__Overview__: Freetags are the way to solicit content authors and/or users to create a taxonomy structure for your site. Unlike categories, which are pre-defined, Freetags give the authors freedom to define their own structure (or lack of structure - with Freetags you can have "Cars","Autos","Automobiles" as tags)
;__To access__: Click the __Tags__ icon {img src=pics/large/vcard.png alt="Tags"} on the ((Admin Panels|Admin Panel)) %%% or %%% Access __http://yourdomain.com/tiki-admin.php?page=freetags__ 
;__Tabs__: This page contains the following tabs:{toc}
;__Note__: ''Categories can be used to create a defined taxonomy structure and to provide access control.  Freetags can not be used to provide access control.''


;__Note__: ''The following information should be migrated to the Search section of the Tiki User and/or Admin Guides''
! Tags
This page is about Freetags, which is the [http://en.wikipedia.org/wiki/Folksonomy|folksonomy] implementation of TikiWiki. The name is based on the name of the underlying library from Gordon Luk: [http://www.getluky.net/freetag/].

Though similar in function to ((categories)), freetags work somewhat differently. Also, freetags should not be confused with backlinks-to-index style tags discussed further at ((How To Tag)).

::{img src="img/wiki_up/freetags_01.png" }::

Basically folksonomy tagging means/is based on:
* everybody can assign keywords to anything
* bottom-up instead of top-down categorization
* from chaos comes order
* emergent patterns are more powerful than imposition of categories

See: ((Multilingual tags))

!! What can I tag within Tiki?
You can currently tag:
* ((Wiki)) pages
* ((Blog)) posts
* ((Image gallery)) & individual images
* ((File gallery))
* ((Trackers)) & individual tracker items
* ((Quiz))
* ((Polls))
* ((Surveys))
* ((Directory))
* ((Faqs))
* ((Spreadsheet))
* ((Articles))

!! Modules
* ((Module freetag|freetag)) : that allows to add and remove tag from a current object
* ((Module freetags_current|freetags_current)) : that displays the current tags of an object. Only for a wiki page.
* ((Module freetags_prefered|freetags_prefered)) : Shows the favorite tags of a user. The number of tags is the value of the parameter rows defined at the module  assigment.
* ((Module freetags_most_popular|freetags_most_popular)): Shows the most popular tags. The number of tags is the value of the parameter rows defined at the module  assigment.
* ((Module freetags_morelikethis|freetags_morelikethis)): Shows the objects that have the same tags than an object. Only for a wiki page. The number of objects is the value of the parameter rows defined at the module  assignment.


!! User
When offered to do so (for instance, editing wiki pages), just enter your tags into the textfield separated by spaces.

^::{img src="img/wiki_up/freetags_user_00.png" }::^

You can browse the available tags by clicking on one, when seeing it somewhere. 

^::{img src="img/wiki_up/freetags_user_00b.png" }::^

It will take you to __tiki-browse_freetags.php__ with the tag centered in the morcego browser, if that feature is enabled.

^::{img src="img/wiki_up/freetags_user_01.png" }::^

The syntax of a tag is defined by the admin setting. Tags are separated by space(s). If you want to enter a tag with a space - if the admin setting allows it, you must enclose it into double quotes. Example: in the module freetag, if you enter: "computer science" ibm pc, you will add 3 tags "computer science", "ibm" and "pc"

^__Note about usage in features different than wiki pages__: 
For the moment, you can only use freetags in module - the module finds out for what object the freetag has been added looking at the url param.^

!! Admin
In order to go to the admin screen, use this url: __tiki-admin.php?page=freetags__

!!! Freetag Browsing
^::{img src="img/wiki_up/freetags_admin_01.png" }::^
* __Only accept alphanumeric ASCII freetags (no accents or special chars)__: If checked all non-alphabetical characters are withdrawn in the tag. Example: free_movie will become freemovie.
* __Or valid characters pattern__: It is possible if the previous box is not checked to explicitly tell what characters are not wiped off. Only alphanumeric freetags is the pattern a-zA-Z0-9. If you want to include space and _, the pattern can look like a-zA-Z _0-9. For more option [http://www.php.net/manual/en/reference.pcre.pattern.syntax.php]. The character double quote " can not be included in the pattern as it is the character to delimit tags with space.
* __Only accept lowercase freetags__ Each uppercase character are replaced by the lowercase character. Example: FreeMovie will become freemovie

!!! Tag Management
^::{img src="img/wiki_up/freetags_admin_02.png" }::^

!!! Freetag 3D Browser Configuration
There is an admin screen, which currently only accepts configuration of the morcego browser for browsing the freetags.

^::{img src="img/wiki_up/freetags_admin_03.png" }::^

To use the morcego 3D-Network-Browser, you'll have to activate the features:
* ((Morcego)) and
* ((Ajax))

!! Perms
* tiki_p_view_freetags: to view tags
* tiki_p_freetags_tag: to add tags

-=More information=-
* [http://en.wikipedia.org/wiki/Folksonomy]
* Some ideas about freetags display: [http://www.smashingmagazine.com/2007/11/07/tag-clouds-gallery-examples-and-good-practices/]


!!Alias
(alias(tag))
(alias(tagging))
(alias(freetag))
(alias(freetags))
(alias(free tag))
(alias(free tags))
(alias(Folksonomy))
(alias(label))
(alias(labels))