=== iRadeo Audio Player ===
Contributors: cakkineni
Tags: audio player, radio player, sermon player, playlist, podcast
Requires at least: 4.7
Tested up to: 6.9
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a hosted WordPress audio player, sermon player, radio player, playlist, and AI voice station with one shortcode.

== Description ==

**iRadeo Audio Player** puts a hosted website audio player on any WordPress page or post in minutes. Use it as a WordPress sermon player, radio player, podcast player, playlist player, school announcement player, or any site audio player that should keep visitors on your own website.

Unlike a basic file player, iRadeo hosts the audio, serves the embeddable player, keeps your playlist online, and lets paid plans add AI voice tracks for station IDs, sponsor reads, church reminders, school updates, show intros, and announcements.

**Works with:** Gutenberg, Classic Editor, Elementor, Divi, Beaver Builder, and any page builder that supports shortcodes.

**Quick setup:**
 1. [Create your iRadeo station](https://www.iradeo.com/audio-hosting-embed?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=wp_install_setup) — no coding needed
 2. Copy your station ID from your iRadeo dashboard
 3. Open **Settings > iRadeo Player** and save the station ID
 4. Paste this on any page: `[iradeo]`

**Shortcode options:**

 * `id` — Your iRadeo station ID *(optional if saved in Settings)*
 * `compact` — Set to `true` for a compact 150px player *(default: false)*
 * `height` — Custom height in pixels *(default: 280)*
 * `width` — Custom width *(default: 100%)*

**Examples:**

Standard player:
`[iradeo]`

Specific station:
`[iradeo id="12345"]`

Compact player:
`[iradeo compact="true"]`

Custom size:
`[iradeo id="12345" height="200" width="80%"]`

Also includes:

 * A **Gutenberg block** — search for "iRadeo" in the block inserter
 * A setup screen under **Settings > iRadeo Player**
 * A default station ID so editors can use `[iradeo]` without remembering numbers

== Screenshots ==

1. A hosted iRadeo playlist embedded directly inside a website page, keeping listeners on the site instead of sending them to another platform.

== Installation ==

1. Upload the `iradeo-player` folder to `/wp-content/plugins/`
2. Activate the plugin in *Plugins > Installed Plugins*
3. Go to *Settings > iRadeo Player*
4. Create an iRadeo station or paste your existing station ID
5. Add `[iradeo]` to any page or post

Or install directly from the WordPress plugin directory: search for **iRadeo Audio Player**.

== Frequently Asked Questions ==

= Where do I find my station ID? =

After [signing up for a free trial](https://www.iradeo.com/pricing), your station ID appears in your iRadeo dashboard next to each player. Paste it into the shortcode and you're done.

= Do I need a paid account? =

A free trial works. [Start yours here](https://www.iradeo.com/audio-hosting-embed?utm_source=wordpress_plugin&utm_medium=readme_faq&utm_campaign=wp_install_setup) — the plugin is free to install and takes a few minutes to set up.

= Does it work with page builders? =

Yes — Elementor, Divi, Beaver Builder, and any builder that supports shortcodes or HTML blocks.

= Can I use this for church sermons or school audio? =

Yes. Upload sermons, lessons, announcements, playlists, or recorded programs in iRadeo, then embed the player on your WordPress site. Premium and Ultimate plans also include AI voice generation for announcements, intros, sponsor reads, and station IDs.

== External Services ==

This plugin connects to **iRadeo** (https://www.iradeo.com), a third-party audio hosting and streaming service operated by iRadeo.

**What it does:** When a page containing the iRadeo shortcode or block is loaded, the plugin embeds an iframe that loads the iRadeo audio player from `https://www.iradeo.com/station/player/`.

**What data is sent:** The station ID you provide in the shortcode or block is included in the iframe URL. No visitor personal data (IP address, cookies, user account data) is sent by this plugin — any such data handling is governed by iRadeo's own privacy policy.

**When it is sent:** Every time a page or post containing the iRadeo player is rendered and viewed in a browser.

**Service links:**

* Service: https://www.iradeo.com
* Terms of Use: https://www.iradeo.com/terms
* Privacy Policy: https://www.iradeo.com/privacy

== Changelog ==

= 1.2.1 =
* Improved WordPress.org search positioning for sermon player, radio player, playlist player, and hosted website audio use cases
* Clarified that iRadeo keeps listeners on the WordPress site while hosting audio and playlists externally
* Added WordPress.org screenshot support so installers can see the embedded website-player use case before setup

= 1.2.0 =
* Added Settings > iRadeo Player setup screen
* Added default station ID option so `[iradeo]` works without repeating an ID
* Added tracked setup links for users who install before creating an iRadeo station
* Added admin-facing empty-state guidance when a shortcode is missing a station ID
* Added UTM tracking to embedded player URLs generated by the plugin

= 1.1.0 =
* Added AI voice positioning and tracking to the plugin onboarding path

= 1.0.1 =
* Improved setup notice: clearer CTA directing new users to free trial signup instead of dashboard
* Better onboarding flow for users without an iRadeo account
* Updated FAQ with direct signup links

= 1.0.0 =
* Initial release
