Tag-me Plugin<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/TagMePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/TagMePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> IntroductionThe larger a wiki gets, the harder it is to find content. This wiki tagging plugin attempts to solve the issue based on these assumptions:
User InterfaceTag List on TopicEvery topic has a list showing all tags associated with the topic. Additional tags can be added to the topic, and new tags can be created.Default "twiki" styleScreenshot of tags shown on a topic: You see:
"blog" styleBut the same control can have a different look and feel if we specifystyle="blog" . In view mode it has a terse apperance:
But, if you click on Tags, and that you have an account and can edit tags, you
will see:
Create, Rename, Delete tagsCreate New TagsGo to TWiki.TagMeCreateNewTag to create new tags.Anyone is allowed to create new tags. For developers: Add Tag to TopicOnce a new tag is created, it can be added in the tag list of the topic.Rename TagsGo to TWiki.TagMeRenameTag to rename existing tags.Rename permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: Delete TagsGo to TWiki.TagMeDeleteTag to delete existing tags.Delete permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: List All TagsTWiki.TagMeViewAllTags shows all tags used in the system. The font size indicates the overall tag count of a tag. Screenshot of tag cloud in the list all tags view:<div class="tagmeTagCloud" style="line-height:2em;"> %TAGME{ tpaction="showalltags" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\" style=\"font-size:$size%\">$tag</a>" separator=" " minsize="94" maxsize="220"}% </div> List My TagsTWiki.TagMeViewMyTags shows all tags used by logged-in user. The font size indicates the overall tag count of a tag.Tag SearchTWiki.TagMeSearch shows a list of topics that are tagged with all of the selected tags, sorted by relevance. Topics with a high tag count are shown first.Plugin VariableThe Plugin handles a%TAGME{}% variable that performs different actions. The tpaction="" is a required parameter.
How to put tags on every pageTo show the tag interface at the top of the page directly below the breadcrumb (like on twiki.org), use the default templateview.tagme.tmpl in the templates directory.
This template is in fact a 'skin' template. To enable it, write in Main.TWikiPreferences:
* Set SKIN = tagme,patternThe list of skins can be appended, for instance: tagme,corporate,pattern .
For the "blog" style, use for a simple "Tags: list-of-tags (edit)" at the top
of the page:
* Set SKIN = tagme_styleblog,patternAnd for an alternate style, with no tags line shown if no tags exists, and the button to open the tag edit frame placed at the right of the Edit and Attach ones, in the same style, on the upper right: * Set SKIN = tagme_styleblogbutton,pattern
For TWiki 4.1, use:
* Set SKIN = tagme04x01,pattern Customizing the appearanceIf you customize your site you probably want to change overall appearance. You can find instructions how to do that - at least for default pattern skin - in TWiki.PatternSkinCssCookbook.The short summary is:
Other places for the tag interfaceTo show the tags in the top bar, edit TWiki.WebTopBar and copy:<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>To show the tags at the bottom of every page, write in Main.TWikiPreferences: * Set WEBCOPYRIGHT = Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] %BR% Copyright © 1999-%GMTIME{"$year"}% by... etc Show tags without vote buttonsTo just show the tags for a topic, without buttons or "Create new tag" link, use ashowalltags search:
Tags: %TAGME{ tpaction="showalltags" web="%WEB%" topic="%TOPIC%" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\">$tag</a> " }% Tag stylesCSS StylesTagMePlugin writes the following CSS styles:
Search results CSS Styles
Preventing link wrapIf users are allowed to use spaces in their tag names (whenNORMALIZE_TAG_INPUT is set to 0), tag links may break halfway to the next line. To prevent wrapping, add a wrapper div around the tags:
<div class="tagmeTagCloud"> %TAGME{ ... }% </div>This CSS style is included in tagme.css :
.tagmeTagCloud a { white-space:nowrap; } Example styles used on twiki.orgTo show the 'tags shown on a topic':<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>CSS styles: .tagmetags select { font-size:.8em; margin:0 .25em; } .tagmetags a { text-decoration:none; white-space:nowrap; } .tagmetags a:link, .tagmetags a:visited { color:#8E9195; /* all links are gray; for blue links use: #06c */ text-decoration:none; } .tagmetags a:hover { color:#FBF7E8; } .tagMeControl { color:#8E9195; /* gray for non-links */ } Plugin SettingsPlugin settings are stored as preferences variables. To reference a plugin setting write%<plugin>_<setting>% , e.g., %TAGMEPLUGIN_SHORTDESCRIPTION% .
NOTE: Do not change the settings here, overload them in the Main.TWikiPreferences. Prefix a setting with TAGMEPLUGIN_ , e.g. to overload NORMALIZE_TAG_INPUT define a TAGMEPLUGIN_NORMALIZE_TAG_INPUT setting in the Main.TWikiPreferences.
Plugin Installation InstructionsNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.
Limitations
Plugin Info | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Added: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Tag-me Plugin<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/TagMePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/TagMePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Plugin to tag wiki content collectively in order to find content by tags and to get a meaningful page ranking.
IntroductionThe larger a wiki gets, the harder it is to find content. This wiki tagging plugin attempts to solve the issue based on these assumptions:
User InterfaceTag List on TopicEvery topic has a list showing all tags associated with the topic. Additional tags can be added to the topic, and new tags can be created.Default "twiki" styleScreenshot of tags shown on a topic: You see:
"blog" styleBut the same control can have a different look and feel if we specifystyle="blog" . In view mode it has a terse apperance:
But, if you click on Tags, and that you have an account and can edit tags, you
will see:
Create, Rename, Delete tagsCreate New TagsGo to TWiki.TagMeCreateNewTag to create new tags.Anyone is allowed to create new tags. For developers: Add Tag to TopicOnce a new tag is created, it can be added in the tag list of the topic.Rename TagsGo to TWiki.TagMeRenameTag to rename existing tags.Rename permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: Delete TagsGo to TWiki.TagMeDeleteTag to delete existing tags.Delete permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: List All TagsTWiki.TagMeViewAllTags shows all tags used in the system. The font size indicates the overall tag count of a tag. Screenshot of tag cloud in the list all tags view:<div class="tagmeTagCloud" style="line-height:2em;"> %TAGME{ tpaction="showalltags" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\" style=\"font-size:$size%\">$tag</a>" separator=" " minsize="94" maxsize="220"}% </div> List My TagsTWiki.TagMeViewMyTags shows all tags used by logged-in user. The font size indicates the overall tag count of a tag.Tag SearchTWiki.TagMeSearch shows a list of topics that are tagged with all of the selected tags, sorted by relevance. Topics with a high tag count are shown first.Plugin VariableThe Plugin handles a%TAGME{}% variable that performs different actions. The tpaction="" is a required parameter.
How to put tags on every pageTo show the tag interface at the top of the page directly below the breadcrumb (like on twiki.org), use the default templateview.tagme.tmpl in the templates directory.
This template is in fact a 'skin' template. To enable it, write in Main.TWikiPreferences:
* Set SKIN = tagme,patternThe list of skins can be appended, for instance: tagme,corporate,pattern .
For the "blog" style, use for a simple "Tags: list-of-tags (edit)" at the top
of the page:
* Set SKIN = tagme_styleblog,patternAnd for an alternate style, with no tags line shown if no tags exists, and the button to open the tag edit frame placed at the right of the Edit and Attach ones, in the same style, on the upper right: * Set SKIN = tagme_styleblogbutton,pattern
For TWiki 4.1, use:
* Set SKIN = tagme04x01,pattern Customizing the appearanceIf you customize your site you probably want to change overall appearance. You can find instructions how to do that - at least for default pattern skin - in TWiki.PatternSkinCssCookbook.The short summary is:
Other places for the tag interfaceTo show the tags in the top bar, edit TWiki.WebTopBar and copy:<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>To show the tags at the bottom of every page, write in Main.TWikiPreferences: * Set WEBCOPYRIGHT = Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] %BR% Copyright © 1999-%GMTIME{"$year"}% by... etc Show tags without vote buttonsTo just show the tags for a topic, without buttons or "Create new tag" link, use ashowalltags search:
Tags: %TAGME{ tpaction="showalltags" web="%WEB%" topic="%TOPIC%" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\">$tag</a> " }% Tag stylesCSS StylesTagMePlugin writes the following CSS styles:
Search results CSS Styles
Preventing link wrapIf users are allowed to use spaces in their tag names (whenNORMALIZE_TAG_INPUT is set to 0), tag links may break halfway to the next line. To prevent wrapping, add a wrapper div around the tags:
<div class="tagmeTagCloud"> %TAGME{ ... }% </div>This CSS style is included in tagme.css :
.tagmeTagCloud a { white-space:nowrap; } Example styles used on twiki.orgTo show the 'tags shown on a topic':<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>CSS styles: .tagmetags select { font-size:.8em; margin:0 .25em; } .tagmetags a { text-decoration:none; white-space:nowrap; } .tagmetags a:link, .tagmetags a:visited { color:#8E9195; /* all links are gray; for blue links use: #06c */ text-decoration:none; } .tagmetags a:hover { color:#FBF7E8; } .tagMeControl { color:#8E9195; /* gray for non-links */ } Plugin SettingsPlugin settings are stored as preferences variables. To reference a plugin setting write%<plugin>_<setting>% , e.g., %TAGMEPLUGIN_SHORTDESCRIPTION% .
NOTE: Do not change the settings here, overload them in the Main.TWikiPreferences. Prefix a setting with TAGMEPLUGIN_ , e.g. to overload NORMALIZE_TAG_INPUT define a TAGMEPLUGIN_NORMALIZE_TAG_INPUT setting in the Main.TWikiPreferences.
Plugin Installation InstructionsNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.
Limitations
Plugin Info
|
Tag-me Plugin<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/TagMePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/TagMePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> IntroductionThe larger a wiki gets, the harder it is to find content. This wiki tagging plugin attempts to solve the issue based on these assumptions:
User InterfaceTag List on TopicEvery topic has a list showing all tags associated with the topic. Additional tags can be added to the topic, and new tags can be created.Default "twiki" styleScreenshot of tags shown on a topic: You see:
"blog" styleBut the same control can have a different look and feel if we specifystyle="blog" . In view mode it has a terse apperance:
But, if you click on Tags, and that you have an account and can edit tags, you
will see:
Create, Rename, Delete tagsCreate New TagsGo to TWiki.TagMeCreateNewTag to create new tags.Anyone is allowed to create new tags. For developers: Add Tag to TopicOnce a new tag is created, it can be added in the tag list of the topic.Rename TagsGo to TWiki.TagMeRenameTag to rename existing tags.Rename permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: Delete TagsGo to TWiki.TagMeDeleteTag to delete existing tags.Delete permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: List All TagsTWiki.TagMeViewAllTags shows all tags used in the system. The font size indicates the overall tag count of a tag. Screenshot of tag cloud in the list all tags view:<div class="tagmeTagCloud" style="line-height:2em;"> %TAGME{ tpaction="showalltags" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\" style=\"font-size:$size%\">$tag</a>" separator=" " minsize="94" maxsize="220"}% </div> List My TagsTWiki.TagMeViewMyTags shows all tags used by logged-in user. The font size indicates the overall tag count of a tag.Tag SearchTWiki.TagMeSearch shows a list of topics that are tagged with all of the selected tags, sorted by relevance. Topics with a high tag count are shown first.Plugin VariableThe Plugin handles a%TAGME{}% variable that performs different actions. The tpaction="" is a required parameter.
How to put tags on every pageTo show the tag interface at the top of the page directly below the breadcrumb (like on twiki.org), use the default templateview.tagme.tmpl in the templates directory.
This template is in fact a 'skin' template. To enable it, write in Main.TWikiPreferences:
* Set SKIN = tagme,patternThe list of skins can be appended, for instance: tagme,corporate,pattern .
For the "blog" style, use for a simple "Tags: list-of-tags (edit)" at the top
of the page:
* Set SKIN = tagme_styleblog,patternAnd for an alternate style, with no tags line shown if no tags exists, and the button to open the tag edit frame placed at the right of the Edit and Attach ones, in the same style, on the upper right: * Set SKIN = tagme_styleblogbutton,pattern
For TWiki 4.1, use:
* Set SKIN = tagme04x01,pattern Customizing the appearanceIf you customize your site you probably want to change overall appearance. You can find instructions how to do that - at least for default pattern skin - in TWiki.PatternSkinCssCookbook.The short summary is:
Other places for the tag interfaceTo show the tags in the top bar, edit TWiki.WebTopBar and copy:<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>To show the tags at the bottom of every page, write in Main.TWikiPreferences: * Set WEBCOPYRIGHT = Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] %BR% Copyright © 1999-%GMTIME{"$year"}% by... etc Show tags without vote buttonsTo just show the tags for a topic, without buttons or "Create new tag" link, use ashowalltags search:
Tags: %TAGME{ tpaction="showalltags" web="%WEB%" topic="%TOPIC%" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\">$tag</a> " }% Tag stylesCSS StylesTagMePlugin writes the following CSS styles:
Search results CSS Styles
Preventing link wrapIf users are allowed to use spaces in their tag names (whenNORMALIZE_TAG_INPUT is set to 0), tag links may break halfway to the next line. To prevent wrapping, add a wrapper div around the tags:
<div class="tagmeTagCloud"> %TAGME{ ... }% </div>This CSS style is included in tagme.css :
.tagmeTagCloud a { white-space:nowrap; } Example styles used on twiki.orgTo show the 'tags shown on a topic':<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>CSS styles: .tagmetags select { font-size:.8em; margin:0 .25em; } .tagmetags a { text-decoration:none; white-space:nowrap; } .tagmetags a:link, .tagmetags a:visited { color:#8E9195; /* all links are gray; for blue links use: #06c */ text-decoration:none; } .tagmetags a:hover { color:#FBF7E8; } .tagMeControl { color:#8E9195; /* gray for non-links */ } Plugin SettingsPlugin settings are stored as preferences variables. To reference a plugin setting write%<plugin>_<setting>% , e.g., %TAGMEPLUGIN_SHORTDESCRIPTION% .
NOTE: Do not change the settings here, overload them in the Main.TWikiPreferences. Prefix a setting with TAGMEPLUGIN_ , e.g. to overload NORMALIZE_TAG_INPUT define a TAGMEPLUGIN_NORMALIZE_TAG_INPUT setting in the Main.TWikiPreferences.
Plugin Installation InstructionsNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.
Limitations
Plugin Info
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Changed: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
< < |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Added: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
> > |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Tag-me Plugin<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/TagMePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/TagMePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> IntroductionThe larger a wiki gets, the harder it is to find content. This wiki tagging plugin attempts to solve the issue based on these assumptions:
User InterfaceTag List on TopicEvery topic has a list showing all tags associated with the topic. Additional tags can be added to the topic, and new tags can be created.Default "twiki" styleScreenshot of tags shown on a topic: You see:
"blog" styleBut the same control can have a different look and feel if we specifystyle="blog" . In view mode it has a terse apperance:
But, if you click on Tags, and that you have an account and can edit tags, you
will see:
Create, Rename, Delete tagsCreate New TagsGo to TWiki.TagMeCreateNewTag to create new tags.Anyone is allowed to create new tags. For developers: Add Tag to TopicOnce a new tag is created, it can be added in the tag list of the topic.Rename TagsGo to TWiki.TagMeRenameTag to rename existing tags.Rename permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: Delete TagsGo to TWiki.TagMeDeleteTag to delete existing tags.Delete permissions are controlled with ALLOW_TAG_CHANGE (see Plugin Settings below).
For developers: List All TagsTWiki.TagMeViewAllTags shows all tags used in the system. The font size indicates the overall tag count of a tag. Screenshot of tag cloud in the list all tags view:<div class="tagmeTagCloud" style="line-height:2em;"> %TAGME{ tpaction="showalltags" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\" style=\"font-size:$size%\">$tag</a>" separator=" " minsize="94" maxsize="220"}% </div> List My TagsTWiki.TagMeViewMyTags shows all tags used by logged-in user. The font size indicates the overall tag count of a tag.Tag SearchTWiki.TagMeSearch shows a list of topics that are tagged with all of the selected tags, sorted by relevance. Topics with a high tag count are shown first.Plugin VariableThe Plugin handles a%TAGME{}% variable that performs different actions. The tpaction="" is a required parameter.
How to put tags on every pageTo show the tag interface at the top of the page directly below the breadcrumb (like on twiki.org), use the default templateview.tagme.tmpl in the templates directory.
This template is in fact a 'skin' template. To enable it, write in Main.TWikiPreferences:
* Set SKIN = tagme,patternThe list of skins can be appended, for instance: tagme,corporate,pattern .
For the "blog" style, use for a simple "Tags: list-of-tags (edit)" at the top
of the page:
* Set SKIN = tagme_styleblog,patternAnd for an alternate style, with no tags line shown if no tags exists, and the button to open the tag edit frame placed at the right of the Edit and Attach ones, in the same style, on the upper right: * Set SKIN = tagme_styleblogbutton,pattern
For TWiki 4.1, use:
* Set SKIN = tagme04x01,pattern Customizing the appearanceIf you customize your site you probably want to change overall appearance. You can find instructions how to do that - at least for default pattern skin - in TWiki.PatternSkinCssCookbook.The short summary is:
Other places for the tag interfaceTo show the tags in the top bar, edit TWiki.WebTopBar and copy:<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>To show the tags at the bottom of every page, write in Main.TWikiPreferences: * Set WEBCOPYRIGHT = Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] %BR% Copyright © 1999-%GMTIME{"$year"}% by... etc Show tags without vote buttonsTo just show the tags for a topic, without buttons or "Create new tag" link, use ashowalltags search:
Tags: %TAGME{ tpaction="showalltags" web="%WEB%" topic="%TOPIC%" format="<a href=\"%SCRIPTURL{view}%/%SYSTEMWEB%/TagMeSearch?tag=$tag\">$tag</a> " }% Tag stylesCSS StylesTagMePlugin writes the following CSS styles:
Search results CSS Styles
Preventing link wrapIf users are allowed to use spaces in their tag names (whenNORMALIZE_TAG_INPUT is set to 0), tag links may break halfway to the next line. To prevent wrapping, add a wrapper div around the tags:
<div class="tagmeTagCloud"> %TAGME{ ... }% </div>This CSS style is included in tagme.css :
.tagmeTagCloud a { white-space:nowrap; } Example styles used on twiki.orgTo show the 'tags shown on a topic':<div class="tagmetags"> Tags: %TAGME{ tpaction="%URLPARAM{tpaction}%" web="%WEB%" tag="%URLPARAM{tag}%" }%, [[%SYSTEMWEB%.TagMeViewAllTags][view all tags]] </div>CSS styles: .tagmetags select { font-size:.8em; margin:0 .25em; } .tagmetags a { text-decoration:none; white-space:nowrap; } .tagmetags a:link, .tagmetags a:visited { color:#8E9195; /* all links are gray; for blue links use: #06c */ text-decoration:none; } .tagmetags a:hover { color:#FBF7E8; } .tagMeControl { color:#8E9195; /* gray for non-links */ } Plugin SettingsPlugin settings are stored as preferences variables. To reference a plugin setting write%<plugin>_<setting>% , e.g., %TAGMEPLUGIN_SHORTDESCRIPTION% .
NOTE: Do not change the settings here, overload them in the Main.TWikiPreferences. Prefix a setting with TAGMEPLUGIN_ , e.g. to overload NORMALIZE_TAG_INPUT define a TAGMEPLUGIN_NORMALIZE_TAG_INPUT setting in the Main.TWikiPreferences.
Plugin Installation InstructionsNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.
Limitations
Plugin Info
|