You can follow the development on our Github repository. Constributions are welcome!
Changelog
[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.