=== Audio Player Block – Advanced Block for Embedding Audio Files  ===
Contributors: bplugins, abuhayat, freemius, shamim10
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, audio player block, mp3 player, Gutenberg block
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 1.6.0
Requires PHP: 7.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

A block for embedding a beautiful audio player.

== Description ==

A block for embedding a beautiful audio player on the WordPress website. It supports multiple audios as a playlist and you can select a single audio file to make a non playlist player. 


**[Get Pro Version](https://bplugins.com/products/audio-player-block/pricing)**


= Free Features =
- **Multiple Audio Management (Add / Remove Audios)**: Easily add or remove multiple audio tracks from the player with full control over your playlist.
- **Track Details Input (Title & Artist)**: Set a custom title and artist name for each audio track to keep your content well organized.
- **Cover Image & Audio File Upload**: Upload audio files along with a cover image to create a more engaging and visually appealing audio player.
- **Player Customization (Width, Height & Styles)**: Adjust the player’s width and height, and style it with custom colors, backgrounds, hover effects, and other design settings to match your website.
- **Smart Audio Play / Pause Control**: Play one audio track at a time while automatically pausing others; click again to pause the currently playing audio.
- **Shortcode Integration**: Use shortcode support to display the audio player anywhere on your website with ease.

= Pro Features =
- **Customize 5 Different Themes**: Add 5 new themes with different looks and settings.
- **Auto Play**: Automatically start the next song once the current one ends, if enabled.
- **Loop Mode**: Enable looping of the current track once it finishes playing.
- **Navigation Prev/Next**: Easily navigate to the previous or next track in the playlist.
- **Current & Total Time Display**: Shows the current & total playback time of the audio track.
- **Custom Stop Button**: Show or hide a custom stop button based on your settings.
- **Input Range Thumb**: Customize the style of the range slider thumb for seeking.
- **Playback Speed Control**: Enable or disable playback speed adjustment options.
- **Download Icon**: Add an option to download the audio file directly from the player.
- **Forward & Backward Button Visibility**: Show or hide the forward & backward button for skipping parts of the track.
- **Artist Opacity**: Control the transparency of the artist's name display.
- **Thumbnail Border & Radius**: Customize the border & radius of the track's thumbnail image.
- **Input Range Height & Radius**: Adjust the height & radius of the seek range slider.
- **Controls Border & Hover Border**: Customize the border & hover border style of the player controls.
- **Time Display Radius**: Customize the corner radius of the time display boxes.
- **Thumb Width, Radius, Outline & Shadow**: Adjust the width, radius, outline & shadow of the seek range slider thumb.
- **Wave Normal & Light Color**: Set the base color & light of the audio waveform.
- **Playlist Border & Radius**: Customize the border and corner radius of the playlist displayed below the lite audio player.


= How to use =
- First, install the Audio Player Block plugin
- Add the Audio Player Block from the block category called "Widgets" in the Gutenberg editor.
- You can change block settings from the right-side settings sidebar.
- Enjoy!

* For installation help click on Installation Tab

== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository: 
[**Audio Player Block on GitHub**](https://github.com/bPlugins/audio-player-block-free)

= bpl-tools =

* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made


= Feedback =
- Did you like this plugin? Dislike it? Do you have a feature request? [Please share your feedback with us](mailto:support@bplugins.com 'Send feedback')


### ⭐ Check out the Parent Plugin of this plugin-

🔥 **[B Blocks](https://bblockswp.com)** – Best gutenberg blocks collections for WordPress.


### ⭐ Check out our other WordPress Plugins-

🔥 **[Html5 Audio Player](https://bplugins.com/products/html5-audio-player)** – Best audio player plugin for WordPress.

🔥 **[Html5 Video Player](https://bplugins.com/products/html5-video-player)** – Best video player plugin for WordPress.

🔥 **[PDF Poster](https://bplugins.com/products/pdf-poster)** – A fully-featured PDF Viewer Plugin for WordPress.

🔥 **[Document Embedder](https://bplugins.com/products/document-embedder)** – Best WordPress Document Embedder Plugin.

🔥 **[3D Viewer](https://bplugins.com/products/3d-viewer)** – Display interactive 3D models on the webs.

🔥 **[Advanced Post Block](https://bplugins.com/products/advanced-post-block)** – Best Post Display Plugin for WordPress.


== Installation ==

= From Gutenberg Editor: =
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Audio Player**
3. Click on the **Audio Player** to add the block

= Download & Upload: =
1. Download the **Audio Player Block** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`audio-player-block.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

= Manually: =
1. Download and upload the **Audio Player Block** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress


== Frequently Asked Questions ==

= Is Audio Player Block free? =

Yes, Audio Player Block is a free Gutenberg block plugin.

= Does it work with any WordPress theme? =

Yes, it will work with any standard WordPress theme.

= Can I change block settings? =

Yes, you can change block settings from the Gutenberg block editor's right sidebar.

= How many times can I reuse a block? =

You can use unlimited times as you want.

= Where can I get support? =

You can post your questions on the [support forum here](https://wordpress.org/support/plugin/audio-player-block/)


== Screenshots ==

1. Add Block
2. General Settings
3. Style Configuration 1
4. Style Configuration 2
5. Advanced Configuration
6. Default Theme
7. Slider Theme
8. One Haash Theme
9. Wooden Theme
10. Lite Theme
11. Card Theme
12. ShortCode Generator


== Changelog == 

= 1.6.0 - 04 June, 2026 =
* **New:** Added uninstall data cleanup settings to wipe database configs and post type records on delete.
* **Improved:** Unlocked previously locked pro fields in the Gutenberg editor and introduced a clean, non-intrusive notices UI to display premium feature requirements.
* **Updated:** Redesigned the shortcode copy-to-clipboard UI column in the audio player block CPT admin table for a better user experience.
* **Updated:** Streamlined editor Settings controls for free users, focusing on Default and Slider theme controls.
* **Updated:** Removed Pro-only theme styling and assets to reduce package footprint.

= 1.5.2 - 09 April, 2026 =
* **Fixed:** Class naming conflict and namespace resolution issue in LicenseActivation.
* **Updated:** Freemius SDK update new version.

= 1.5.1 - 19 March, 2026 =
* Added auto height for all tracks

= 1.5.0 - 16 March, 2026 =
* Updated track limit (threshold) control for playlist layouts
* Added new 'Show Less' button and text editing option
* Added new pro features modal

= 1.4.5 - 25 Feb, 2026 =
* Added “Help & Demos” quick access link in Plugins page.
* Fix issues in dashboard

= 1.4.4 - 24 Feb, 2026 =
* Added brand new dashboard with license activation support
* Extended Download Icon feature to all player layouts

= 1.4.3 - 04 Nov, 2025 =
* Update sdk

= 1.4.2 - 30 October, 2025 =
* Update controls in all players

= 1.4.1 - 12 October, 2025 =
* added buy now button in feature compare section

= 1.4.0 - 24 Sep, 2025 =
* added our current dashboard

= 1.3.7 - 28 July, 2025 =
* updated admin dashboard

= 1.3.6 - 13 July, 2025 =
* update premium feature

= 1.3.5 - 10 July, 2025 =
* update shortcode and clipboard

= 1.3.4 - 2 June, 2025 =
* input range and track issue solved

= 1.3.3 - 20 May, 2025 =
* Optimize dashboard layout and change cover photo some layouts

= 1.3.2 - 11 April, 2025 =
* Added loop, auto-play and cutom stop button

= 1.3.1 - 21 March, 2025 =
* Update custom dashboard styles

= 1.3.0 - 5 March, 2025 =
* Update Full Audio Panel and some styles

= 1.2.4 - 26 Feb, 2025 =
* Shortcode improvement

= 1.2.3 - 27 Jan, 2025 =
* Updated SDK version

= 1.2.2 - 26 Jan, 2025 =
* solving the problem in arrow icons

= 1.2.1 - 09 Jan, 2025 =
* Premium issue fixed

= 1.2.0 - 06 Jan, 2025 =
* Upgrade to Premium version

= 1.1.0 - 30 Sep, 2023 =
* Stop at the end of the album

= 1.0.9 =
* Fix the icon visible issue

= 1.0.8 =
* Performance Improvements

= 1.0.7 =
* Fix the play pause icon not visible on iPhone

= 1.0.6 =
* Change audio property update way.

= 1.0.5 =
* Pause other audio when playing.
* Not load scripts if block is not used

= 1.0.4 =
* Fix responsive issue
* Fix play/pause button accuracy

= 1.0.3 =
* Hours feature

= 1.0.2 =
* Add translate feature
* Insert file from URL

= 1.0.1 =
* readme updated
* fix mirror issues

= 1.0.0 =
* Initial Release