PHPackages                             bencarr/craft-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 & Helpers](/categories/utility)
4. /
5. bencarr/craft-fathom-analytics

AbandonedArchivedCraft-plugin[Utility & Helpers](/categories/utility)

bencarr/craft-fathom-analytics
==============================

An unofficial Fathom Analytics integration for Craft CMS

1.0.0-beta.2(2y ago)09mitPHPPHP >=8.0.2

Since Jan 25Pushed 2y ago1 watchersCompare

[ Source](https://github.com/bencarr/craft-fathom-analytics)[ Packagist](https://packagist.org/packages/bencarr/craft-fathom-analytics)[ RSS](/packages/bencarr-craft-fathom-analytics/feed)WikiDiscussions main Synced 3w ago

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

Fathom Analytics
================

[](#fathom-analytics)

A Craft CMS plugin to surface your [Fathom Analytics](https://usefathom.com/) data in the Craft control panel.

Features
--------

[](#features)

This plugin is intended to help content authors get a nice overview of site analytics, and surface some contextual information they can use to tailor their content changes. It’s a companion, not a replacement for your Fathom Analytics dashboard.

### Dashboard Widgets

[](#dashboard-widgets)

Fantastic dashboard widgets with customizable date ranges to keep an eye on what’s most important to you:

- **Current Visitors** — How many people are on your site right now, where are they, and where were they referred from?
- **Browsers** — Breakdown of your traffic by browser.
- **Device Type** — Breakdown of your traffic by desktop, mobile, and tablet.
- **Top Pages** — List of your top 10 pages by visits and views.
- **Top Referrers** — List of your top 10 referrers by visits and views.
- **Visitors** — Chart of visitors and pageviews over time.
- **Overview** — Basic totals for number of visits, number of visitors, average time on site, and bounce rate.

### Entry Sidebar Widget

[](#entry-sidebar-widget)

A mini widget with entry-specific analytics right in the entry edit form with tabs to cover all the basics:

- **Overview** — Visitors, views, average time on page, and bounce rate.
- **Visitors** — Chart of visitors and pageviews over time.
- **Browsers** — Breakdown of traffic by browser.
- **Devices** — Breakdown of traffic by desktop, mobile, and tablet.
- **Referrers** — List of the top 10 referrers by visits and views.

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

[](#requirements)

This plugin requires Craft CMS 4.5.0 or later, and PHP 8.0.2 or later.

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

[](#installation)

You can install this plugin from the Plugin Store or with Composer.

### From the Plugin Store

[](#from-the-plugin-store)

Go to the Plugin Store in your project’s Control Panel and search for “Fathom Analytics”. Then press “Install”.

### With Composer

[](#with-composer)

Open your terminal and run the following commands:

```
# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require bencarr/craft-fathom-analytics

# tell Craft to install the plugin
./craft plugin/install fathom
```

Configuration
-------------

[](#configuration)

Once the plugin is installed, you’ll need to configure your API Key and Site ID either using the plugin settings page or a configuration file. You can [generate an API key](https://app.usefathom.com/api/create) from your Fathom Analytics account, and [find your site ID](https://app.usefathom.com/sites) by clicking the site from your sites list.

### From the Plugin Settings Page

[](#from-the-plugin-settings-page)

On an environment with admin changes enabled, open Settings then press “Fathom Analytics” under the “Plugins” section. Your API key is sensitive data, so you’ll probably want to use an environment variable that you keep out of version control.

### From a Configuration File

[](#from-a-configuration-file)

Create a file called `fathom.php` in your `config/` directory.

```