WordPress.org

Plugin Directory

wiki:Tags

Tags Plugin

Introduction

  • Version 0.2.1
  • Compatibility: Wordpress 1.5
  • Plugin URI: http://boke.name/c/wordpress-tags
  • Description: A plugin that tag each entry of the blog, and give a tag access method and tag list.
  • Author: Felix Wong
  • Author Email: felix[at]cenrik[dot]net
  • License: GPLv2 or later

Installation

  • Uncompress wp-tags-x.x.x.tar.gz, a wp-tags/ directory is created. It contains README (this file), tags.patch and a wp-content/ directory.
  • Copy wp-tags/wp-content/* to /path/to/your/wp/wp-content, including plugins/tags.php and themes/default/tags.php. The former one is Tags plugin for WP. The latter one is Tags template for the default theme in WP 1.5. You may have a look at it to create your own template.
  • Apply tags.patch in /path/to/your/wp
            patch -p1 < tags.php
    

It includes fields in the simple post form and the advanced editing form.

  • Activate your plugin in WP plugins management page. Then go to Manage/Tags page. Tags plugin will create the tags table for you automatically, if you haven't got one.

Use

  • A field named Tags is next to Title field in Write Post page. You can freely add any tags you want into the field (just like del.icio.us). Tags are not predefined and they can be created as many as you like. When no post is attached to a tag, this tag will not exist any more.
  • Categories do not conflict with Tags.
  • Tag access method
    • if mod_rewrite is loaded:
              http://your.blog.site/tags/tag1+tag2+tag3
      
    • if mod_rewrite is not loaded:
              http://your.blog.site/index.php?tags=tag1+tag2+tag3
      

The URL means you access posts which have tag1 and tag2 and tag3.

Template API

  • To get the tags specified in the URL:
            function tags_title($delimeter="+", $target="_self")
    
  • To determine whether a post has tags, in the_post() context:
            function have_tags()
    
  • To get the tags of a post, in the_post() context:
            function the_tags($delimeter=", ", $echo = false, $link = true, $target="_self")
    
  • To list all tags of the blog:
            function list_tags($delimeter=", ", $sort = true, $desc = true, $count = 12)
    
  • To list all tags of the blog:
            function list_tags($delimeter=", ", $sort = true, $desc = true, $count = 12)
    
  • (Experimental) To create a tags impression image: (need GD2 support)see this example
            function tag_list_image($sort = true, $desc = true, $count = 12)
    

Acknowledgement

  • Great thanks to my lovely girl friend Shasha. She supports me a lot. :-)
  • Thanks to Matt for the trac system.
Last modified 13 years ago Last modified on 03/13/05 15:27:18