filed under: geek, tagging, textpattern, tru_tags

Posted 189 days ago

To learn more about tru_tags, check out the other tru_tags articles on this site.

Current Release

tru_tags 3.1 (for TXP 4.0.5 and above) (download)

Forum announcement

This is a minor bugfix release, fixing issues created in 3.0. Specifically, messy URLs are fixed on clean-url sites, and the text on the admin page has been updated to be clearer.

Read more...

filed under: geek, tagging, textpattern, tru_tags

Posted 189 days ago

To learn more about tru_tags, check out the other tru_tags articles on this site.

Installation

1. Go to the releases page to get the latest release. Don’t save it – just open it in your browser.
2. Scroll down a slight bit and follow the on-page instructions: copy/paste the big square block of characters into your Textpattern install, under admin -> plugins.
3. Hit “Upload”.
4. Remember to switch the plugin to “Active” in the plugin list.
5. You can find help text for the plugin by clicking the “help” link in the plugin list.

Configuration

Step 1: Click the “read more” link :)

Read more...

filed under: geek, tagging, textpattern, tru_tags

Posted 189 days ago

To learn more about tru_tags, check out the other tru_tags articles on this site.

Core features

• Tag any article with an unlimited number of tags
• List all the tags associated with an article
• Generate a tag cloud or simple tag list
• Search for all articles tagged with a given tag
• Clean URLs and rel="tag" support without mod_rewrite or .htaccess modifications
• RSS and Atom support
• Clickable list of tags in the ‘Write’ page of the Textpattern admin
• Admin-side configurability
• Admin-side tag maintenance and redirection tools
• Tag links can go to external sites or alternate locations
• Show a cloud of “related tags” in the search results page
• Designed with site security in mind
• Clean, readable code

Advanced features

Adding tags to an article:

• Tags can be multi-word, with spaces. (use commas to separate tags)

Listing tags for an article:

• Supports standard textpattern attributes like wraptag / break / class / etc. (the default break is a comma)
• Don’t have to generate links when showing tags
• Can render article tags as a mini-cloud, including sorting and advanced cloud features

Tag cloud:

• Supports standard textpattern attributes like wraptag / break / class / etc. (the default break is a comma)
• Can filter a cloud to only show tags from specific sections
• Can exclude specific sections from the cloud
• Cloud automatically filters out future-dated articles and non-published articles
• Uses percentages for font sizes, so the cloud can be in any container, with fonts of any specified size
• Can specify min and max percentage sizes
• Can show the number of times a tag has been used, after the link or in the title attribute
• Don’t have to generate links when showing tags
• Tags have the class attribute set in various ways, so you can take complete control over tag styling
• Infrequently (or frequently) used tags can be hidden
• Can sort the cloud by tag frequency (ascending or descending)
• Can limit the cloud to a max of ‘N’ tags, with the ability to keep only the most-used tags or a random set (weighted by frequency)

Tag search:

• Site admins can put the name of the tag currently being searched into titlebars or links to external sites (this is careful about scripting attacks)
• A handy txp tag (tru_tags_search_parameter) to return whatever the user typed into Textpattern’s search field (this is careful about scripting attacks)
• Renders search results just like the standard article list does. This means you have complete control over the tag search output formatting, and that it supports standard features like article excerpts, override forms, etc.
• Customizable support for standard 404 pages

RSS / Atom feeds:

• Includes article tags in the RSS and Atom feeds (which means that Technorati will correctly identify articles)
• Can include article tags in the feed body
• Can customise the feed body to change the look of the tags, and/or to add extra items to the feed

Admin-side:

• A few fancy javascript tricks to make it easy to use
• List can be turned off or styled using CSS (and another plugin) if there are too many tags

Known issues (in the latest release)

• tru_tags must use the Keywords field, and cannot use a custom field
• No support for multiple tags at once (e.g. “life AND books”) tag search (but see this post for possibilities)
• No feature to show a month-based historical listing of articles (like ran_tags does)
• The tag cloud can be limited to just show tags from one section, but when you click a tag link from the cloud it shows articles from all sections
• The tag search doesn’t support pagination. (It will show all the articles associated with a particular tag, no matter how many there are.)

Add a comment [9]

filed under: geek, tagging, textpattern, tru_tags

Posted 189 days ago

To learn more about tru_tags, check out the other tru_tags articles on this site.

This post contains an up-to-date list of all the (as-yet-unimplemented) feature requests that I’m aware of, with a rough indication of the order that I plan to implement them. If you have additional feature requests or want to suggest reprioritization of one of the features below, please add a post to the forum thread for this plugin. I’ll see it and update this page, and others will see the request also.

Group 1

• Make it possible to create an ‘archives’ page, by tag
• Make it possible to always show the tag parameter with the correct spaces
• Make tru_tags_search_parameter just use the new txp:search_term tag
• Improve the admin-side tag renaming features
  • “Delete all ‘ABC’ tags from articles also tagged with ‘XYZ’”
• Add links to truist.com, forum post
• Indicate more clearly what the site-wide default is for clean urls

Group 2

• Limit cloud to tags from X recent articles, or within X time period
  • Order list by (oldest? newest?) article date
• Color tags by age (of most recent article)

Group 3

• Related article list (for a single article), based on number-of-matching-tags
  • Filter by section / category
  • Second-level sorting by date?
• Limit cloud to a specific category

Group 4

• Multi-tag search (tag1 + tag2)
  • General boolean logic ((tag1 or tag2) and tag3)
• Fix txp:older and txp:newer

Group 5

• Grouped index of tags – by section, category, alphabetical, etc
  • show articles for each tag?
  • single page per group
• Grouping related keywords (admin-side)
• Grouped-tag search (public side)
• Color tags by category / section

Group 6

• Move admin-side tag cloud to a better location (for big clouds)
• Auto-complete typing in the Keywords field (admin-side)

Group 7

• mintagcount / maxtagcount, but based on percentages
• Show a “related” cloud for general search-result pages (or other custom-generated article lists)
• “There are [x] posts tagged: [tag_name]”
• Alphabetical listing of articles in tag search result

Group “depends on the next release of Textpattern”

• RSS feeds for individual tags

filed under: tagging, textpattern, tru_tags

Posted 555 days ago

I’m proud to say that tru_tags is the tagging plugin of choice over on Textpattern Resources v2 (a.k.a. textpattern.org). That makes it the preferred tag plugin of at least one of the Textpattern developers, and puts it in the spotlight on an official Textpattern site.

Check out the gorgeous tag cloud and the post describing the use of tru_tags.

Woohoo!

Add a comment [3]

filed under: business, geek, tagging, tru_tags

Posted 673 days ago

I’m pleased to announce the public release of tru_tags v1.8, sponsored by Simon Finch, a consultant / web developer in the U.K.

This release of tru_tags contains two new features: a new type of tag cloud and the ability for article tags to render as a mini-cloud. I also massively refactored and condensed the code, making it much easier to read/understand and hopefully much easier to maintain.

The first new feature can be seen by clicking one of the links in my tag cloud (over in the sidebar). On the resulting page, you’ll see that a second cloud appears (in the sidebar) under the heading “Related Tags”. It is showing you all the tags that are related to the tag you clicked on.

I mentioned that this version was sponsored by Simon Finch, and it’s true – he paid for these specific features, because he needed them for a consulting project he was working on. That has me excited in all sorts of ways:

1. My plugin is being used in the real world (in an online store!)
2. Work that I originally did for my own benefit is now helping others
3. I’m earning income that is derived from that original work
4. I’m earning income from open-source software!

As usual, you can download this version from the announcement page and you can find out how to use it on the instructions page.

(For those of you waiting for other features, they’ll be coming soon in a v1.9. I wanted to get v1.8 out the door with just the features for Simon, so I’ve had to delay the rest of these.)

Thanks, Simon!

Add a comment [1]

filed under: geek, tagging, textpattern, truist.com, tru_tags

Posted 804 days ago

When I first created this blog I wanted it to have tagging support, which doesn’t come built into Textpattern (my blog software). At the time (Christmas 2005), tagging plugins for Textpattern were virtually nonexistent. Hunting around the web, I found ran_tags, chh_keywords, rss_unlimited_categories, and ajw_technorati_tags. They were all unworkable for me, because of bugs or complexity or feature-set, so I was left without tagging support.

So I wrote my own, based on ran_tags. I published it on the textpattern forums and subsequently released about a dozen new versions, each with new features to make it more powerful and/or easier to use. The plugin has seen a lot of adoption, and seems to be popular among the textpattern community. You can see it in use on this site.

It’s written with ease-of-use, simplicity, and security in mind, and it has a very rich feature set. To learn more, please check out the features list. There is one (potential) downside for some users, though. To help keep the code simple, I call out to the Textpattern code to actually do the tag search. That means that articles can only be tagged via the Keywords field, rather than using a custom field. Some people use the keywords field for other purposes, so they can’t use tru_tags. There are also a few other minor annoyances documented on the features page.

tru_tags can be downloaded from the releases page, and you can learn to use it by reading the detailed usage instructions. If you have questions, please post comments to any of these articles, or in the forum, and I’ll get back to you quickly.

Enjoy!

Add a comment [42]