README

Clicky Analytics for Craft CMS

Brings your Clicky web analytics straight into the Craft CMS 5 control panel: a solid set of native dashboard widgets plus a per-entry page-stats field, the whole lot running off the Clicky API.

Features

• 21 dashboard widgets: build your own Craft dashboard from Report (configurable), Live Visitors, Current Visitors, Overview, New vs Returning, Top Pages, Top Sources, Top Referrals, Search Engines, Top Countries, Top Browsers, Operating Systems, Devices, Entry Pages, Exit Pages, Downloads, Goals, Campaigns, Cities, Regions and Screen Resolutions.
• Configurable Report widget: choose any metric and how to draw it, Counter, Line, Bar or Pie.
• Live Visitors widget: recent visits with country flag, location, landing page, browser & OS logos, referrer and dwell time, with a new / returning / both filter.
• Country drilldown: expand a country in the Top Countries widget to load its cities and regions inline.
• Page Stats field: add the “Clicky Analytics Page Stats” field to an entry type's field layout to show that entry's own analytics (visitors, traffic sources, recent visitors) inside the entry editor.
• Per-widget date ranges: Today, Yesterday, 2 days ago, Last 7/14/28/60/90 days and recent months.
• Colour schemes: re-theme every widget, the field and the charts at once, choosing between Clicky Analytics (warm), Ocean (blue), Monochrome, Forest (green) or Berry (purple) in the plugin settings.
• Layout options: a compact density and a slim bar style, for when you'd rather the widgets and the field sat tighter than the comfortable default.
• Brand logos & flags: self-hosted SVG country flags, browser logos, OS logos and search-engine logos that render identically on every OS.
• Version consolidation: optionally merge browser and OS versions (e.g. one “Google Chrome” row instead of one per version), per widget or as a plugin default.
• Open in Clicky: every row deep-links to the matching report in Clicky.
• Tracking code injection: let the plugin add the Clicky tracking snippet (with <noscript> fallback) to every front-end page for you, so there's no need to paste it into your layout by hand. Skipped automatically when devMode is on.
• Twig variable: read any of the same data in your own templates via craft.clickyAnalytics.

Documentation

Full documentation lives at https://johnhenry.ie/plugins/clicky-analytics/

Support

Need a hand? Open an issue on our GitHub Issues page

License

This package is licensed for free under the MIT License.

Requirements

• Craft CMS 5.0.0 or later
• PHP 8.2, 8.3 or 8.4
• A Clicky account with API access (Site ID + Sitekey)

Credits & attribution

Clicky is a trademark of Roxr Software Ltd.; this is an unofficial, community plugin with nothing to do with them directly. It bundles a few icon sets to identify browsers, operating systems, search engines and countries:

• Country flags: flag-icons (MIT)
• Browser logos: browser-logos (respective trademarks)
• OS & search-engine logos: SVG Logos (respective trademarks)

All product names, logos and brands belong to their respective owners and are used here only to tell one browser, OS or country apart from another.