chrometoaster / ga-gtm-singlefield
Adds single field to CMS settings section to hold GA or GTM code. Template snippets need to be inserted to theme templates manually.
Installs: 6 091
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 10
Forks: 4
Open Issues: 1
Type:silverstripe-vendormodule
Requires
- php: 7.x || 8.x
- silverstripe/cms: ^4.0 || ^5.0
- silverstripe/framework: ^4.0 || ^5.0
README
Adds support for a single-field configuration of GA/GTM code within the CMS.
Comes with Google snippets that need to be included in your theme's templates.
Requirements
- SilverStripe 4.0 and above
Installation
Module
$ composer require chrometoaster/ga-gtm-singlefield
Alternatively, you can also install the module manually by placing a copy to the root folder of your site.
Run dev/build either via opening the url http://<your-host>/dev/build
in a browser or
by running the dev/build via a CLI.
Theme integration
Place two template includes into your theme's main template, e.g. Page.ss.
Head
<% include GA_GTM_head %>
as close to the opening <head>
tag as possible:
<head itemscope itemtype="http://schema.org/WebSite"> <meta charset="utf-8"> <title itemprop="name">$Title</title> <% include Chrometoaster\GA_GTM\GA_GTM_head %>
Body
<% include Chrometoaster\GA_GTM\GA_GTM_body %>
directly after the opening <body>
tag:
</head> <body> <% include Chrometoaster\GA_GTM\GA_GTM_body %>
Usage
You will see a new 'GA & GTM' tab with a single field for a GA or GTM code under Settings in the CMS.
Insert a valid GA or GTM code and check if it's getting output to the resulting markup correctly.
Changelog
For details of updates, bugfixes, and features, please see the changelog.
TODO
- Replace template includes with TemplateGlobalProvider or Controller function.
- Investigate options for automatically inserting the necessary tags to the markup, e.g. extending the $MetaTags functionality or using Requirements backend.