feat(0.6.2): current version badge on Settings page

Small grey pill follows the "Radio — Settings" H1 — v{RADIO_VERSION}.
Visible at a glance so you don't have to hover the plugin row in
Plugins → Installed or open About just to check what version you're on.
Dark-theme variant so it stays readable when theme=dark.

Files: radio.php (version), inc/settings.php (<span> inside H1),
assets/css/radio.css (.radio-version-badge + dark override),
inc/about.php (rotate v0.6.2 into latest expanded slot, v0.6.1 into
earlier-releases list), CHANGELOG.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

CHANGELOG.md

@@ -9,6 +9,93 @@ Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) — versi
 
 ---
 
+## [0.6.2] — 2026-05-30 — Current version badge on Settings
+
+### Added
+- Small grey pill follows the **"Radio — Settings"** heading: `v{RADIO_VERSION}`. Visible at a glance so you don't have to hover the plugin row in *Plugins → Installed* or open *About* just to check what version you're on.
+- Dark-theme variant of the badge (`#2c3338` background, `#c3c4c7` text) so it stays readable when `theme=dark`.
+
+**Files changed:** `radio.php` (version), `inc/settings.php` (`<span class="radio-version-badge">v…</span>` inside the H1), `assets/css/radio.css` (`.radio-version-badge` styling + dark-theme override).
+
+---
+
+## [0.6.1] — 2026-05-30 — About page restructure
+
+By v0.6.0 the About page had eight version-history entries, each a full paragraph, dwarfing the other cards and pushing Credits + thanks off the visible area. v0.6.1 rebalances the layout.
+
+### Changed
+- **Three short cards on top** (What / Who / **Credits**) — equal-height, balanced row. Credits is no longer a fourth card buried under the version history; it sits beside What and Who where it belongs.
+- **Version history is its own full-width card below.** Only the **latest** release is shown in full; **earlier releases collapse to one line each** (version + date + headline). The card now stays compact however many versions ship — adding a future release adds one line, not a paragraph.
+- **Full prose for older versions lives in `CHANGELOG.md` on Gitea** — the "View the full CHANGELOG.md →" link does the heavy lifting. Single source of truth, no duplication.
+
+**Files changed:** `radio.php` (version), `inc/about.php` (3-card top + new `.radio-about-versions` block with `__latest` / `__earlier` sub-elements; 9 versions in the earlier-releases list incl. v0.1.0), `assets/css/radio.css` (removed dead `.radio-about-card--versions` rules; added `.radio-about-versions` + `__latest` + `__earlier` rules; dark-theme overrides for the new selectors).
+
+---
+
+## [0.6.0] — 2026-05-30 — Pop-out mini-player (continuous background play)
+
+Until v0.5.0 the audio cut every time you navigated between WP admin pages — every navigation is a full page reload, which destroys the `<audio>` element. v0.6.0 fixes the background-music use case by letting you pop the player out into a separate browser window that persists across the parent tab's navigation.
+
+### Added — **Pop out** button + standalone popup player
+- Small **`↗ Pop out`** button beside the Play button on both the main Radio page and the Dashboard widget. Click it and a **380×560 standalone window** opens with just the player chrome (no WP admin sidebar / nav).
+- The popup lives at `admin-post.php?action=radio_popout&play=1` — a new server-side route that renders a **full standalone HTML page** outside the WP admin shell (custom `<!DOCTYPE>`, head, body, no admin chrome).
+- Popup is `radio_popout`-named so a second click on Pop out **re-focuses the existing window** instead of opening a new one.
+- The popup's `<audio>` element is never destroyed by parent-tab navigation, so the music keeps playing while you click around Plugins, Posts, Users, etc.
+
+### Auto-resume — pick up where the main tab left off
+- The Pop-out button URL carries `&play=1`. `radio.js` reads it from the localized config and auto-calls `audio.play()` 200 ms after init. Same-origin user-gesture popups are exempt from autoplay-blocking on every modern browser, so it just works.
+- On opening the popup, **every other audio surface in the main tab is paused** so you don't end up with two streams running simultaneously.
+
+### Popup details
+- Theme follows the user's saved choice (`radio_state['theme']`) — light by default, dark if explicitly set; the popup body gets the `radio-theme-dark` class so the existing dark-mode CSS rules apply.
+- The popup includes everything you need to listen and switch: now-playing block (with dancing bars + Web Audio visualizer), play/pause, mute, volume, full station dropdown grouped by genre, error slot.
+- Close button (`✕`) in the top-right calls `window.close()`.
+- Pop out button **does not appear inside the popup** itself (would be infinite); the JS detects `popoutUrl === ''` in the localized config and hides any Pop-out button it finds.
+- Popup blocked? The button shows a clear alert: *"Pop-out blocked by the browser. Allow popups for this site, then try again."*
+
+### State stays in sync
+- The popup uses the **same `radio_save_state` AJAX endpoint** as the main player. If you change station or volume in the popup, it persists to user_meta; the next time you load any Radio page in the main tab it picks up the new values.
+- Track history continues to log from whichever surface is playing — the popup polls SomaFM and POSTs to `radio_log_track` exactly like the main player.
+
+**Files changed:** `radio.php` (version, `popoutUrl` added to localized config, new `admin_post_radio_popout` action + `radio_render_popout_page` handler with full standalone HTML), `inc/admin-page.php` + `inc/dashboard-widget.php` (Pop-out button beside Play), `assets/css/radio.css` (Pop-out button styling), `assets/js/radio.js` (`bindPopOut` opens the window + pauses other surfaces, autoplay branch reads `cfg.autoPlay`), `inc/about.php` (history entry).
+
+---
+
+## [0.5.0] — 2026-05-29 — Track history + favourites
+
+SomaFM plays deep cuts you'll never hear again. v0.5.0 quietly logs every track that scrolls past so you can find it again later — and a star button keeps the ones worth keeping forever.
+
+### Added — `Radio → History` admin page (per-user)
+- **History tab** — capped FIFO list of the last 500 played tracks. Each row shows when (relative time, full timestamp on hover), station, *artist — title*, four search links, and a favourite-star toggle.
+- **Favourites tab** — uncapped list of starred tracks. Same row layout. Survives even when the history rolls over.
+- **Filter** by artist/title (live, client-side) and by station (dropdown). **Clear history** button on the History tab — favourites preserved.
+- **Four search providers** per row, brand-tinted on hover: **Spotify** (green), **YouTube** (red), **Apple Music** (pink), **Bandcamp** (teal). Deep-link search URLs only — no API keys, no third-party JS.
+- Empty-state messages on both tabs.
+
+### Added — automatic logging during playback
+- `fetchTrack` (the existing 30s SomaFM polling loop) now hands every new track to a new `logTrackIfNew` helper that POSTs it to `wp_ajax_radio_log_track`.
+- **Dedup**: client-side via `lastLoggedSig` so the 30s polling doesn't re-log the same song; server-side against the last entry in user_meta as belt-and-braces.
+- **Junk filtering**: `(unknown)` artists and entries missing artist *or* title are dropped server-side in `radio_sanitize_entry`.
+
+### Added — per-user storage
+- Two new `user_meta` keys, separate from `radio_state` so frequent track inserts don't churn the player-state blob:
+  - `radio_history` — capped at **500 entries** (~50–80 KB max).
+  - `radio_favourites` — uncapped, expected to stay small (user-curated).
+
+### Added — three new AJAX endpoints
+- `wp_ajax_radio_log_track` — append a track (nonce: `radio_save_state`; player-page only).
+- `wp_ajax_radio_toggle_favourite` — toggle a track in favourites (nonce: `radio_history`; History-page only).
+- `wp_ajax_radio_clear_history` — clear the history list (nonce: `radio_history`; History-page only). Favourites untouched.
+
+### Notes
+- Per-user — nothing is shared, nothing leaves the site. Just your own listening history on your own WP account.
+- **No PII concern** — entries are public station/artist/title strings from SomaFM's own JSON.
+- Search-link UI tints toward each provider's brand colour on hover only — keeps the row visually calm in the default state.
+
+**Files changed:** `radio.php` (version, require, submenu, asset enqueue hook, three AJAX endpoints, three new localized strings), **new** `inc/history.php` (storage helpers + page renderer), `assets/css/radio.css` (history-page table, toolbar, search-link pills, favourite star, dark-theme overrides), `assets/js/radio.js` (`logTrackIfNew` wired into `fetchTrack`; `bindHistoryPage` for filter/favourite/clear), `inc/about.php` (history entry).
+
+---
+
 ## [0.4.0] — 2026-05-29 — Now-playing indicator: dancing bars + Web Audio visualizer
 
 A small visual that instantly says *"this is playing right now."* Two layers — a reliable CSS-only indicator that always works, and a progressive Web Audio upgrade that draws actual frequency data when the browser allows.

assets/css/radio.css

@@ -166,6 +166,16 @@
     font-family: "Helvetica Neue", Arial, sans-serif;
 }
 
+/* v0.6.0: Pop-out button — small secondary button beside Play. Uses WP
+   native .button styles; the ↗ glyph signals "opens in another window." */
+.radio-player__popout {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    font-size: 12px;
+}
+.radio-player__popout span[aria-hidden] { font-size: 13px; line-height: 1; }
+
 .radio-player__volume {
     display: flex;
     align-items: center;
@@ -287,6 +297,22 @@
     font-size: 13px;
 }
 
+/* Small grey pill that follows the Settings page H1 — at-a-glance
+   confirmation of the version you are running (v0.6.2). */
+.radio-version-badge {
+    display: inline-block;
+    margin-left: 8px;
+    padding: 2px 8px;
+    background: #e2e4e7;
+    color: #50575e;
+    border-radius: 10px;
+    font-size: 11px;
+    font-weight: 600;
+    vertical-align: middle;
+    letter-spacing: 0.02em;
+}
+.radio-theme-dark .radio-version-badge { background: #2c3338; color: #c3c4c7; }
+
 /* ──────────────────────────────────────────────────────────────────
  * Dashboard widget — no nested card; bare content inside .inside
  * (WP renders the widget as a postbox already; don't double up)
@@ -349,27 +375,50 @@
     padding-top: 0;
 }
 
-.radio-about-card--versions ul {
+.radio-about-changelog-link {
-    list-style: none;
+    display: inline-block;
-    padding: 12px;
+    margin: 0 12px 12px;
-    margin: 0;
+    font-size: 13px;
+    color: var(--wp-admin-theme-color, #2271b1);
+    text-decoration: none;
+}
+.radio-about-changelog-link:hover { text-decoration: underline; }
+
+/* ──────────────────────────────────────────────────────────────────
+ * Version history — full-width card BELOW the top row of cards
+ * (v0.6.1). Latest release shown in full; earlier releases collapse
+ * to one line each so the card stays compact however many versions
+ * ship. Full prose for older versions lives in the CHANGELOG on Gitea.
+ * ─────────────────────────────────────────────────────────────── */
+
+.radio-about-versions {
+    max-width: 1100px;
+    margin-top: 16px;
+    background: #fff;
+    border: 1px solid #c3c4c7;
+    box-shadow: 0 1px 1px rgba(0, 0, 0, 0.04);
 }
 
-.radio-about-card--versions li {
+.radio-about-versions h2 {
-    margin-bottom: 10px;
+    margin: 0;
+    padding: 8px 12px;
+    font-size: 14px;
+    font-weight: 600;
+    background: #f6f7f7;
+    border-bottom: 1px solid #c3c4c7;
+}
+
+.radio-about-versions__latest {
+    padding: 12px 12px 8px;
+}
+
+.radio-about-versions__latest .ver {
+    font-weight: 600;
+    color: var(--wp-admin-theme-color, #2271b1);
     font-size: 13px;
 }
 
-.radio-about-card--versions li:last-child {
+.radio-about-versions__latest .latest {
-    margin-bottom: 0;
-}
-
-.radio-about-card--versions .ver {
-    font-weight: 600;
-    color: var(--wp-admin-theme-color, #2271b1);
-}
-
-.radio-about-card--versions .latest {
     display: inline-block;
     margin-left: 6px;
     padding: 1px 7px;
@@ -381,16 +430,47 @@
     vertical-align: middle;
 }
 
-.radio-about-changelog-link {
+.radio-about-versions__latest p {
-    display: inline-block;
+    margin: 6px 0 0;
-    margin: 0 12px 12px;
     font-size: 13px;
-    color: var(--wp-admin-theme-color, #2271b1);
+    color: #1d2327;
-    text-decoration: none;
 }
 
-.radio-about-changelog-link:hover {
+.radio-about-versions h3 {
-    text-decoration: underline;
+    margin: 4px 0 0;
+    padding: 8px 12px 4px;
+    font-size: 11px;
+    font-weight: 600;
+    color: #646970;
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    border-top: 1px solid #f0f0f1;
+}
+
+.radio-about-versions__earlier {
+    list-style: none;
+    margin: 0;
+    padding: 4px 12px 8px;
+}
+
+.radio-about-versions__earlier li {
+    padding: 4px 0;
+    font-size: 13px;
+    color: #50575e;
+}
+
+.radio-about-versions__earlier .ver {
+    display: inline-block;
+    min-width: 48px;
+    font-weight: 600;
+    color: var(--wp-admin-theme-color, #2271b1);
+}
+
+.radio-about-versions__earlier .ver-date {
+    display: inline-block;
+    min-width: 110px;
+    font-size: 11px;
+    color: #646970;
 }
 
 /* ──────────────────────────────────────────────────────────────────
@@ -440,6 +520,12 @@
     color: #f0f0f1;
     border-bottom-color: #3c434a;
 }
+.radio-theme-dark .radio-about-versions { background: #1d2327; border-color: #3c434a; color: #c3c4c7; }
+.radio-theme-dark .radio-about-versions h2 { background: #2c3338; color: #f0f0f1; border-bottom-color: #3c434a; }
+.radio-theme-dark .radio-about-versions h3 { color: #a7aaad; border-top-color: #3c434a; }
+.radio-theme-dark .radio-about-versions__latest p { color: #c3c4c7; }
+.radio-theme-dark .radio-about-versions__earlier li { color: #c3c4c7; }
+.radio-theme-dark .radio-about-versions__earlier .ver-date { color: #a7aaad; }
 .radio-theme-dark #radio_dashboard_widget .radio-player__credit {
     border-top-color: #3c434a;
 }
@@ -453,3 +539,105 @@
     border-radius: 3px;
     border: 1px solid #3c434a;
 }
+
+/* ──────────────────────────────────────────────────────────────────
+ * History + Favourites page (v0.5.0)
+ * ─────────────────────────────────────────────────────────────── */
+
+.radio-history-wrap { max-width: 1100px; }
+
+.radio-tab-count {
+    color: #646970;
+    font-weight: 400;
+    margin-left: 2px;
+}
+
+.radio-history-toolbar {
+    display: flex;
+    gap: 10px;
+    align-items: center;
+    margin: 12px 0 16px;
+    flex-wrap: wrap;
+}
+
+.radio-history-toolbar input[type="search"] {
+    flex: 1 1 220px;
+    max-width: 360px;
+}
+.radio-history-toolbar select { max-width: 220px; }
+.radio-history-clear { margin-left: auto !important; }
+
+.radio-history-empty {
+    margin-top: 24px;
+    padding: 24px;
+    background: #fff;
+    border: 1px solid #c3c4c7;
+    color: #50575e;
+    font-style: italic;
+    text-align: center;
+}
+
+.radio-history-table { background: #fff; }
+.radio-history-table th,
+.radio-history-table td { padding: 10px 12px; vertical-align: middle; }
+.radio-history-table th.when,
+.radio-history-table th.station,
+.radio-history-table th.fav { white-space: nowrap; }
+.radio-history-table .when,
+.radio-history-table .station {
+    color: #646970; font-size: 12px; white-space: nowrap;
+}
+.radio-history-table .track { font-size: 14px; }
+.radio-history-table .track strong { color: #1d2327; }
+.radio-history-table .search { white-space: nowrap; }
+.radio-history-table .fav { text-align: center; width: 42px; }
+
+/* Search-link pills, brand-tinted on hover */
+.radio-search-link {
+    display: inline-block;
+    padding: 2px 8px;
+    margin-right: 4px;
+    font-size: 11px;
+    font-weight: 600;
+    border-radius: 10px;
+    text-decoration: none;
+    background: #e2e4e7;
+    color: #1d2327;
+    transition: background 0.15s ease, color 0.15s ease;
+}
+.radio-search-link:hover                 { background: #d0d3d6; }
+.radio-search-link--spotify:hover        { background: #1ed760; color: #000; }
+.radio-search-link--youtube:hover        { background: #ff0000; color: #fff; }
+.radio-search-link--apple:hover          { background: #fa57c1; color: #fff; }
+.radio-search-link--bandcamp:hover       { background: #629aa9; color: #fff; }
+
+/* Favourite star — grey by default, golden when starred */
+.radio-fav-btn {
+    background: none;
+    border: 0;
+    padding: 4px 6px;
+    cursor: pointer;
+    font-size: 18px;
+    line-height: 1;
+    color: #c3c4c7;
+    transition: transform 0.12s ease, color 0.12s ease;
+}
+.radio-fav-btn:hover { transform: scale(1.2); color: #f0b849; }
+.radio-fav-btn:focus { outline: 2px solid var(--wp-admin-theme-color, #2271b1); outline-offset: 1px; }
+.radio-fav-btn.is-fav { color: #f0b849; }
+.radio-fav-btn[disabled] { opacity: 0.5; cursor: progress; }
+
+/* Filtered-out rows hidden via JS */
+.radio-history-row.is-filtered { display: none; }
+
+/* Dark theme — history surfaces */
+.radio-theme-dark .radio-history-table { background: #1d2327; color: #c3c4c7; border-color: #3c434a; }
+.radio-theme-dark .radio-history-table th { background: #2c3338; color: #f0f0f1; border-bottom-color: #3c434a; }
+.radio-theme-dark .radio-history-table .track strong { color: #f0f0f1; }
+.radio-theme-dark .radio-history-table .when,
+.radio-theme-dark .radio-history-table .station { color: #a7aaad; }
+.radio-theme-dark .radio-search-link { background: #2c3338; color: #c3c4c7; }
+.radio-theme-dark .radio-history-empty { background: #1d2327; border-color: #3c434a; color: #c3c4c7; }
+.radio-theme-dark .radio-fav-btn { color: #50575e; }
+.radio-theme-dark .radio-fav-btn.is-fav,
+.radio-theme-dark .radio-fav-btn:hover { color: #f0b849; }

assets/js/radio.js

@@ -109,7 +109,8 @@
     }
 
     /** SomaFM current-track polling. Best-effort: stays hidden if the API
-     *  is unreachable / CORS-blocked (the plugin keeps working regardless). */
+     *  is unreachable / CORS-blocked (the plugin keeps working regardless).
+     *  v0.5.0: hands new tracks to logTrackIfNew so they land in user history. */
     function startTrackPolling(player, station) {
         stopTrackPolling(player);
         var trackEl = player.querySelector('[data-radio-track]');
@@ -129,6 +130,7 @@
                     if (!title && !artist) { trackEl.hidden = true; return; }
                     trackEl.textContent = artist ? (title + ' — ' + artist) : title;
                     trackEl.hidden = false;
+                    logTrackIfNew(artist, title, station);
                 })
                 .catch(function () { trackEl.hidden = true; });
         }
@@ -136,6 +138,29 @@
         player._trackTimer = setInterval(fetchTrack, 30000);
     }
 
+    /** v0.5.0: POST a newly-played track to the server history.
+     *  Deduped client-side via lastLoggedSig so consecutive polls of the
+     *  same song don't spam the endpoint (server dedups too as belt+braces). */
+    var lastLoggedSig = '';
+    function logTrackIfNew(artist, title, station) {
+        if (!cfg.ajaxUrl || !cfg.nonce) { return; }
+        if (!artist || !title) { return; }
+        if (artist.toLowerCase() === '(unknown)') { return; }
+        var sig = (artist + '|' + title + '|' + ((station && station.id) || '')).toLowerCase();
+        if (sig === lastLoggedSig) { return; }
+        lastLoggedSig = sig;
+
+        var fd = new FormData();
+        fd.append('action',     'radio_log_track');
+        fd.append('nonce',      cfg.nonce);
+        fd.append('artist',     artist);
+        fd.append('title',      title);
+        fd.append('station',    (station && station.name) || '');
+        fd.append('station_id', (station && station.id)   || '');
+        fetch(cfg.ajaxUrl, { method: 'POST', credentials: 'same-origin', body: fd })
+            .catch(function () { /* track log is best-effort */ });
+    }
+
     function stopTrackPolling(player) {
         if (player._trackTimer) {
             clearInterval(player._trackTimer);
@@ -387,6 +412,44 @@
         }
 
         bindMute(player, audio, volumeIn, volPctEl);
+        bindPopOut(player);
+
+        // v0.6.0: popout auto-resume — when opened with ?play=1, immediately
+        // pick up where the main tab left off. Same-origin user-gesture popups
+        // are exempt from autoplay blocking on every modern browser.
+        if (cfg.autoPlay) {
+            setTimeout(function () {
+                if (audio.paused) { audio.play().catch(function () { /* autoplay denied — user just clicks play */ }); }
+            }, 200);
+        }
+    }
+
+    /** v0.6.0: Pop-out window button. Opens a 380×560 standalone window
+     *  with just the player chrome (no WP admin), via admin-post.php?
+     *  action=radio_popout&play=1. The popup persists across main-tab
+     *  navigation so background music doesn't cut when you move around
+     *  the WP admin. Pauses every other audio surface in this tab so
+     *  there's only one stream playing at a time. */
+    function bindPopOut(player) {
+        var btn = player.querySelector('[data-radio-popout]');
+        if (!btn) { return; }
+        if (!cfg.popoutUrl) { btn.style.display = 'none'; return; } // already in popout
+        btn.addEventListener('click', function () {
+            var w = window.open(
+                cfg.popoutUrl + '&play=1',
+                'radio_popout',
+                'width=380,height=560,resizable=yes,scrollbars=no,toolbar=no,location=no,menubar=no,status=no'
+            );
+            if (!w) {
+                window.alert('Pop-out blocked by the browser. Allow popups for this site, then try again.');
+                return;
+            }
+            w.focus();
+            // Pause every audio surface in this tab — the popup is the new player.
+            document.querySelectorAll('[data-radio-audio]').forEach(function (a) {
+                if (!a.paused) { a.pause(); }
+            });
+        });
     }
 
     /** Keep all .radio-player surfaces on the same station. */
@@ -435,10 +498,79 @@
         });
     }
 
+    /** v0.5.0: wire the History admin page — filter, favourite-toggle,
+     *  clear-history. No-op on pages without these elements. */
+    function bindHistoryPage() {
+        var searchIn   = document.getElementById('radio-history-search');
+        var stationSel = document.getElementById('radio-history-station');
+        var rows       = document.querySelectorAll('.radio-history-row');
+        var clearBtn   = document.getElementById('radio-history-clear');
+
+        function applyFilter() {
+            if (!rows.length) { return; }
+            var q = (searchIn ? searchIn.value : '').toLowerCase().trim();
+            var s = stationSel ? stationSel.value : '';
+            rows.forEach(function (row) {
+                var matchQ = !q || (row.dataset.search || '').indexOf(q) !== -1;
+                var matchS = !s || row.dataset.stationId === s;
+                row.classList.toggle('is-filtered', !(matchQ && matchS));
+            });
+        }
+        if (searchIn)   { searchIn.addEventListener('input',  applyFilter); }
+        if (stationSel) { stationSel.addEventListener('change', applyFilter); }
+
+        // Favourite-toggle buttons (per row)
+        document.querySelectorAll('.radio-fav-btn').forEach(function (btn) {
+            btn.addEventListener('click', function () {
+                var fd = new FormData();
+                fd.append('action',     'radio_toggle_favourite');
+                fd.append('nonce',      btn.dataset.nonce || '');
+                fd.append('artist',     btn.dataset.artist || '');
+                fd.append('title',      btn.dataset.title || '');
+                fd.append('station',    btn.dataset.station || '');
+                fd.append('station_id', btn.dataset.stationId || '');
+                btn.disabled = true;
+                fetch(cfg.ajaxUrl, { method: 'POST', credentials: 'same-origin', body: fd })
+                    .then(function (r) { return r.json(); })
+                    .then(function (res) {
+                        btn.disabled = false;
+                        if (!res || !res.success) { return; }
+                        var isFav = !!(res.data && res.data.favourite);
+                        btn.classList.toggle('is-fav', isFav);
+                        btn.textContent = isFav ? '★' : '☆';
+                        btn.setAttribute('aria-label', isFav
+                            ? (cfg.strings.removeFav || 'Remove from favourites')
+                            : (cfg.strings.addFav    || 'Add to favourites'));
+                    })
+                    .catch(function () { btn.disabled = false; });
+            });
+        });
+
+        // Clear-history button (history tab only)
+        if (clearBtn) {
+            clearBtn.addEventListener('click', function () {
+                var msg = cfg.strings.clearConfirm || 'Clear all track history? (Favourites are kept.)';
+                if (!window.confirm(msg)) { return; }
+                var fd = new FormData();
+                fd.append('action', 'radio_clear_history');
+                fd.append('nonce',  clearBtn.dataset.nonce || '');
+                clearBtn.disabled = true;
+                fetch(cfg.ajaxUrl, { method: 'POST', credentials: 'same-origin', body: fd })
+                    .then(function (r) { return r.json(); })
+                    .then(function (res) {
+                        if (res && res.success) { window.location.reload(); }
+                        else { clearBtn.disabled = false; }
+                    })
+                    .catch(function () { clearBtn.disabled = false; });
+            });
+        }
+    }
+
     function init() {
         var players = document.querySelectorAll('.radio-player');
         for (var i = 0; i < players.length; i++) { bindPlayer(players[i]); }
         bindSettingsSlider();
+        bindHistoryPage();
     }
 
     if (document.readyState === 'loading') {

inc/about.php

@@ -2,9 +2,12 @@
 /**
  * Radio — About page (WP Admin → Radio → About).
  *
- * Plain-language explanation of what the plugin does + version
+ * Top row: three short cards (What / Who / Credits) — equal-height,
- * history + link to the CHANGELOG.md on Gitea. Pattern mirrors
+ * balanced layout. Below: a full-width Version history card with the
- * a-buddy/inc/about.php.
+ * latest release shown in full and earlier releases as a one-line
+ * summary list, capped by a link to the full CHANGELOG on Gitea.
+ *
+ * Pattern mirrors a-buddy/inc/about.php.
  */
 
 if ( ! defined( 'ABSPATH' ) ) { exit; }
@@ -19,6 +22,7 @@ function radio_render_about_page() {
     <div class="wrap radio-about-wrap">
         <h1><?php esc_html_e( 'About Radio', 'radio' ); ?></h1>
 
+        <!-- ── Top row: three short cards (What / Who / Credits) ── -->
         <div class="radio-about-grid">
 
             <div class="radio-about-card">
@@ -44,41 +48,6 @@ function radio_render_about_page() {
                 </p>
             </div>
 
-            <div class="radio-about-card radio-about-card--versions">
-                <h2><?php esc_html_e( 'Version history', 'radio' ); ?></h2>
-                <ul>
-                    <li>
-                        <span class="ver">v0.4.0</span> &mdash; 29 May 2026 <span class="latest">latest</span><br>
-                        <?php esc_html_e( 'Now-playing visual indicator. Four tiny dancing bars next to "Now Playing" pulse while the audio is playing (pure CSS, always works). On top of that, a Web Audio frequency visualizer tries to draw live frequency bars on a small canvas — if the browser allows it and the stream is CORS-friendly it kicks in automatically; if not, the CSS bars stay and nothing breaks.', 'radio' ); ?>
-                    </li>
-                    <li>
-                        <span class="ver">v0.3.2</span> &mdash; 29 May 2026<br>
-                        <?php esc_html_e( 'Play-button glyph baseline fix. The dashicon used for play/pause was rendering below the button text. Swapped to a plain Unicode glyph (▶ / ‖) that sits on the text baseline like any other character.', 'radio' ); ?>
-                    </li>
-                    <li>
-                        <span class="ver">v0.3.1</span> &mdash; 29 May 2026<br>
-                        <?php esc_html_e( 'My Radio layout polish + dropped dark-auto. Player no longer stretches edge-to-edge (max-width 880px); volume slider fixed width so the % label sits next to it; station dropdown capped at 360px; play-button icon shrunk to match the button text baseline; intro paragraph now fits one line. Removed the prefers-color-scheme dark-auto behaviour that was unreadable against WordPress\'s still-white postbox; theme=dark is still available as an explicit choice and now gives the player its own dark surface so it actually reads.', 'radio' ); ?>
-                    </li>
-                    <li>
-                        <span class="ver">v0.3.0</span> &mdash; 29 May 2026<br>
-                        <?php esc_html_e( 'Dark theme wired through. Mute toggle on the speaker icon. OS media keys (F8 / headphone buttons / lock-screen) play and pause via MediaSession. Current track polled from SomaFM and shown under the station description while playing. Save errors surface as a brief notice instead of being swallowed. Genre badge restyled as an inline pill.', 'radio' ); ?>
-                    </li>
-                    <li>
-                        <span class="ver">v0.2.0</span> &mdash; 26 May 2026<br>
-                        <?php esc_html_e( 'UI rebuilt to WordPress admin standards. Postbox container, native Play/Pause button with text label, picks up your admin colour scheme via var(--wp-admin-theme-color), genre badge moved inline, dashboard widget no longer renders a card-inside-a-card. Functionality identical to v0.1.0 — purely visual polish.', 'radio' ); ?>
-                    </li>
-                    <li>
-                        <span class="ver">v0.1.0</span> &mdash; 26 May 2026<br>
-                        <?php esc_html_e( 'First release. 44 SomaFM stations grouped by 10 genres, dashboard widget + dedicated admin page, per-user state in user_meta, self-hosted update checker against Gitea. Direct HTML5 audio playback — no proxy, no build step, no tracking.', 'radio' ); ?>
-                    </li>
-                </ul>
-                <a class="radio-about-changelog-link"
-                   href="<?php echo esc_url( RADIO_GITEA_URL . '/src/branch/main/CHANGELOG.md' ); ?>"
-                   target="_blank" rel="noopener">
-                    <?php esc_html_e( 'View the full CHANGELOG.md →', 'radio' ); ?>
-                </a>
-            </div>
-
             <div class="radio-about-card">
                 <h2><?php esc_html_e( 'Credits + thanks', 'radio' ); ?></h2>
                 <p>
@@ -98,7 +67,39 @@ function radio_render_about_page() {
                 </p>
             </div>
 
+        </div><!-- /.radio-about-grid -->
+
+        <!-- ── Version history: latest in full, earlier as one-liners ── -->
+        <div class="radio-about-versions">
+            <h2><?php esc_html_e( 'Version history', 'radio' ); ?></h2>
+
+            <div class="radio-about-versions__latest">
+                <span class="ver">v0.6.2</span> &mdash; 30 May 2026 <span class="latest"><?php esc_html_e( 'latest', 'radio' ); ?></span>
+                <p>
+                    <?php esc_html_e( 'Current version badge on the Settings page. A small grey pill follows the "Radio — Settings" heading so the version you are running is visible at a glance — no need to hover the plugin in Plugins → Installed or open the About page to check.', 'radio' ); ?>
+                </p>
             </div>
+
+            <h3><?php esc_html_e( 'Earlier releases', 'radio' ); ?></h3>
+            <ul class="radio-about-versions__earlier">
+                <li><span class="ver">v0.6.1</span> <span class="ver-date">30 May 2026</span> &mdash; <?php esc_html_e( 'About page restructure — balanced 3-card top row + compact version history', 'radio' ); ?></li>
+                <li><span class="ver">v0.6.0</span> <span class="ver-date">30 May 2026</span> &mdash; <?php esc_html_e( 'Pop-out mini-player — continuous background play across admin navigation', 'radio' ); ?></li>
+                <li><span class="ver">v0.5.0</span> <span class="ver-date">29 May 2026</span> &mdash; <?php esc_html_e( 'Track history + favourites (Spotify / YouTube / Apple Music / Bandcamp search links)', 'radio' ); ?></li>
+                <li><span class="ver">v0.4.0</span> <span class="ver-date">29 May 2026</span> &mdash; <?php esc_html_e( 'Now-playing indicator — dancing bars + Web Audio frequency visualizer', 'radio' ); ?></li>
+                <li><span class="ver">v0.3.2</span> <span class="ver-date">29 May 2026</span> &mdash; <?php esc_html_e( 'Play-button glyph baseline fix (dashicon → Unicode ▶ / ‖)', 'radio' ); ?></li>
+                <li><span class="ver">v0.3.1</span> <span class="ver-date">29 May 2026</span> &mdash; <?php esc_html_e( 'My Radio layout polish + dropped dark-auto', 'radio' ); ?></li>
+                <li><span class="ver">v0.3.0</span> <span class="ver-date">29 May 2026</span> &mdash; <?php esc_html_e( 'Dark theme + mute + OS media keys + SomaFM current-track display', 'radio' ); ?></li>
+                <li><span class="ver">v0.2.0</span> <span class="ver-date">26 May 2026</span> &mdash; <?php esc_html_e( 'UI rebuilt to WordPress admin standards', 'radio' ); ?></li>
+                <li><span class="ver">v0.1.0</span> <span class="ver-date">26 May 2026</span> &mdash; <?php esc_html_e( 'First release — 44 SomaFM stations, dashboard widget + dedicated admin page, per-user state, self-hosted Gitea updater', 'radio' ); ?></li>
+            </ul>
+
+            <a class="radio-about-changelog-link"
+               href="<?php echo esc_url( RADIO_GITEA_URL . '/src/branch/main/CHANGELOG.md' ); ?>"
+               target="_blank" rel="noopener">
+                <?php esc_html_e( 'View the full CHANGELOG.md →', 'radio' ); ?>
+            </a>
+        </div>
+
     </div>
     <?php
 }

inc/admin-page.php

@@ -58,6 +58,10 @@ function radio_render_main_page() {
                             <span data-radio-play-label><?php esc_html_e( 'Play', 'radio' ); ?></span>
                         </button>
 
+                        <button type="button" class="button radio-player__popout" data-radio-popout title="<?php esc_attr_e( 'Open in a pop-out window — keeps playing while you navigate the admin', 'radio' ); ?>">
+                            <span aria-hidden="true">↗</span> <?php esc_html_e( 'Pop out', 'radio' ); ?>
+                        </button>
+
                         <div class="radio-player__volume">
                             <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'radio' ); ?>">
                                 <span class="dashicons dashicons-controls-volumeon" aria-hidden="true"></span>

inc/dashboard-widget.php

@@ -51,6 +51,10 @@ function radio_render_dashboard_widget() {
                 <span data-radio-play-label><?php esc_html_e( 'Play', 'radio' ); ?></span>
             </button>
 
+            <button type="button" class="button radio-player__popout" data-radio-popout title="<?php esc_attr_e( 'Open in a pop-out window — keeps playing while you navigate', 'radio' ); ?>">
+                <span aria-hidden="true">↗</span> <?php esc_html_e( 'Pop out', 'radio' ); ?>
+            </button>
+
             <div class="radio-player__volume">
                 <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'radio' ); ?>">
                     <span class="dashicons dashicons-controls-volumeon" aria-hidden="true"></span>

inc/history.php

@@ -0,0 +1,255 @@
+<?php
+/**
+ * Radio — track history + favourites (v0.5.0).
+ *
+ * Storage: two per-user `wp_usermeta` keys, separate from `radio_state`
+ * so frequent track logging doesn't rewrite the whole state blob.
+ *   radio_history    — capped FIFO list of recently played tracks
+ *   radio_favourites — uncapped list of user-starred tracks
+ *
+ * Entry shape:
+ *   array(
+ *     'artist'     => string,
+ *     'title'      => string,
+ *     'station'    => string,    // display name e.g. "DEF CON Radio"
+ *     'station_id' => string,    // e.g. "soma-defcon"
+ *     'at'         => int,       // unix timestamp
+ *   )
+ */
+
+if ( ! defined( 'ABSPATH' ) ) { exit; }
+
+const RADIO_HISTORY_KEY    = 'radio_history';
+const RADIO_FAVOURITES_KEY = 'radio_favourites';
+const RADIO_HISTORY_CAP    = 500;
+
+/** Current user's track history (oldest first). */
+function radio_get_history( $user_id = 0 ) {
+    $user_id = $user_id ? (int) $user_id : get_current_user_id();
+    if ( ! $user_id ) { return array(); }
+    $h = get_user_meta( $user_id, RADIO_HISTORY_KEY, true );
+    return is_array( $h ) ? $h : array();
+}
+
+/** Current user's favourited tracks (oldest first). */
+function radio_get_favourites( $user_id = 0 ) {
+    $user_id = $user_id ? (int) $user_id : get_current_user_id();
+    if ( ! $user_id ) { return array(); }
+    $f = get_user_meta( $user_id, RADIO_FAVOURITES_KEY, true );
+    return is_array( $f ) ? $f : array();
+}
+
+/** Normalise raw POSTed track data; returns null on junk input. */
+function radio_sanitize_entry( $entry ) {
+    if ( ! is_array( $entry ) ) { return null; }
+    $artist     = isset( $entry['artist'] )     ? sanitize_text_field( wp_unslash( $entry['artist'] ) )     : '';
+    $title      = isset( $entry['title'] )      ? sanitize_text_field( wp_unslash( $entry['title'] ) )      : '';
+    $station    = isset( $entry['station'] )    ? sanitize_text_field( wp_unslash( $entry['station'] ) )    : '';
+    $station_id = isset( $entry['station_id'] ) ? sanitize_key( wp_unslash( $entry['station_id'] ) )        : '';
+    if ( ! $artist || ! $title )                   { return null; }
+    if ( strtolower( $artist ) === '(unknown)' )   { return null; } // SomaFM promo / dead-air placeholder
+    return array(
+        'artist'     => mb_substr( $artist, 0, 200 ),
+        'title'      => mb_substr( $title, 0, 200 ),
+        'station'    => mb_substr( $station, 0, 100 ),
+        'station_id' => $station_id,
+        'at'         => time(),
+    );
+}
+
+/** Dedup signature — artist|title|station_id, lowercased + trimmed. */
+function radio_entry_signature( $entry ) {
+    $a = isset( $entry['artist'] )     ? $entry['artist']     : '';
+    $t = isset( $entry['title'] )      ? $entry['title']      : '';
+    $s = isset( $entry['station_id'] ) ? $entry['station_id'] : '';
+    return strtolower( trim( $a . '|' . $t . '|' . $s ) );
+}
+
+/** Append a track to the user's history, deduped against the last entry
+ *  and capped at RADIO_HISTORY_CAP. Returns true if appended. */
+function radio_log_track( $entry, $user_id = 0 ) {
+    $user_id = $user_id ? (int) $user_id : get_current_user_id();
+    if ( ! $user_id ) { return false; }
+    $clean = radio_sanitize_entry( $entry );
+    if ( ! $clean ) { return false; }
+
+    $history = radio_get_history( $user_id );
+    if ( ! empty( $history ) ) {
+        $last_sig = radio_entry_signature( $history[ count( $history ) - 1 ] );
+        if ( radio_entry_signature( $clean ) === $last_sig ) { return false; }
+    }
+
+    $history[] = $clean;
+    if ( count( $history ) > RADIO_HISTORY_CAP ) {
+        $history = array_slice( $history, -RADIO_HISTORY_CAP );
+    }
+    update_user_meta( $user_id, RADIO_HISTORY_KEY, $history );
+    return true;
+}
+
+/** Toggle whether an entry is favourited. Returns the new state
+ *  (true = now favourited, false = now unfavourited). */
+function radio_toggle_favourite( $entry, $user_id = 0 ) {
+    $user_id = $user_id ? (int) $user_id : get_current_user_id();
+    if ( ! $user_id ) { return false; }
+    $clean = radio_sanitize_entry( $entry );
+    if ( ! $clean ) { return false; }
+    $sig = radio_entry_signature( $clean );
+
+    $favs  = radio_get_favourites( $user_id );
+    $found = -1;
+    foreach ( $favs as $i => $f ) {
+        if ( radio_entry_signature( $f ) === $sig ) { $found = $i; break; }
+    }
+    if ( $found >= 0 ) {
+        array_splice( $favs, $found, 1 );
+        update_user_meta( $user_id, RADIO_FAVOURITES_KEY, $favs );
+        return false;
+    }
+    $favs[] = $clean;
+    update_user_meta( $user_id, RADIO_FAVOURITES_KEY, $favs );
+    return true;
+}
+
+/** Clear the user's history (favourites preserved). */
+function radio_clear_history_all( $user_id = 0 ) {
+    $user_id = $user_id ? (int) $user_id : get_current_user_id();
+    if ( ! $user_id ) { return false; }
+    delete_user_meta( $user_id, RADIO_HISTORY_KEY );
+    return true;
+}
+
+/** URL-build helpers for the four search providers. */
+function radio_search_urls( $artist, $title ) {
+    $enc = rawurlencode( trim( $artist . ' ' . $title ) );
+    return array(
+        'spotify'  => 'https://open.spotify.com/search/' . $enc,
+        'youtube'  => 'https://www.youtube.com/results?search_query=' . $enc,
+        'apple'    => 'https://music.apple.com/search?term=' . $enc,
+        'bandcamp' => 'https://bandcamp.com/search?q=' . $enc,
+    );
+}
+
+/** Render the History admin page (tabs: History / Favourites). */
+function radio_render_history_page() {
+    if ( ! current_user_can( 'read' ) ) {
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'radio' ) );
+    }
+
+    $tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'history'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- tab-switch only, no state change
+    if ( ! in_array( $tab, array( 'history', 'favourites' ), true ) ) { $tab = 'history'; }
+
+    $all_history    = radio_get_history();
+    $all_favourites = radio_get_favourites();
+    $entries        = ( $tab === 'favourites' ) ? $all_favourites : $all_history;
+    $entries        = array_reverse( $entries ); // newest first
+
+    // Set of favourite signatures for fast lookup in the row render.
+    $fav_sigs = array();
+    foreach ( $all_favourites as $f ) { $fav_sigs[ radio_entry_signature( $f ) ] = true; }
+
+    // Stations present in the current tab → filter dropdown options.
+    $stations_in_list = array();
+    foreach ( $entries as $e ) {
+        if ( ! empty( $e['station_id'] ) && ! isset( $stations_in_list[ $e['station_id'] ] ) ) {
+            $stations_in_list[ $e['station_id'] ] = $e['station'];
+        }
+    }
+    asort( $stations_in_list );
+
+    $base_url = admin_url( 'admin.php?page=radio-history' );
+    $hist_url = $base_url . '&tab=history';
+    $fav_url  = $base_url . '&tab=favourites';
+    $nonce    = wp_create_nonce( 'radio_history' );
+    ?>
+    <div class="wrap radio-history-wrap">
+        <h1><?php esc_html_e( 'Radio — Track history', 'radio' ); ?></h1>
+
+        <h2 class="nav-tab-wrapper">
+            <a href="<?php echo esc_url( $hist_url ); ?>" class="nav-tab <?php echo $tab === 'history' ? 'nav-tab-active' : ''; ?>">
+                <?php esc_html_e( 'History', 'radio' ); ?>
+                <span class="radio-tab-count">(<?php echo (int) count( $all_history ); ?>)</span>
+            </a>
+            <a href="<?php echo esc_url( $fav_url ); ?>" class="nav-tab <?php echo $tab === 'favourites' ? 'nav-tab-active' : ''; ?>">
+                ★ <?php esc_html_e( 'Favourites', 'radio' ); ?>
+                <span class="radio-tab-count">(<?php echo (int) count( $all_favourites ); ?>)</span>
+            </a>
+        </h2>
+
+        <?php if ( empty( $entries ) ) : ?>
+            <p class="radio-history-empty">
+                <?php if ( $tab === 'favourites' ) : ?>
+                    <?php esc_html_e( 'No favourites yet — star a track on the History tab to save it here.', 'radio' ); ?>
+                <?php else : ?>
+                    <?php esc_html_e( 'No tracks logged yet. Play some music in the Radio player — tracks will appear here as they play.', 'radio' ); ?>
+                <?php endif; ?>
+            </p>
+        <?php else : ?>
+
+            <div class="radio-history-toolbar">
+                <input type="search" id="radio-history-search" placeholder="<?php esc_attr_e( 'Filter by artist or title…', 'radio' ); ?>" />
+                <select id="radio-history-station">
+                    <option value=""><?php esc_html_e( 'All stations', 'radio' ); ?></option>
+                    <?php foreach ( $stations_in_list as $sid => $sname ) : ?>
+                        <option value="<?php echo esc_attr( $sid ); ?>"><?php echo esc_html( $sname ); ?></option>
+                    <?php endforeach; ?>
+                </select>
+                <?php if ( $tab === 'history' ) : ?>
+                    <button type="button" id="radio-history-clear" class="button radio-history-clear" data-nonce="<?php echo esc_attr( $nonce ); ?>">
+                        🗑 <?php esc_html_e( 'Clear history', 'radio' ); ?>
+                    </button>
+                <?php endif; ?>
+            </div>
+
+            <table class="widefat radio-history-table">
+                <thead>
+                    <tr>
+                        <th class="when"><?php esc_html_e( 'When', 'radio' ); ?></th>
+                        <th class="station"><?php esc_html_e( 'Station', 'radio' ); ?></th>
+                        <th class="track"><?php esc_html_e( 'Artist — Title', 'radio' ); ?></th>
+                        <th class="search"><?php esc_html_e( 'Search', 'radio' ); ?></th>
+                        <th class="fav"><span class="screen-reader-text"><?php esc_html_e( 'Favourite', 'radio' ); ?></span>★</th>
+                    </tr>
+                </thead>
+                <tbody>
+                <?php foreach ( $entries as $e ) :
+                    $sig    = radio_entry_signature( $e );
+                    $is_fav = isset( $fav_sigs[ $sig ] );
+                    $search = radio_search_urls( $e['artist'], $e['title'] );
+                    $ago    = human_time_diff( (int) $e['at'], time() );
+                    ?>
+                    <tr class="radio-history-row" data-station-id="<?php echo esc_attr( $e['station_id'] ); ?>" data-search="<?php echo esc_attr( strtolower( $e['artist'] . ' ' . $e['title'] ) ); ?>">
+                        <td class="when" title="<?php echo esc_attr( wp_date( 'j M Y, H:i', (int) $e['at'] ) ); ?>">
+                            <?php printf( esc_html__( '%s ago', 'radio' ), esc_html( $ago ) ); ?>
+                        </td>
+                        <td class="station"><?php echo esc_html( $e['station'] ); ?></td>
+                        <td class="track">
+                            <strong><?php echo esc_html( $e['artist'] ); ?></strong> &mdash; <?php echo esc_html( $e['title'] ); ?>
+                        </td>
+                        <td class="search">
+                            <a href="<?php echo esc_url( $search['spotify'] );  ?>" target="_blank" rel="noopener" class="radio-search-link radio-search-link--spotify">Spotify</a>
+                            <a href="<?php echo esc_url( $search['youtube'] );  ?>" target="_blank" rel="noopener" class="radio-search-link radio-search-link--youtube">YouTube</a>
+                            <a href="<?php echo esc_url( $search['apple'] );    ?>" target="_blank" rel="noopener" class="radio-search-link radio-search-link--apple">Apple</a>
+                            <a href="<?php echo esc_url( $search['bandcamp'] ); ?>" target="_blank" rel="noopener" class="radio-search-link radio-search-link--bandcamp">Bandcamp</a>
+                        </td>
+                        <td class="fav">
+                            <button type="button"
+                                    class="radio-fav-btn <?php echo $is_fav ? 'is-fav' : ''; ?>"
+                                    data-artist="<?php echo esc_attr( $e['artist'] ); ?>"
+                                    data-title="<?php echo esc_attr( $e['title'] ); ?>"
+                                    data-station="<?php echo esc_attr( $e['station'] ); ?>"
+                                    data-station-id="<?php echo esc_attr( $e['station_id'] ); ?>"
+                                    data-nonce="<?php echo esc_attr( $nonce ); ?>"
+                                    aria-label="<?php echo $is_fav ? esc_attr__( 'Remove from favourites', 'radio' ) : esc_attr__( 'Add to favourites', 'radio' ); ?>">
+                                <?php echo $is_fav ? '★' : '☆'; ?>
+                            </button>
+                        </td>
+                    </tr>
+                <?php endforeach; ?>
+                </tbody>
+            </table>
+
+        <?php endif; ?>
+    </div>
+    <?php
+}

inc/settings.php

@@ -47,7 +47,10 @@ function radio_render_settings_page() {
     $hide_widget = ! empty( $state['hide_dashboard_widget'] );
     ?>
     <div class="wrap radio-settings-wrap">
-        <h1><?php esc_html_e( 'Radio — Settings', 'radio' ); ?></h1>
+        <h1>
+            <?php esc_html_e( 'Radio — Settings', 'radio' ); ?>
+            <span class="radio-version-badge">v<?php echo esc_html( RADIO_VERSION ); ?></span>
+        </h1>
 
         <form method="post" action="">
             <?php wp_nonce_field( 'radio_save_settings', 'radio_settings_nonce' ); ?>

radio.php

@@ -5,7 +5,7 @@
  * Plugin Name: Radio
  * Plugin URI:  https://icanhelp.ie/radio
  * Description: A small, focused, free radio player for your WordPress admin. 44 SomaFM stations grouped by 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday, specials. Plays via HTML5 audio; volume + station choice persist per-user.
- * Version:     0.4.0
+ * Version:     0.6.2
  * Requires at least: 5.0
  * Requires PHP: 7.4
  * Author:      David Keane
@@ -20,7 +20,7 @@
 if ( ! defined( 'ABSPATH' ) ) { exit; }
 
 // Plugin coordinates.
-if ( ! defined( 'RADIO_VERSION' ) )   { define( 'RADIO_VERSION',   '0.4.0' ); }
+if ( ! defined( 'RADIO_VERSION' ) )   { define( 'RADIO_VERSION',   '0.6.2' ); }
 if ( ! defined( 'RADIO_FILE' ) )      { define( 'RADIO_FILE',      __FILE__ ); }
 if ( ! defined( 'RADIO_PATH' ) )      { define( 'RADIO_PATH',      plugin_dir_path( __FILE__ ) ); }
 if ( ! defined( 'RADIO_URL' ) )       { define( 'RADIO_URL',       plugin_dir_url( __FILE__ ) ); }
@@ -34,6 +34,7 @@ require_once RADIO_PATH . 'inc/dashboard-widget.php'; // the compact mini-player
 require_once RADIO_PATH . 'inc/admin-page.php';       // dedicated Radio admin page (larger player)
 require_once RADIO_PATH . 'inc/about.php';            // About page
 require_once RADIO_PATH . 'inc/settings.php';         // Settings page
+require_once RADIO_PATH . 'inc/history.php';          // Track history + favourites (v0.5.0)
 require_once RADIO_PATH . 'inc/updater.php';          // self-hosted update checker against Gitea
 
 /**
@@ -75,6 +76,15 @@ function radio_register_admin_menu() {
         'radio_render_settings_page'
     );
 
+    add_submenu_page(
+        'radio',
+        __( 'Track history', 'radio' ),
+        __( 'History', 'radio' ),
+        'read',
+        'radio-history',
+        'radio_render_history_page'
+    );
+
     add_submenu_page(
         'radio',
         __( 'About', 'radio' ),
@@ -96,6 +106,7 @@ function radio_enqueue_admin_assets( $hook ) {
         'toplevel_page_radio',        // Radio main page
         'radio_page_radio-settings',  // Settings
         'radio_page_radio-about',     // About
+        'radio_page_radio-history',   // History + Favourites (v0.5.0)
     );
     if ( ! in_array( $hook, $radio_hooks, true ) ) { return; }
 
@@ -120,6 +131,7 @@ function radio_enqueue_admin_assets( $hook ) {
         'stations'  => radio_get_stations_flat(),
         'ajaxUrl'   => admin_url( 'admin-ajax.php' ),
         'nonce'     => wp_create_nonce( 'radio_save_state' ),
+        'popoutUrl' => admin_url( 'admin-post.php?action=radio_popout' ),
         'strings'   => array(
             'play'         => __( 'Play', 'radio' ),
             'pause'        => __( 'Pause', 'radio' ),
@@ -131,6 +143,9 @@ function radio_enqueue_admin_assets( $hook ) {
             'nowPlaying'   => __( 'Now Playing', 'radio' ),
             'volume'       => __( 'Volume', 'radio' ),
             'station'      => __( 'Station', 'radio' ),
+            'addFav'       => __( 'Add to favourites', 'radio' ),
+            'removeFav'    => __( 'Remove from favourites', 'radio' ),
+            'clearConfirm' => __( 'Clear all track history? (Favourites are kept.)', 'radio' ),
         ),
     ) );
 }
@@ -162,6 +177,184 @@ function radio_ajax_save_state() {
     wp_send_json_success( radio_get_state() );
 }
 
+/**
+ * AJAX: log a played track to the user's history (v0.5.0).
+ * Nonce: same `radio_save_state` token used for state saves — both come
+ * from the same `wp_localize_script` config available on player pages.
+ */
+add_action( 'wp_ajax_radio_log_track', 'radio_ajax_log_track' );
+function radio_ajax_log_track() {
+    if ( ! is_user_logged_in() ) { wp_send_json_error( 'Not logged in.', 401 ); }
+    check_ajax_referer( 'radio_save_state', 'nonce' );
+    $logged = radio_log_track( array(
+        'artist'     => $_POST['artist']     ?? '',
+        'title'      => $_POST['title']      ?? '',
+        'station'    => $_POST['station']    ?? '',
+        'station_id' => $_POST['station_id'] ?? '',
+    ) );
+    wp_send_json_success( array( 'logged' => (bool) $logged ) );
+}
+
+/**
+ * AJAX: toggle whether a track is favourited.
+ * Nonce: `radio_history` — created fresh per History-page render so the
+ * AJAX is gated to users who actually loaded the page.
+ */
+add_action( 'wp_ajax_radio_toggle_favourite', 'radio_ajax_toggle_favourite' );
+function radio_ajax_toggle_favourite() {
+    if ( ! is_user_logged_in() ) { wp_send_json_error( 'Not logged in.', 401 ); }
+    check_ajax_referer( 'radio_history', 'nonce' );
+    $new_state = radio_toggle_favourite( array(
+        'artist'     => $_POST['artist']     ?? '',
+        'title'      => $_POST['title']      ?? '',
+        'station'    => $_POST['station']    ?? '',
+        'station_id' => $_POST['station_id'] ?? '',
+    ) );
+    wp_send_json_success( array( 'favourite' => (bool) $new_state ) );
+}
+
+/** AJAX: clear the current user's history (favourites preserved). */
+add_action( 'wp_ajax_radio_clear_history', 'radio_ajax_clear_history' );
+function radio_ajax_clear_history() {
+    if ( ! is_user_logged_in() ) { wp_send_json_error( 'Not logged in.', 401 ); }
+    check_ajax_referer( 'radio_history', 'nonce' );
+    radio_clear_history_all();
+    wp_send_json_success();
+}
+
+/**
+ * v0.6.0 — Pop-out mini player. Renders a standalone HTML page (no WP
+ * admin chrome) at `admin-post.php?action=radio_popout`, opened by the
+ * JS via `window.open()`. The popup persists across main-tab navigation
+ * so background music keeps playing when the user moves around the
+ * admin. `&play=1` in the URL tells `radio.js` to auto-resume on load.
+ */
+add_action( 'admin_post_radio_popout', 'radio_render_popout_page' );
+function radio_render_popout_page() {
+    if ( ! current_user_can( 'read' ) ) {
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'radio' ) );
+    }
+
+    $state    = radio_get_state();
+    $station  = radio_find_station( $state['station_id'] );
+    $stations = radio_get_stations_grouped();
+    $theme    = isset( $state['theme'] ) ? $state['theme'] : 'auto';
+    if ( ! in_array( $theme, array( 'auto', 'light', 'dark' ), true ) ) { $theme = 'auto'; }
+
+    $cfg = array(
+        'state'     => $state,
+        'stations'  => radio_get_stations_flat(),
+        'ajaxUrl'   => admin_url( 'admin-ajax.php' ),
+        'nonce'     => wp_create_nonce( 'radio_save_state' ),
+        'popoutUrl' => '', // already in popout — no further popouts
+        'autoPlay'  => isset( $_GET['play'] ), // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- query flag only, no state change
+        'strings'   => array(
+            'play'         => __( 'Play', 'radio' ),
+            'pause'        => __( 'Pause', 'radio' ),
+            'loading'      => __( 'Loading…', 'radio' ),
+            'error'        => __( 'Stream error — try another station.', 'radio' ),
+            'saveError'    => __( 'Preferences not saved — check your connection.', 'radio' ),
+            'mute'         => __( 'Mute', 'radio' ),
+            'unmute'       => __( 'Unmute', 'radio' ),
+            'nowPlaying'   => __( 'Now Playing', 'radio' ),
+            'volume'       => __( 'Volume', 'radio' ),
+            'station'      => __( 'Station', 'radio' ),
+        ),
+    );
+    ?>
+<!DOCTYPE html>
+<html lang="<?php echo esc_attr( str_replace( '_', '-', get_bloginfo( 'language' ) ) ); ?>">
+<head>
+    <meta charset="<?php bloginfo( 'charset' ); ?>">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><?php printf( esc_html__( 'Radio — %s', 'radio' ), esc_html( $station['name'] ) ); ?></title>
+    <link rel="stylesheet" href="<?php echo esc_url( includes_url( 'css/dashicons.min.css' ) ); ?>?ver=<?php echo esc_attr( get_bloginfo( 'version' ) ); ?>">
+    <link rel="stylesheet" href="<?php echo esc_url( RADIO_URL . 'assets/css/radio.css' ); ?>?ver=<?php echo esc_attr( RADIO_VERSION ); ?>">
+    <style>
+        :root { --wp-admin-theme-color: #2271b1; }
+        html, body { margin: 0; padding: 0; }
+        body { padding: 14px; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; background: #f0f0f1; color: #1d2327; font-size: 13px; }
+        .radio-popout-header { display: flex; justify-content: space-between; align-items: center; margin: 0 0 12px; }
+        .radio-popout-header h1 { margin: 0; font-size: 14px; font-weight: 600; color: #1d2327; }
+        .radio-popout-header h1::before { content: '📻 '; }
+        .radio-popout-close { background: none; border: 0; font-size: 18px; cursor: pointer; color: #646970; padding: 4px 8px; line-height: 1; border-radius: 3px; }
+        .radio-popout-close:hover { color: #b32d2e; background: rgba(179,45,46,0.08); }
+        .radio-popout-wrap { background: #fff; border: 1px solid #c3c4c7; padding: 14px; border-radius: 3px; }
+        .radio-popout-wrap .radio-player__station-select select { max-width: 100%; }
+        .radio-popout-wrap .radio-player__volume { width: 100%; }
+        .radio-popout-wrap .radio-player__controls { flex-direction: column; align-items: stretch; gap: 10px; }
+        body.radio-theme-dark { background: #101213; color: #f0f0f1; }
+        body.radio-theme-dark .radio-popout-header h1 { color: #f0f0f1; }
+        body.radio-theme-dark .radio-popout-wrap { background: #1d2327; border-color: #3c434a; }
+        body.radio-theme-dark .radio-popout-close { color: #a7aaad; }
+    </style>
+</head>
+<body class="radio-popout radio-theme-<?php echo esc_attr( $theme ); ?>">
+
+    <div class="radio-popout-header">
+        <h1><?php esc_html_e( 'Radio', 'radio' ); ?></h1>
+        <button type="button" class="radio-popout-close" onclick="window.close()" title="<?php esc_attr_e( 'Close', 'radio' ); ?>">✕</button>
+    </div>
+
+    <div class="radio-popout-wrap">
+        <div class="radio-player" data-radio-surface="popout">
+
+            <div class="radio-player__now">
+                <span class="radio-player__indicator" aria-hidden="true">
+                    <span class="radio-player__bars"><span></span><span></span><span></span><span></span></span>
+                    <canvas class="radio-player__viz" data-radio-viz hidden></canvas>
+                </span>
+                <span class="radio-player__label"><?php esc_html_e( 'Now Playing', 'radio' ); ?></span>
+                <span class="radio-player__station-name" data-radio-name><?php echo esc_html( $station['name'] ); ?></span>
+                <span class="radio-player__station-genre" data-radio-genre><?php echo esc_html( $station['genre'] ); ?></span>
+                <p class="radio-player__station-desc" data-radio-desc><?php echo esc_html( $station['description'] ); ?></p>
+                <p class="radio-player__track" data-radio-track hidden></p>
+            </div>
+
+            <div class="radio-player__controls">
+                <button type="button" class="button button-primary radio-player__play" data-radio-play>
+                    <span class="radio-player__play-glyph" data-radio-play-glyph aria-hidden="true">&#9654;</span>
+                    <span data-radio-play-label><?php esc_html_e( 'Play', 'radio' ); ?></span>
+                </button>
+                <div class="radio-player__volume">
+                    <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'radio' ); ?>">
+                        <span class="dashicons dashicons-controls-volumeon" aria-hidden="true"></span>
+                    </button>
+                    <input type="range" min="0" max="100" value="<?php echo esc_attr( (int) round( $state['volume'] * 100 ) ); ?>" data-radio-volume aria-label="<?php esc_attr_e( 'Volume', 'radio' ); ?>">
+                    <span class="radio-player__volume-pct" data-radio-volume-pct><?php echo esc_html( (int) round( $state['volume'] * 100 ) ); ?>%</span>
+                </div>
+            </div>
+
+            <div class="radio-player__station-select">
+                <label for="radio-station-popout"><?php esc_html_e( 'Station', 'radio' ); ?></label>
+                <select id="radio-station-popout" data-radio-station>
+                    <?php foreach ( $stations as $genre => $entries ) :
+                        if ( empty( $entries ) ) { continue; }
+                        ?>
+                        <optgroup label="<?php echo esc_attr( $genre ); ?>">
+                            <?php foreach ( $entries as $entry ) : ?>
+                                <option value="<?php echo esc_attr( $entry['id'] ); ?>" data-url="<?php echo esc_attr( $entry['url'] ); ?>" data-desc="<?php echo esc_attr( $entry['description'] ); ?>" data-genre="<?php echo esc_attr( $entry['genre'] ); ?>" <?php selected( $entry['id'], $state['station_id'] ); ?>>
+                                    <?php echo esc_html( $entry['name'] ); ?>
+                                </option>
+                            <?php endforeach; ?>
+                        </optgroup>
+                    <?php endforeach; ?>
+                </select>
+            </div>
+
+            <div class="radio-player__error" data-radio-error hidden></div>
+            <audio data-radio-audio preload="none" crossorigin="anonymous"></audio>
+        </div>
+    </div>
+
+    <script>window.RadioPlugin = <?php echo wp_json_encode( $cfg ); ?>;</script>
+    <script src="<?php echo esc_url( RADIO_URL . 'assets/js/radio.js' ); ?>?ver=<?php echo esc_attr( RADIO_VERSION ); ?>"></script>
+</body>
+</html>
+    <?php
+    exit;
+}
+
 /**
  * Surface the user's theme choice (auto/light/dark) to CSS as a body
  * class. `radio-theme-dark` forces dark; `radio-theme-auto` lets the