1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

XF 1.5 Thread Tagging

Discussion in 'Have You Seen...?' started by Mike, Jun 25, 2015.

  1. Mike

    Mike XenForo Developer Staff Member

    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...
     
  2. OperaManiac

    OperaManiac Well-Known Member

  3. BassMan

    BassMan Well-Known Member

    Excellent!

    Looking forward for XenForo 1.5. Great work!
     
    ForestForTrees likes this.
  4. Jeremy

    Jeremy XenForo Moderator Staff Member

    Now, who's going to tag all the suggestions for us?
     
    Amaury likes this.
  5. Lisa

    Lisa Well-Known Member

    You thought it, you do it :D
     
    Amaury likes this.
  6. Daniel Hood

    Daniel Hood Well-Known Member

    Didn't really that coming until v2. Nice.
     
    ForestForTrees likes this.
  7. imthebest

    imthebest Formerly Super120

    Oh my god finally thread tagging as part of the core software. Thanks Mike!!

    I believe that now everyone will need an importer from @Dinh Thanh or @xfrocks
     
  8. Rudy

    Rudy Well-Known Member

    I nominate anyone east of Ohio... :D
     
    Amaury likes this.
  9. Hoffi

    Hoffi Well-Known Member

    Thank you!
     
  10. Rudy

    Rudy Well-Known Member

    In the tag admin, is there a way to create a tag? Or, are they only created via use in threads?

    My thinking is that we (staff) want to create specific tags for a couple of designated forum areas that members can use. We can create a "dummy" thread to create tags if we need to so it's not a big deal, but just curious...

    The plugin is great though! The permissions are much needed. We had a tagging issue with vB where members were jokingly (or maliciously) adding tags to existing threads, and we had no way to find out who was doing it. In essence, they ruined a nice feature for us.
     
  11. Jeremy

    Jeremy XenForo Moderator Staff Member

    Oh good, that means the rest of staff!
     
    Amaury likes this.
  12. Rudy

    Rudy Well-Known Member

    Planning on leaving Pittsburgh soon, are ya? ;)
     
    Amaury likes this.
  13. Mike

    Mike XenForo Developer Staff Member

    Yes, you can create a tag. I just cut that button out of the screenshot. It's the same UI as the admin tag edit option.
     
    Valhalla, otto, Veer and 2 others like this.
  14. Dakis

    Dakis Well-Known Member

    BANG!!!

    That is great!! Awesome! It will surely be heavily used.
     
    ForestForTrees likes this.
  15. karll

    karll Well-Known Member

    Will the tags for a thread appear along with the thread title on the New Posts page and within (sub-)forums? Or are they only displayed once you open the thread?
     
  16. Mike

    Mike XenForo Developer Staff Member

    They are only displayed in the thread (though they're likely available if you wanted to display them; it seems like a lot of clutter to me).
     
  17. Daniel Hood

    Daniel Hood Well-Known Member

    Minor cosmetic issue. In the first screenshot it appears as if the tags are on a different line that 'thread tools' unless there's enough of them to have to break to a new line. It just looks a little odd having them sit like 15px above the blue line in my opinion.
     
  18. Alex S

    Alex S Member

    It'll be something similar like by twitter?
     
  19. Mike

    Mike XenForo Developer Staff Member

    They are separate lines. There's already the page nav (or "go to first unread") in the empty spot you're referring to.
     
  20. imthebest

    imthebest Formerly Super120

Share This Page