GTM Kit Changelog

You can follow the development on our Github repository. Constributions are welcome!

Changelog

[2.2.1] – 2024-10-29

Bugfixes:

  • If the cart and checkout endpoints were set to the same page in order to skip the cart the ‘checkout’ and ‘purchase’ events would not fire.

Other:

  • Tested up to WordPress 6.7.

[2.2] – 2024-10-16

Enhancements:

  • Added notifications and warnings for missing GTM container, debug log usage, auto-update and event inspector usage. These improvements aim to ensure smooth production operations.

Other:

  • Minor refactoring

[2.1] – 2024-10-01

Enhancements:

  • Added support for the Bricks theme builder.

Bugfixes:

  • In some cases other plugins or a theme could block GTM Kit from firing JS event like the one that fires the add_to_cart GTM event.

[2.0] – 2024-09-11

Breaking change:

  • Starting with GTM Kit version 2.0, the add_to_wishlist event is no longer supported in the free version of GTM Kit.

Enhancements:

  • A notifications handler has been added to communicate issues and notifications that require the user’s attention.
  • Added a warning when other Google Tag Manager plugins that may cause a conflict are active.
  • WooCommerce users are advised to install a supported SEO plugin to take advantage of a default category in data layer items.

Other:

  • Increased PHPStan analysis level to 6, enhancing static code analysis and catching potential issues earlier in the development process.
  • Require WordPress 6.3.
  • Require WooCommerce 8.3.
  • Require PHP 7.4.

[1.23.3] – 2024-08-22

Bugfixes:

  • Prevent fatal errors caused by invalid filter input from third-party plugins.
  • In WordPress versions prior to 6.6, the options pages fail to load due to a missing dependency.

[1.23.2] – 2024-08-13

Other:

  • Require WooCommerce 8.2.
  • Tested up to WooCommerce 9.2.

[1.23.1] – 2024-07-15

Enhancements:

  • The ‘Getting Started’ section the setup wizard has been updated with new content.

Bugfixes:

  • An upgrade function was causing problems for multisite installations leading lost configuration.

[1.23] – 2024-07-04

Enhancements:

  • Added an option to exclude selected user roles from tracking.
  • Improve the flexibility of GTM Kit integrations.

Other

  • Tested up to WooCommerce 9.1.
  • Tested up to WordPress 6.6.

[1.22.4] – 2024-05-30

Enhancements:

  • Improve log and support data.

Bugfixes:

  • There was a typo preventing the GTMKIT_WC_DEBUG_TRACK_PURCHASE constant from having any effect.

Other:

  • Tested up to WooCommerce 8.9.

[1.22.3] – 2024-05-22

Bugfixes:

  • The datalayer was not pushed when the container was disabled.

[1.22.2] – 2024-05-14

Bugfixes:

  • Fix items in add_shipping_info and add_payment_info.

[1.22.1] – 2024-05-13

Bugfixes:

  • wait_for_update was not printed in Google Consent Mode default settings.

[1.22] – 2024-05-08

Enhancements:

  • Added an Event Inspector for verifying that events are being pushed to the datalayer. You can now debug events without using GTM preview mode.
  • Added advanced GCM settings: ‘ads_data_redaction’, ‘url_passthrough’ and ‘wait_for_update’.
  • Updated the custom container loader for use with Stape.io.

[1.21] – 2024-04-15

Enhancements:

  • Added user-data in the datalayer containing user data formatted for the User-Provided Data variable so you don’t have to map it manually.
  • Added Google Tag Manager templates for Google Ads and Facebook.
  • Added dynamic template sections that allows for template updates wíthout updating the plugin.
  • The tutorial section is now dynamic and based on a feed, so we don’t have to update the plugin to include new tutorials.

Bugfixes:

  • JavaScript translations was not loaded correct.

Other:

  • Tested up to WooCommerce 8.8.

[1.20] – 2024-03-20

Enhancements:

  • Added a new section for GTM templates that you can use to configure the necessary Tags, Triggers and Variables in Google Tag Manager.
  • Added support for the ‘new_customer’ parameter on the ‘purchase’ event, which is used for customer acquisition reporting and Google Smart Shopping campaigns.
  • Added a debug log for debugging the ‘purchase’ event without make a purchase.
  • Improved the pagespeed of the control panel. The control panel is now loading significantly faster than before.

Bugfixes:

  • Add missing ‘currency’ on the ‘view_item’ event.
  • Add missing ‘payment_type’ on the ‘add_payment_info’ event.
  • On the ‘add_shipping_info’ and ‘add_payment_info’ events the items parameter was cast as an object instead of an array as it should be.

Other:

  • Require WooCommerce 8.0.

[1.19.1] – 2024-03-05

Bugfixes:

  • Scripts were not enqueued if the container was inactive.

Other:

  • Tested up to WooCommerce 8.7.

[1.19] – 2024-02-07

Enhancements:

  • Add option to fire a ‘load_delayed_js’ event, which can be used to delay JavaScript execution in Google Tag Manager.
  • This release comes with many behind-the-scenes improvements and general enhancements.
  • The script settings are the same on all pages and are now cached in the object cache for better performance.
  • The function to share system data with the support team has been improved with more data.
  • The code has been refactored for extendability.

[1.18.1] – 2024-01-08

Bugfixes:

  • Added missing flush of the ecommerce object on the select_item event.
  • 1.17 introduced a bug that caused item brand to be limited to a product attribute.

Other:

  • Tested up to WooCommerce 8.5.
  • Minor refactoring.

[1.18] – 2024-01-02

Enhancements:

  • Add support for Google Consent Mode v2
  • Added a function to share system data with the GTM Kit support team. If you have registered a support request on WordPress.org and the GTM Kit support team has asked you to send your system data you can now do that in a secure way without posting any private information in the support forum.
  • Enhanced support for the select_item event in more WordPress themes. This update significantly improves the compatibility of the select_item event handling in themes such as Woodmart.

Bugfixes:

  • When adding a product to the cart from a product category page the quantity was not specified in the add_to_cart event.
  • On Single product pages a click on a quantity control would result in an undefined event.

[1.17] – 2023-12-04

Enhancements:

  • Added option to specify the Google Tag Manager environment.
  • Performance optimization through optimized database queries and general code improvements.
  • Added a filter to deactivate the container, so the container can be deactivated on specific pages.
  • Improved support of the ‘add_to_wishlist’ event. Themes and plugins just have to add the class ‘add_to_wishlist’ on the ‘Add to wishlist’ button.

Bugfixes:

  • Add missing _sbp cookie in the cookie keeper.
  • The constant GTMKIT_EDD_DEBUG_TRACK_PURCHASE and GTMKIT_WC_DEBUG_TRACK_PURCHASE was not overriding correct.
  • Because of recent changes in WooCommerce clicks on grouped products in a product list would be treated as add_to_cart and not select_item.
  • Clicks on variation products and grouped products in product lists was treated as add_to_cart events and are now select_item events as they should be.
  • If a product ID prefix was used the ‘add_to_cart’ event did not work on grouped products.

Other:

  • Refactoring code for simplicity and maintainability.

[1.16.2] – 2023-11-15

Bugfixes:

  • Fix critical JS bug.

[1.16] – 2023-11-15

Enhancements:

  • Add option to include customer data from Easy Digital Downloads on the purchase event.
  • Added the filter ‘gtmkit_datalayer_script’, which allows you to filter the datalayer script.
  • Added the constant ‘GTMKIT_EDD_DEBUG_TRACK_PURCHASE’, which allows users of Easy Digital Downloads to force tracking of purchase event on every page refresh for debugging.

Bugfixes:

  • Billing state and shipping stat was not included in the customer data on the ‘purchase’ event.

Other:

  • Tested up to WordPress 6.4
  • Tested up to WooCommerce 8.3

[1.15] – 2023-10-24

Enhancements:

  • Added support for the WooCommerce block ‘all-products’.
  • Inline scripts are now registered with the wp_add_inline_script insted of wp_head. This allows easy extension GTM Kit and implementation of a CSP (Content Security Policy).

Bugfixes:

  • The product ID Prefix was not added when a product variation was selected.
  • Tax was not added on the total on the add_shipping_info and add_payment_info events.

[1.14.2] – 2023-10-11

Bugfixes:

  • Items was not loaded correct in the Ease Digital Downloads begin_checkout event.
  • Fixes a problem where variation products would use the master product id.
  • Fixes an error when shipping was selected in the WooCommerce block cart.
  • Using variation product selection without including gtmkit_product_data would result in a JavaScript error.
  • Using the WooCommerce ‘All products’ block without including gtmkit_product_data would result in a JavaScript error.

[1.14.1] – 2023-10-06

Bugfixes:

  • Set custom page type in post sidebar was removed by mistake in 1.14
  • Fix possible naming collision with other GTM plugins

[1.14] – 2023-10-03

Enhancements:

  • There is a new admin GUI based on WordPress components and the admin is now more extendable.
  • We have added a more robust method of adding data attributes to the HTML.
  • The autoload of options has been optimized for better performance.

Bugfixes:

  • Flush cache after setting or updating an option.

Other:

  • Require WordPress 6.2
  • Require WooCommerce 7.6
  • Tested up to WooCommerce 8.2

[1.13.2] – 2023-09-25

Bugfixes:

  • Fixes a bug that prevented the option to import settings from other plugins on first install.

[1.13.1] – 2023-08-31

Bugfixes:

  • Fixes a bug where a REST request could fail because the function is_plugin_active() is not ready.

Other:

  • Tested up to WooCommerce 8.1

[1.13.0] – 2023-08-30

Enhancements:

  • Add option to set Google Consent Mode default settings if a Consent Management Platform is not used.
  • Added support for import of more plugin configurations.
  • Prevent Consent Management Platforms from blocking GTM Kit and the Google Tag Manager container. This can be overridden with the filter hook ‘gtmkit_header_script_attributes’.

Bugfixes:

  • Fix a bug that in some cases would cause a namespace problem.

Other:

  • Declare compatibility with the WooCommerce Cart and Checkout blocks.
  • Comply with WordPress Coding Standards.

[1.12.2] – 2023-08-15

Bugfixes:

  • Fixes an error when no payment gateways are defined.
  • Fixes empty items in begin_checkout event.

[1.12.1] – 2023-08-07

Bugfixes:

  • A custom datalayer name was not registered correct

[1.12] – 2023-08-07

Enhancements:

  • Improved support for the WooCommerce cart and checkout blocks
  • Added the class input-needed to the block list of the add_to_cart event
  • Added option to import plugin settings from GTM4WP in the setup wizard
  • Improved the setup wizard with option to enable essential settings

Other:

  • Use global object for script data and settings
  • Require WooCommerce 7.1
  • Require WordPress 6.1
  • Tested up to WordPress 6.3
  • Tested up to WooCommerce 8.0

[1.11.1] – 2023-07-07

Bugfixes:

  • Cast transaction_id to string. According to the GA4 documentation transaction_id should be a string as it allows numbers, letters, and special characters like dashes or spaces.

[1.11] – 2023-07-04

Enhancements:

  • Added Just-The-Container mode for those with simple needs. This option reduces the functionality to just the GTM container code.
  • Added help section with GTM container import files

Other:

  • Removed option to delay the container script by 2 seconds.
  • WooCommerce tested up to: 7.9
  • Added PHPStan to ensure code quality
  • Refactored code and improved code quality
  • All PHP classes are marked ‘final’
  • The Gulp build tool has been removed and we are now using NPM as a build tool

[1.10] – 2023-06-12

Enhancements:

  • Added setup wizard for onboarding new users

Other:

  • Updated dependencies
  • Implemented Tailwind

[1.9] – 2023-04-19

Enhancements:

  • Added option to include the customer data in the data layer on the “purchase” event.
  • Added the constant ‘GTMKIT_WC_DEBUG_TRACK_PURCHASE’, which allows you to force tracking of purchase event on every page refresh for debugging.

Bugfixes:

  • Fixed a bug where Easy Digital Download Pro was not detected.

Other:

  • Changed required capability from ‘install_plugins’ to ‘manage_options’.
  • WooCommerce tested up to: 7.6.

[1.8] – 2023-04-03

Enhancements:

  • Added ‘add_to_wishlist’ event when used together with the most popular wishlist plugins ‘YITH WooCommerce Wishlist’ and ‘TI WooCommerce Wishlist’.
  • Improve compatibility with other plugins and customisations.
  • Added item_variant to the items element in the datalayer.
  • Added ‘coupon’ to the datalayer.
  • Added option to log helpful messages and warnings to the browser log.

Bugfixes:

  • Fixed a bug where inline styles would be stripped from the HTML.
  • Fixed af bug where items in the ‘view_cart’ event had double brackets.

[1.7.1] – 2023-03-23

Bugfixes:

  • The begin_checkout event did not contain data layer values for ecommerce.currency and ecommerce.value

[1.7] – 2023-03-20

Enhancements:

  • Added support for the new WooCommerce checkout block
  • Added meta box on posts where you can enter the page type to be included in the data layer.
  • Added the filter gtmkit_admin_capability, which allows you to set the capability required to manage the plugin options.
  • Added option to share anonymous data with the development team to help improve GTM Kit.

Bugfixes:

  • Type cast the item value to prevent string values in the data layer
  • On installations of Easy Digital Download where the Confirmation Page was not configured the Purchase event would not fire.

Other:

  • Minor styling of the dashboard
  • Updated the tutorial section
  • Improved some help texts
  • Added missing translation strings
  • WordPress tested up to 6.2
  • WooCommerce tested up to: 7.5.

[1.6.2] – 2023-02-27

Bugfixes:

  • Backwards compatibility with PHP 7.2. Trailing comma in function calls is only available since PHP 7.3

[1.6.1] – 2023-02-23

Enhancements:

  • Added declaration of plugin compatibility with WooCommerce High-Performance Order Storage.

Other:

  • WooCommerce tested up to: 7.4

[1.6] – 2023-01-24

Enhancements:

  • Added support Easy Digital Downloads for the events: view_item, add_to_cart, begin_checkout, purchase
  • Added support for primary product category in Rank Math SEO

Other:

  • WooCommerce tested up to: 7.3
  • Refactored integrations
  • Added missing translation string

[1.5.3] – 2023-01-03

Enhancements:

  • Align text domain with GlotPress making the plugin compatible with translations from WordPress.org

[1.5.2] – 2023-01-03

Enhancements:

  • Added better help texts.
  • Fixed typos.

[1.5.1] – 2022-12-20

Enhancements:

  • Added better support for the Google Ads remarketing tag.

[1.5] – 2022-12-12

Enhancements:

  • Add option til select the Google business vertical value to include in all items. This is used for Google Ads remarketing.
  • Add option to add a prefix to the item IDs.

Bugfixes:

  • Fix wrong currency value in the Data Layer.

[1.4.5] – 2022-11-26

Enhancements:

  • By default the Contact Form 7 integration script will only load on pages where the Contact Form 7 script is registered.
  • Tutorials and help text have been improved

Bugfixes:

  • Fix datalayer_name collision when both WooCommerce and CF7 integration are active.

Other:

  • WooCommerce tested up to: 7.1

[1.4.4] – 2022-11-20

Enhancements:

  • Added tutorials section to the dashboard.

Bugfixes:

  • Fix the description og the CF7 integration.

[1.4.3] – 2022-11-08

Bugfixes:

  • The items object was limited to 1 on the checkout page.

[1.4] – 2022-11-03

Enhancements:

  • Added options to add user data to the datalayer (logged in, user ID, user role).
  • Added option to limit view_item event on variable products to the master product instead of pushing the view_item event on both the master and selected variation.
  • Added edit button on container dashboard

Bugfixes:

  • Clear the previous ecommerce object before add_to_cart.
  • Set default option for CF7 integration

Other:

  • Added support links in help section

[1.3.3] – 2022-10-30

Bugfixes:

  • Fix custom datalayer name in CF7.

[1.3.1] – 2022-10-06

Bugfixes:

  • A custom container domain would not be used in the noscript container.

[1.3] – 2022-09-30

Enhancements:

  • Added compatibility with WooCommerce High-Performance Order Storage.
  • Added DNS prefetch for the Google Tag Manager host.
  • Added Contact Form 7 Integration.
  • New admin dashboard.
  • New admin navigation.

Other:

  • Cleaned up and formatted code.

[1.2] – 2022-09-13

Enhancements:

  • Option to include the defined page type. I.e. post, page, product, category, cart, checkout etc.

[1.1] – 2022-09-11

Enhancements:

  • Option to include the permalink structure of the product base, category base, tag base and attribute base in the datalayer.
  • Option to include the path of cart, checkout, order received adn my account page in the datalayer.

Bugfixes:

  • Fixes a bug where an aggressive wp_kses filter prevents add to cart tracking on product catagory pages.

Other:

  • Disable WooCommerce settings if WooCommerce is not active
  • Update logo.

[1.0] – 2022-09-06

The plugin has been used in production for a year and is considered stable. This is the first public release.