ExpressionEngine Add-ons

Tag 5.0.4

Tag your content with keywords and intuitively display relationships between entries.

  Overview

Establishing interesting and useful relationships within the content on a website is a powerful method of retaining visitors and bringing them back. The Solspace Tag add-on is an intuitive relationship tool. It lets you freely apply relevant tags to entries on your site. You can then display in your templates the relationships that emerge within this data to improve your visitors' experience. Relationships develop over time, naturally, intuitively. Tag brings this natural progression to your website.

Tag also allows your users to view lists of entries that contain specific tag(s), or while viewing a specific entry, see other entries that are related by use of the same tag(s). These related entries can be ranked by most tag matches. You can also display a list or a weighted "cloud" of tags that exist for your site.

Tags can be created/selected in the Publish page of the control panel while creating or editing an entry. They can also be added to entries via Channel Form. Since it's a field type, you can have as many Tag fields (and groups) as you wish.

  Compatibility

The latest version of Tag is 5.0.4. The chart below shows the current technical requirements and compatibility for the latest version of Tag.

  What People Are Saying

Using this module for related posts allows the entries to dynamically update the more you add to your site, using an algorithm that matches up tags. It has increased click-through rates on my blogs, and cross-promotion of content. Highly recommended.

Ryan Battles

Tag is a great addition to our already excellent arsenal of ExpressionEngine addons and one of the many “must-installs” for any site that requires cross-promoting entries. The documentation is well written and extremely easy to install and train users on.

bcw

Where EE's native categories are clunky and hard to get right, Tag is easy to use, flexible and precise. I use it for all the normal reasons and it does the job.

Adman

@jesseknowles Solspace Tag is one of the most powerful add-ons we've used. Great template tag logic and admin tools. A+

  Changelog

For updating instructions, please visit the documentation.

  Documentation     Updates

Updates

Updating Instructions #

If you're upgrading from Tag 4.x on ExpressionEngine 2.x, it's recommended that you upload the new Tag files to your new ExpressionEngine 3.x site directory just before running the EE2 -> EE3 upgrade. Proceed with the following instructions...

  1. Within your sites ./system/user/addons/ directory, delete the tag folder and upload the new one from the /system/user/addons/ directory in your download package.
  2. Within your sites ./themes/user/ directory, delete the tag folder and upload the new one from the /themes/user/ directory in your download package.
  3. Go to the Add-On Manager area in the ExpressionEngine control panel, scroll to down to the Third Party Add-Ons section, and find Tag in the list, and click Update.

Changelog #

5.0.4 (June 22, 2016) #

  • Updated for compatibility with ExpressionEngine 3.4.

5.0.3 (April 29, 2016) #

  • Added support for PHP7.

5.0.2 (April 18, 2016) #

  • Updated Tag for compatibility with ExpressionEngine 3.3's new icon set in the control panel.
  • Fixed a bug where the "Insert New Tag Group" button shortcut feature inside of new channel field page didn't work.
  • Fixed a bug where the Manage Tags page of control panel would show entities for some special characters in tags.

5.0.1 (February 3, 2016) #

  • Fixed a bug where Tag would not install on Windows based machines.
  • Fixed a bug where a PHP error could occur in some Tag template tags when the channel="" parameter was used.

5.0.0 (November 9, 2015) #

  • Updated Tag to be compatible with ExpressionEngine 3+ (only). Tag 4.x is required for ExpressionEngine 2.x.
  • Updated install SQL to correct issues with MySQL strict mode, defaults, and unnecessarily signed integers.
  • Removed Tag Publish Tab feature (field type still exists).
  • Removed Tag Subscriptions and supporting template tags.
  • Removed Tag:Search Results template tag.
  • Removed Tag:Tagged template tag.
  • Removed Tag:Entry_Widget template tag because using the Tag standard fieldtype takes its place and it was only a shim for older functionality.
  • Removed Tag:Form. This was a legacy support template tag. Use the Tag fieldtype in Channel:Form in Edit mode.
  • Removed 'marker' and 'marker_id' parameters in favor of feeding segments via the tag="" parameter directly to the template tags.
  • Removed exclusive="yes" functionality and ability to negate tags in Tag:Entries.
  • Fixed a bug where the 'Total Tags in Group' number in the Tag Groups section of the Control Panel was incorrect.

4.2.9 (April 28, 2015) #

  • Added dynamic="no" parameter to the Tag:Tags tag.
  • Updated for compatibility with ExpressionEngine 2.10+.

4.2.8 (September 24, 2014) #

  • Added pagination to the Tag:Tags tag.
  • Added placeholder in 'Tag' field to remind users to press '[Enter]' between entering tags.
  • Fixed a bug in Tag:Entries while using inclusive="yes" where entries that were associated with tags containing a 'comma' were not returned despite using another tag separator besides a 'comma'.

4.2.7 (April 8, 2014) #

  • Fixed a bug where Tag would conflict with some other add-ons in EE 2.8.
  • Fixed a bug where 'session_id' fetching was causing errors in EE 2.5.x.

4.2.6 (April 3, 2014) #

  • Updated for compatibility with ExpressionEngine 2.8.

4.2.5 (September 18, 2013) #

  • Fixed a bug where the Tag fieldtype would trigger errors with PHP 5.2.x and EE 2.7.

4.2.4 (September 13, 2013) #

  • Added preference for multiple item input separator in Tag fields.
  • Updated for compatibility with EE 2.7.
  • Fixed a bug where Tag suggestions didn't work with jQuery 1.9+.
  • Fixed a bug where Suggest Tags didn't function correctly when using Tag with Channel Form.
  • Fixed a bug where tags containing characters that are listed as the current default separator were being split when the fieldtype saved.
  • Fixed a bug where the Tag fieldtype could cause PHP errors in the post edit entry screen in some versions of ExpressionEngine.

4.2.3 (May 2, 2013) #

  • Fixed a bug where an error would occur when using Tag:Entries.

4.2.2 (April 18, 2013) #

  • Added case="" parameter for {exp:tag:tags}.
  • Added support for Better Workflow previews (fieldtype only).
  • Added default tagdata for fieldtype output in Channel Entries if no tagpair is used.
  • Added platform check for time conversion for multi-EE version support.
  • Updated for compatibility with ExpressionEngine 2.6.
  • Updated error handling to a more modern EE default as EE->output->show_user_error() has been deprecated.
  • Updates are now automatic and no longer require a manual update screen.
  • Removed Gallery Entries columns from default install tables.
  • Fixed a bug where user localization preferences might be ignored when loading language files in some situations.
  • Fixed a bug where inserting new tag groups during new Channel fieldtype creation would cause PHP errors.
  • Fixed a bug where errors where thrown on the 'cp_js_end' hook in certain versions of EE.
  • Fixed a bug where a default tag separator was not set on install of module.
  • Fixed a bug with Tag:Entries where in some rare cases, PHP errors could occur with relationship fields in versions greater than ExpressionEngine 2.5.x.

4.2.1 (December 28, 2012) #

  • Fixed a bug where Tag widget autocomplete and Top Tag counts were not properly respecting the Tag group preferences on Tag fieldtype settings.
  • Fixed a bug where Tag widget autocomplete made every Tag field use the last set Tag group in SafeCracker.

4.2.0 (December 28, 2012) #

  • Removed support for ExpressionEngine 1.x (Tag is now EE2 only).
  • Added offline documentation files to download package.
  • Added ability to use multiple entry ID's in {exp:tag:tags}.
  • Added multibyte lower/upper case conversion to {exp:tag:tag_name}.
  • Fixed a bug where pagination would not parse correctly if limit="" parameter was higher than actual results in {exp:tag:cloud}.
  • Fixed a bug where {exp:tag:related_entries} would not order tags by relevance when using orderby="relevance".
  • Fixed a bug where the Utilities in the Tag CP would not work with throttling enabled.
  • Fixed a bug where the Tag fieldtype's Tag Suggest feature would not work with some UTF-8 ranges, such as Russian characters.
  • Fixed a bug where Tag Group short names were not customizable.
  • Fixed a bug where the url_title="" parameter was not functioning in {exp:tag:related_entries}.
  • Fixed a bug where the Tag fieldtype/widget autocomplete would include all tags from any Tag group despite field settings set to "This Group".
  • Fixed a bug where MySQL errors could occur in front end templates and on the publish page in EE 2.5.4+.

4.1.1 (April 16, 2012) #

  • Added a new "Tag Field Sync" Utility for people who switch from the Publish Tab to a Custom Field method and wish to sync tag data for EE Search's use (EE2-only).
  • Modified Tag:Entries to allow tag_group_id="" or tag_group_name="" without specifying a tag_id or tag_name (EE2-only).
  • Modified the language in the Preferences tab to explain what "Allow New Tag Creation via Publish Tab" does.
  • Fixed a bug where an extension call in the CP was interfering with the usage of the Session object.
  • Fixed a bug where the Tag field type would not work on some subdomain/https setups (EE2-only).
  • Fixed a bug where the channel="" parameter was not being respected in Tag:Related_Entries when ordering by relevance.
  • Fixed a bug where the disable="" parameter was not being respected in the Tag:Entries tag.
  • Fixed a bug where the Tag module's tags were not using the last instance of the tag marker when finding tag names in the URI.
  • Fixed a bug where the Tag Group was not being remembered across pagination in the CP when viewing the list of tags for a group (EE2-only).
  • Fixed a bug where multiple foreign words were being inserted when MySQL's collation matched multiple words with different accents on letters.
  • Fixed a bug where a MySQL error might be shown in the CP.
  • Fixed a bug where ampersands did not work correctly with the Top Tags and Suggest Tags feature (EE2-only).
  • Fixed a bug where single quotes in Top Tags would result in a javascript error and make all Tag functionality halt (EE2-only).
  • Removed the usage of set_gmt().

4.1.0 (February 1, 2012) #

  • Added {tag_widget} to Tag:Form to allow the usage of the Tag widget for inputs and auto-suggest ('Suggest Tags' and 'Top Tags' are not loaded) (EE2-only).
  • Added tag_group_id="" and tag_group="" parameters to Tag:Form to allow tag groups to function in Tag:Form (EE2-only).
  • Added total_entries_[tag_group_id] and total_entries_[tag_group_short_name] to Tag:Tags and Tag:Cloud as well as a custom update that recounts each tag via AJAX to correct these totals (EE2-only).
  • Added prepending to pagination variables and variable pairs ('tag_paginate'). Deprecated 'paginate' variable pair.
  • Updated pagination to support ExpressionEngine 2.4.
  • Updated the Tag fieldtype to allow {field:tag_fieldtype_name} usage in SafeCracker instead of requiring the use of the Tag:Widget tag (EE2-only).
  • Fixed a bug with the Tag entry javascript where tag names in the Top Tags areas would not properly toggle when the tag name contained double quotes.
  • Fixed a potential security issue in some AJAX URI's.
  • Fixed a bug where Chrome and Safari would sometimes not render the entire tag graphic.

4.0.1 (August 5, 2011) #

  • Fixed a bug where the Top Tags Limit in the Tag Field Type preferences did not show the current setting on edit.
  • Fixed a bug where Tag Cloud would not properly increment the {step} variable when ranking by "entries".
  • Fixed a bug where the harvest field selected per channel in the Tag Preferences area would save its value, but not reflect the change in the form on refresh.

4.0.0 (July 26, 2011) #

  • Converted Tag to use Solspace Add-on Builder Framework, and Solspace Bridge for EE 1.x.
  • Updated Tag entry interface UI/UX for publish area and front end (EE2).
  • Changed Tag field handling to be a custom field type now. You can create as many Tag fields as you wish (EE2).
  • Changed Tag field data to now store tags in the channel entry data, if used as field type (EE2).
  • Changed the Tag themes folder to now reside in /themes/third_party/tag/ folder in EE2, and /themes/tag/ in EE1.
  • Changed Tag:Cloud loop to now default to ordering by tag name.
  • Added Tag Groups, which give the ability to have more than one set of tags, and filter on groups in templates (EE2).
  • Added tag_group_id= and tag_group_name= parameters to all relevant Tag template tags (EE2).
  • Added ability to assign a Tag Group to harvested tags when using the Harvest tool in the Tag CP (EE2).
  • Added {exp:tag:entry_widget} template tag to handle support for front end publishing with SafeCracker SAEF (EE2).
  • Added more options for tag separators for front end assigning of tags.
  • Added a clause in Tag:Related_Entries that auto-inserts fake pagination when needed to avoid results ordering issues.
  • Fixed a bug where CKEditor-based WYSIWYG fields would not work with Suggest Tags feature.
  • Fixed a bug with the Tag config file where it would throw an error during upgrade from EE 1.x to 2.x.
  • Fixed a bug where tags containing foreign characters were never assigned 'click' counts.
  • Fixed a bug where editing a tag with apostrophes or single quotes in the control panel would fail and not render the tag name correctly.
  • Fixed a bug where Tag would not support using a template named "tag" as the tag trigger for Tag:Entries loop.
  • Deprecated Tag tab and old tab/non-field behavior (EE2).

  Pro Services

Need help with an implementation of Tag? Need Tag to do more? We're available for hire!

If you're interested in any of the above services, or have questions about them, fill out the form below to begin our conversation!

  EE Aftercare

Ongoing repairs, additions, and adjustments are a normal part of the life cycle of a web site. With EE Aftercare, you have someone on your team who you can trust to take care of your web site. Solspace brings years of experience in developing, refurbishing, and supporting EE web sites. With EE Aftercare, you have a high-end developer on your team, working with you to have the best and most effective possible web presence.

Learn more about EE Aftercare