README

A Flarum extension that puts a click count next to every link in a post.

What it does

Every http(s) link grows a small badge once people start clicking. The badge inherits your theme and dark mode automatically. The number tells everyone reading the post how many people opened that link.

On top of the badge:

• Popular links sidebar widget on each discussion.
• Most clicked links widget on user profiles.
• Live updates when flarum/realtime is installed. Badges tick up without a page reload.
• Admin analytics with filters, CSV export, and a per-link drill-down that shows who clicked. Daily clicks chart, top domains rollup, weekday-by-hour heatmap, and a mobile / tablet / desktop split.
• Per-discussion click stats. Mods get a "Click stats" item in the discussion controls dropdown, scoped to that thread.
• User click trail. Drill from a clicker into every link that user has opened.
• Webhook to forward click events. Exponential backoff retries, dedup header, and a "Send test ping" button.
• Console tooling: backfill, counter reconcile, daily rollup, anomaly detection, weekly digest.
• Domain blocklist and an optional confirm-before-leaving dialog for outbound clicks.
• Privacy controls: forum-wide skip-guests, per-user opt-out, author per-post toggle, tag-level opt-out (with flarum/tags), and full GDPR export / anonymize / delete (with flarum/gdpr).

Popular links sidebar	Most clicked links on profile

Installation

composer require datlechin/flarum-link-clicks

Enable from Admin → Extensions.

Updating

composer update datlechin/flarum-link-clicks
php flarum migrate
php flarum cache:clear

Configuration

The extension page (Admin → Extensions → Link Clicks) has three tabs.

Settings

Webhook

Each recorded click is sent to your URL as a JSON POST. Toggle it on, paste a URL, optionally set a shared secret to sign the request body.

{
  "event": "click_recorded",
  "counted": true,
  "post_link": { "id": 123, "url": "https://example.com/page", "is_internal": false, "is_attachment": false, "post_id": 456, "discussion_id": 789, "clicks_count": 42 },
  "actor": { "user_id": 10, "username": "alice" },
  "ip_address": "192.168.1.1",
  "user_agent": "Mozilla/5.0 ...",
  "clicked_at": "2026-05-09T12:34:56Z"
}

actor is null for guest clicks. counted is false when the click hit a dedup or self-click rule (the badge didn't tick up). When a secret is set, the signature is sent in X-LinkClicks-Signature: sha256=<hex>, computed over the raw body. Delivery is async and retried a few times on failure.

Permissions

Adds one permission: View link click analytics. Admins have it by default. Grant to other groups from Admin → Permissions.

Console commands

Privacy and GDPR

The extension stores the IP address and User-Agent of each recorded click. Under GDPR these are personal data. As the forum operator you're responsible for:

• Disclosing the collection in your privacy notice.
• Choosing a lawful basis (legitimate interest is the usual fit for engagement analytics).
• Setting a retention window (the daily purge handles this).
• Honouring access and erasure requests. Install flarum/gdpr to expose them automatically.

Defaults that lean toward privacy: bots are dropped, DNT: 1 is honoured, authors can't inflate their own counts, the redirect URL never contains the destination.

Sponsors

If this extension is useful to you, sponsoring on GitHub helps me keep building and maintaining open source for Flarum.

Links

• Packagist
• GitHub
• Discuss