搜索冬季 / wn-matomo-plugin
将 Matomo 分析与 Winter CMS 集成
Requires
- php: >=7.2
- composer/installers: ~1.11
This package is auto-updated.
Last update: 2024-09-16 05:28:16 UTC
README
Matomo 是一个替代 Google Analytics 的工具，允许网站所有者拥有自己的分析数据并保护客户的隐私。这是一个将 Matomo 集成到 WinterCMS 的 WinterCMS 插件，提供报告小部件、基于客户端的跟踪组件以及（计划中）服务器端跟踪组件。
先决条件
您必须能够访问 Matomo，无论是通过 Matomo 提供的云服务还是通过 自托管 Matomo 实例。如果您对隐私非常担忧，您可能希望选择自托管的实例。
插件使用
您必须具备基本的知识才能使用此插件。特别是，您必须知道如何创建新的跟踪实例、用户和安全令牌。不要担心，通过在 Matomo 中玩耍，学习这些是非常容易的。
在 Matomo 上设置站点
为了为您的 Winter CMS 实例设置 Matomo 分析
- 确定您打算使用的分析服务器（例如，matomo.org）。
- 在 Matomo 后端设置您的 CMS 服务器以进行跟踪并记下站点 ID
- 再次在 Matomo 后端生成一个安全令牌（一个 Auth Token）。请注意，必须在一个 没有 超级管理员访问权限的用户下创建 Auth Token
- 将 Matomo 服务器 URL、站点 ID 和 Auth Token 添加到此插件的配置中
注意：您可能想禁用您目前正在使用的任何广告拦截器。
注意：当检测到经过身份验证的后端用户或网站处于维护模式时，跟踪器将被禁用
配置
此插件的配置是通过一个 配置文件 处理的。为了修改配置值并开始使用，您可以将值添加到您的 .env 环境文件中，或者将 plugins/winter/matomo/config/config.php 文件复制到 config/winter/matomo/config.php 并在那里进行更改。
环境文件支持的值
MATOMO_SERVER="https://example.matomo.cloud/"MATOMO_SITE_ID=1MATOMO_TOKEN=""
跟踪
要开始跟踪您的访客，只需将 Tracker 组件添加到您想包含 Matomo 跟踪器的所有页面的 <head> 部分。
注意：跟踪组件必须在关闭
</head>标签之前渲染。
这样，Matomo 应该开始跟踪，并且您应该很快看到结果。
注意：Matomo 提供了侧重于“近”的近实时结果，所以您可能需要等待几分钟才能看到第一个结果。
报告
此插件提供两个主要的仪表板报告小部件。
第一个小部件是“分析仪表板”小部件，它通过使用 iframe 将整个 Matomo 仪表板嵌入到 Winter 仪表板中。建议您将此小部件设置为最大宽度，以便轻松查看所有数据。此小部件支持更改报告的时间段。
第二个小部件是“分析报告”小部件，它提供从预设的常用报告列表中选择的功能，这些报告可以嵌入到Winter仪表板上的独立小部件中。每个小部件都允许您配置要检查的时间段、数据的显示方式以及结果中包含的行数。还可以导出单个报告的数据。
致谢
此插件最初由瑞士库斯讷特阿尔里吉的赫尔穆特·考夫曼编写。您可以通过电子邮件 software@mercator.li 联系赫尔穆特。
随后，它已被修改并作为Winter CMS的第三方插件重新发布，由Winter CMS团队和赫尔穆特·考夫曼维护。
如果您想为此插件的开发做出贡献，请随时向此插件的存储库提交问题或拉取请求：https://github.com/wintercms/wn-matomo-plugin
如果您想支持赫尔穆特·考夫曼，请访问 PayPal。
如果您想支持Winter CMS，请访问 WinterCMS.com。