README

Matomo Analytics 是 WinterCMS 的一个插件，用于 Matomo，这是一个 Google Analytics 的替代品，允许网站所有者拥有自己的分析数据并保护其客户的隐私。

先决条件

您必须能够访问 Matomo，无论是通过 Matomo 提供的云服务，还是通过一个 私有 Matomo 实例。如果您对隐私问题非常担忧，您可能想要选择一个私有实例。

安装

使用 Composer 通过执行以下命令安装插件：

composer require mercator/wn-matomo-plugin

并运行

php artisan winter:up
php artisan cache:clear

从您的 WinterCMS 安装根目录。

或者，创建一个名为 "mercator/matomo" 的目录，从 Github 下载文件，并将它们移动到新创建的子目录中。

一旦 WinterCMS 市场可用，将从 WinterCMS 后端添加安装。

插件使用

为了使用此插件，您必须具备基本的 Matomo 知识，特别是您必须知道如何创建新的跟踪实例、用户和安全令牌。不要担心，通过在 Matomo 中尝试操作，学习起来相当简单。

配置

在 Winter 后端，转到 Matomo Analytics 插件的设置。

为了使 Matomo Analytics 运行，

• 确定您打算使用的分析服务器（例如，matomo.org）。
• 在 Matomo 后端设置您的 CMS 服务器进行跟踪，并记下服务器 ID
• 再次在 Matomo 后端生成一个安全令牌（所谓的 Auth Token）。请注意，Auth Token 必须在 没有 管理员访问权限的用户下创建
• 将以上三项信息输入 Winter CMS 后端插件部分
• 可能需要禁用您正在使用的任何广告拦截器

跟踪

要开始跟踪您的访问者，请转到 Winter CMS 的 CMS 部分，并将跟踪代码拖放到 Winter 网站的布局（s）上。

这样，Matomo 应该开始跟踪，您应该很快看到结果。请注意，Matomo 提供几乎实时的结果，重点是“几乎”，所以您可能需要等待几分钟才能看到第一个结果。

报告

转到Winter仪表板并添加一个新的小部件。在添加新小部件时，在Winter仪表板中选择Matomo小部件作为小部件类型。然后，选择实际的报告类型。对于每个添加的报告，您可以更改报告期间（7/30/360天）以及报告的显示方式（例如，饼图）。还可以导出单个报告的数据。

此外，还提供完整的Matomo仪表板。这是Matomo后端中仪表板的副本。在Winter仪表板中创建小部件时，只需选择Matomo仪表板作为小部件类型即可。

后端的报告选项卡提供可用报告的列表。

急救

如果您在添加小部件时无法选择Matomo小部件或Matomo仪表板，请检查后端的配置设置。特别是确保已启用Winter仪表板小部件。

如果您在Winter仪表板上看到错误消息

• 请检查后端的配置设置
• 确保您正在使用的Matomo用户的Auth Token只具有只读权限。

如果您在Winter仪表板上看到空的小部件

• 请检查后端的配置设置
• 请检查小部件的配置设置，特别是您是否确实选择了一个报告，以及表示是否有意义

如果您的Matomo小部件无法调整大小（并且部分内容被隐藏）

• 将小部件配置中的宽度设置为另一个值，例如，12列改为6列。之后您可以将其设置回原始值
• 删除并重新添加小部件

感谢

我要感谢WinterCMS的团队成员们对他们持续的支持——不仅是为了完成这个插件，还包括我过去两年中所写的其他插件。

请注意，这不仅仅关乎金钱。这是对我时间的认可。

贡献

请随意发送拉取请求！请将拉取请求发送到master分支。

结语

此插件由瑞士库斯讷特阿姆里吉的赫尔穆特·考夫曼（Helmut Kaufmann）编译。赫尔穆特可以通过电子邮件software@mercator.li联系。

虽然它看起来很简单，但将此插件组合起来花费了一些时间。因此，如果您觉得它有用，请随意赞助一杯啤酒，两杯或更多都欢迎。《a href="https://www.paypal.com/donate/?hosted_button_id=MZYBN2NEDEDNC" rel="nofollow noindex noopener external ugc">PayPal可能是您的最佳选择...

许可证

版权所有2022年，瑞士库斯讷特阿姆里吉赫尔穆特·考夫曼（《a href="https://mercator.li" rel="nofollow noindex noopener external ugc">https://mercator.li）。

本程序是自由软件：您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发和/或修改它，许可证版本为3，或（根据您的选择）任何较新版本。

本程序以供使用为目的进行分发，但没有任何保证；甚至没有对适销性或适用于特定目的的隐含保证。有关更多信息，请参阅GNU通用公共许可证。

您应该已经收到随本程序一起提供的GNU通用公共许可证副本。
如果没有收到，请参阅https://gnu.ac.cn/licenses。