Skip to content
Statistics and chart widgets for Fathom Lite analytics.
PHP JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
boilerplate
resources/img screenshot Feb 8, 2020
src Initial commit Feb 6, 2020
.craftplugin craft plugin desc Feb 11, 2020
.gitignore Initial commit Feb 6, 2020
CHANGELOG.md Initial commit Feb 6, 2020
LICENSE.md Initial commit Feb 6, 2020
README.md Redme Feb 11, 2020
composer.json Initial commit Feb 6, 2020
package-lock.json Initial commit Feb 6, 2020
package.json
tailwind.config.js Initial commit Feb 6, 2020

README.md

Fathom Analytics for Craft CMS

Statistics and chart widgets for Fathom Lite.

Screenshot

A word about privacy & Fathom

If you care about privacy and website-analytics, I encourage you to read some of my toughts about it, explaining why I made the move from Google Analytics to Fathom.

TL;DR

Fathom is a Google Analytics alternative. They offer Fathom Lite, which is free and you can self-host. Thereby no data is being shared with third party services.

Although Fathom Lite does not collect any personally identifiable information (and is GDPR compliant), it currently still uses a cookie (and is not PECR compliant without a cookie notice). If you need a cookie-free solution, I suggest switching to Fathom Pro. Fathom Lite might become cookie-free in a future update though 🤞.

Requirements

This plugin requires Craft CMS 3.0.0-beta.23 or later and Fathom Lite

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:

     cd /path/to/project
    
  2. Then tell Composer to load the plugin:

     composer require stenvdb/fathom-analytics
    
  3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Fathom Analytics.

Fathom Analytics Overview

This plugin only works with Fathom Lite, the self-hosted open source version. Reasons being Fathom does not have an official documented API. Once Fathom releases a documented API (which might be in the works), I'll consider providing support for Fathom Pro. In the meantime, this plugin uses Fathom's already great internal API.

Configuring Fathom Analytics

This plugin obviously requires Fathom running on one of your servers. Once it is up and running (which is super easy), configure Fathom Analytic's settings:

// 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',

'username' => '$FATHOM_USERNAME',

'password' => '$FATHOM_PASSWORD'

Fathom Analytics Roadmap

  • Support Fathom Pro
  • Entry tracking report field (on a per entry basis)
  • Have an idea? Let me know
You can’t perform that action at this time.