PHPackages                             paulmorel/fathom-analytics - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. paulmorel/fathom-analytics

ActiveKirby-plugin[Utility &amp; Helpers](/categories/utility)

paulmorel/fathom-analytics
==========================

A Kirby 3 plugin for integrating the Fathom Analytics service to your site.

1.0.0(4y ago)97.4k↓31.7%1[1 issues](https://github.com/PaulMorel/kirby3-fathom-analytics/issues)MITPHP

Since Sep 29Pushed 4y ago2 watchersCompare

[ Source](https://github.com/PaulMorel/kirby3-fathom-analytics)[ Packagist](https://packagist.org/packages/paulmorel/fathom-analytics)[ RSS](/packages/paulmorel-fathom-analytics/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Kirby Fathom Analytics
======================

[](#kirby-fathom-analytics)

[![GitHub release (latest by date)](https://camo.githubusercontent.com/36fbf791fdff51607b0ffa5b33c3425c2600a133b8598cbaa683f90766c7c23b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7061756c6d6f72656c2f6b69726279332d666174686f6d2d616e616c7974696373)](https://camo.githubusercontent.com/36fbf791fdff51607b0ffa5b33c3425c2600a133b8598cbaa683f90766c7c23b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7061756c6d6f72656c2f6b69726279332d666174686f6d2d616e616c7974696373)[![Kirby CMS Version](https://camo.githubusercontent.com/274bfab72c2cf3dcc156f2e1550669aad0c7c565cc09b3b10155d071144d3850/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4b697262792d76332e342e302b2d696e666f726d6174696f6e616c)](https://camo.githubusercontent.com/274bfab72c2cf3dcc156f2e1550669aad0c7c565cc09b3b10155d071144d3850/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4b697262792d76332e342e302b2d696e666f726d6174696f6e616c)[![License](https://camo.githubusercontent.com/df111c26744f3157beaebfc409b8e436575918111bd53ba1ed9da24d162a6876/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7061756c6d6f72656c2f6b69726279332d666174686f6d2d616e616c7974696373)](https://camo.githubusercontent.com/df111c26744f3157beaebfc409b8e436575918111bd53ba1ed9da24d162a6876/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7061756c6d6f72656c2f6b69726279332d666174686f6d2d616e616c7974696373)

A Kirby 3 plugin for integrating the privacy focused [Fathom Analytics](https://usefathom.com/) service to your site.

Main Feautres
-------------

[](#main-feautres)

This plugin does two things:

- It provides a panel view to display the Fathom Analytics dashboard directily in the panel
- It provides a snippet to embed the Fathom Analytics tracking code

Requirements
------------

[](#requirements)

- Kirby CMS v3.4.0+

Installation
------------

[](#installation)

### Download

[](#download)

Download and copy this repository to the plugins folder of your Kirby 3 installation. You should end up with a folder structure like this:

```
/site/plugins/fathom-analytics

```

### Git submodule

[](#git-submodule)

If you prefer to use Git submodules, you can install the plugin like this:

```
git submodule add https://github.com/PaulMorel/kirby3-fathom-analytics.git site/plugins/fathom-analytics

```

### Composer

[](#composer)

If you are using Composer, you can install the plugin like this:

```
composer require paulmorel/fathom-analytics

```

Usage
-----

[](#usage)

### Setup

[](#setup)

After installing the plugin, there a couple of important steps to do in your Fathom Analytics settings.

1. If not already done, add your site in Fathom Analytics
2. Go to your site settings and get the SiteID.
3. Still in the site settings, setup Site Sharing, either Public or Private.

Afterwards, in your site config, add your SiteID and the share password (if needed).

Example:

```
return [
    /* ... */
    'paulmorel.fathom-analytics' => [
        'siteId' => 'ABCDEFGH',
        'sharePassword' => 'hunter2'
    ]
    /* ... */
];
```

### Embedding the tracking code

[](#embedding-the-tracking-code)

The tracking code is provided as a snippet, so it can be simply embedded in the `` tag with the `snippet()` helper function.

If no `siteId` is provided, the snippet does nothing.

```

```

### Viewing your stats

[](#viewing-your-stats)

The plugin provides a panel view that loads your site's analytics dashboard in an iframe. Simply open the menu in the panel's top bar and click on Analytics.

Options
-------

[](#options)

### `siteId` (Required)

[](#siteid-required)

This is the SiteID provided by Fathom Analytics at the top of your site's setting page.

### `sharePassword`

[](#sharepassword)

This is the share password for your site's dashboard. This is only required if you set Site Sharing to Private.

### `customDomain`

[](#customdomain)

If you use the custom domain feature with Fathom Analytics, you can set it with this option.

Example:

```
'customDomain' => 'https://armadillo.example.com'
```

### `disableForRole`

[](#disableforrole)

Allows you to disable the tracking code for logged in users with the specified roles. Expects an `Array`. Defaults to `['admin']`.

Examples:

```
'disableForRole' => [
    'admin'
],
```

```
'disableForRole' => [
    'admin',
    'editor',
    'translator'
],
```

Disclaimer
----------

[](#disclaimer)

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License
-------

[](#license)

MIT

Support
-------

[](#support)

This plugin is completely free to use, but if you'd like to support me or this project, [consider signing-up to Fathom Analytics with my affiliate link](https://usefathom.com/ref/44ARQE).

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Total

3

Last Release

1716d ago

Major Versions

0.0.2 → 1.0.02021-10-22

### Community

Maintainers

![](https://www.gravatar.com/avatar/b37002b179821ed67400a5d085a73fbc254ac7f8783330edfe310021da34fe9e?d=identicon)[PaulMorel](/maintainers/PaulMorel)

---

Top Contributors

[![PaulMorel](https://avatars.githubusercontent.com/u/1200261?v=4)](https://github.com/PaulMorel "PaulMorel (12 commits)")

---

Tags

fathom-analyticskirbykirby-3kirby-cmskirby-pluginkirby3-plugin

### Embed Badge

![Health badge](/badges/paulmorel-fathom-analytics/health.svg)

```
[![Health](https://phpackages.com/badges/paulmorel-fathom-analytics/health.svg)](https://phpackages.com/packages/paulmorel-fathom-analytics)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k584.8k474](/packages/getkirby-cms)[medienbaecker/kirby-modules

Easily add modules to your pages

895.5k1](/packages/medienbaecker-kirby-modules)[distantnative/retour-for-kirby

Manage redirects and track 404s right from the Kirby CMS Panel

14698.5k1](/packages/distantnative-retour-for-kirby)[arnoson/kirby-vite

Vite helper for Kirby CMS

9765.1k3](/packages/arnoson-kirby-vite)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4149.6k2](/packages/bnomei-kirby3-dotenv)[medienbaecker/kirby-alter

242.1k](/packages/medienbaecker-kirby-alter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
