Title: Uplink Analytics Dashboard for Cabin
Author: Stephen Walker
Published: <strong>August 12, 2026</strong>
Last modified: August 12, 2026

---

Search plugins

![](https://ps.w.org/uplink-analytics-dashboard-for-cabin/assets/icon-256x256.png?
rev=3643265)

# Uplink Analytics Dashboard for Cabin

 By [Stephen Walker](https://profiles.wordpress.org/stphnwlkr/)

[Download](https://downloads.wordpress.org/plugin/uplink-analytics-dashboard-for-cabin.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/uplink-analytics-dashboard-for-cabin/#description)
 * [Reviews](https://wordpress.org/plugins/uplink-analytics-dashboard-for-cabin/#reviews)
 *  [Installation](https://wordpress.org/plugins/uplink-analytics-dashboard-for-cabin/#installation)
 * [Development](https://wordpress.org/plugins/uplink-analytics-dashboard-for-cabin/#developers)

 [Support](https://wordpress.org/support/plugin/uplink-analytics-dashboard-for-cabin/)

## Description

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. Learn more about the plugin at [uplink.press](https://uplink.press/code/uplink-analytics-dashboard-for-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"]
    [uplianda_demographics date_range="30" title="Demographics"]
    [uplianda_sources date_range="30" title="Sources"]
    ```

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"]
    [uplianda_demographics devices="true" countries="true" languages="false" browsers="false"]
    [uplianda_sources traffic_sources="true" referrers="false"]
    ```

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/?utm_campaign=wp_widget&utm_medium=web&utm_source=sw' );
    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](https://withcabin.com/?utm_campaign=wp_widget&utm_medium=web&utm_source=sw)
before use.

The Country Traffic Map includes simplified geographic shapes generated at build
time from [Natural Earth](https://www.naturalearthdata.com/downloads/110m-cultural-vectors/),
whose map data is in the public domain. No request is made to Natural Earth or any
other map provider when the plugin runs.

## Screenshots

[⌊Settings screen for connecting Cabin, choosing defaults, controlling dashboard
access, and selecting report modules.⌉⌊Settings screen for connecting Cabin, choosing
defaults, controlling dashboard access, and selecting report modules.⌉[

Settings screen for connecting Cabin, choosing defaults, controlling dashboard access,
and selecting report modules.

[⌊Responsive Demographics report showing device, country, language, and browser 
data.⌉⌊Responsive Demographics report showing device, country, language, and browser
data.⌉[

Responsive Demographics report showing device, country, language, and browser data.

[⌊Sustainability and Sources reports showing environmental metrics, acquisition 
channels, and referrers.⌉⌊Sustainability and Sources reports showing environmental
metrics, acquisition channels, and referrers.⌉[

Sustainability and Sources reports showing environmental metrics, acquisition channels,
and referrers.

[⌊Custom private dashboard combining the Country Traffic Map, Site Traffic chart,
Popular Content, and sustainability summary.⌉⌊Custom private dashboard combining
the Country Traffic Map, Site Traffic chart, Popular Content, and sustainability
summary.⌉[

Custom private dashboard combining the Country Traffic Map, Site Traffic chart, 
Popular Content, and sustainability summary.

## Blocks

This plugin provides 1 block.

 *   Uplink Site Traffic for Cabin Display Cabin site traffic with interactive charts

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/uplink-analytics-dashboard-
    for-cabin` directory, or install the plugin through the WordPress plugins screen.
 2. Activate the plugin through the Plugins screen in WordPress.
 3. Navigate to Settings  Uplink Analytics.
 4. Add your Cabin Analytics API key and default domain.
 5. Add any Cabin chart, Popular Content, Sustainability, Demographics, Sources, or
    Country Traffic Map block, or use the included shortcodes.
 6. Optionally open Uplink Dashboard for Cabin  Edit Dashboard to create a private 
    analytics workspace with WordPress blocks, then use Customize Styles for live color,
    typography, and spacing adjustments.

## FAQ

### Where do I get a Cabin Analytics API key?

Visit https://withcabin.com/?utm_campaign=wp_widget&utm_medium=web&utm_source=sw
and log into your account. Navigate to your site settings to generate an API key.

### Can I display analytics for multiple domains?

Yes. You can configure a default domain in the settings, and individual shortcode
or block instances can override it.

### 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. The plugin registers a standalone dashboard widget titled “Uplink Popular Content
for Cabin.” Manage its visibility and placement from the WordPress Dashboard Screen
Options. The widget includes controls for date range and item count. The default
date range is controlled in Settings  Uplink Analytics.

### Can I build a custom analytics page inside WordPress admin?

Yes. Open Uplink Dashboard for Cabin  Edit Dashboard and use the core WordPress 
block editor. The page is available only in WordPress admin to authorized roles.
It inherits the active site design, and you can repeat Cabin blocks and configure
every instance independently.

### What date ranges are supported for Popular Content?

Popular Content supports `1`, `7`, `14`, `30`, and `90` day ranges. The default 
is controlled in Settings  Uplink Analytics.

### Does this work with Cabin Analytics v1 or v2?

This plugin uses the Cabin Analytics API v1. Visit https://withcabin.com/?utm_campaign
=wp_widget&utm_medium=web&utm_source=sw for current Cabin product and support information.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Uplink Analytics Dashboard for Cabin” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Stephen Walker ](https://profiles.wordpress.org/stphnwlkr/)

[Translate “Uplink Analytics Dashboard for Cabin” into your language.](https://translate.wordpress.org/projects/wp-plugins/uplink-analytics-dashboard-for-cabin)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/uplink-analytics-dashboard-for-cabin/),
check out the [SVN repository](https://plugins.svn.wordpress.org/uplink-analytics-dashboard-for-cabin/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/uplink-analytics-dashboard-for-cabin/)
by [RSS](https://plugins.trac.wordpress.org/log/uplink-analytics-dashboard-for-cabin/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 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.”

## Meta

 *  Version **1.0.0**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.9 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 8.3 or higher **
 * Tags
 * [analytics](https://wordpress.org/plugins/tags/analytics/)[charts](https://wordpress.org/plugins/tags/charts/)
   [dashboard](https://wordpress.org/plugins/tags/dashboard/)[privacy](https://wordpress.org/plugins/tags/privacy/)
 *  [Advanced View](https://wordpress.org/plugins/uplink-analytics-dashboard-for-cabin/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/uplink-analytics-dashboard-for-cabin/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/uplink-analytics-dashboard-for-cabin/reviews/)

## Contributors

 *   [ Stephen Walker ](https://profiles.wordpress.org/stphnwlkr/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/uplink-analytics-dashboard-for-cabin/)