README

安装

通过 ContaoManager 或 Composer 安装 composer require slashworks/contao-trackingmanager-bundle

配置

在相应的根页面上启用跟踪管理器，并相应地填写文本、按钮等字段。

Cookie 配置

在后台跟踪管理器中，现在可以创建任意数量的 Cookie。这仅用于后续的控制。您可以点击“创建基础配置”按钮生成一个基础配置。这将创建一个系统相关的 Cookie 提示和 Google Analytics（截至 2020 年 6 月）。我们必须为每种语言单独创建提示，并为每种语言定义至少一个基础 Cookie。

最后，我们需要再次切换到我们语言的根页面，并选择要在这里请求哪些 Cookie。

到目前为止，我们只控制管理器的显示。尚未阻止 Cookie。

防止 Cookie 输出或设置 Cookie 的脚本的代码

当跟踪管理器显示且用户接受 Cookie 时，管理器将设置自己的 Cookie 以记住选择。Cookie 的名称与配置名称相对应。（例如，tm_base 和 bozi_ga）。在 tm_base Cookie 中，我们存储当前的配置。如果此配置更改，跟踪管理器将再次显示。

现在，在您想要设置相应 Cookie 的代码中，我们可以进行查询，以检查 Cookie XY 是否被接受。

if(TrackingManagerStatus::getCookieStatus('bozi_ga')){}

//oder mehrsprachig falls es das selbe Skript ist
if(TrackingManagerStatus::getCookieStatus('bozi_ga') or TrackingManagerStatus::getCookieStatus('bozi_ga_en')){} …usw

这控制了 bozi_ga 被接受时的输出。因此，在模板中只需用相应的代码区域将其包裹起来。这可以用于任何配置的 Cookie。

扩展统计

通过添加一个钩子可以扩展统计。这个钩子应该如下所示

 $GLOBALS['TL_HOOKS']['generateTimeConfig'] =
        array('myRowTitle' => array(
            'start' => new \DateTime('01.01.1970'),
            'end' => new \DateTime(),
            'status' => 1
            )
        );

为此，您需要一个用于时间范围标题的语言变量。

 $GLOBALS['TL_LANG']['tl_tmConfig']['myRowTitle'] = 'My language variable';

新功能 4

现在，可以通过 Cookie 后台模块将多个模板分配给 Cookie。这样，就无需像上面描述的那样编辑模板。目前，只考虑了 analytics 模板。

编辑 Cookie 设置 - 再次显示跟踪管理器

在根页面的设置中，默认启用“显示编辑按钮”复选框：在前端显示一个 Cookie 编辑按钮。用户可以通过它更改自己的 Cookie 设置。此外，可以使用新的插入标签来创建一个内联元素，该元素也可以再次显示跟踪管理器。

 {{tm_editor::Cookies bearbeiten}}

作为第二个参数，可以输入所需的文本。

如果想要独立插入 Cookie 编辑按钮并特别调整输出，则可以将任何元素设置为具有属性 `data-action="show_trackingmanager"`。点击该元素将打开跟踪管理器。

slashworks / contao-trackingmanager-bundle

维护者

详细信息