﻿=== European School Radio Widget Block ===
Contributors: europeanschoolradio, georgepapas
Tags: Web, Radio, Podcasts, Shows, Player
Author: George Papadopoulos
E-mail: gpapas@europeanschoolradio.eu
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 3.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Gutenberg Block widget for listening to the European School Radio live stream with modern style variants and real-time metadata.

== Description ==

The European School Radio Widget Block allows you to integrate the live radio player directly into your WordPress pages, posts, or Block Widget areas (Site Editor) using modern Gutenberg blocks.

### Key Features:
* **Gutenberg Block Native:** Modern Block API v3 integration with live editor preview.
* **Style Variants:**
  * **Variant A (Standard Card):** Rich media card with artwork, volume controls, animated soundwaves, live indicator, and "Next On" schedule preview.
  * **Variant B (Mini Pill):** Compact, modern pill design ideal for sidebars, footers, or headers.
* **Streaming Quality Selection:** Choose between Low Quality (64Kbps), Medium Quality (128Kbps), and High Quality (320Kbps).
* **Metadata & Customization:** Toggle options for "Now Playing" track info and "Next On" upcoming program schedule.


== Installation ==

1. Upload the `european-school-radio-widget` folder to the `/wp-content/plugins/` directory, or install it directly via the WordPress Plugins menu.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Open any Page, Post, or Site Editor and insert the block **European School Radio Widget Block**.
4. Customize your settings via the Block Inspector (Style Variant, Streaming Quality, Now Playing, Next On).


== Frequently Asked Questions ==

= Is there any configuration required after activation? =

No initial setup is required. Default options (Mini Pill variant and High Quality stream) work out of the box.

= Is it multisite compatible? =

Yes, it fully supports WordPress Multisite installations.

= Does it create or modify database tables? =

No, the plugin does not create any additional database tables.

= Does it support classic widgets? =

Version 3.0.0+ transitions the plugin into a native Gutenberg Block. If you are upgrading from legacy widget versions, please test your layout after updating.


== Screenshots ==

1. Block settings in the Gutenberg Editor Inspector Controls.
2. Variant A (Standard Card) frontend player preview.
3. Variant B (Mini Pill) frontend player preview.


== Services ==

This WordPress Plugin streams live audio from the European School Radio platform via an embedded player widget.

* **Live Player Stream:** [https://europeanschoolradio.eu/player](https://europeanschoolradio.eu/player)
* **Terms of Service & GDPR:** [https://community.europeanschoolradio.eu/gdpr](https://community.europeanschoolradio.eu/gdpr)


== Upgrade Notice ==

= 3.0.0 =
Major update: Replaced legacy PHP widgets with a modern Gutenberg Block (API v3). Supports Style Variants (Standard Card & Mini Pill), customizable Audio Quality, and Block Inspector Controls.


== Changelog ==

= 3.0.0 =
* Complete refactor to Gutenberg Block architecture (Block API v3).
* Added Style Variants: Variant A (Standard Card) & Variant B (Mini Pill).
* Added Streaming Quality settings (64Kbps, 128Kbps, 320Kbps).
* Added live soundwave animation and real-time metadata display controls.
* Updated WP compatibility up to 7.1.