XF 1.5 Thread Tagging

Tags are a common method of adding keywords to content to aid searching and discovery. In XenForo 1.5, we're adding support for applying tags to threads, as well as a framework for add-ons to add tags to their own content types.

upload_2015-6-25_12-53-21.png


Thread tags apply to the thread itself (rather than individual posts), so they are displayed at the top of the thread view, independent of any post.

Clicking any tag will take you to a page displaying all content that has that tag attached to it:

upload_2015-6-25_12-54-22.png


These results pages will be accessible to search engines (and of course end users) to help them relate the tagged content to each other.

To edit the tags in an existing thread, clicking the "edit" link shown in the first screenshot will bring up an overlay with a tag editor:

upload_2015-6-25_12-55-15.png


When typing a tag in, auto-complete options will be displayed.

Tagging Options
If you are allowing untrusted users to apply tags, it may be useful to apply some limits. To do this, there are a number of options:

upload_2015-6-25_12-55-50.png


These options cover limits over the amount of tagging an individual user can do and the actual structure of the tags. Note that tags will have some normalization applied (lower casing, white space adjustments, etc) independent of any structure limits.

Tagging Permissions
There are also a number of permissions that allow you to control who can tag content:
  • Create new content tag (global) - this controls whether a user can create an entirely new tag. If they do not have this permission (but have permission to apply tags), the user will only be able to use a tag that has already been created.
  • Bypass user content tag limit (global) - having this permission allows the user to bypass the "Max Content Tags Per User" option.
  • Tag thread by self (global and per forum) - this permission allows a user to apply tags to threads they create. By default, they will only be able to edit the tags they applied to the thread.
  • Tag thread by anyone (global and per forum) - this permission allows a user to apply tags to threads created by anyone. Like above, they will generally only be able to edit the tags they applied.
  • Manage tags by others in own thread (global and per forum) - this permission extends the tag management to control any tag that has been applied to their own thread, regardless of who applied it.
  • Manage tags by anyone (global and per forum) - this is a moderator-level permission that allows full tag management.
Admin Tag Management
Admins can manage tags through the admin control panel. They are given a list of tags, including filtering and sorting options:

upload_2015-6-25_12-57-55.png


Editing a tag gives the following options:

upload_2015-6-25_12-58-13.png


Normally, when a tag is created, the "URL version" is automatically generated. This is what will be displayed in the URL when viewing the tag results page (example.com/community/tags/tag-name-here/). Normally, this is automatically generated from the user entered tag by deaccenting and normalizing, along with some extra processes to ensure uniqueness. However, an admin can manually override this if desired.

Normally tags will be removed when they are no longer used (specifically, when their last usage is removed). Choosing to make a tag permanent prevents this. This is mostly significant for communities where admins will create a list of valid tags and not allow users to add their own.

Deleting a tag should be straightforward enough. Merging tags allows you to change all references to tag X into tag Y.

Tag Searches
Tag searching is exposed via a new tab on the search pages:

upload_2015-6-25_12-59-19.png


This allows searching by a single tag or multiple tags. Entering multiple tags will only return content with all tags applied.

Below this, we display a tag cloud showing the most popular tags with various "weights" to indicate how popular they are. There are some options that control what is included in the tag cloud:

upload_2015-6-25_12-59-49.png


In terms of searching itself, tags are included as part of the content's title, allowing the text of the tag to be searched. With XenForo Enhanced Search, this automatically increases the relevancy of a result matching a tag. Tags are also indexed as "metadata" internally which means they can be searched via a non-keyword method. This is not exposed by default outside of the dedicated tag search page.

Tagging for Developers
Like many other systems in XenForo, the tagging framework is implemented in a content-agnostic way. This allows tagging to be added to many content types easily. Developers wishing to add tagging to their content mostly just need to implement the necessary handler class and display the tags on their content pages.

We intend on releasing updates to our official add-ons to add support for tagging.



That's all for today. Until next time...
 

trigatch4

Member
Four questions:
  • Can you limit tags for use in specific forums?
  • When you conduct a general search, will tag pages be part of the results?
  • Any plans for "auto-tagging" that will link the first mention of a tag on a thread to its corresponding tag page?
  • When do you expect XF 1.5 to be released?
Wonderful development, great to hear!
 

Alpha1

Well-known member
Many thanks for implementing this!!! A few questions:
  1. Will the vbulletin importer support tags import?
  2. Are there any tools for managing large numbers of tags? My big board has 35k tags. In vbulletin tag management was a massive headache, because admincp had no tools. Is this better in XF?
  3. Can abusive tags be reported?
 

Mike

XenForo developer
Staff member
Currently no to each, though this could potentially be expanded (either early in the beta or in a future version).

Importers may be updated but that has not been investigated in detail yet.
Tag management via inline moderation could be an option.
I'm not sure what specifically you're referring to with abusive tags - is that the tag itself, or the tag in the context of the thread it's attached to. Either way, reporting the first post in the thread would probably be the main approach to that.
 

resonansER

Well-known member
OH, MY GOD, KIER! and his apostles Mike and Brogan! :) :) :) FINALLY! Don't past even 7 years and tags system has been implemented to XenForo! Hooray! And thank you SO MUCH! (y)
 
Last edited:

Alpha1

Well-known member
Currently no to each, though this could potentially be expanded (either early in the beta or in a future version).
I hope this will happen. It would be extremely helpful if we could import tags from vbulletin and also if there would be some useful tools to manage tags in admincp.

I'm not sure what specifically you're referring to with abusive tags - is that the tag itself, or the tag in the context of the thread it's attached to. Either way, reporting the first post in the thread would probably be the main approach to that.
With abusive tags I mean a tag which itself is malicious in nature. For example when someone tags a thread with the word 'idiot' or with a spam text.
From my 13 years of experience with a big board, I can say with certainty that people will not report the first post to report a bad tag. It would make no sense either to do so because the post report will not give moderators the tools to remove the abusive tag from the database or to merge an erroneous tag into the correct one.

Suggestion posted here: https://xenforo.com/community/threads/report-bad-tags.100289/

I see in the screenshot that its possible to protect a tag from being deleted if unused. Does this mean that there is a function to purge unused tags?
 

Mike

XenForo developer
Staff member
I see in the screenshot that its possible to protect a tag from being deleted if unused. Does this mean that there is a function to purge unused tags?
When a tag becomes unused (last time it's attached to content), it's removed. This may be a bit less common than you may think as it's specifically when every usage is removed from the database. If there's "hidden" content with it applied, it's not going to be removed.
 

Renegade

Well-known member
First I liked the first post, then I came down to the editor to make this post, now I am off to read the first post. (y)

Can we have an option to keep the tags predefined (even better if it is per forum based) so that users do not enter random tags. Show them the list of tags while creating topic and also autocomplete on that field?
 
Last edited:

erich37

Well-known member
Tags are textual, not image based.

You can create tags such as "5 stars".

I have read that XF is going to use "FontAwesome" in the future.
So I guess a "text" could display "stars" via "FontAwesome" ?
Not sure if this would work with displaying "stars" in Google-Search-Results via Microdata ?


Anyway, many thanks for adding the Tagging-feature :)
 
Top