=== FWD Plasmic Audio Player === Contributors: futurewebdesign Donate link: https://fwdapps.net/p/pap/ Tags: audio player, mp3, music player, radio, icecast Requires at least: 5.0 Tested up to: 7.0 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.