Uplink Analytics Dashboard for Cabin

Uplink Analytics Dashboard for Cabin integrates Cabin Analytics into your WordPress site. It provides dashboard widgets, Gutenberg blocks, shortcodes, and popular content output powered by the Cabin Analytics API.

This is an independent UplinkPress plugin. It is not affiliated with, endorsed by, or an official product of Cabin.

The Cabin Analytics API is available to Cabin PRO accounts.

Features:

Dashboard widget for viewing analytics in WordPress admin
Private Uplink Dashboard for Cabin, designed with blocks for authorized WordPress users
Polished standalone Uplink Popular Content for Cabin dashboard widget with title, domain, controls, and summary/detail metrics
Separate Sustainability, Demographics, and Sources dashboard widgets
Per-module visibility controls for dashboard reports, blocks, and shortcodes
Uplink Site Traffic for Cabin block for analytics charts
Gutenberg block for Popular Content with the same interactive controls and expandable metrics as the Dashboard widget
Gutenberg blocks for Sustainability, Demographics, and Sources
Privacy-friendly Country Traffic Map block with an independent date range and accessible country values
Live data previews for every Cabin block in the WordPress editor
Editable headings for every analytics block, with clear report-specific defaults
Shortcode support for analytics charts
Popular Content shortcode
Sustainability, Demographics, Sources, and Country Traffic Map shortcodes
Reconciles Cabin page paths to local WordPress public post types
Configurable popular content title, quantity, and date range for shortcode and block output
Popular Content date range setting for shortcode, block, and dashboard widget
Interactive stacked bar and line charts showing page views and unique visitors
Configurable date ranges
Global settings for API key, default domain, chart options, and popular content defaults
Responsive front-end output

Popular Content:

The Popular Content feature retrieves top pages from Cabin Analytics and attempts to match each path to a local WordPress post, page, or public custom post type. Matching content uses the local WordPress title and permalink. If a Cabin path does not exist on the current WordPress installation, the plugin displays a readable path title linked to the configured Cabin domain instead.

Default shortcode:

[uplianda_popular_content]

With custom options:

[uplianda_popular_content qty="10" date_range="30" title="Top Content"]

Parameters:

qty – Number of posts to display: 5, 10, 20, or 50
date_range – 1, 7, 14, 30, or 90
title – Optional heading text

If no shortcode title or date range is provided, the plugin uses the values configured in Settings Uplink Analytics.

Dashboard Popular Content:

Popular Content is available as a standalone WordPress dashboard widget titled “Uplink Popular Content for Cabin.” It can be shown, hidden, and moved using the standard WordPress Dashboard Screen Options. The widget, block, and shortcode share the same presentation: title and domain, date range controls, quantity controls for 5, 10, 20, or 50 items, and summary/detail entries with page views, unique visitors, and Attention. Attention uses Cabin’s approximate duration style, such as ~52s or ~2m. Per-page CO₂ is displayed only when Cabin returns a positive value.

Sustainability, Demographics, and Sources:

The WordPress dashboard provides three movable widgets so each report stays compact:

Sustainability displays available total and average CO₂, transfer volume, and green-hosting status.
Demographics displays device mix, countries, languages, and browsers.
Sources displays traffic sources and top referrers.

Each report also has a dynamic Block API v3 block and shortcode. Adding one to public content is the site owner’s explicit choice to publish that Cabin data. The dashboard REST route remains limited to logged-in users who can edit posts.

Shortcodes:

[uplianda_sustainability date_range="30" title="Sustainability"]

Cabin Analytics API key not configured.

Supported reporting periods are 7, 14, 30, and 90 days.

Every module is enabled by default. Set a shortcode module to false to hide it:

[uplianda_sustainability total_co2="true" average_co2="false" transfer_volume="true" green_hosting="true"]

Cabin Analytics API key not configured.

The equivalent block settings are available in the block sidebar. Every block also provides a Heading field. Defaults are Site Traffic, Top Content, Sustainability, Demographics, Sources, and Country Traffic. Dashboard-widget modules are configured under Settings Uplink Analytics.

Country Traffic Map:

The Uplink Country Traffic Map for Cabin block plots Cabin’s aggregated country totals on a responsive world choropleth. Each block has its own 7, 14, 30, or 90 day reporting period. Pointer hover reveals a country tooltip. Keyboard users can Tab to the map once and move through countries in descending traffic order with the arrow keys; Home and End jump to the first and last country. A ranked list and expandable table provide the exact values without relying on color or the map graphic.

The map is rendered locally from bundled Natural Earth public-domain geometry. It does not use Google Maps, map tiles, geocoding, external map scripts, browser location, cookies, or visitor-level data. Only the server-side Cabin API request described under External Services is made.

Shortcode:

[uplianda_country_map date_range="30" title="Traffic by Country"]

Private Uplink Dashboard for Cabin:

Uplink Dashboard for Cabin adds a backend-only analytics page to the WordPress admin menu. Administrators can open Uplink Dashboard for Cabin Edit Dashboard and design the page freely with the core block editor. Core blocks such as Columns, Group, Heading, Tabs, and Spacer can be combined with any Cabin block.

The protected dashboard viewer uses an isolated document with a builder-neutral, accessible style foundation. Open Uplink Dashboard for Cabin and choose Customize Styles to adjust colors, typography, and spacing in a live-preview drawer. Page colors and report-surface text colors are independent, and charts and progress indicators have dedicated color controls. Closing without saving restores the saved design; Save Styles persists the validated CSS tokens. Core block controls and explicit user styles can still override the low-specificity defaults.

Each Cabin report block keeps its own date range and module choices. For example, add four Demographics blocks in different locations and configure them separately for devices, countries, languages, and browsers. The saved page is private, excluded from public queries and search, and its REST endpoints require dashboard authorization.

Administrators have access by default and always retain access. Additional WordPress roles can be authorized under Settings Uplink Analytics Private Uplink Dashboard for Cabin. Authorized roles can both view the dashboard and edit its layout.

The private dashboard is optional. Clear Enable Private Dashboard in that settings section to remove it from the WordPress admin menu without deleting its saved layout. Cabin blocks remain available for posts and pages.

Chart Shortcode:

Basic usage:

[uplianda]

With custom parameters:

[uplianda title="Site Traffic" domain="example.com" chart_type="line" date_range="30" allow_switching="true"]

Parameters:

domain – Override default domain
title – Optional heading; defaults to Site Traffic
chart_type – bar or line
date_range – 7, 14, 30, or 90
allow_switching – true or false

wp-config.php Defaults

Site owners can define defaults in wp-config.php. Constants take precedence over values saved in the WordPress admin.

define( 'UPLIANDA_API_KEY', 'your-api-key' );
define( 'UPLIANDA_DOMAIN', 'example.com' );
define( 'UPLIANDA_DEFAULT_CHART_TYPE', 'bar' );
define( 'UPLIANDA_DEFAULT_DATE_RANGE', '7' );
define( 'UPLIANDA_DASHBOARD_URL', 'https://withcabin.com' );
define( 'UPLIANDA_POPULAR_CONTENT_TITLE', 'Top Content' );
define( 'UPLIANDA_POPULAR_CONTENT_DATE_RANGE', '30' );
define( 'UPLIANDA_PRIVATE_DASHBOARD_ENABLED', true );

Dashboard module defaults can also be locked with boolean constants. Available suffixes are:

UPLIANDA_DASHBOARD_SUSTAINABILITY_TOTAL_CO2
UPLIANDA_DASHBOARD_SUSTAINABILITY_AVERAGE_CO2
UPLIANDA_DASHBOARD_SUSTAINABILITY_TRANSFER_VOLUME
UPLIANDA_DASHBOARD_SUSTAINABILITY_GREEN_HOSTING
UPLIANDA_DASHBOARD_DEMOGRAPHICS_DEVICES
UPLIANDA_DASHBOARD_DEMOGRAPHICS_COUNTRIES
UPLIANDA_DASHBOARD_DEMOGRAPHICS_LANGUAGES
UPLIANDA_DASHBOARD_DEMOGRAPHICS_BROWSERS
UPLIANDA_DASHBOARD_SOURCES_TRAFFIC_SOURCES
UPLIANDA_DASHBOARD_SOURCES_REFERRERS

For example: define( 'UPLIANDA_DASHBOARD_DEMOGRAPHICS_BROWSERS', false );

External Services

This plugin connects to the Cabin Analytics API at https://api.withcabin.com/v1/analytics to retrieve analytics data. It sends the configured domain, requested date range, requested data scope, list limit, and the administrator-provided API key. Requests occur when an analytics chart, Popular Content display, dashboard insight widget, Country Traffic Map, or public insight block or shortcode needs uncached data. Responses are cached temporarily in WordPress.

Cabin is a third-party service. This independent UplinkPress plugin is not affiliated with or endorsed by Cabin. A Cabin PRO account and API key are required. Review Cabin before use.

The Country Traffic Map includes simplified geographic shapes generated at build time from Natural Earth, whose map data is in the public domain. The plugin makes no requests to Natural Earth or any other map provider when it runs.

Installation

Upload the plugin files to the /wp-content/plugins/uplink-analytics-dashboard-for-cabin directory, or install the plugin through the WordPress plugins screen.
Activate the plugin through the Plugins screen in WordPress.
Navigate to Cabin Dashboard Settings.
Add your Cabin Analytics API key and default domain.
Add any Cabin chart, Popular Content, Sustainability, Demographics, Sources, or Country Traffic Map block, or use the included shortcodes.
Open Cabin Dashboard to view the API-powered analytics report in WordPress admin.

Frequently asked questions

Where do I get a Cabin Analytics API key?

Cabin currently provides API keys on its Plus and Scale plans. Sign in to Cabin, open the API keys section of your account settings, select New Key, and choose the domains that key may access.

Can I display analytics for multiple domains?

You can set one default domain for the Cabin Dashboard, Popular Content, report widgets, and report blocks. The Site Traffic block and

Cabin Analytics domain is not configured.

shortcode can override that default domain for an individual chart. The API key must have access to every domain you request.

How does Popular Content work?

The plugin requests top page data from Cabin Analytics, normalizes each returned path, then attempts to match that path to a local WordPress post, page, or public custom post type. Matching content uses the local title and permalink. Unmatched paths fall back to a readable title and an HTTPS link on the configured Cabin domain.

Can Popular Content appear on the WordPress dashboard?

Yes. Enable WP dashboard widgets under Cabin Dashboard Settings. The plugin then registers a standalone widget titled “Uplink Popular Content for Cabin.” Manage its visibility and placement from the WordPress Dashboard Screen Options. Turning off WP dashboard widgets unregisters it and the other Cabin widgets, removing their entries from Screen Options. The widget includes controls for date range and item count. The default date range is controlled in Cabin Dashboard Settings.

Is the Cabin Dashboard stored as a WordPress page or custom post type?

No. Cabin Dashboard is a purpose-built WordPress admin page available only to authorized roles. It is not a post and does not use a custom post type. Blocks and shortcodes remain available for layouts you create in the WordPress editor.

Who can view the Cabin Dashboard?

Administrators always have access. An administrator can grant access to other WordPress roles under Cabin Dashboard Settings. The dashboard stays available even when the optional WordPress dashboard widgets are disabled.

What date ranges are supported for Popular Content?

Popular Content supports 1, 7, 14, 30, and 90 day ranges. The default is controlled in Cabin Dashboard Settings.

Does this work with Cabin Analytics v1 or v2?

This plugin uses the Cabin Analytics API v1. Visit https://withcabin.com for current Cabin product and support information.

Changelog

2.1.0

Added a page-level analytics dialog to Top Pages with traffic, attention, scroll depth, energy, and page-specific events from the available Cabin API data.
Made each Top Pages data row open its page details while retaining the page-name button for keyboard and screen-reader access.
Added seven-item pagination for page-specific Events and kept event counts sorted in descending order.
Unified the page overview into a compact aligned panel with consistent typography, dividers, responsive stacking, and concise unavailable values.
Standardized ranked-list measurement bars and restored consistent spacing between Top Pages and Referrals.

2.0.2

Sorted Events by count in descending order, with event names used only to break ties.
Moved Attention directly below Summary in the dashboard and section navigation.
Added an API-powered scroll-depth graph with cumulative reach values, an average marker, and compact hover and keyboard-focus labels.

2.0.1

Refreshed the WordPress.org screenshots with the new Cabin Dashboard and settings experience.
Reorganized and restyled settings for clearer connection, dashboard, content, and widget controls.
Hidden widget-only module settings when WordPress dashboard widgets are disabled, while preserving their saved values.
Removed the light-theme flash during dashboard range changes and improved the loading transition.

2.0.0

Breaking: replaced the custom-post-type dashboard and editor workflow with an always-available Cabin Analytics page in WordPress admin. Existing private dashboard post layouts are no longer used.
Kept existing Cabin blocks and shortcodes unchanged.
Added a responsive Cabin-style report with light and dark themes, fixed period controls, section navigation, and bundled Public Sans and Wittgenstein fonts.
Added reports for all available Cabin API data, including events, attention, screen sizes, operating systems, countries, sources, and environmental metrics.
Added interactive chart modes, Cabin-style data balloons, country flags, an accessible world map, search, pagination, and View all controls.
Replaced Enable Private Dashboard with Enable WP dashboard widgets. The Cabin Dashboard remains available when widgets are disabled.
Preserved saved settings during plugin updates and kept Settings under the Cabin Dashboard menu.
Added responsive layouts for narrower WordPress admin widths and smoother period and list transitions.

1.1.2

Restored a visible View Dashboard button in the private dashboard editor and removed the hidden Options-menu action.

1.1.1

Removed the redundant admin-bar and editor-panel dashboard links, leaving the editor Options menu return action.

1.1.0

Added WordPress 7.1 icon registry support with a compatibility fallback for WordPress 6.9 and 7.0.
Replaced the legacy chart Dashicon with the UplinkPress analytics icon in the admin menu and block editor.
Shortened the private dashboard editor tab label to Dashboard.
Added View Dashboard actions to the editor toolbar, Options menu, and Dashboard settings panel.
Renamed the WordPress admin menu item to Cabin Dashboard.

1.0.1

Fixed Popular Content date-range and quantity controls in dashboard widgets, blocks, and shortcodes.
Fixed the Popular Content homepage entry so it uses the configured Cabin domain instead of the local WordPress front page.
Fixed the Site Traffic dashboard widget so the standard WordPress show/hide control fully collapses its content.
Corrected renamed data attributes used by the Country Traffic Map and private-dashboard style customizer.

1.0.0

Initial release under the Uplink Analytics Dashboard for Cabin name by UplinkPress.
Added dashboard widgets for analytics trends and popular content.
Added blocks and shortcodes for charts and popular content.
Added accessible chart controls, keyboard-readable data points, and status messaging.
Added server-side Cabin API authentication, constrained public requests, and transient caching.
Added wp-config.php defaults and safe fallback links for unmatched Popular Content paths.
Added separate Sustainability, Demographics, and Sources dashboard widgets, Block API v3 blocks, and shortcodes.
Added per-module visibility controls to report blocks, shortcodes, and dashboard settings.
Renamed Popular Content average duration to Attention with Cabin-style approximate seconds and minutes.
Refreshed the settings screen with grouped configuration and a complete usage reference.
Added a distinct UplinkPress identity for this independent Cabin integration.
Added explicit site-owner-controlled public output for Cabin insight data.
Set minimum requirements to WordPress 6.9 and PHP 8.3; tested through WordPress 7.1.
Hid unavailable zero-value CO₂ metrics from Popular Content.
Added a private, role-controlled Uplink Dashboard for Cabin that authorized users can design freely with core and Cabin blocks.
Isolated the private dashboard document so it inherits active-theme and responsive block styles without affecting WordPress admin.
Added core color, typography, spacing, background, gradient, and border controls to Cabin blocks.
Preserved the accessible Cabin blue/white functional palette for controls, links, focus indicators, charts, and progress bars instead of inheriting potentially low-contrast theme accents.
Added live dashboard style controls with clearer visual descriptions for page, surface, typography, chart, progress, and spacing tokens.
Prevented theme viewport rules from causing runaway private-dashboard iframe heights or internal scrollbars.
Made private-dashboard links open outside the iframe with localized screen-reader announcements.
Unified the Popular Content widget, block, and shortcode around the same interactive controls, expandable rows, and detail metrics.
Added an accessible, privacy-friendly Country Traffic Map block and shortcode with independent reporting periods, pointer and keyboard tooltips, bundled public-domain Natural Earth geometry, and no third-party map requests.
Added editable headings to every analytics block and set the Site Traffic block’s displayed default heading to “Site Traffic.”

Screenshots

Complete Cabin Dashboard in dark mode, showing the available report sections in one WordPress admin page.
Summary and Top Pages reports with period controls, chart modes, search, pagination, and measurement bars.
Global reach report with the local world map, country flags, search, pagination, and value controls.
Responsive dashboard layout with the side rail removed and report controls retained on a narrower WordPress admin screen.
Redesigned settings page with clear sections for the Cabin connection, dashboard access, content defaults, and optional WordPress dashboard widgets.