=== FWD Plasmic Audio Player ===
Contributors: futurewebdesign
Donate link: https://fwdapps.net/p/pap/
Tags: audio player, mp3 player, shoutcast, icecast, visualizer
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Powerful and extremely customizable 3D audio player with an organic sphere visualizer, playlist support, and Shoutcast/Icecast playback.

== Description ==
FWD Plasmic Audio Player is a next‑gen audio player powered by Three.js and WebGL shaders. It renders a real‑time organic sphere visualizer, supports playlists and likes, and plays .mp3 files plus Shoutcast and Icecast streams. It is fully responsive and optimized for mobile and desktop.

== Links ==
- [Homepage](https://fwdapps.net/p/pap/)
- [Demos](https://fwdapps.net/p/pap/#demos)
- [Features](https://fwdapps.net/p/pap/#features)
- [JavaScript Documentation](https://fwdapps.net/p/pap/javascript-documentation.html)
- [WordPress Documentation](https://fwdapps.net/p/pap/wordpress-documentation.html)
- [Support](https://fwdapps.net/contact)

== Highlights ==
**Three.js + WebGL Visualizer** – Real‑time organic sphere visualizer driven by shaders and audio data.

**Responsive Layout** – Fully responsive and adaptable to any device and orientation.

**Playlist & Controls** – Optional playlist with artwork, artist/title, like button, share window and playback controls.

**Shoutcast & Icecast** – Radio stream support with automatic track metadata/artwork when available.

**Highly Customizable** – Control colors, sizes, scrubbing, playback rate, visibility and behavior for nearly every UI element.

== Main Features ==
- **Desktop & Mobile Optimized** – iOS, Android, and desktop browsers supported.
- **Lazy Scrolling/Loading** – Initialize only when the player becomes visible on the page.
- **Two‑Way Controls** – Normal or compact controls, with customizable compact width.
- **Vector Skin** – Sharp on any display.
- **Customizable Size** – Set any width/height and place it anywhere on the page.
- **Organic Sphere Visualizer** – Fully customizable shader‑based sphere with two dynamic lights.
- **Particles (Optional)** – Particle field that reacts to bass/mids/treble.
- **Audio Formats** – Single .mp3 format across browsers, plus Shoutcast & Icecast streams.
- **External Sources & Cloud Storage** – Play from any public URL (S3, Google Drive, Dropbox, etc.).
- **Playlist** – Artwork, artist/title, like button, and mini visualizer per track.
- **Like Button** – Available in playlist and/or controls.
- **Share Window** – Nine platforms with configurable order.
- **Artwork Image** – Optional artwork in controls and playlist.
- **Title & Artist** – Optional in controls and playlist.
- **Autoplay, Loop, Shuffle** – Optional playback behaviors, with browser‑policy compliant autoplay.
- **Playback Rate** – Adjustable playback rate with scrubber.
- **Volume Button & Scrubber** – Customizable volume control.
- **Magic Scrubber Hit Area** – Larger hit area for easy scrubbing on mobile.
- **Scrubbers Tooltips** – Tooltip feedback for scrubbers.
- **Keyboard Support** – Space/Arrow/M shortcuts for play, scrub and volume.
- **Audio Source Encryption** – Optional source obfuscation.
- **Google Analytics** – Track playback events.
- **Full API** – API methods and events for advanced integrations.

== Configuration ==
After activation, open the FWD Plasmic Audio Player menu in the WordPress admin and create:
1. A **Preset** (player settings)
2. A **Playlist** (tracks and metadata)

Then use the shortcode below in any post/page.

== Shortcode ==
Basic example:

[fwdpap preset_name="Preset 1" playlist_name="Playlist 1"]

== WooCommerce ==
Place the shortcode in the product description to replace the default gallery with the player.

== Installation ==
1. Upload the plugin folder to the `/wp-content/plugins/` directory.  
2. Activate the plugin through the ‘Plugins’ menu in WordPress.  
3. Create a preset and a playlist in the plugin admin menu.  
4. Add the shortcode to any post or page.

== Frequently Asked Questions ==
= Does it work with Gutenberg? =  
Yes. You can use the shortcode in any block or the Classic block.

= Is it mobile‑friendly? =  
Yes. FWD Plasmic Audio Player is fully responsive and optimized for touch.

= Can I use external audio sources? =  
Yes. It supports external .mp3 URLs, Shoutcast, and Icecast streams.


== External services ==

This plugin uses the following third-party/external services:

1. Google Analytics (Google Tag Manager script)
- What it is used for: optional playback analytics/events.
- When it is used: only if a Google Analytics tracking code is configured in the plugin.
- What data is sent: playback event data such as track URL and track info (artist/title) when playback starts.
- Service provider: Google.
- Terms of service: https://policies.google.com/terms
- Privacy policy: https://policies.google.com/privacy

2. Apple iTunes Search API
- What it is used for: retrieve track artwork for Shoutcast and Icecast streams when the player updates the current song metadata.
- When it is used: when a Shoutcast or Icecast stream is played and the plugin refreshes the current artist/title metadata.
- What data is sent: the current track artist name and title are sent in the search request to look up matching artwork. The request is made from the visitor browser directly to `itunes.apple.com`.
- Service provider: Apple.
- Terms of service: https://www.apple.com/legal/internet-services/terms/site.html
- Privacy policy: https://www.apple.com/legal/privacy/

3. ipify API
- What it is used for: obtain the visitor public IP address to limit repeated likes from the same IP.
- When it is used: when a user clicks the Like action.
- What data is sent: the visitor browser sends a request to `api.ipify.org` and receives the visitor public IP address, which the plugin uses to prevent duplicate likes from the same IP address.
- Service provider: ipify.
- Terms of service: https://www.ipify.org/
- Privacy policy: https://www.ipify.org/


== Development ==
This plugin’s full source code is publicly available for transparency and verification.  
Developed and maintained by [FutureWebDesign](https://fwdapps.net).

- [Source code & build tools](https://fwdapps.net/d/js/pap.zip) — includes original uncompiled files and Vite build configuration.
- Distributed plugin uses a compiled build generated by Vite for optimal performance.
