Differences

This shows you the differences between two versions of the page.

Link to this comparison view

tag:start [2010/02/02 02:12]
127.0.0.1 external edit
tag:start [2010/05/23 02:32] (current)
Mark Updated for v1.0.0
Line 1: Line 1:
-====== Tag Plugin v0.4.======+====== Tag Plugin v1.0.======
  
-Tag plugin enables you to put "tags" to your articles and make it easier for +Tag plugin enables you to put "tags" to your content and make it easier for 
-you and visitors to classify articles using the tags.+you and visitors to classify content using the tags.  This allows you to implement a 'Tag Cloud' to highlight content on your site.
  
 ===== Requirements ===== ===== Requirements =====
  
-  * glFusion v1.1.2 or newer+  * glFusion v1.2.0 or newer
  
 ===== Installation ===== ===== Installation =====
Line 24: Line 24:
  
  
-When you are writing an article and want to put tags to itjust enter+When you are create content and want to associate tags with the content, enter
  
     [tag:your_favorite_tag]     [tag:your_favorite_tag]
  
-in the article. You can use multiple tags like this:+in the editor. You can use multiple tags like this:
  
     [tag:glFusion plugins]     [tag:glFusion plugins]
Line 52: Line 52:
 edit menu items in the admin control panel. This block is created automatically edit menu items in the admin control panel. This block is created automatically
 during the plugin installation. during the plugin installation.
 +
 +The **Tag Plugin** supports all glFusion plugins, so you can include the tag auto tag in just about any type of content, including; Stories, Forum Posts, Media Gallery descriptions, DokuWiki pages, evList events, etc.
  
 ===== Configuration ===== ===== Configuration =====
 +You can control certain features of the Tag Plugin by modifying the following configuration options.  The configuration options are set using the glFusion Online Configuration system: Command & Control -> Configuration -> Tag Plugin
 +
  
-CONFIGURATION+^Option  ^Description  ^ 
 +|Default name for Tag Cloud Block  | The default name of tag block which will be created during the installation. If you  disable/enable the tag plugin, this block named will also be disabled/enabled automatically.  | 
 +|Tag Name  |Tag name to be used in items (articles), like '[tag:foo]'. You might prefer a shorter name like '[t:foo]'.  | 
 +|Max length of tag in bytes  |Max length of a tag in bytes. Should not be longer than 255.  | 
 +|Tag case-sensitive  |If this is true, the tag "glFusion" will NOT be identified with the tag "glfusion". When you change this option, you should re-install tag plugin.  | 
 +|Allow stemming words  |If this is true, each tag consisting only of alphabets will be stemmed. For example, tag "realize" will be stemmed into "real", thus tag "realize" will be identified with tag "real". **WARNING:** The stemming feature is still not perfect. For example, 'Firefox' is stemmed into 'Firefoxi'. So, I don't recommend you set tag_stemming to true for the time being (and forever, maybe).  | 
 +|Use list of bad words  |Whether to use a list of bad words. If a tag is regarded as bad, it will be replaced with **badword_replace** automatically.  | 
 +|String to be used as spacer in Tag Cloud  |A string to be used as a spacer in displaying tag clouds  | 
 +|Max number of tags in Tag Cloud  |Max number of tags to be displayed in tag clouds in public_html/tag/index.php  | 
 +|Max Number of tgas in Tag Cloud Block  |Max number of tags to be displayed in tag clouds in side block  | 
 +|Threshold of Tag Levels  |Thresholds of frequency of each tag cloud level. All tag clouds are  classified in 10 levels (level 0..level 9). Those tags whose number is equal to or smaller than $_TAG_CONF['tag_cloud_threshold'][X] belong to level X. Each level corresponds to its own class in CSS (Cascading Style Sheet), so you can display in different styles tags according to their levels.  | 
 +|Replace an underscore with a space  |Whether to replace an underscore included in tag texts with a space when a tag is displayed.  | 
 +|Max number of keywords  |The number of key words to be included in <meta name="keywords" content="foo,bar"> tag. If the number is 0, the meta tag won't be included.  | 
 +|Publish tags as template vars  |If this is set to true, tags will NOT be displayed where they should be in the article, but will be published as template vars ({tag_label} and  {tag_part}) which can be used in 'storytext.thtml', 'featuredstorytext.thtml', and 'archivestorytext.thtml'. If this is set to false, tags will be displayed in the article.  | 
 +|Default name for Tag Menu Block  |  | 
 +|String to be used as an indenter in Tag Menu  |A string to indent an item of tag menu  | 
 +|Display number of items in Tag Menu  |Whether to add the number of items to each tag menu item.  | 
 +|Display glFusion Blocks  |Select which glFusion navigation blocks to display when viewing the tag list page.  |
  
-|default_block_name  | The default name of tag block which will be created during the installation. If you  disable/enable the tag plugin, this block named will also be disabled/enabled automatically.  | 
-|tag_name  |Tag name to be used in items (articles), like '[tag:foo]'. You might prefer a shorter name like '[t:foo]'.  | 
-|max_tag_len  |Max length of a tag in bytes. Should not be longer than 255.  | 
-|tag_case_sensitive  |If this is true, the tag "glFusion" will NOT be identified with the tag "glfusion". When you change this option, you should re-install tag plugin.  | 
-|tag_stemming  |If this is true, each tag consisting only of alphabets will be stemmed. For example, tag "realize" will be stemmed into "real", thus tag "realize" will be identified with tag "real". **WARNING:** The stemming feature is still not perfect. For example, 'Firefox' is stemmed into 'Firefoxi'. So, I don't recommend you set tag_stemming to true for the time being (and forever, maybe).  | 
-|tag_check_badword  |Whether to use a list of bad words. If a tag is regarded as bad, it will be replaced with **badword_replace** automatically.  | 
-|tag_cloud_spacer  |A string to be used as a spacer in displaying tag clouds  | 
-|max_tag_cloud  |Max number of tags to be displayed in tag clouds in public_html/tag/index.php  | 
-|max_tag_cloud_in_block  |Max number of tags to be displayed in tag clouds in side block  | 
-|tag_cloud_threshold  |Thresholds of frequency of each tag cloud level. All tag clouds are  classified in 10 levels (level 0..level 9). Those tags whose number is equal to or smaller than $_TAG_CONF['tag_cloud_threshold'][X] belong to level X. Each level corresponds to its own class in CSS (Cascading Style Sheet), so you can display in different styles tags according to their levels.  | 
-|replace_underscore  |Whether to replace an underscore included in tag texts with a space when a tag is displayed.  | 
-|num_keywords  |The number of key words to be included in <meta name="keywords" content="foo,bar"> tag. If the number is 0, the meta tag won't be included.  | 
-|publish_as_template_vars  |If this is set to true, tags will NOT be displayed where they should be in the article, but will be published as template vars ({tag_label} and  {tag_part}) which can be used in 'storytext.thtml', 'featuredstorytext.thtml', and 'archivestorytext.thtml'. If this is set to false, tags will be displayed in the article.  | 
-|menu_indenter  |A string to indent an item of tag menu  | 
-|add_num_items_to_menu  |Whether to add the number of items to each tag menu item.  | 
  
 ===== License ===== ===== License =====
tag/start.txt · Last modified: 2010/05/23 02:32 by Mark
 
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3