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. Learn more about the plugin at uplink.press.
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, or50date_range–1,7,14,30, or90title– 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 domaintitle– Optional heading; defaults toSite Trafficchart_type–barorlinedate_range–7,14,30, or90allow_switching–trueorfalse
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_CO2UPLIANDA_DASHBOARD_SUSTAINABILITY_AVERAGE_CO2UPLIANDA_DASHBOARD_SUSTAINABILITY_TRANSFER_VOLUMEUPLIANDA_DASHBOARD_SUSTAINABILITY_GREEN_HOSTINGUPLIANDA_DASHBOARD_DEMOGRAPHICS_DEVICESUPLIANDA_DASHBOARD_DEMOGRAPHICS_COUNTRIESUPLIANDA_DASHBOARD_DEMOGRAPHICS_LANGUAGESUPLIANDA_DASHBOARD_DEMOGRAPHICS_BROWSERSUPLIANDA_DASHBOARD_SOURCES_TRAFFIC_SOURCESUPLIANDA_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. No request is made to Natural Earth or any other map provider when the plugin runs.