Description
Establishing interesting and useful relationships within the content on a website is a powerful method of retaining visitors and bringing them back. The Tag add-on is an intuitive relationship tool. It lets you freely apply relevant tags to content 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 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. Users can also subscribe to tags and view lists of entries that contain the tag(s) they’ve subscribed to. 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 CP while creating or editing an entry. They can also be added to entries via SafeCracker, or seperately through the Tag form template tag. You can have as many Tag fields (and groups) as you wish, as it is a field type.
If you already have a tagging system where tags are placed into a custom field, or if you’ve manipulated the Tag “feel” by assigning your entries to EE categories, Tag can easily transition your website. Using the built in Harvesting utility, you can easily harvest this data, and it will automatically convert all into Tag tags and apply them to your entries.
Works on: ExpressionEngine 2.x Shortcut:
Compare
Link to this page:
Changelog
- Version 4.2.3
- Version 4.2.2
- Version 4.2.1
- Version 4.2.0
- Version 4.1.1
- Version 4.1.0
- Version 4.0.1
- Version 4.0.0
- Version 3.0.5
- Version 3.0.4
- Version 3.0.3
- Version 3.0.2
- Version 3.0.1
- Version 3.0.0
Version 4.2.3 (May 2, 2013)
- Fixed a bug where an error would occur when using Tag:Entries.
Version 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.
Version 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.
Version 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+.
Version 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().
Version 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.
Version 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.
Version 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).
Version 3.0.5 (February 18, 2011)
- Added NSM Add-on Updater support.
- Added a check for enabled extensions in case a user upgrades from EE 1.x to EE 2.x and the Tag extension becomes disabled.
- Added a tag_separator="" parameter to the Tag:Entries, Tag:Tag_Name, and Tag:Gallery_Entries tags to specify an alternate seperator to "comma" (in case a user has to force 'index.php?/' in .htaccess thus preventing the use of commas in URL's).
- Fixed a bug where inclusive tags where improperly displaying entries if at all.
- Fixed a bug where the Tag:Related_Gallery_Entries tag would display an error on gallery entries in certain situations.
- Fixed a bug where there could sometimes be an issue with upgrading from Tag 2.1.x to Tag 3.x.
Version 3.0.4 (December 21, 2010)
- Added {if tag_no_results} conditional to Tag as alternative to {if no_results}.
- Added a routine to the upgrade to clean up and repair tags with rogue "space" issues.
- Updated and enhanced Tag module CP area (in EE 2.x) to conform completely to native EE styling.
- Fixed a bug where tag limits where not respected during parsing, after publish submission.
- Fixed a bug where input tags would accept and add tags with preceding/exceeding spaces instead of trimming and matching existing tags.
Version 3.0.3 (November 5, 2010)
- Updated the words "channel" and "weblog" to be interchangeable in Tag variables.
- Fixed a bug where the Tag SAEF feature didn't work correctly in EE 2.x.
- Fixed a bug where the Tag tab in the Publish page could still cause issues in EE 2.x.
- Fixed a bug where the autosuggest feature in the Tag tab didn't work correctly in IE.
- Fixed a bug where foreign characters would not parse correctly in Tag:Entries tag.
- Fixed a bug where the Tag:Related_Entries tag would trigger a PHP error in EE 1.x.
- Fixed a bug where some older versions of Tag did not get a proper update to the preferences table, causing possible Upgrade errors.
- Fixed a bug where Batch Harvest in EE 2.x was missing XID.
- Fixed a bug where a field could be deleted from a weblog/channel but an attempt to harvest that field on publish might occur.
- Fixed a bug where multiple harvested tag fields sometimes had the wrong channel ID assigned in the entries table.
- Fixed a bug where the footer.html files was missing from the 2.x view files.
- Fixed various UI issues.
- Removed "flow_ui" theme from Tag module in EE 1.x.
Version 3.0.2 (August 18, 2010)
- Added {tag_count} and {tag_total_results} variables to Tag:Tags to avoid naming conflicts with the variables parsed by Weblog:Entries.
- Fixed a bug where tags with spaces did not get wrapped in quotes when auto suggested in the Publish page.
- Fixed a bug where the Tags tab was inserted incorrectly and did not play nice with custom layouts.
- Fixed a bug where Tag:Entries would incorrectly parse foreign characters in custom weblog fields in EE 1.6.x.
- Fixed a bug where data from custom fields were being inserted into the Tag field in the Publish page upon update in EE 2.x.
- Fixed a misspelling in the Preferences page.
Version 3.0.1 (July 12, 2010)
- Added support for submitting Tags through the SAEF in EE 2.x.
- Modified all instances of BASEPATH to now use PATH_THIRD as the app folder is outside of the system folder in EE 2.1.
- Fixed a bug where the Tag tab was being called in the SAEF on the front end in EE 2.x.
Version 3.0.0 (June 23, 2010)
- Added a simple search ability to the Manage Tags area of the Tag control panel.
- Added a "cloud-like" clickable list of Tags to the UI (for EE 1.6.x) to easily add existing common Tags to an entry.
- Added {count} and {total_results} variables to the Tag:Tags tag.
- Added {subscribe_link} and {unsubscribe_link} variables to the Tag:Subscribed tag.
- Changed wording for removing of tags from "Bad" status.
- Upgraded module to use Solspace Bridge 1.0 with CodeIgniter, therefore allowing compatibility with EE 2.x.
- Fixed a bug where Bad Tags were still being shown in the Tag:Tags tag.
- Fixed a bug where the Tag_Name tag was ignoring the websafe_separator="" parameter completely.
- Fixed a bug where the inclusive="yes" with multiple tags in tag="" was sometimes treated as OR instead of AND in Tag:Entries.
Installation
ExpressionEngine 2.x Installation Instructions
1. Copy Add-on Files
- Within the /EE2/system/expressionengine/third_party/ directory, copy the tag folder into your sites’ ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy the tag folder into your sites’ ./themes/third_party/ directory.
2. Installing the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel, find Tag in the list, and click Install.
3. Setup & Configuring
- Use of this add-on requires special Tag fields to be created, and a few preferences be set in the Tag control panel. Consult the documentation on this for more information.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Installation Instructions
1. Copy Add-on Files
- Within the /EE1/system/ directory, copy the bridge folder into your sites’ ./system/ directory.
- Within the /EE1/system/modules/ directory, copy the tag folder into your sites’ ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy the ext.tag_extension.php file into your sites’ ./system/extensions/ directory.
- Within the /EE2/themes/ directory, copy the tag folder into your sites’ ./themes/ directory.
2. Installing the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel, find Tag in the list, and click Install.
3. Setup & Configuring
- Use of this add-on requires a few preferences be set in the Tag control panel. Consult the documentation on this for more information.
- Go to the Extensions Manager area in the ExpressionEngine Control Panel, and make sure the jQuery for the CP extension exists and is enabled.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Updates
- Upgrading from Tag 3.x or 4.x to latest Tag 4.x on EE 2.x
- Upgrading from Tag 3.x or 4.x to latest Tag 4.x on EE 1.x
- Upgrading from Tag 2.x to Tag 4.x
- Upgrading from Tag 2.x to latest Tag 2.x
After downloading the latest version of the add-on, unzip the download file and follow these instructions...
ExpressionEngine 2.x Updating Instructions
1. Copy Add-on Files
- Within the /EE2/system/expressionengine/third_party/ directory, copy the tag folder into your sites' ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy the tag folder into your sites' ./themes/third_party/ directory.
2. Updating the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel and click the link for Tag.
- Click the Update link now displayed in the module's control panel.
- If you're updating from Tag 3.x to Tag 4.x, please click here to follow additional special instructions.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Updating Instructions
1. Upgrading from Tag 2.x to Tag 4.x (if applicable)
If you're upgrading from Tag 2.x to Tag 4.x, please follow the special instructions below:
- Take your site Offline. We recommend that you take your site offline for the duration of the update so that people visiting your site won't see any PHP errors, etc.
- Go to the Extensions area in the ExpressionEngine Control Panel, find Tag Submit in the list, and click Disable.
- Delete the language files named lang.tag.php, lang.tag_fns.php, and lang.tag_submit.php in your ./system/language/english/ directory.
- Delete the folder named tag in your ./system/modules/ directory.
- Delete the extension file named ext.tag_submit.php in your ./system/extensions/ directory.
- Delete the folder named tag_themes in your ./themes/ directory.
2. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It is included with your download in a separate folder.
- Within the /EE1/system/ directory, copy the bridge folder into your sites' ./system/ directory.
- Within the /EE1/system/modules/ directory, copy the tag folder into your sites' ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy the ext.tag_extension.php file into your sites' ./system/extensions/ directory.
- Within the /EE1/themes/ directory, copy the tag folder into your sites ./themes/ directory.
3. Updating the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel and click the link for Tag.
- Click the Update link now displayed in the module's control panel.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Software Support
We pride ourselves on our level of support and our attention to the customer. If you have an issue, we're here to help.
30-day Money Back Guarantee
If your software purchase does not meet your expectations, or is not right for you, just let us know and we'll give you a full refund within 30 days of purchase.
Affiliate Program
Add a Solspace Affiliate link to your site and make 5% on referred purchases. Read more »



