Working with tags

Note: This functionality is only available in Pivot 1.40 beta 2 and higher!!

When writing an entry, you can add tags in two different ways: Either by inserting them in the text itself, or by adding them to the ‘keywords’.

In the first case, the tag will be shown in the entry, and it will link to the appropiate tag page. The latter one will be linked on a seperate line with ‘Used tags:’

Inserting tags in the text:

1. Select the word, you’d like to make into a tag
2. Click the tag button on the toolbar
3. Type the name of the tag, or select one from the suggested tags below
4. Click ‘Go!’, and Pivot will add the tag in your text.

The inserted tag will look like [[ tt:Pivot ]]. You can make a tag that links to another location, by using [[ tt:Pivot:www.example.org ]].

Inserting tags in the text:

You can also insert tags, by typing them in the ‘keywords’ field. Below the field, you’ll see a number of suggested tags, which you can click to add them to the list.

If you don’t see the ‘keywords’ field, you’re probably using the ‘basic view’. Toggle to ‘extended view’ to see the keywords.

You can show the tags to your visitors in a few different ways:

• You can display a (small) tag cloud on your frontpage, that links to the large tag cloud, and to the individual tag pages.
• The [[tt]] tags in your entry will be shown as clickable tags.
• Below the entry you can show a list of the used tags in that entry.

You can use the tags to go to the tagpage, or you can link to it yourself (by doing so in your templates, for instance). The page with the global Tag Cosmos is located at www.yourdomain.com/pivot/tags.php, and the individual tag pages are at www.yourdomain.com/pivot/tags.php?tag=nameoftag, where ‘nameoftag’ is the name of the tag.

This is what a typical tag page looks like:

As you can see it lists the entries on your weblog that have been tagged with that tag, it shows the related tags, buttons to fetch feeds with links from various external sources, and a few images from Flickr that have been tagged with it.

Go to Administration > Configuration, and tweak the settings to your liking:

The information for the tags is stored in pivot/db/tagdata. If this folder is not present in your Pivot install, please make the folder, and make sure Pivot can write files in there (ie. chmod to 777)

To start using tags, you can either use the new default template that comes with the full installer of pivot 1.40, or you can add it to any existing set of templates.

You might also want to add the following styles to your .css file, for a sensible representation of the tags:

 
/* For tags: */
.taglinkext, a[rel="tag"] {
	background-image: none;
	border-bottom: 3px double #C2C2C2;
}
 
.taglinkext:hover {
	color: #00A8FF!important;
	background-image: none;
	border-bottom: 3px double #00A8FF;
}
 
#flickrpics a, #flickrpics a:hover  {
	background-image: none;
}
 
#flickrpics img  {
	margin-right: 4px;
	border-width: 1px;
}
 
#tagbuttons a, #tagbuttons a:hover {
	background-image: none;
}
 
#tagbuttons img {
	border-width: 1px;
}

In your entries you can add inline tags that look like [[tt:tagname]], either by typing them yourself. or by using the tag button on the toolbar.

The tags for each entry can be listed by adding [[tags]] to your _sub_entry.html template, like so:

<span class="tags">[[tags]]</span>

In your .css file you can then add:

.tags {
	display: block;
	margin-top: 6px;
	font-size: 0.95em;
}
 
.tags a, .tags {
	color: #666666;
}

This way the ‘used tags’ will only take up space when there actually are tags.

If you’d like to change the ‘Used tags’ label, you can use:

[[ tags : These are the tags used: %tags% : / ]]

The second parameter is the label that is used for the tags. Be sure to include %tags%, or else you won’t see the tags. If you want to include a colon(:) in the label, use it’s html-entity: :. The third parameter is the seperator. So, this example would look like this on your weblog:

These are the tags used: tagname / other / third

To add a tagcloud to any Pivot page, use this:

<h3><a href="/pivot/tags.php">Tag cloud</a></h3>
<div id='tagcloud'>[[ tagcloud ]]</div>

This way you can style it to your liking using:

#tagcloud { .. }
 
#tagcloud a { .. }

You can pass three parameters, like so: [[ tagcloud:20:10:18 ]]. This will mean that the 20 biggest tags are shown, with 10 being the minimum and 18 the maximum font size.