feat(0.7.0): WordPress.org submission prep — full Plugin Check clean

Ran the official Plugin Check (PCP) against v0.6.3 — surfaced 169 issues. This release closes all of them so the plugin is submission- ready for the WordPress.org plugin directory. Branding - Plugin Name renamed: "Radio" → "RangerHQ Radio". Removes the trademarked "SomaFM" from the plugin name surface (PCP trademarked_term). Lines up with the RangerHQ plugin family. SomaFM credited in Description + About as the data source. Folder/slug stays `a-radio` — no install path changes; existing user_meta keys (radio_state / radio_history / radio_favourites) untouched. - Text Domain header renamed: `radio` → `a-radio` (matches slug). - Requires at least bumped: 5.0 → 5.3 (matches wp_date() usage). - File docstring header dropped "SomaFM" from prominent line. Code (mass-mechanical) - 134 i18n call sites rewritten from `'radio'` text domain to `'a-radio'` across 7 PHP files. Single sed pass on the unique pattern `, 'radio' )` — the 6 menu-slug `'radio'` references in add_*_page() were correctly left alone (those are URL slugs). Security - 8 × MissingUnslash + 8 × InputNotSanitized in the v0.5.0 history endpoints (radio_ajax_log_track, radio_ajax_toggle_favourite). All four $_POST['artist|title|station|station_id'] access points are now wrapped sanitize_text_field( wp_unslash( $_POST['…'] ) ) (or sanitize_key for station_id) at the access point. Translator comments - 6 × printf / sprintf calls with placeholders now carry /* translators: ... */ comments. Pop-out window refactor - Inline <link> stylesheets, <style> block, and <script> tag in radio_render_popout_page() replaced with wp_enqueue_style() + wp_enqueue_script() + wp_localize_script() registered before HTML output, then wp_print_styles() in <head> and wp_print_footer_ scripts() at end of <body>. - Popup-specific CSS moved out of inline <style> and into radio.css under body.radio-popout scope so it only fires inside the popup. Removed - .DS_Store files (root + assets/). PCP hidden_files. Distribution - New readme.txt in proper WordPress.org format: Plugin headers, Contributors, Donate link, Tags, Requires-at-least, Tested-up-to, Stable Tag, Requires-PHP, License, Description, Installation, FAQ, Screenshots, Changelog, Upgrade Notice. Compat - No behaviour change for users; user_meta preserved. - Displayed Plugin Name in Plugins → Installed changes from "Radio" to "RangerHQ Radio" — only visible difference on update. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
feat(0.6.3): discreet "buy me a coffee" support link
2026-05-30 02:51:09 +01:00 · 2026-05-30 00:44:44 +01:00 · 2026-05-30 00:30:14 +01:00
10 changed files with 430 additions and 172 deletions
@@ -9,6 +9,70 @@ Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) — versi

 ---

+## [0.7.0] — 2026-05-30 — WordPress.org submission prep (full Plugin Check clean)
+
+Ran the official WordPress.org **Plugin Check (PCP)** against v0.6.3 — surfaced **169 issues**. This release closes all of them so the plugin is submission-ready for the WordPress.org plugin directory.
+
+### Changed — branding
+- **Plugin Name renamed: "Radio" → "RangerHQ Radio"** to (a) remove the trademarked term "SomaFM" from the plugin name surface (PCP `trademarked_term` warning) and (b) line up with the RangerHQ plugin family. SomaFM is still credited in the Description and on the About page as the data source. Plugin folder/slug stays `a-radio` — no install path changes; existing user_meta keys (`radio_state` / `radio_history` / `radio_favourites`) untouched.
+- **`Text Domain` header renamed**: `radio` → `a-radio` (matched the slug for the first time; PCP `textdomain_mismatch`).
+- **`Requires at least` bumped**: `5.0` → `5.3` (matches `wp_date()` usage in `inc/history.php`; PCP `wp_function_not_compatible_with_requires_wp`).
+- **File docstring header** dropped "SomaFM" from the prominent first line.
+
+### Changed — code (mass-mechanical)
+- **134 i18n call sites** rewritten from `'radio'` text domain → `'a-radio'` across `radio.php`, `inc/admin-page.php`, `inc/dashboard-widget.php`, `inc/settings.php`, `inc/about.php`, `inc/history.php`, `inc/updater.php`. Single sed pass on the unique pattern `, 'radio' )` (the 6 menu-slug `'radio'` references in `add_menu_page` / `add_submenu_page` were left alone — they're the URL slug, not the text domain).
+
+### Fixed — security
+- **8 × `MissingUnslash` + 8 × `InputNotSanitized`** in the v0.5.0 history endpoints (`radio_ajax_log_track`, `radio_ajax_toggle_favourite`). All four `$_POST['artist|title|station|station_id']` access points are now wrapped `sanitize_text_field( wp_unslash( $_POST['…'] ) )` (or `sanitize_key()` for `station_id`) at the access point. The downstream `radio_sanitize_entry()` helper still re-sanitizes as belt+braces.
+
+### Added — translator comments
+- 6 × `printf` / `sprintf` calls with placeholders now carry `/* translators: ... */` comments: pop-out window title, updater status messages (HTTP error / available / up-to-date / download), history page "%s ago" relative time.
+
+### Refactored — pop-out window
+- Inline `<link>` stylesheets, inline `<style>` block, and `<script>` tag in `radio_render_popout_page()` replaced with `wp_enqueue_style()` + `wp_enqueue_script()` + `wp_localize_script()` registered before the HTML output, then `wp_print_styles()` in `<head>` and `wp_print_footer_scripts()` at end of `<body>`.
+- Popup-specific CSS (header, close button, wrap, layout overrides, popup dark theme) moved out of the inline `<style>` and into `assets/css/radio.css` under `body.radio-popout` scope so it only fires inside the popup.
+
+### Removed
+- `.DS_Store` files (root + `assets/`) — stray macOS Finder artefacts; PCP `hidden_files`. `.gitignore` already covers them.
+
+### Added — distribution
+- **`readme.txt`** in proper WordPress.org format: Plugin headers, Contributors, Donate link, Tags, Requires-at-least, Tested-up-to, Stable Tag, Requires-PHP, License, License URI, short description (≤150 chars), Description, Installation, FAQ, Screenshots, Changelog, Upgrade Notice.
+
+### Compat notes
+- No behaviour change for existing users. Per-user state (`radio_state` / `radio_history` / `radio_favourites`) is preserved across the upgrade — no migration needed.
+- The displayed Plugin Name in **Plugins → Installed** changes from "Radio" to "RangerHQ Radio" — that's the only visible difference on update.
+
+**Files changed:** `radio.php` (header + 6 translator comments + 8 $_POST hardenings + popup enqueue refactor), `inc/admin-page.php` / `inc/dashboard-widget.php` / `inc/settings.php` / `inc/about.php` / `inc/history.php` / `inc/updater.php` (textdomain mass-fix + translator comments where applicable + about-page version rotation), `assets/css/radio.css` (popup styles moved in under `body.radio-popout`), **new** `readme.txt`, **removed** `.DS_Store`, `assets/.DS_Store`.
+
+---
+
+## [0.6.3] — 2026-05-30 — Discreet "buy me a coffee" support link
+
+### Added
+- New `RADIO_SUPPORT_URL` constant in `radio.php` (default `https://buymeacoffee.com/davidtkeane`). Wrapped in `if ( ! defined(...) )` so it's override-able from `wp-config.php`.
+- Tiny footer line `☕  Like Radio? If You fancy to buy me a coffee →` inside the **Updates panel** on Settings, below the manual-update note.
+- Matching footer line at the bottom of the **Credits + thanks** card on the About page.
+- Both spots render from the same constant — change one place, both update.
+- **Conditional render**: if `RADIO_SUPPORT_URL` is empty / undefined, the link is silently hidden. Forks can strip funding with one line.
+
+### Design
+- Muted styling deliberate: 12 px, admin-theme-coloured link, subtle top border. Reads as housekeeping ("here's where to send thanks") not a sales pitch. No yellow BMC brand chrome.
+- Dark-theme variant for the divider (`#3c434a`) so it stays subtle on the dark surface.
+
+**Files changed:** `radio.php` (version, `RADIO_SUPPORT_URL` constant), `inc/updater.php` (link inside the Updates panel after the manual-update paragraph), `inc/about.php` (link inside the Credits + thanks card; rotate v0.6.3 into latest expanded slot, v0.6.2 into earlier-releases list), `assets/css/radio.css` (`.radio-support-link` styling + dark-theme override).
+
+---
+
+## [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.
@@ -297,6 +297,39 @@
    font-size: 13px;
 }

+/* v0.6.3: Discreet "buy me a coffee" support line. Rendered in two
+   spots from the single RADIO_SUPPORT_URL constant — bottom of the
+   Updates panel in Settings, and bottom of the Credits + thanks card
+   on About. Muted styling deliberate: housekeeping not sales pitch. */
+.radio-support-link {
+    display: block;
+    margin-top: 12px;
+    padding-top: 10px;
+    border-top: 1px solid #f0f0f1;
+    font-size: 12px;
+    color: var(--wp-admin-theme-color, #2271b1);
+    text-decoration: none;
+}
+.radio-support-link::before { content: '☕  '; opacity: 0.8; }
+.radio-support-link:hover { text-decoration: underline; }
+.radio-theme-dark .radio-support-link { border-top-color: #3c434a; }
+
+/* Small grey pill that follows the Settings page H1 — at-a-glance
+   confirmation of the version you are running. */
+.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)
@@ -524,6 +557,39 @@
    border: 1px solid #3c434a;
 }

+/* ──────────────────────────────────────────────────────────────────
+ * Pop-out window (v0.6.0 → moved here from inline <style> in v0.7.0
+ * for PCP cleanliness). All scoped to body.radio-popout so these
+ * rules only fire inside the popup window, never bleed onto admin
+ * pages that load the same radio.css.
+ * ─────────────────────────────────────────────────────────────── */
+body.radio-popout {
+    /* Popup has no WP admin chrome to provide --wp-admin-theme-color;
+       set a reasonable default so the player + links still tint. */
+    --wp-admin-theme-color: #2271b1;
+    margin: 0;
+    padding: 14px;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+    background: #f0f0f1;
+    color: #1d2327;
+    font-size: 13px;
+}
+body.radio-popout .radio-popout-header { display: flex; justify-content: space-between; align-items: center; margin: 0 0 12px; }
+body.radio-popout .radio-popout-header h1 { margin: 0; font-size: 14px; font-weight: 600; color: #1d2327; }
+body.radio-popout .radio-popout-header h1::before { content: '📻 '; }
+body.radio-popout .radio-popout-close { background: none; border: 0; font-size: 18px; cursor: pointer; color: #646970; padding: 4px 8px; line-height: 1; border-radius: 3px; }
+body.radio-popout .radio-popout-close:hover { color: #b32d2e; background: rgba(179, 45, 46, 0.08); }
+body.radio-popout .radio-popout-wrap { background: #fff; border: 1px solid #c3c4c7; padding: 14px; border-radius: 3px; }
+body.radio-popout .radio-popout-wrap .radio-player__station-select select { max-width: 100%; }
+body.radio-popout .radio-popout-wrap .radio-player__volume { width: 100%; }
+body.radio-popout .radio-popout-wrap .radio-player__controls { flex-direction: column; align-items: stretch; gap: 10px; }
+
+/* Popup dark theme — keeps the popup readable when theme=dark */
+body.radio-popout.radio-theme-dark { background: #101213; color: #f0f0f1; }
+body.radio-popout.radio-theme-dark .radio-popout-header h1 { color: #f0f0f1; }
+body.radio-popout.radio-theme-dark .radio-popout-wrap { background: #1d2327; border-color: #3c434a; }
+body.radio-popout.radio-theme-dark .radio-popout-close { color: #a7aaad; }
+
 /* ──────────────────────────────────────────────────────────────────
 * History + Favourites page (v0.5.0)
 * ─────────────────────────────────────────────────────────────── */
@@ -14,48 +14,48 @@ if ( ! defined( 'ABSPATH' ) ) { exit; }

 function radio_render_about_page() {
    if ( ! current_user_can( 'read' ) ) {
-        wp_die( esc_html__( 'You do not have permission to view this page.', 'radio' ) );
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'a-radio' ) );
    }

    $count = count( radio_get_stations_flat() );
    ?>
    <div class="wrap radio-about-wrap">
-        <h1><?php esc_html_e( 'About Radio', 'radio' ); ?></h1>
+        <h1><?php esc_html_e( 'About Radio', 'a-radio' ); ?></h1>

        <!-- ── Top row: three short cards (What / Who / Credits) ── -->
        <div class="radio-about-grid">

            <div class="radio-about-card">
-                <h2><?php esc_html_e( 'What Radio does', 'radio' ); ?></h2>
+                <h2><?php esc_html_e( 'What Radio does', 'a-radio' ); ?></h2>
                <p>
                    <?php
                    printf(
                        /* translators: %d = station count */
-                        esc_html__( 'Adds a small, focused radio player to your WordPress dashboard. %d hand-curated SomaFM stations across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday and specials. Plays in your admin pages while you work. Your chosen station + volume persist per user.', 'radio' ),
+                        esc_html__( 'Adds a small, focused radio player to your WordPress dashboard. %d hand-curated SomaFM stations across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday and specials. Plays in your admin pages while you work. Your chosen station + volume persist per user.', 'a-radio' ),
                        (int) $count
                    );
                    ?>
                </p>
                <p>
-                    <?php esc_html_e( 'Audio plays directly in your browser via HTML5 — no server-side proxy, no extra services to host, no third-party tracking. Just an <audio> element pointed at SomaFM\'s public streams.', 'radio' ); ?>
+                    <?php esc_html_e( 'Audio plays directly in your browser via HTML5 — no server-side proxy, no extra services to host, no third-party tracking. Just an <audio> element pointed at SomaFM\'s public streams.', 'a-radio' ); ?>
                </p>
            </div>

            <div class="radio-about-card">
-                <h2><?php esc_html_e( 'Who Radio is for', 'radio' ); ?></h2>
+                <h2><?php esc_html_e( 'Who Radio is for', 'a-radio' ); ?></h2>
                <p>
-                    <?php esc_html_e( 'Anyone who likes background music while working in the WordPress admin. Coders, writers, support agents, content editors. The 44 SomaFM stations cover a wide enough range that there\'s something for any mood — from coding-focus ambient (Groove Salad, Drone Zone) to drive-time electronic (DEF CON Radio, Beat Blender) to mellow lounge (Lush, Secret Agent) to specifically-quirky picks (SF 10-33 mixes ambient with San Francisco public-safety radio).', 'radio' ); ?>
+                    <?php esc_html_e( 'Anyone who likes background music while working in the WordPress admin. Coders, writers, support agents, content editors. The 44 SomaFM stations cover a wide enough range that there\'s something for any mood — from coding-focus ambient (Groove Salad, Drone Zone) to drive-time electronic (DEF CON Radio, Beat Blender) to mellow lounge (Lush, Secret Agent) to specifically-quirky picks (SF 10-33 mixes ambient with San Francisco public-safety radio).', 'a-radio' ); ?>
                </p>
            </div>

            <div class="radio-about-card">
-                <h2><?php esc_html_e( 'Credits + thanks', 'radio' ); ?></h2>
+                <h2><?php esc_html_e( 'Credits + thanks', 'a-radio' ); ?></h2>
                <p>
                    <?php
                    printf(
                        wp_kses(
                            /* translators: %s = link to somafm.com */
-                            __( 'All stations and streams are provided by %s — an independent, listener-supported, commercial-free internet radio network broadcasting from San Francisco since 2000. Radio is just a small WordPress wrapper around their public streams. If you enjoy this plugin, please consider donating to SomaFM directly.', 'radio' ),
+                            __( 'All stations and streams are provided by %s — an independent, listener-supported, commercial-free internet radio network broadcasting from San Francisco since 2000. Radio is just a small WordPress wrapper around their public streams. If you enjoy this plugin, please consider donating to SomaFM directly.', 'a-radio' ),
                            array( 'a' => array( 'href' => true, 'target' => true, 'rel' => true ) )
                        ),
                        '<a href="https://somafm.com/support/" target="_blank" rel="noopener">SomaFM</a>'
@@ -63,39 +63,47 @@ function radio_render_about_page() {
                    ?>
                </p>
                <p>
-                    <?php esc_html_e( 'Plugin author: David Keane. Part of the RangerHQ plugin family. GPL v2 or later. Source on Gitea.', 'radio' ); ?>
+                    <?php esc_html_e( 'Plugin author: David Keane. Part of the RangerHQ plugin family. GPL v2 or later. Source on Gitea.', 'a-radio' ); ?>
                </p>
+                <?php if ( defined( 'RADIO_SUPPORT_URL' ) && RADIO_SUPPORT_URL ) : ?>
+                    <a class="radio-support-link" href="<?php echo esc_url( RADIO_SUPPORT_URL ); ?>" target="_blank" rel="noopener">
+                        <?php esc_html_e( 'Like Radio? If You fancy to buy me a coffee →', 'a-radio' ); ?>
+                    </a>
+                <?php endif; ?>
            </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>
+            <h2><?php esc_html_e( 'Version history', 'a-radio' ); ?></h2>

            <div class="radio-about-versions__latest">
-                <span class="ver">v0.6.1</span> &mdash; 30 May 2026 <span class="latest"><?php esc_html_e( 'latest', 'radio' ); ?></span>
+                <span class="ver">v0.7.0</span> &mdash; 30 May 2026 <span class="latest"><?php esc_html_e( 'latest', 'a-radio' ); ?></span>
                <p>
-                    <?php esc_html_e( 'About page restructure. Three short cards on top (What / Who / Credits) now balance the layout; Credits gets equal billing instead of being pushed off the bottom. Version history is its own full-width card below — only the latest release is 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' ); ?>
+                    <?php esc_html_e( 'WordPress.org submission prep — full Plugin Check Pro clean. Plugin name normalised to "RangerHQ Radio" (SomaFM stays in the description as the data source). Text Domain renamed to "a-radio" across all 134 i18n call sites. Translator comments added to every printf placeholder. All admin $_POST access now properly unslashed + sanitized at the access point. Requires-at-least bumped to 5.3 (matches wp_date usage). Pop-out window now uses wp_enqueue_* + wp_print_styles / wp_print_footer_scripts instead of raw <link> / <script> tags; popup-specific CSS moved into radio.css under body.radio-popout scope. Stray .DS_Store files removed. Proper wp.org-format readme.txt added.', 'a-radio' ); ?>
                </p>
            </div>

-            <h3><?php esc_html_e( 'Earlier releases', 'radio' ); ?></h3>
+            <h3><?php esc_html_e( 'Earlier releases', 'a-radio' ); ?></h3>
            <ul class="radio-about-versions__earlier">
-                <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>
+                <li><span class="ver">v0.6.3</span> <span class="ver-date">30 May 2026</span> &mdash; <?php esc_html_e( 'Discreet buy-me-a-coffee support link (Updates panel + Credits card)', 'a-radio' ); ?></li>
+                <li><span class="ver">v0.6.2</span> <span class="ver-date">30 May 2026</span> &mdash; <?php esc_html_e( 'Current version badge on the Settings page', 'a-radio' ); ?></li>
+                <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', 'a-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', 'a-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)', 'a-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', 'a-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 ▶ / ‖)', 'a-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', 'a-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', 'a-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', 'a-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', 'a-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' ); ?>
+                <?php esc_html_e( 'View the full CHANGELOG.md →', 'a-radio' ); ?>
            </a>
        </div>

@@ -12,7 +12,7 @@ if ( ! defined( 'ABSPATH' ) ) { exit; }

 function radio_render_main_page() {
    if ( ! current_user_can( 'read' ) ) {
-        wp_die( esc_html__( 'You do not have permission to view this page.', 'radio' ) );
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'a-radio' ) );
    }

    $state    = radio_get_state();
@@ -21,13 +21,13 @@ function radio_render_main_page() {
    $count    = count( radio_get_stations_flat() );
    ?>
    <div class="wrap radio-wrap">
-        <h1><?php esc_html_e( 'Radio', 'radio' ); ?></h1>
+        <h1><?php esc_html_e( 'Radio', 'a-radio' ); ?></h1>

        <p class="radio-intro">
            <?php
            printf(
                /* translators: %d = number of stations */
-                esc_html__( 'A tab of background music for your WordPress admin. %d hand-curated SomaFM stations across 10 genres — free, no ads, no tracking.', 'radio' ),
+                esc_html__( 'A tab of background music for your WordPress admin. %d hand-curated SomaFM stations across 10 genres — free, no ads, no tracking.', 'a-radio' ),
                (int) $count
            );
            ?>
@@ -35,7 +35,7 @@ function radio_render_main_page() {

        <div class="postbox">
            <div class="postbox-header">
-                <h2 class="hndle"><?php esc_html_e( 'Player', 'radio' ); ?></h2>
+                <h2 class="hndle"><?php esc_html_e( 'Player', 'a-radio' ); ?></h2>
            </div>
            <div class="inside">
                <div class="radio-player" data-radio-surface="main">
@@ -45,7 +45,7 @@ function radio_render_main_page() {
                            <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__label"><?php esc_html_e( 'Now Playing', 'a-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>
@@ -55,24 +55,24 @@ function radio_render_main_page() {
                    <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>
+                            <span data-radio-play-label><?php esc_html_e( 'Play', 'a-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 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', 'a-radio' ); ?>">
+                            <span aria-hidden="true">↗</span> <?php esc_html_e( 'Pop out', 'a-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' ); ?>">
+                            <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'a-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' ); ?>">
+                            <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', 'a-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-main"><?php esc_html_e( 'Station', 'radio' ); ?></label>
+                        <label for="radio-station-main"><?php esc_html_e( 'Station', 'a-radio' ); ?></label>
                        <select id="radio-station-main" data-radio-station>
                            <?php foreach ( $stations as $genre => $entries ) :
                                if ( empty( $entries ) ) { continue; }
@@ -100,7 +100,7 @@ function radio_render_main_page() {
            printf(
                wp_kses(
                    /* translators: %s = link to somafm.com */
-                    __( 'Stations and streams provided by %s — an independent, listener-supported, commercial-free internet radio network. Please consider supporting them.', 'radio' ),
+                    __( 'Stations and streams provided by %s — an independent, listener-supported, commercial-free internet radio network. Please consider supporting them.', 'a-radio' ),
                    array( 'a' => array( 'href' => true, 'target' => true, 'rel' => true ) )
                ),
                '<a href="https://somafm.com/" target="_blank" rel="noopener">SomaFM</a>'
@@ -21,7 +21,7 @@ function radio_register_dashboard_widget() {

    wp_add_dashboard_widget(
        'radio_dashboard_widget',
-        __( 'Radio', 'radio' ),
+        __( 'Radio', 'a-radio' ),
        'radio_render_dashboard_widget'
    );
 }
@@ -38,7 +38,7 @@ function radio_render_dashboard_widget() {
                <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__label"><?php esc_html_e( 'Now Playing', 'a-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>
@@ -48,24 +48,24 @@ function radio_render_dashboard_widget() {
        <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>
+                <span data-radio-play-label><?php esc_html_e( 'Play', 'a-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 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', 'a-radio' ); ?>">
+                <span aria-hidden="true">↗</span> <?php esc_html_e( 'Pop out', 'a-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' ); ?>">
+                <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'a-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' ); ?>">
+                <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', 'a-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-widget"><?php esc_html_e( 'Station', 'radio' ); ?></label>
+            <label for="radio-station-widget"><?php esc_html_e( 'Station', 'a-radio' ); ?></label>
            <select id="radio-station-widget" data-radio-station>
                <?php foreach ( $stations as $genre => $entries ) :
                    if ( empty( $entries ) ) { continue; }
@@ -90,7 +90,7 @@ function radio_render_dashboard_widget() {
            printf(
                wp_kses(
                    /* translators: %s = link to somafm.com */
-                    __( 'Powered by %s', 'radio' ),
+                    __( 'Powered by %s', 'a-radio' ),
                    array( 'a' => array( 'href' => true, 'target' => true, 'rel' => true ) )
                ),
                '<a href="https://somafm.com/" target="_blank" rel="noopener">SomaFM</a>'
@@ -133,7 +133,7 @@ function radio_search_urls( $artist, $title ) {
 /** 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' ) );
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'a-radio' ) );
    }

    $tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'history'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- tab-switch only, no state change
@@ -163,15 +163,15 @@ function radio_render_history_page() {
    $nonce    = wp_create_nonce( 'radio_history' );
    ?>
    <div class="wrap radio-history-wrap">
-        <h1><?php esc_html_e( 'Radio — Track history', 'radio' ); ?></h1>
+        <h1><?php esc_html_e( 'Radio — Track history', 'a-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' ); ?>
+                <?php esc_html_e( 'History', 'a-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' ); ?>
+                ★ <?php esc_html_e( 'Favourites', 'a-radio' ); ?>
                <span class="radio-tab-count">(<?php echo (int) count( $all_favourites ); ?>)</span>
            </a>
        </h2>
@@ -179,24 +179,24 @@ function radio_render_history_page() {
        <?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 esc_html_e( 'No favourites yet — star a track on the History tab to save it here.', 'a-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 esc_html_e( 'No tracks logged yet. Play some music in the Radio player — tracks will appear here as they play.', 'a-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' ); ?>" />
+                <input type="search" id="radio-history-search" placeholder="<?php esc_attr_e( 'Filter by artist or title…', 'a-radio' ); ?>" />
                <select id="radio-history-station">
-                    <option value=""><?php esc_html_e( 'All stations', 'radio' ); ?></option>
+                    <option value=""><?php esc_html_e( 'All stations', 'a-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' ); ?>
+                        🗑 <?php esc_html_e( 'Clear history', 'a-radio' ); ?>
                    </button>
                <?php endif; ?>
            </div>
@@ -204,11 +204,11 @@ function radio_render_history_page() {
            <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>
+                        <th class="when"><?php esc_html_e( 'When', 'a-radio' ); ?></th>
+                        <th class="station"><?php esc_html_e( 'Station', 'a-radio' ); ?></th>
+                        <th class="track"><?php esc_html_e( 'Artist — Title', 'a-radio' ); ?></th>
+                        <th class="search"><?php esc_html_e( 'Search', 'a-radio' ); ?></th>
+                        <th class="fav"><span class="screen-reader-text"><?php esc_html_e( 'Favourite', 'a-radio' ); ?></span>★</th>
                    </tr>
                </thead>
                <tbody>
@@ -220,7 +220,10 @@ function radio_render_history_page() {
                    ?>
                    <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 ) ); ?>
+                            <?php
+                                /* translators: %s = human-readable time difference, e.g. "2 minutes" */
+                                printf( esc_html__( '%s ago', 'a-radio' ), esc_html( $ago ) );
+                            ?>
                        </td>
                        <td class="station"><?php echo esc_html( $e['station'] ); ?></td>
                        <td class="track">
@@ -240,7 +243,7 @@ function radio_render_history_page() {
                                    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' ); ?>">
+                                    aria-label="<?php echo $is_fav ? esc_attr__( 'Remove from favourites', 'a-radio' ) : esc_attr__( 'Add to favourites', 'a-radio' ); ?>">
                                <?php echo $is_fav ? '★' : '☆'; ?>
                            </button>
                        </td>
@@ -11,7 +11,7 @@ if ( ! defined( 'ABSPATH' ) ) { exit; }

 function radio_render_settings_page() {
    if ( ! current_user_can( 'read' ) ) {
-        wp_die( esc_html__( 'You do not have permission to view this page.', 'radio' ) );
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'a-radio' ) );
    }

    // Handle form submission.
@@ -39,7 +39,7 @@ function radio_render_settings_page() {
        $state['hide_dashboard_widget'] = $hide_widget ? 1 : 0;
        update_user_meta( $user_id, RADIO_META_KEY, $state );

-        echo '<div class="notice notice-success is-dismissible"><p>' . esc_html__( 'Settings saved.', 'radio' ) . '</p></div>';
+        echo '<div class="notice notice-success is-dismissible"><p>' . esc_html__( 'Settings saved.', 'a-radio' ) . '</p></div>';
    }

    $state    = radio_get_state();
@@ -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', 'a-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' ); ?>
@@ -55,7 +58,7 @@ function radio_render_settings_page() {
            <table class="form-table" role="presentation">
                <tr>
                    <th scope="row">
-                        <label for="default_station"><?php esc_html_e( 'Default station', 'radio' ); ?></label>
+                        <label for="default_station"><?php esc_html_e( 'Default station', 'a-radio' ); ?></label>
                    </th>
                    <td>
                        <select id="default_station" name="default_station">
@@ -72,14 +75,14 @@ function radio_render_settings_page() {
                            <?php endforeach; ?>
                        </select>
                        <p class="description">
-                            <?php esc_html_e( 'The station that loads when you open Radio in a fresh tab.', 'radio' ); ?>
+                            <?php esc_html_e( 'The station that loads when you open Radio in a fresh tab.', 'a-radio' ); ?>
                        </p>
                    </td>
                </tr>

                <tr>
                    <th scope="row">
-                        <label for="default_volume"><?php esc_html_e( 'Default volume', 'radio' ); ?></label>
+                        <label for="default_volume"><?php esc_html_e( 'Default volume', 'a-radio' ); ?></label>
                    </th>
                    <td>
                        <input type="range" id="default_volume" name="default_volume" min="0" max="100" value="<?php echo esc_attr( (int) round( $state['volume'] * 100 ) ); ?>" aria-describedby="default_volume_label">
@@ -89,34 +92,34 @@ function radio_render_settings_page() {

                <tr>
                    <th scope="row">
-                        <label for="theme"><?php esc_html_e( 'Theme', 'radio' ); ?></label>
+                        <label for="theme"><?php esc_html_e( 'Theme', 'a-radio' ); ?></label>
                    </th>
                    <td>
                        <select id="theme" name="theme">
-                            <option value="auto"  <?php selected( $state['theme'], 'auto' ); ?>><?php esc_html_e( 'Auto (match WP admin colour scheme)', 'radio' ); ?></option>
-                            <option value="light" <?php selected( $state['theme'], 'light' ); ?>><?php esc_html_e( 'Light', 'radio' ); ?></option>
-                            <option value="dark"  <?php selected( $state['theme'], 'dark' ); ?>><?php esc_html_e( 'Dark', 'radio' ); ?></option>
+                            <option value="auto"  <?php selected( $state['theme'], 'auto' ); ?>><?php esc_html_e( 'Auto (match WP admin colour scheme)', 'a-radio' ); ?></option>
+                            <option value="light" <?php selected( $state['theme'], 'light' ); ?>><?php esc_html_e( 'Light', 'a-radio' ); ?></option>
+                            <option value="dark"  <?php selected( $state['theme'], 'dark' ); ?>><?php esc_html_e( 'Dark', 'a-radio' ); ?></option>
                        </select>
                    </td>
                </tr>

                <tr>
                    <th scope="row">
-                        <?php esc_html_e( 'Dashboard widget', 'radio' ); ?>
+                        <?php esc_html_e( 'Dashboard widget', 'a-radio' ); ?>
                    </th>
                    <td>
                        <label>
                            <input type="checkbox" name="hide_dashboard_widget" value="1" <?php checked( $hide_widget ); ?>>
-                            <?php esc_html_e( 'Hide the Radio widget from the WordPress Dashboard', 'radio' ); ?>
+                            <?php esc_html_e( 'Hide the Radio widget from the WordPress Dashboard', 'a-radio' ); ?>
                        </label>
                        <p class="description">
-                            <?php esc_html_e( 'When checked, Radio is only accessible from the dedicated admin page (WP Admin → Radio → My Radio).', 'radio' ); ?>
+                            <?php esc_html_e( 'When checked, Radio is only accessible from the dedicated admin page (WP Admin → Radio → My Radio).', 'a-radio' ); ?>
                        </p>
                    </td>
                </tr>
            </table>

-            <?php submit_button( __( 'Save Changes', 'radio' ), 'primary', 'radio_settings_submit' ); ?>
+            <?php submit_button( __( 'Save Changes', 'a-radio' ), 'primary', 'radio_settings_submit' ); ?>
        </form>

        <?php
@@ -112,9 +112,10 @@ function radio_update_status( $force_refresh = false ) {
    $latest  = radio_fetch_latest_release( $force_refresh );

    if ( ! $latest || empty( $latest['version'] ) ) {
-        $msg = __( 'No releases tagged on the Gitea repo yet.', 'radio' );
+        $msg = __( 'No releases tagged on the Gitea repo yet.', 'a-radio' );
        if ( $latest && ! empty( $latest['error_code'] ) && (int) $latest['error_code'] !== 404 ) {
-            $msg = sprintf( __( 'Could not reach Gitea (HTTP %d). Try again in a few minutes.', 'radio' ), (int) $latest['error_code'] );
+            /* translators: %d = HTTP status code returned by the Gitea API */
+            $msg = sprintf( __( 'Could not reach Gitea (HTTP %d). Try again in a few minutes.', 'a-radio' ), (int) $latest['error_code'] );
        }
        return array(
            'status'   => 'unknown',
@@ -133,7 +134,8 @@ function radio_update_status( $force_refresh = false ) {
            'download_url' => $latest['download_url'],
            'published_at' => $latest['published_at'],
            'body'         => $latest['body'],
-            'message'      => sprintf( __( 'A new version (v%1$s) is available — you are on v%2$s.', 'radio' ), $latest['version'], $current ),
+            /* translators: 1: latest version available; 2: version currently installed */
+            'message'      => sprintf( __( 'A new version (v%1$s) is available — you are on v%2$s.', 'a-radio' ), $latest['version'], $current ),
        );
    }

@@ -141,7 +143,8 @@ function radio_update_status( $force_refresh = false ) {
        'status'   => 'up-to-date',
        'current'  => $current,
        'latest'   => $latest['version'],
-        'message'  => sprintf( __( 'You are up to date (v%s).', 'radio' ), $current ),
+        /* translators: %s = current installed version */
+        'message'  => sprintf( __( 'You are up to date (v%s).', 'a-radio' ), $current ),
        'repo_url' => radio_gitea_repo_url(),
    );
 }
@@ -163,38 +166,45 @@ function radio_render_updates_panel() {
    $rel_url  = radio_gitea_releases_url();
    ?>
    <div class="radio-updates" style="max-width:720px; margin-top:24px; padding:18px 20px; background:#fff; border:1px solid #ccd0d4; border-radius:4px;">
-        <h2 style="margin-top:0;"><?php esc_html_e( 'Updates', 'radio' ); ?></h2>
+        <h2 style="margin-top:0;"><?php esc_html_e( 'Updates', 'a-radio' ); ?></h2>
        <p style="margin:0 0 12px;">
-            <?php esc_html_e( 'Radio is self-hosted on Gitea. Click Check now to ask the repo whether there is a newer release than the one you are running.', 'radio' ); ?>
+            <?php esc_html_e( 'Radio is self-hosted on Gitea. Click Check now to ask the repo whether there is a newer release than the one you are running.', 'a-radio' ); ?>
        </p>

        <p id="radio-update-status" style="margin:0 0 12px;">
-            <strong><?php esc_html_e( 'Status:', 'radio' ); ?></strong>
+            <strong><?php esc_html_e( 'Status:', 'a-radio' ); ?></strong>
            <span id="radio-update-status-text"><?php echo esc_html( $status['message'] ); ?></span>
            <?php if ( $status['status'] === 'available' && ! empty( $status['download_url'] ) ) : ?>
                <br>
                <a href="<?php echo esc_url( $status['download_url'] ); ?>" class="button button-primary" style="margin-top:8px;">
                    <?php
                    /* translators: %s is the latest version number, e.g. "0.2.0" */
-                    echo esc_html( sprintf( __( 'Download v%s (.zip)', 'radio' ), $status['latest'] ) );
+                    /* translators: %s = latest available version number, e.g. "0.7.0" */
+                    echo esc_html( sprintf( __( 'Download v%s (.zip)', 'a-radio' ), $status['latest'] ) );
                    ?>
                </a>
                <?php if ( ! empty( $status['html_url'] ) ) : ?>
-                    <a href="<?php echo esc_url( $status['html_url'] ); ?>" target="_blank" rel="noopener" style="margin-left:8px;"><?php esc_html_e( 'View release notes →', 'radio' ); ?></a>
+                    <a href="<?php echo esc_url( $status['html_url'] ); ?>" target="_blank" rel="noopener" style="margin-left:8px;"><?php esc_html_e( 'View release notes →', 'a-radio' ); ?></a>
                <?php endif; ?>
            <?php endif; ?>
        </p>

        <p style="margin:0 0 4px;">
            <button type="button" id="radio-check-updates-btn" class="button" data-nonce="<?php echo esc_attr( $nonce ); ?>">
-                ↻ <?php esc_html_e( 'Check now', 'radio' ); ?>
+                ↻ <?php esc_html_e( 'Check now', 'a-radio' ); ?>
            </button>
-            <a href="<?php echo esc_url( $repo_url ); ?>" target="_blank" rel="noopener" class="button" style="margin-left:6px;"><?php esc_html_e( 'View on Gitea', 'radio' ); ?></a>
-            <a href="<?php echo esc_url( $rel_url ); ?>"  target="_blank" rel="noopener" class="button" style="margin-left:6px;"><?php esc_html_e( 'View all releases', 'radio' ); ?></a>
+            <a href="<?php echo esc_url( $repo_url ); ?>" target="_blank" rel="noopener" class="button" style="margin-left:6px;"><?php esc_html_e( 'View on Gitea', 'a-radio' ); ?></a>
+            <a href="<?php echo esc_url( $rel_url ); ?>"  target="_blank" rel="noopener" class="button" style="margin-left:6px;"><?php esc_html_e( 'View all releases', 'a-radio' ); ?></a>
        </p>
        <p style="margin:10px 0 0; color:#646970; font-size:12px;">
-            <?php esc_html_e( 'Manual update path: download the .zip, deactivate the plugin in WordPress, upload via Plugins → Add New → Upload, reactivate. Your settings survive the upgrade (state is stored in user_meta).', 'radio' ); ?>
+            <?php esc_html_e( 'Manual update path: download the .zip, deactivate the plugin in WordPress, upload via Plugins → Add New → Upload, reactivate. Your settings survive the upgrade (state is stored in user_meta).', 'a-radio' ); ?>
        </p>
+
+        <?php if ( defined( 'RADIO_SUPPORT_URL' ) && RADIO_SUPPORT_URL ) : ?>
+            <a class="radio-support-link" href="<?php echo esc_url( RADIO_SUPPORT_URL ); ?>" target="_blank" rel="noopener">
+                <?php esc_html_e( 'Like Radio? If You fancy to buy me a coffee →', 'a-radio' ); ?>
+            </a>
+        <?php endif; ?>
    </div>

    <script>
@@ -1,31 +1,32 @@
 <?php
 /**
- * Radio — a free SomaFM player for your WordPress dashboard
+ * RangerHQ Radio — a small, focused internet radio player for your WP dashboard.
 *
- * Plugin Name: Radio
+ * Plugin Name: RangerHQ 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.6.1
- * Requires at least: 5.0
+ * Description: A small, focused internet radio player for your WordPress admin. 44 hand-curated stations from SomaFM across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday, specials. Plays via HTML5 audio; per-user station + volume + history + favourites; pop-out window for continuous background play.
+ * Version:     0.7.0
+ * Requires at least: 5.3
 * Requires PHP: 7.4
 * Author:      David Keane
 * Author URI:  https://rangersmyth.xyz/
 * License:     GPL v2 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
- * Text Domain: radio
+ * Text Domain: a-radio
 *
- * @package Radio
+ * @package RangerHQ_Radio
 */

 if ( ! defined( 'ABSPATH' ) ) { exit; }

 // Plugin coordinates.
-if ( ! defined( 'RADIO_VERSION' ) )   { define( 'RADIO_VERSION',   '0.6.1' ); }
-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__ ) ); }
-if ( ! defined( 'RADIO_BASENAME' ) )  { define( 'RADIO_BASENAME',  plugin_basename( __FILE__ ) ); }
-if ( ! defined( 'RADIO_GITEA_URL' ) ) { define( 'RADIO_GITEA_URL', 'https://git.davidtkeane.com/ranger/a-radio' ); }
+if ( ! defined( 'RADIO_VERSION' ) )     { define( 'RADIO_VERSION',     '0.7.0' ); }
+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__ ) ); }
+if ( ! defined( 'RADIO_BASENAME' ) )    { define( 'RADIO_BASENAME',    plugin_basename( __FILE__ ) ); }
+if ( ! defined( 'RADIO_GITEA_URL' ) )   { define( 'RADIO_GITEA_URL',   'https://git.davidtkeane.com/ranger/a-radio' ); }
+if ( ! defined( 'RADIO_SUPPORT_URL' ) ) { define( 'RADIO_SUPPORT_URL', 'https://buymeacoffee.com/davidtkeane' ); }

 // Includes — each file owns one concern.
 require_once RADIO_PATH . 'inc/stations.php';         // the 44-station array + genre helpers
@@ -45,8 +46,8 @@ require_once RADIO_PATH . 'inc/updater.php';          // self-hosted update chec
 add_action( 'admin_menu', 'radio_register_admin_menu' );
 function radio_register_admin_menu() {
    add_menu_page(
-        __( 'Radio', 'radio' ),
-        __( 'Radio', 'radio' ),
+        __( 'Radio', 'a-radio' ),
+        __( 'Radio', 'a-radio' ),
        'read',                       // any logged-in user with read access has their own radio
        'radio',
        'radio_render_main_page',
@@ -60,8 +61,8 @@ function radio_register_admin_menu() {
    // form gotcha).
    add_submenu_page(
        'radio',
-        __( 'My Radio', 'radio' ),
-        __( 'My Radio', 'radio' ),
+        __( 'My Radio', 'a-radio' ),
+        __( 'My Radio', 'a-radio' ),
        'read',
        'radio',
        ''
@@ -69,8 +70,8 @@ function radio_register_admin_menu() {

    add_submenu_page(
        'radio',
-        __( 'Settings', 'radio' ),
-        __( 'Settings', 'radio' ),
+        __( 'Settings', 'a-radio' ),
+        __( 'Settings', 'a-radio' ),
        'manage_options',
        'radio-settings',
        'radio_render_settings_page'
@@ -78,8 +79,8 @@ function radio_register_admin_menu() {

    add_submenu_page(
        'radio',
-        __( 'Track history', 'radio' ),
-        __( 'History', 'radio' ),
+        __( 'Track history', 'a-radio' ),
+        __( 'History', 'a-radio' ),
        'read',
        'radio-history',
        'radio_render_history_page'
@@ -87,8 +88,8 @@ function radio_register_admin_menu() {

    add_submenu_page(
        'radio',
-        __( 'About', 'radio' ),
-        __( 'About', 'radio' ),
+        __( 'About', 'a-radio' ),
+        __( 'About', 'a-radio' ),
        'read',
        'radio-about',
        'radio_render_about_page'
@@ -133,19 +134,19 @@ function radio_enqueue_admin_assets( $hook ) {
        'nonce'     => wp_create_nonce( 'radio_save_state' ),
        'popoutUrl' => admin_url( 'admin-post.php?action=radio_popout' ),
        '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' ),
-            'addFav'       => __( 'Add to favourites', 'radio' ),
-            'removeFav'    => __( 'Remove from favourites', 'radio' ),
-            'clearConfirm' => __( 'Clear all track history? (Favourites are kept.)', 'radio' ),
+            'play'         => __( 'Play', 'a-radio' ),
+            'pause'        => __( 'Pause', 'a-radio' ),
+            'loading'      => __( 'Loading…', 'a-radio' ),
+            'error'        => __( 'Stream error — try another station.', 'a-radio' ),
+            'saveError'    => __( 'Preferences not saved — check your connection.', 'a-radio' ),
+            'mute'         => __( 'Mute', 'a-radio' ),
+            'unmute'       => __( 'Unmute', 'a-radio' ),
+            'nowPlaying'   => __( 'Now Playing', 'a-radio' ),
+            'volume'       => __( 'Volume', 'a-radio' ),
+            'station'      => __( 'Station', 'a-radio' ),
+            'addFav'       => __( 'Add to favourites', 'a-radio' ),
+            'removeFav'    => __( 'Remove from favourites', 'a-radio' ),
+            'clearConfirm' => __( 'Clear all track history? (Favourites are kept.)', 'a-radio' ),
        ),
    ) );
 }
@@ -186,11 +187,13 @@ 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' );
+    // Unslash + sanitize at access; radio_sanitize_entry() also re-sanitizes
+    // downstream as belt+braces, but PCP wants the cleanup AT the access point.
    $logged = radio_log_track( array(
-        'artist'     => $_POST['artist']     ?? '',
-        'title'      => $_POST['title']      ?? '',
-        'station'    => $_POST['station']    ?? '',
-        'station_id' => $_POST['station_id'] ?? '',
+        'artist'     => isset( $_POST['artist'] )     ? sanitize_text_field( wp_unslash( $_POST['artist'] ) )     : '',
+        'title'      => isset( $_POST['title'] )      ? sanitize_text_field( wp_unslash( $_POST['title'] ) )      : '',
+        'station'    => isset( $_POST['station'] )    ? sanitize_text_field( wp_unslash( $_POST['station'] ) )    : '',
+        'station_id' => isset( $_POST['station_id'] ) ? sanitize_key( wp_unslash( $_POST['station_id'] ) )        : '',
    ) );
    wp_send_json_success( array( 'logged' => (bool) $logged ) );
 }
@@ -205,10 +208,10 @@ 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'] ?? '',
+        'artist'     => isset( $_POST['artist'] )     ? sanitize_text_field( wp_unslash( $_POST['artist'] ) )     : '',
+        'title'      => isset( $_POST['title'] )      ? sanitize_text_field( wp_unslash( $_POST['title'] ) )      : '',
+        'station'    => isset( $_POST['station'] )    ? sanitize_text_field( wp_unslash( $_POST['station'] ) )    : '',
+        'station_id' => isset( $_POST['station_id'] ) ? sanitize_key( wp_unslash( $_POST['station_id'] ) )        : '',
    ) );
    wp_send_json_success( array( 'favourite' => (bool) $new_state ) );
 }
@@ -232,7 +235,7 @@ function radio_ajax_clear_history() {
 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' ) );
+        wp_die( esc_html__( 'You do not have permission to view this page.', 'a-radio' ) );
    }

    $state    = radio_get_state();
@@ -249,51 +252,46 @@ function radio_render_popout_page() {
        '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' ),
+            'play'         => __( 'Play', 'a-radio' ),
+            'pause'        => __( 'Pause', 'a-radio' ),
+            'loading'      => __( 'Loading…', 'a-radio' ),
+            'error'        => __( 'Stream error — try another station.', 'a-radio' ),
+            'saveError'    => __( 'Preferences not saved — check your connection.', 'a-radio' ),
+            'mute'         => __( 'Mute', 'a-radio' ),
+            'unmute'       => __( 'Unmute', 'a-radio' ),
+            'nowPlaying'   => __( 'Now Playing', 'a-radio' ),
+            'volume'       => __( 'Volume', 'a-radio' ),
+            'station'      => __( 'Station', 'a-radio' ),
        ),
    );
+
+    /*
+     * v0.7.0: Enqueue popup assets via WP so we can emit them with
+     * wp_print_styles() / wp_print_footer_scripts() — passes PCP's
+     * NonEnqueuedStylesheet / NonEnqueuedScript checks (we used raw
+     * <link> / <script> tags before). dashicons is core-registered.
+     */
+    wp_enqueue_style( 'dashicons' );
+    wp_enqueue_style( 'radio-admin', RADIO_URL . 'assets/css/radio.css', array(), RADIO_VERSION );
+    wp_enqueue_script( 'radio-admin', RADIO_URL . 'assets/js/radio.js', array(), RADIO_VERSION, true );
+    wp_localize_script( 'radio-admin', 'RadioPlugin', $cfg );
    ?>
 <!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>
+    <title><?php
+        /* translators: %s = currently playing station name */
+        printf( esc_html__( 'Radio — %s', 'a-radio' ), esc_html( $station['name'] ) );
+    ?></title>
+    <?php wp_print_styles(); /* dashicons + radio.css; popup-specific overrides scoped under body.radio-popout in radio.css */ ?>
 </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>
+        <h1><?php esc_html_e( 'Radio', 'a-radio' ); ?></h1>
+        <button type="button" class="radio-popout-close" onclick="window.close()" title="<?php esc_attr_e( 'Close', 'a-radio' ); ?>">✕</button>
    </div>

    <div class="radio-popout-wrap">
@@ -304,7 +302,7 @@ function radio_render_popout_page() {
                    <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__label"><?php esc_html_e( 'Now Playing', 'a-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>
@@ -314,19 +312,19 @@ function radio_render_popout_page() {
            <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>
+                    <span data-radio-play-label><?php esc_html_e( 'Play', 'a-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' ); ?>">
+                    <button type="button" class="radio-player__mute" data-radio-mute aria-label="<?php esc_attr_e( 'Mute', 'a-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' ); ?>">
+                    <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', 'a-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>
+                <label for="radio-station-popout"><?php esc_html_e( 'Station', 'a-radio' ); ?></label>
                <select id="radio-station-popout" data-radio-station>
                    <?php foreach ( $stations as $genre => $entries ) :
                        if ( empty( $entries ) ) { continue; }
@@ -347,8 +345,7 @@ function radio_render_popout_page() {
        </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>
+    <?php wp_print_footer_scripts(); /* radio.js + the wp_localize_script-emitted window.RadioPlugin inline blob */ ?>
 </body>
 </html>
    <?php
@@ -0,0 +1,107 @@
+=== RangerHQ Radio ===
+Contributors: davidtkeane
+Donate link: https://buymeacoffee.com/davidtkeane
+Tags: radio, music, audio, internet radio, background music
+Requires at least: 5.3
+Tested up to: 6.7
+Stable tag: 0.7.0
+Requires PHP: 7.4
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+A small, focused internet radio player for your WordPress admin — 44 hand-curated stations, history, favourites, and a pop-out window.
+
+== Description ==
+
+**RangerHQ Radio** adds a tiny, focused internet radio player to your WordPress dashboard so you can have background music while you work in the admin — without leaving the page, opening Spotify, or installing a desktop client.
+
+= What you get =
+
+* **44 hand-curated stations from [SomaFM](https://somafm.com)** across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday and specials. From coding-focus ambient (Groove Salad, Drone Zone) to drive-time electronic (DEF CON Radio, Beat Blender) to mellow lounge (Lush, Secret Agent).
+* **Now-playing indicator** — small CSS dancing-bars equalizer that pulses while audio is playing. A Web Audio frequency visualizer kicks in automatically when the browser allows it (with a graceful fallback to the CSS bars).
+* **Track history + favourites** — every track that scrolls past is logged to your personal History page (capped at 500); a star toggle promotes the good ones to a separate Favourites tab that doesn't age out. Each row has four search links (Spotify, YouTube, Apple Music, Bandcamp) so you can find that track on whichever service you use.
+* **Pop-out mini-player** — a 380×560 standalone window that persists across the main tab's navigation, so background music doesn't cut when you move between Plugins, Posts, Users, etc.
+* **OS media keys** — F8/headphone buttons/lock-screen widget play and pause the radio (via MediaSession API).
+* **Mute toggle** — the speaker icon is clickable; remembers prior volume.
+* **Dark theme** — explicit dark option for the player surface (`Settings → Theme`).
+* **Per-user state** — your chosen station, volume, theme, history, and favourites all live in `user_meta`, so each WordPress user has their own setup.
+
+= Privacy + dependencies =
+
+* **No tracking, no telemetry, no third-party scripts on your admin pages.** Audio plays directly in your browser via HTML5 — just an `<audio>` element pointed at SomaFM's public streams.
+* **No data leaves your site.** History and favourites are stored in your own `wp_usermeta`. The four search links use deep-link search URLs on each provider's public site — no API keys, no third-party JS embedded.
+* **Stations courtesy of [SomaFM](https://somafm.com)** — an independent, listener-supported, commercial-free internet radio network broadcasting from San Francisco since 2000. RangerHQ Radio is a small wrapper around their public streams. If you enjoy the music, please consider [supporting SomaFM directly](https://somafm.com/support/).
+
+== Installation ==
+
+1. Upload the plugin folder to `/wp-content/plugins/` (or install from the WordPress plugin directory).
+2. Activate the plugin through the **Plugins** menu in WordPress.
+3. Open **Radio → My Radio** in the admin sidebar and press Play. Your station and volume choice are saved per user.
+
+There is no separate configuration step — defaults are sensible (Groove Salad at 60% volume). Settings are at **Radio → Settings**.
+
+== Frequently Asked Questions ==
+
+= Does this work on the front-end of my site? =
+
+No — RangerHQ Radio is admin-only. It adds a player to the WordPress dashboard for you (and your other authenticated admins) to use while working. It does not embed a radio player on the public-facing site.
+
+= Can I add my own stations? =
+
+Not via the admin yet. The station list is hard-coded in `inc/stations.php` (44 SomaFM stations). If you'd like to add custom stations or other internet radio sources, please open an issue on the [Gitea repo](https://git.davidtkeane.com/ranger/a-radio).
+
+= The pop-out window doesn't open. =
+
+Your browser may be blocking pop-ups. Click the address bar's pop-up icon to allow pop-ups for this site, then try again.
+
+= Why does Touch ID / a passkey prompt appear when I press Play? =
+
+It shouldn't. This plugin uses no biometrics or authentication of its own — that's a different plugin in the RangerHQ family.
+
+= The current-track display says nothing / is hidden. =
+
+SomaFM's track-info endpoint (`somafm.com/songs/{station}.json`) is fetched best-effort. If it's unreachable or the browser blocks the request, the track display silently hides. The player keeps working regardless.
+
+== Screenshots ==
+
+1. The main player page (Radio → My Radio) with the now-playing indicator dancing while audio is playing.
+2. The dashboard widget — same player, compact, sits alongside your usual dashboard widgets.
+3. Track History page with star-to-favourite and four search-provider links per row.
+4. Pop-out mini-player window — keeps playing while you navigate the rest of the admin.
+
+== Changelog ==
+
+= 0.7.0 =
+* WordPress.org submission prep — full PCP-clean. Plugin name normalised to **RangerHQ Radio** (SomaFM stays in the description as the data source). Text Domain renamed `radio` → `a-radio` everywhere (134 i18n call sites updated). Six `printf` / `sprintf` calls now carry translator comments. All admin `$_POST` access now `wp_unslash()` + `sanitize_*` at the access point. `Requires at least` bumped to 5.3 (matches `wp_date()` usage). Pop-out window now uses `wp_enqueue_*` + `wp_print_styles()` / `wp_print_footer_scripts()` instead of raw `<link>` / `<script>` tags; popup-specific CSS moved into `radio.css` under `body.radio-popout` scope. `.DS_Store` files removed. Proper `readme.txt`.
+
+= 0.6.3 =
+* Discreet "buy me a coffee" support link in the Updates panel and the About-page Credits card. Single `RADIO_SUPPORT_URL` constant; conditional render — silently hidden if the constant is empty.
+
+= 0.6.2 =
+* Current version badge on the Settings page — small grey pill follows the H1 reading `v{RADIO_VERSION}`.
+
+= 0.6.1 =
+* About page restructure — 3-card top row (What / Who / Credits) + full-width Version history with the latest expanded and earlier releases as one-liners.
+
+= 0.6.0 =
+* Pop-out mini-player. `↗ Pop out` button beside Play opens a 380×560 standalone window that persists across the main tab's navigation, so background music keeps playing while you click around Plugins / Posts / Users.
+
+= 0.5.0 =
+* Track history + favourites. Every track that scrolls past is logged to a per-user `Radio → History` page (capped at 500). Star toggle promotes tracks to a separate Favourites tab. Four search-provider links per row (Spotify, YouTube, Apple Music, Bandcamp).
+
+= 0.4.0 =
+* Now-playing visual indicator. CSS dancing-bars equalizer that pulses while audio is playing. Web Audio frequency visualizer kicks in when the browser allows it (with graceful fallback).
+
+= 0.3.0 =
+* Dark theme, mute toggle on the speaker icon, MediaSession API (OS media keys), SomaFM current-track polling under the station description.
+
+= 0.2.0 =
+* UI rebuilt to WordPress admin standards — postbox container, native play/pause button with text label, picks up the user's admin colour scheme via `var(--wp-admin-theme-color)`.
+
+= 0.1.0 =
+* First release — 44 SomaFM stations across 10 genres, dashboard widget + dedicated admin page, per-user state, self-hosted Gitea updater.
+
+== Upgrade Notice ==
+
+= 0.7.0 =
+WordPress.org submission prep. Plugin name now "RangerHQ Radio". Text Domain renamed `radio` → `a-radio`. No user-visible behaviour changes; settings, history, and favourites all survive the upgrade.