內容簡介
Uplink Analytics Dashboard for Cabin 將 Cabin 數據整合至 WordPress，提供一個響應式的管理報告，讓使用者能快速查看流量、內容、來源及地理位置等資訊，無需離開 WordPress 控制台。
【主要功能】
• 響應式 Cabin 風格管理儀表板，支援明暗模式
• 提供流量摘要、熱門頁面及來源報告
• AI 代理、能源及碳排放報告
• 支援多種報告期間選擇
• 角色基礎的儀表板存取控制
• 五個可選的 WordPress 控制台小工具
外掛標籤
開發者團隊
② 後台搜尋「Uplink Analytics Dashboard for Cabin」→ 直接安裝（推薦）
原文外掛簡介
Uplink Analytics Dashboard for Cabin brings your Cabin data into WordPress. Its main Cabin Dashboard is a responsive admin report for a quick look at traffic, content, sources, geography, devices, attention, events, and environmental data without leaving WordPress.
The plugin also provides optional WordPress dashboard widgets, Gutenberg blocks, shortcodes, and popular content lists powered by the Cabin Analytics API. Existing blocks and shortcodes remain separate from the admin dashboard, so you can publish selected reports without exposing the private WordPress admin page.
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.
Cabin API keys are currently available on the Cabin Plus and Scale plans.
Features:
Responsive Cabin-style admin dashboard with light and dark modes
Reports for summary traffic, top pages, referrals, sources, bounce rate, countries, languages, devices, screen sizes, browsers, operating systems, attention, and events
AI agent, energy, carbon, and scroll-depth reports when Cabin returns that data for the connected plan
Reporting periods for today, 7, 14, 30, or 90 days in the admin dashboard
Search, pagination, View all controls, chart tooltips, country flags, and an accessible world map
Page-level traffic, attention, energy, and event details opened directly from Top Pages
Role-based dashboard access, with administrator access retained
Five optional WordPress dashboard widgets for Analytics, Popular Content, Sustainability, Demographics, and Sources
Standalone Uplink Popular Content for Cabin dashboard widget with title, domain, controls, and summary/detail metrics
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
Bundled dashboard fonts, flags, and map geometry with no runtime font, flag, or map service request
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 Cabin Dashboard → Settings.
Dashboard Popular Content:
Popular Content is available as a standalone WordPress dashboard widget titled “Uplink Popular Content for Cabin” when WP dashboard widgets are enabled in Cabin Dashboard → Settings. It can be hidden, shown, and moved using the standard WordPress Dashboard Screen Options. Disabling WP dashboard widgets unregisters all five Cabin widgets, so they no longer appear in 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 Cabin Dashboard → Settings. Each report block keeps its own date range and module choices.
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"]
Cabin Dashboard:
Cabin Dashboard adds a backend-only analytics page to the WordPress admin menu. It presents the available Cabin API data in a focused report with section navigation, selectable reporting periods, and light or dark mode. Access is controlled by role from the plugin settings.
The dashboard closely follows Cabin’s public analytics layout, typography, spacing, controls, and color palettes. A side rail keeps long reports navigable on larger screens and disappears when the WordPress admin area gets narrower. The fixed header keeps reporting periods and dashboard actions available. The local light or dark preference follows the user between visits.
Charts support line and bar views with data balloons. Longer data sets include search, pagination, percentage or value controls, and View all. The page uses bundled fonts and local assets, so it makes no external font, flag, or map request.
Administrators have access by default and always retain access. Additional WordPress roles can be authorized under Cabin Dashboard → Settings → Cabin Dashboard.
The Cabin Dashboard is always available to authorized roles. Clear Enable WP dashboard widgets to unregister the five widgets from the standard WordPress Dashboard without changing the Cabin Dashboard, blocks, or shortcodes.
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_DASHBOARD_WIDGETS_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. Cabin currently provides API keys on its Plus and Scale plans. Review Cabin’s API documentation 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.
