jonnitto/smartlook

Integrate smartlook.com into your Neos CMS Site

2.0.0 2022-04-05 14:56 UTC

Requires

• neos/neos: ^5.3 || ^7.0 || ^8.0

GPL-3.0

• Jon Uhlmann

• tracking
• smartlook
• recording

README

Jonnitto.Smartlook

Add Smartlook to your Neos CMS site:

Installation

Most of the time you have to make small adjustments to a package (e.g. configuration in Settings.yaml). Because of that, it is important to add the corresponding package to the composer from your theme package. Mostly this is the site packages located under Packages/Sites/. To install it correctly go to your theme package (e.g.Packages/Sites/Foo.Bar) and run following command:

composer require jonnitto/smartlook --no-update

The --no-update command prevent the automatic update of the dependencies. After the package was added to your theme composer.json, go back to the root of the Neos installation and run composer update. Et voilà! Your desired package is now installed correctly.

Set id for recording

You need to set the id on your Settings.yaml file:

Jonnitto:
  Smartlook:
    Id: 123456789012345678901234567890

You get the id after registration on smartlook.com

Automatic handling of forms

The plugin add automaticly data-recording-ignore="mask" to every form tag. This behavior can be disabled via Settings.yaml:

Jonnitto:
  Smartlook:
    ignoreForms: false

Disable recording on a certain page

If you want to disable recording on a certain page you just set the variable track to false:

prototype(Page).head.smartlook.track = false;

or

renderPathPage.head.smartlook.track = false;

If this variable is set to false, smartlook('disable',true); is getting added to the tracking code. To disable the complete code on a page you can delete the complete tag like this: prototype(Page).head.smartlook >