Files

T

ranger 340cbb2487 v0.7.5 — WordPress.org slug rename: a-radio → rangerhq-radio

A third-party AI-driven naming check flagged `a-radio` as too
generic for the wp.org Plugin Directory (single common functional
word, no distinguishing prefix). The verdict was advisory but
defensible — short generic slugs are increasingly rejected as the
directory grows past 60K plugins. Fixing it preemptively is cheaper
than facing a rejection at submission time.

The new slug `rangerhq-radio` matches the public display name
"RangerHQ Radio" (unchanged) and lines up with the rest of the
RangerHQ plugin family: `rangerhq-spatial`, `rangerhq-glyph`,
now `rangerhq-radio`.

Changes (packaging only — no player behaviour change):
* Text Domain `a-radio` → `rangerhq-radio` across all 125 i18n
  call sites via in-place sed (esc_html__, _e, __, esc_attr_e
  and their friends). PHP lint clean post-rename.
* `Text Domain:` plugin header in radio.php line 15 → `rangerhq-radio`.
* `RADIO_GITEA_URL` constant value → new Gitea repo URL.
* README.md install link → new repo URL.
* readme.txt FAQ Gitea link → new repo URL.
* readme.txt Stable tag → 0.7.5.
* inc/about.php — v0.7.5 in "latest" slot; v0.7.4 demoted.

Unchanged deliberately (would have been pure churn):
* Plugin Name header "RangerHQ Radio" — already correct.
* Plugin URI.
* Internal constants `RADIO_*` — don't have to match slug.
* User-meta keys `radio_state` / `radio_history` /
  `radio_favourites` — renaming would orphan every existing
  user's settings on upgrade.
* HTML `data-radio-*` attributes — JS controller's element
  selectors in radio.js, not slug-related.
* CSS class names `radio-player`, `radio-about-*` — internal
  scoping.
* Main plugin file name `radio.php`.

Migration: existing Gitea-installed copies need their folder
renamed on disk (a-radio → rangerhq-radio) + reactivation in
WP admin. No data loss because all user-facing state lives in
user_meta under unchanged keys.

This commit is the file content for v0.7.5; the annotated tag
and push will follow the Gitea repo rename (ranger/a-radio →
ranger/rangerhq-radio) so the new tag lives in the new URL
space from the start.

2026-05-30 04:55:39 +01:00

1.5 KiB

Raw Permalink Blame History

Radio — SomaFM player for your WordPress dashboard

A small, focused, free WordPress plugin that drops a SomaFM radio player into your admin dashboard. 44 hand-curated stations across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday, and specials.

What it does

Mini-player on WP Admin → Dashboard (opt-out via Settings)
Dedicated page at WP Admin → Radio → My Radio
Plays via HTML5 <audio> — no proxy server, no third-party tracking
Per-user state: each admin remembers their own station + volume
Updates via WordPress.org (the canonical channel once published)

Installation

Download the latest release .zip from git.davidtkeane.com/ranger/rangerhq-radio/releases
WP Admin → Plugins → Add New → Upload Plugin
Activate
Look at WP Admin → Dashboard for the mini-player, or WP Admin → Radio

Requirements

WordPress 5.0+
PHP 7.4+
A modern browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)

Credits

All stations and streams are provided by SomaFM, an independent, listener-supported, commercial-free internet radio network broadcasting from San Francisco since 2000. If you enjoy this plugin, please consider donating to SomaFM directly.

License

GPL v2 or later. See LICENSE (the same GPL v2+ terms as WordPress itself).

Author

David Keane — part of the RangerHQ plugin family. rangersmyth.xyz

1.5 KiB Raw Permalink Blame History