vapourtrails.ca

This is the “Tweaks” section from the 1.4 documentation. It needs to be updated, but is still relevant

the_post_keytags() accepts three optional parameters you can use to customize the tags display. In order, they are:

• include_cats — If true, includes the post’s categories at the beginning of the keyword list. The default is false: no categories included.
• local_search — Setting this to “tag” (default) links to the tag search. If set to “search” (pre-1.3 behaviour) links go to your site’s search function for that tag. If blank or “technorati”, links go to Technorati’s pages. If categories were included, they always link to your category pages unless “technorati” was specified.
• link_title — Use this to override the default link title text: e.g. “My link title for” If you specify an empty string (”") then no link title will be displayed.

the_keywords() accepts three optional parameters for output formatting (useful if you want to display all keywords in a list on the sidebar). In order, they are:

• before — Text/HTML to insert before each keyword. The default is blank.
• after — Text/HTML to insert after each keyword. The default is blank.
• separator — Text/HTML to insert between keywords. The default is a comma (”,”).

There are also a few constants in the file that can be edited to change other plugin behaviour:

• KEYWORDS_TAGURL — The name of your site’s keyword/tag search URL. The default setting is ‘tag’: e.g. http://yoursite.com/tag/trogdor will list all posts with the tag trogdor. Only used if you’re using permalinks.
• KEYWORDS_QUERYVAR — GET/POST query variable that’s used behind the scenes. Also defaults to ‘tag’. So http://yoursite.com/?tag=trogdor does the same as the previous example, permalinks or no.
• KEYWORDS_SEARCHURL — If you’re using “search” then this value is used instead of KEYWORDS_TAGURL. Set this to the permalink name for your search function (the WordPress default is ’search’).
• KEYWORDS_META — Name of the custom field the plugin saves your keywords to. The default is ‘keywords’.
• KEYWORDS_ATOMTAGSON — Flag to activate the filter that adds tags to your Atom feed. Set to zero if you do not want tags in your feed (this is required by Technorati).
• KEYWORDS_TECHNORATI — URL used when linking tags to Technorati. You can change this if there is another cool tags site you’d rather to link to.
• KEYWORDS_TEMPLATE — Name of the template file used to display tag search results. The default is keywords.php but tags.php will also work. Sometimes it’s nice to have choices.
• KEYWORDS_REWRITERULES — Flag to activate automatic rewrite rule generation. Turn this off if you don’t trust me and want to add your tag rewrite rules yourself.

If you’re really keen, there are non-echoing functions you can use to further customize your site’s keywords. See the plugin file for more details.