Tag plugin enables you to put “tags” to your articles and make it easier for you and visitors to classify articles using the tags.
The Tag Plugin uses the glFusion automated plugin installer. Simply upload the distribtuion using the glFusion plugin installer located in the Plugin Administration page.
The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.
When you are writing an article and want to put tags to it, just enter
[tag:your_favorite_tag]
in the article. You can use multiple tags like this:
[tag:glFusion plugins]
Each tag must be separated by a space. If you would like to register words as one tag, such as “Zend Framework”, you should enter “Zend_Framework”. By default, tags are case-insensitive. For example, the tag “glfusion” will be identified with “glfusion” or “GLFUSION”.
If you want to ban certain tags, you can do so in the admin control panel. Bad words are also case-insensitive.
If you would like to display “tag clouds” in your site block, just create a PHP block with the function name being phpblock_tag_cloud. This block is create automatically during the plugin installation.
The appearance of tag clouds are controlled with templates (in <glfusion>/plugins/tag/templates/) and Cascading Style Sheet (as <public_html>/tag/tag.css).
In case <public_html>/layout/your_theme/tag.css exists, this will be preferred over <public_html>/tag/tag.css.
If you would like to display a menu based on tags in your site block, just create a PHP block with the function name being phpblock_tag_menu. You can edit menu items in the admin control panel. This block is created automatically during the plugin installation.
CONFIGURATION
| 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. |
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
