WP Manifestindependent plugin directory
manifest / media / bottom-radioplayer-wordpress

Bottom Radio Player

WordPress plugin for Bottom Radio Player: bottom-bar radio player with seamless navigation, configured entirely from a wp-admin settings page. Not on wordpress.org - manual install.

by Jailson · github.com/jailsonsb2/bottom-radioplayer-wordpress · website

★ 0stars
1forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/jailsonsb2/bottom-radioplayer-wordpress/archive/refs/heads/main.zip

Readme

🎵 Bottom Radio Player — WordPress Plugin

WordPress plugin wrapper for bottom_radioplayer — a bottom-bar HTML5 radio player whose signature feature is seamless navigation: internal link clicks swap only the page content, so the audio never stops while visitors browse the site.

This plugin adds a proper wp-admin settings page on top of the core component — configure stations, behavior and appearance entirely from the browser, no file editing required.

This plugin is not published on wordpress.org. Install it manually from this repository (see below).

Screenshot

Bottom Radio Player running on WordPress, with Clip Mode open

Features

  • Settings page (General / Stations / Appearance tabs) under a "Radio Player" admin menu.
  • Stations repeater — add/remove stations, images picked via the native WordPress media library.
  • Automatically skips /wp-admin/ — the player is never loaded on admin screens.
  • Seamless navigation — internal link clicks swap page content via AJAX, audio keeps playing. Also auto-excludes /wp-admin/ and wp-login.php links from interception.
  • Clip Mode — when the now-playing API returns a YouTube video ID for the current song, a "Clipe" button appears automatically and opens a floating video mini-player synced to the song's position. No configuration needed.
  • Custom CSS field to override the player's appearance.
  • Clean uninstall (removes its own options, nothing else).

Installation

  1. Download bottom-radioplayer.zip from this repository (or clone the repo — the zip is already built at the root, ready to upload).
  2. In your WordPress admin: Plugins → Add New → Upload Plugin, choose the zip, Install Now, then Activate.
    • Alternative: extract the folder directly into wp-content/plugins/ via FTP/file manager.
  3. Go to the new Radio Player menu in wp-admin and fill in the General, Stations and Appearance tabs — Save.
  4. The player appears automatically on the front-end of every page.

⚠️ The player will not appear until you configure at least one station (name + stream URL, on the Stations tab) and save. With no stations set, there's nothing to play, so the plugin doesn't load anything on the front-end — the settings page shows a reminder about this until you do.

Updating: repeat steps 1–2 with a newer bottom-radioplayer.zip. Settings are stored in the WordPress database and survive the update.

Customizing the appearance (Custom CSS)

The Appearance tab has a raw CSS textarea, printed on every front-end page inside a `

Read the full README on GitHub →