=== DS Custom Audio Player ===
Contributors: dennisknake
Tags: audio, audioplayer, html5, mp3, podcast
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 2.6
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)
* 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.  
* `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.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.6 =
Added Super Compact View
Translation fixes

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