This shows you the differences between two versions of the page.
|
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.1 ====== | + | ====== Tag Plugin v1.0.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 it, just 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 ===== | ||