=== DS Custom Audio Player ===
Contributors: dennisknake
Tags: audio, audioplayer, html5, mp3, podcast
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 2.7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

DS Custom Audio Player adds a modern, responsive and customizable HTML5 audio player. Works in Gutenberg Block Editor and Classic Editor.

== Description ==

The **DS Custom Audio Player** provides a lightweight, flexible and accessible alternative to the default WordPress audio player. It is designed for bloggers, podcasters and musicians who want more control over the look and functionality of their audio embeds without functionality overkill. It's still just a simple player.

Comes with Language files for German, French, Spanish and Italian Wordpress Installations

### Features

* Customizable player width and colors (buttons, icons, background)
* Normal, compact and super compact view modes
* Metadata display (Artist - Title) read directly from audio files (MP3, OGG, FLAC, M4A, AAC)
* Optional volume control with instant mute/unmute
* Optional download button (filename based on metadata or original file name)
* Optional playback speed button (cycles through 1x / 1.5x / 2x)
* Optional heading text displayed above the player (centered, italic, in theme font)
* Responsive design that works on desktop and mobile devices
* Lightweight: no external libraries required
* Accessibility-friendly controls (ARIA labels, keyboard navigation)
* Works with both **Gutenberg (Block Editor)** and the **Classic Editor**

This plugin uses the text domain `ds-custom-audio-player`.

== Installation ==

1. Upload the plugin folder `ds-custom-audio-player` to `/wp-content/plugins/`.
2. Activate the plugin in the WordPress backend under **Plugins → Installed Plugins**.
3. Configure default values under **Settings → Custom Audio Player**.
4. Insert the shortcode `[dscap_audio src="URL"]` into posts or pages or use the **DS Custom Audio Player Block** in Gutenberg.

== Screenshots ==

1. Global Settings Menu
2. Different appearences
3. Gutenberg Support

== Shortcode Usage ==

Basic example:

[dscap_audio src="https://example.com/audio/song.mp3"]


### Available attributes (override global defaults):

* `src` – **required**, URL to the audio file.  
* `width` – CSS value, e.g. `400px` or `100%`.  
* `color` – Button background color, e.g. `#0073e6`.  
* `bg` – Player background color.  
* `icon` – SVG icon color, e.g. `#ffffff`.  
* `compact` – `0` = normal view incl. Metadata, `1` = compact view, `2` = super compact view 
* `show_volume` – `1` = show volume control, `0` = hide.
* `show_download` – `1` = show download button, `0` = hide.
* `show_speed` – `1` = show playback speed button, `0` = hide.
* `heading` – optional heading text displayed above the player (max. 50 characters).
* `show_heading` – `1` = show heading, `0` = hide.
* `align` – alignment: `left`, `center`, or `right`.

Example with overrides:

[dscap_audio src="https://example.com/audio/podcast.mp3
" width="100%" color="#ff0000" icon="#000000" compact="1" show_download="0" align="center"]


== Frequently Asked Questions ==

= Which audio formats are supported? =  
All formats supported by the browser, including MP3, OGG, WAV, FLAC, M4A, and AAC.  
Metadata extraction works best with MP3, OGG, and FLAC.

= Can I place multiple players on one page? =  
Yes, you can add as many shortcodes or blocks as you like per page.

= Does it work in the Gutenberg Block Editor? =  
Yes, the DS Custom Audio Player provides a custom block that you can insert directly in Gutenberg.

= Will my old shortcodes still work? =  
Yes. Shortcodes from earlier plugin versions like `[custom_audio]` are automatically replaced with `[dscap_audio]` for backward compatibility.

= How does the download file naming work? =  
If metadata (Artist/Title) is available → `Artist - Title.mp3`.  
Otherwise, the original filename is used.

= Is it accessibility-friendly? =  
Yes, all controls use ARIA labels and are keyboard-navigable.


== Changelog ==

= 2.7.0 =
* New: Optional playback speed button (cycles through 1x / 1.5x / 2x) – enable via global settings or shortcode attribute `show_speed`.
* New: Optional heading text above the player – configurable in global settings, displayed centered, italic and in the theme's body font. Enable via global settings or shortcode attributes `show_heading` / `heading`.
* Fix: Player CSS was not loaded in the WordPress Site Editor (Full Site Editing / block themes), causing buttons and icons to appear unstyled.
* Fix: Focus ring color inconsistency on the speed button.
* Fix: Radio buttons and checkboxes in the settings page were vertically misaligned in some language installations.
* Translations updated for German, Spanish, French and Italian.

= 2.6.1 =
Bugfix: Gutenberg editor no longer shows "Invalid parameter(s): attributes" when "Show volume control" or "Show download button" is unchecked in global settings.
Classic Editor: Inserting an audio file via "Add Media" now correctly inserts [dscap_audio src="..."] instead of the WordPress default [audio ...][/audio] shortcode.

= 2.6 =
Added Super Compact View
Translation fixes

= 2.5.2 =
Bugfix: More reliable display of total Audio File length from start

= 2.5.1 =
Minor fixes for WordPress.org submission requirements. Legacy shortcode handling improved.

= 2.5 =
Added Gutenberg block compatibility and improved shortcode rendering.

...

== Upgrade Notice ==

= 2.7.0 =
Adds optional playback speed button and optional heading text above the player. Fixes for Site Editor CSS loading, focus ring styling and settings page alignment. No breaking changes – all new options are disabled by default.

= 2.6 =
Added Super Compact View
Translation fixes

= 2.5.2 =
Bugfix: More reliable display of total Audio File length from start