XF 2.1 / 2.2 Tag Essentials 2.3.1

valai · Dec 18, 2024

Please note that I do not have the time to give personal support for installations. This addon is working perfectly on my forum AVForums, so I will be updating it with maintenance releases and new features as and when they are needed, which current license holders will be able to download.

Also I am vetting who I sell licenses to, so if you wish to purchase a license, please click the purchase link and then send me a message on the m2n.co.uk forum as per the instructions in the product description. Thank you

This addon brings some additional essential features to tags :

Automatically create tags from thread titles
Watch tags
Synonyms: so you can replace variants - synonyms - of a tag with your chosen 'canonical' version
Wikipedia: automatically attempt to get the Wiki for a tag when it is created. You can edit this to write your own definition.
Blacklist tags (with regex definitions) so they are never created. Useful for filtering out common or useless words.
Set default tags for forums
Batch update threads to add the ability to
- find threads with specific tags
- add tags to, and remove tags from, the resulting threads
- automatically add tags to threads based in the thread title
and more

Admin Tag Management Page

Blacklist tag button for each tag
Edit Wiki button for each tag to open the wiki edit page
Blacklist/delete tag buttons now update with Ajax so the page is not refreshed each time a tag is deleted or blacklisted. Very useful when managing tags on a specific page of the list. Deleting a tag used to refresh the page, reloading the list at the start. Now there is no page refresh saving a ton of time.
Inline selection of tags to delete or blacklist. 'Select all' helps speed up the process.

Blacklisted Tags Management

Dedicated page for managing blacklisted tags
New for XF2: pagination and create regex rules for blacklisting

Changes to the Edit Tag page

Assign tag category
Select forums where this tag can be added
Enter synonyms for the tag

Tag Synonyms

This will auto change the synonym tags to the canonical tag when one (or more) is used.

Tag Wiki

On the front end (utilising front end permissions), so that non-admins can edit the content, have a way to edit (supporting bbcode in the description) the tagline and description of the tag. Also change the front end so aside from showing the list of content that is using that tag, you see the tagline and description of the tag in addition to the list of content using the tag.
- Uses Wikipedia API. Admin option to set any Wikimedia API.
- Permission to manage tag wiki
- With permission, when viewing the tag page (thread tags | XenForo Community), there’ll be an “Edit” link to manage the tag description and tagline.
- Provides a tabbed interface to switch between the tag's recent content and the tag wiki description.
- When saving a new tag or an existing tag with empty Wiki information, get the Wiki information from Wikipedia.
- Follow Wikipedia redirects (fixes cases where Wikipedia entries fail to load).
- If the wiki search returns a disambiguation page, there is an option to not use that.
- If the wiki search does not return an exact match, there is an option to try a fuzzy match.
- For when Wikipedia fails to return information for a tag, set the Wiki entry to the contents of the phrase "tagess_no_wikipedia_entry_exists" (default "No Wikipedia entry exists for this tag"). Note: if you do not want to display any text, set the phrase to a single space character to avoid attempting to repopulate it from Wikipedia each time it is saved.
- Batch update process to populate tags with wiki information if they are blank or contain the phrase above. Note: This may take some time if you have a lot of tags to fetch as we limit the frequency of Wikipedia API calls.

Admin Batch Update Threads

In the Batch Update Threads search form, you can now search for threads which have specific tags.
When batch updating threads, you can now add or remove tags in addition to all the existing options. When adding a tag, the user that started the thread is credited.

Tag Suggestions

When creating a thread, after typing the thread title (when the title loses 'focus'), an ajax request will check to see if any tags are included in the title, if they are then they automatically get added to the tags list (they can be removed and more can also be added).
Suggested tags can be single and multiple words. E.g. If these tags exist: "I love John", "John Paul George Ringo", "Paul George Ringo", "Ringo" and a new thread title is "I love John Paul George Ringo a lot" then all the tags will be suggested.
Admin option to set the maximum number of words in a tag which will be auto suggested (default 3). This is to avoid too much processing when searching for tags within a title. If set to 3 words, the above example would not suggest the "John Paul George Ringo" tag as it contains 4 words.
To combat slowness when the server is finding tags to suggest, there is an admin defined list of stop-words to prevent suggesting tags with common words. Use of the stop words list can be disabled, enabled to ignore tags only where the first word of the tag is in the list or enabled to ignore tags which contain any of the stop words.
A default list is included. E.g. "A" and "I". If enabled, this would prevent the "I love John" tag from being suggested in the above example.

Forum Tags

Set a minimum number of tags to be required in new threads in a particular forum.
Set default tags to be auto-suggested when a new thread is created in a particular forum.

Prefix Tags

Set default tags to be auto-suggested when a new thread is created with a particular prefix.

Watch Tags

With permission (Tagess - Can Watch Tag), users are able to watch tags and receive an alert/email when new content is added with that tag.

Tag Preview

When hovering a tag, you will get a preview popover that displays a snippet of the tag description (from the wiki info), with links to the "recent content", "top users", and "view information" pages.

Admin Options

Plenty of them
Rebuild Caches -> Rebuild Empty Wiki Tags
Rebuild Caches -> Prune low usage tags

Live Examples From http://www.avforums.com

4k uhd (ultra hd) | AVForums The tag overview page for their "4k uhd (ultra hd)" tag. Notice the synonyms, tagline and the tabs.
4k uhd (ultra hd) | AVForums - The page where the wiki information is displayed.
4k uhd (ultra hd) | AVForums - A list of users that have used the tag the most.

Terms And Conditions

Each license is valid for use on one site.
12 months support renewals are in place; when your support runs up you can continue to use the add on but will not be able to receive updates until you renew it.

Version 2.1.4 2 bug fixes :
Fix "Restrict addition of tag to threads in these forums" not being checked on reloading the a restricted tag
Fix error when a user attempts to use a blacklisted synonym tag, and correctly report the synonym tag used that was blocked

Version 2.2.0 New feature (Auto-tag threads from thread-title option in Batch Update Threads) and bug fixes :
Requires XF2.1+
New Feature: Add Auto-tag threads from thread-title option in Batch Update Threads function.
Bug fix: Respect tag blacklisting via Batch Update Threads action
Bug fix: Implement Restrict addition of tag to threads in these forums to apply to both manually set thread tags and tags created from the thread title.
Bug fix: Tweak bulk tag management action to read Delete instead of Disable

Version 2.2.1 Bug fixes : Recommend php7.2+ :
Fix "InvalidArgumentException: Accessed unknown getter 'ParenTag' "
Fix "restrict addition of tags to threads in these forums" feature

Version 2.3.0 XF2.2 compatibility update :
Requires php 7.0+
Now depends on Standard Library by Xon
Supports XF2.2

Version 2.3.1 Performance improvement :
Reduce some N+1 queries on viewing tag recent contents & top users
This version supports XF2.1 and 2.2