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)

In addition to Tiki's Freetag system, Tiki also integrates with Cypht, which uses a tag/label system for organizing emails and other content. You can explore more about Cypht’s features, including its tagging system, on the official Cypht Features page: [https://www.cypht.org/features.html].

;__To access__: Click the __Tags__ icon {icon name="admin_freetags" size="2" title="Image may vary depending on icon set in use."} on the ((Admin Panels|Admin Panel)) %%% or Access __http://example.org/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 Freetags 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 ((Documentation Status)).

::{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
** ((Tags Tracker Field))
* ((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.^

^__Note about usage in forums__: 
If you wish to remove a tag attributed to a forum thread, you will need to open the 1st post of the thread. (Tiki 12.2)^

!! Improving search results for tags
See:
https://doc.tiki.org/Search+General+Settings#Tips

-=More information=-
* [http://en.wikipedia.org/wiki/Folksonomy]
* Some ideas about freetags display: [https://www.smashingmagazine.com/2007/11/tag-clouds-gallery-examples-and-good-practices-2/]
~tc~previous link (404): [http://www.smashingmagazine.com/2007/11/07/tag-clouds-gallery-examples-and-good-practices/]~/tc~

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