README

Fathom Lite的统计和图表小部件。

关于隐私和Fathom的说明

如果您关心隐私和网站分析，我鼓励您阅读我关于此的一些想法，解释为什么我从Google Analytics转向Fathom。

TL;DR

Fathom是Google Analytics的替代品。他们提供Fathom Lite，它是免费的，您可以选择自行托管。因此，不会与第三方服务共享任何数据。

尽管Fathom Lite不收集任何个人可识别信息（并且符合GDPR法规），但它目前仍然使用cookie（没有cookie通知则不符合PECR法规）。如果您需要无cookie解决方案，我建议切换到Fathom Pro。不过，Fathom Lite可能会在未来的更新中变为无cookie。

要求

此插件需要Craft CMS 3.0.0-beta.23或更高版本以及Fathom Lite

安装

要安装此插件，请按照以下说明操作。

打开您的终端并转到您的Craft项目
```
 cd /path/to/project
```

然后告诉Composer加载此插件

 composer require stenvdb/craft-fathom-analytics

在控制面板中，转到设置→插件，并点击Fathom Analytics的“安装”按钮。

Fathom Analytics概览

此插件仅与自托管的开源版本Fathom Lite一起工作。原因在于Fathom没有官方文档化的API。一旦Fathom发布官方文档化的API（可能正在进行中），我将考虑提供Fathom Pro的支持。在此期间，此插件使用Fathom已非常出色的内部API。

配置Fathom Analytics

显然，此插件需要Fathom在您的服务器上运行。一旦启动并运行（这非常简单），请在config/fathom-anaytics.php文件中配置Fathom Analytic的设置（支持多站点配置）。以下是一个示例

<?php

return array(
    '*' => array(
        // The domain name where Fathom is hosted. This is also the URL where the tracker code is pointed to.
        'baseUri' => '$FATHOM_BASE_URI',

        // The tracking ID of this site. You can find the ID in your tracking code snippet, e.g.: ABCDE
        'trackingId' => '$FATHOM_TRACKING_ID',

        // You can also use multi-site config values, e.g.
        // 'trackingId' => [
        //     'default' => '$FATHOM_TRACKING_ID',
        //     '<...>' => '<...>'
        // ]

        'username' => '$FATHOM_USERNAME',

        'password' => '$FATHOM_PASSWORD',

        // Automatically inject a tracking script in your site
        'injectTracking' => false,
    ),
    'production' => [
        'injectTracking' => true,
    ],
);

跟踪代码片段

当启用injectTracking设置时，跟踪代码片段（可在插件设置中编辑）将自动注入到您的网站head部分。默认情况下此功能是禁用的。

或者，您可以使用以下代码片段在模板中强制代码注入

{% do craft.fathomAnalytics.inject() %}

Fathom Analytics路线图

支持Fathom Pro
条目跟踪报告字段（基于每个条目）
有什么想法？告诉我

stenvdb / craft-fathom-analytics

维护者

详细信息