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: 5 730

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 10

Forks: 4

Open Issues: 1

Type:silverstripe-vendormodule

2.2.0 2023-08-03 07:12 UTC

This package is auto-updated.

Last update: 2024-03-03 08:26:26 UTC


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.