rangerhq-radio

ranger/rangerhq-radio

Fork 0

Commit Graph

Author	SHA1	Message	Date
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
ranger	de93aa50ca	v0.7.4 — wp.org submission cleanup: remove updater + add LICENSE Walks back v0.7.3's Update URI guard pattern. Plugin Check raised `plugin_updater_detected` on the v0.7.3 build: "Including An Update Checker / Changing Updates functionality. Plugin Updater detected. Use of the Update URI header is not allowed in plugins hosted on WordPress.org." PCP scans the source as-shipped, not as-distributed, so the v0.7.3 build-time `sed` strip never had a chance to run before the scan. The simpler correct answer is to delete the custom updater entirely and rely on wp.org as the canonical update channel once accepted. Removed: * `inc/updater.php` — recoverable from git history at tag v0.7.3 if ever needed for a non-wp.org distribution. * `Update URI:` header line in `radio.php` (plus the NOTE block). * `require_once RADIO_PATH . 'inc/updater.php';` in `radio.php`. * Updates panel render + `function_exists()` guard in `inc/settings.php`. * "Self-hosted update checker" line in `README.md`. * "Self-hosted updater" bullet in `readme.txt` Privacy section. Added (GPL declaration loop closed): * `LICENSE` — verbatim canonical GPL v2 text (338 lines from gnu.org/licenses/gpl-2.0.txt). * GPL header block in `assets/css/radio.css`. * GPL header block in `assets/js/radio.js` (original module overview preserved verbatim below the license header). * GPL header block in `radio.php` docblock alongside the existing `License:` / `License URI:` fields. Migration: existing Gitea-installed copies of v0.7.3 or earlier become orphaned of auto-updates after this lands on them (the updater code is gone, so nothing advertises newer versions back). Recommended path is to uninstall + reinstall from wp.org once the plugin is accepted. No data loss — station + volume + theme + history + favourites all live in user_meta. No user-visible behaviour changes for the player itself. Only the small `Updates` panel that sat at the bottom of Radio → Settings is gone.	2026-05-30 04:43:16 +01:00
ranger	a22ddfb6d3	chore: initial commit — Radio v0.1.0 (Phase A complete) First release of a-radio — a free, focused SomaFM player for the WordPress admin. Extracted-and-rebuilt from RangerPlex's RadioPlayer component, simplified along the way (no Node CORS proxy needed; the browser plays SomaFM streams directly). Phase A deliverables — all in this commit: PLAYER SURFACES - Dashboard widget on WP Admin → Dashboard (compact: play/pause + station select + volume). - Dedicated admin page at WP Admin → Radio → My Radio (larger layout, station genre badge, volume %% display). - Both surfaces share the same JS — picking a station on one mirrors to the other within the same admin session. STATIONS - 44 SomaFM stations grouped by 10 genres (Ambient / Electronic / Lounge / Rock / Metal / Jazz / World / Reggae / Holiday / Specials). - Ported verbatim from RangerPlex's RadioPlayer.tsx. - Default station: Groove Salad (most popular SomaFM channel, safe ambient/coding pick). STATE - Per-user state stored in user_meta under key `radio_state`: { station_id, volume, theme, last_played_at }. - Settings page lets the user pick default station, default volume, theme (auto/light/dark), and hide the dashboard widget. - AJAX endpoint `radio_save_state` persists changes without a page reload. Nonce-protected, capability-checked, only known keys accepted, station validated against the list, volume clamped to [0,1]. UPDATES - Self-hosted updater wired to Gitea (ranger/a-radio) from commit 1. - Direct port of Buddy's inc/updater.php with BUDDY_* → RADIO_* and buddy_* → radio_* renames. Same 12h-success / 1h-error caching. ARCHITECTURE - No `wp` prefix (trademark policy). - GPL v2+ public Gitea repo from day one. - Vanilla JS only — no React, no webpack, no minified-only files. - CSS-only animations, all assets local. - Single H1 per admin page. - Direct HTML5 <audio> playback (SomaFM has CORS headers; no PHP audio proxy needed). This is the key simplification vs RangerPlex. COMPLIANCE - "Powered by SomaFM" credit displayed on both player surfaces with link to somafm.com. About page invites users to donate to SomaFM directly. PHASE PROGRESSION (not in this commit) - Phase B — Settings polish + retry on transient stream errors + README.md formatted for WP.org submission. - Phase C — Now-playing metadata via SomaFM's per-station song history endpoint (this is where the RangerPlex proxy logic ports to — server-side, for metadata not audio). - Phase D — [ranger_radio] shortcode for frontend embedding. - Phase E — Favorites system. - Phase F — Multi-provider (Radio Paradise / NTS / KEXP / BBC). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-26 09:40:23 +01:00

Author

SHA1

Message

Date

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

ranger

de93aa50ca

v0.7.4 — wp.org submission cleanup: remove updater + add LICENSE

Walks back v0.7.3's Update URI guard pattern. Plugin Check raised
`plugin_updater_detected` on the v0.7.3 build:

    "Including An Update Checker / Changing Updates functionality.
     Plugin Updater detected. Use of the Update URI header is not
     allowed in plugins hosted on WordPress.org."

PCP scans the source as-shipped, not as-distributed, so the v0.7.3
build-time `sed` strip never had a chance to run before the scan.
The simpler correct answer is to delete the custom updater entirely
and rely on wp.org as the canonical update channel once accepted.

Removed:
* `inc/updater.php` — recoverable from git history at tag v0.7.3 if
  ever needed for a non-wp.org distribution.
* `Update URI:` header line in `radio.php` (plus the NOTE block).
* `require_once RADIO_PATH . 'inc/updater.php';` in `radio.php`.
* Updates panel render + `function_exists()` guard in `inc/settings.php`.
* "Self-hosted update checker" line in `README.md`.
* "Self-hosted updater" bullet in `readme.txt` Privacy section.

Added (GPL declaration loop closed):
* `LICENSE` — verbatim canonical GPL v2 text (338 lines from
  gnu.org/licenses/gpl-2.0.txt).
* GPL header block in `assets/css/radio.css`.
* GPL header block in `assets/js/radio.js` (original module overview
  preserved verbatim below the license header).
* GPL header block in `radio.php` docblock alongside the existing
  `License:` / `License URI:` fields.

Migration: existing Gitea-installed copies of v0.7.3 or earlier
become orphaned of auto-updates after this lands on them (the
updater code is gone, so nothing advertises newer versions back).
Recommended path is to uninstall + reinstall from wp.org once the
plugin is accepted. No data loss — station + volume + theme +
history + favourites all live in user_meta.

No user-visible behaviour changes for the player itself. Only the
small `Updates` panel that sat at the bottom of Radio → Settings
is gone.

2026-05-30 04:43:16 +01:00

ranger

a22ddfb6d3

chore: initial commit — Radio v0.1.0 (Phase A complete)

First release of a-radio — a free, focused SomaFM player for the
WordPress admin. Extracted-and-rebuilt from RangerPlex's RadioPlayer
component, simplified along the way (no Node CORS proxy needed; the
browser plays SomaFM streams directly).

Phase A deliverables — all in this commit:

PLAYER SURFACES
- Dashboard widget on WP Admin → Dashboard (compact: play/pause +
  station select + volume).
- Dedicated admin page at WP Admin → Radio → My Radio (larger
  layout, station genre badge, volume %% display).
- Both surfaces share the same JS — picking a station on one mirrors
  to the other within the same admin session.

STATIONS
- 44 SomaFM stations grouped by 10 genres (Ambient / Electronic /
  Lounge / Rock / Metal / Jazz / World / Reggae / Holiday / Specials).
- Ported verbatim from RangerPlex's RadioPlayer.tsx.
- Default station: Groove Salad (most popular SomaFM channel, safe
  ambient/coding pick).

STATE
- Per-user state stored in user_meta under key `radio_state`:
  { station_id, volume, theme, last_played_at }.
- Settings page lets the user pick default station, default volume,
  theme (auto/light/dark), and hide the dashboard widget.
- AJAX endpoint `radio_save_state` persists changes without a page
  reload. Nonce-protected, capability-checked, only known keys
  accepted, station validated against the list, volume clamped to
  [0,1].

UPDATES
- Self-hosted updater wired to Gitea (ranger/a-radio) from commit 1.
- Direct port of Buddy's inc/updater.php with BUDDY_* → RADIO_* and
  buddy_* → radio_* renames. Same 12h-success / 1h-error caching.

ARCHITECTURE
- No `wp` prefix (trademark policy).
- GPL v2+ public Gitea repo from day one.
- Vanilla JS only — no React, no webpack, no minified-only files.
- CSS-only animations, all assets local.
- Single H1 per admin page.
- Direct HTML5 <audio> playback (SomaFM has CORS headers; no PHP
  audio proxy needed). This is the key simplification vs RangerPlex.

COMPLIANCE
- "Powered by SomaFM" credit displayed on both player surfaces with
  link to somafm.com. About page invites users to donate to SomaFM
  directly.

PHASE PROGRESSION (not in this commit)
- Phase B — Settings polish + retry on transient stream errors +
  README.md formatted for WP.org submission.
- Phase C — Now-playing metadata via SomaFM's per-station song
  history endpoint (this is where the RangerPlex proxy logic ports
  to — server-side, for metadata not audio).
- Phase D — [ranger_radio] shortcode for frontend embedding.
- Phase E — Favorites system.
- Phase F — Multi-provider (Radio Paradise / NTS / KEXP / BBC).

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

2026-05-26 09:40:23 +01:00

3 Commits