awcodes/gtm

Easy integration of Google Tag Manager into your Laravel application.

Fund package maintenance!
awcodes

v1.1.0 2024-04-15 18:19 UTC

This package is auto-updated.

Last update: 2024-10-08 17:11:40 UTC


README

Latest Version on Packagist Total Downloads

Easy integration of Google Tag Manager into your Laravel application.

Installation

You can install the package via composer:

composer require awcodes/gtm

You can publish the config file with:

php artisan vendor:publish --tag="gtm-config"

This is the contents of the published config file:

return [
    'id' => env('GTM_ID', 'GTM-XXXXXX'),
    'enabled' => env('GTM_ENABLED', true),
];

Optionally, you can publish the views using

php artisan vendor:publish --tag="gtm-views"

Usage

  1. Add your GTM_ID to your .env file
  2. Simply add the blade components to your base layout files.

The enabled attribute is optional, but can be used to control the tags integration from blade files that extend the base layout. It accepts true/false. This can still be controlled globally via the .env file should you need to disable the integration global on different environments as well.

<!-- Should be placed in the head -->
<x-gtm::script :enabled="$enabled" />

<!-- Should be placed after the opening body tag -->
<x-gtm::no-script :enabled="$enabled" />

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.