{"id":252502,"date":"2025-09-23T13:52:58","date_gmt":"2025-09-23T13:52:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ds-custom-audio-player\/"},"modified":"2026-06-04T19:47:55","modified_gmt":"2026-06-04T19:47:55","slug":"ds-custom-audio-player","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/ds-custom-audio-player\/","author":23367347,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.7.0","stable_tag":"trunk","tested":"7.0","requires":"5.0","requires_php":"7.2","requires_plugins":null,"header_name":"DS Custom Audio Player","header_author":"Dennis Knake","header_description":"A fully customizable and lean HTML5 audio player for WordPress with SVG icons, optional metadata display (Artist, Title), volume control, and download button.","assets_banners_color":"26313b","last_updated":"2026-06-04 19:47:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.dennis-knake.de\/ds-custom-audio-player\/","header_author_uri":"https:\/\/www.dennis-knake.de\/","rating":0,"author_block_rating":0,"active_installs":40,"downloads":676,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.5.1":{"tag":"2.5.1","author":"dennisknake","date":"2025-09-23 15:37:42"},"2.5.2":{"tag":"2.5.2","author":"dennisknake","date":"2025-09-25 18:53:34"},"2.6":{"tag":"2.6","author":"dennisknake","date":"2025-09-26 22:23:14"},"2.6.1":{"tag":"2.6.1","author":"dennisknake","date":"2026-06-03 18:06:20"},"2.7":{"tag":"2.7","author":"dennisknake","date":"2026-06-04 19:51:28"}},"upgrade_notice":{"2.7.0":"<p>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 \u2013 all new options are disabled by default.<\/p>","2.6":"<p>Added Super Compact View\nTranslation fixes<\/p>","2.5.2":"<p>Bugfix: More reliable display of total Audio File length from start<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3366751,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3366751,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3366751,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3366751,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"dscap\/block":{"apiVersion":3,"name":"dscap\/block","title":"DS Custom Audio Player","category":"media","icon":"format-audio","description":"Custom audio player with three views: Normal (with metadata), Compact and Very Compact (without metadata). Includes volume and download options.","keywords":["audio","music","player","mp3"],"textdomain":"ds-custom-audio-player","attributes":{"src":{"type":"string","default":""},"width":{"type":"string","default":""},"color":{"type":"string","default":""},"bg":{"type":"string","default":""},"icon":{"type":"string","default":""},"compact":{"type":"integer"},"show_volume":{"type":"boolean","default":true},"show_download":{"type":"boolean","default":true},"show_speed":{"type":"boolean","default":false},"heading":{"type":"string","default":""},"show_heading":{"type":"boolean","default":false},"align":{"type":"string","default":""}},"supports":{"html":false,"multiple":true},"editorScript":"dscap-block-editor-js","editorStyle":"dscap-custom-audio-style","style":"dscap-custom-audio-style"}},"tagged_versions":["2.5.1","2.5.2","2.6","2.6.1","2.7"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3368706,"resolution":"1","location":"assets","locale":"","width":681,"height":632},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3368706,"resolution":"2","location":"assets","locale":"","width":667,"height":737},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3366627,"resolution":"3","location":"assets","locale":"","width":381,"height":362}},"screenshots":{"1":"Global Settings Menu","2":"Different appearences","3":"Gutenberg Support"}},"plugin_section":[],"plugin_tags":[452,9130,203,708,238],"plugin_category":[50,56],"plugin_contributors":[248256],"plugin_business_model":[],"class_list":["post-252502","plugin","type-plugin","status-publish","hentry","plugin_tags-audio","plugin_tags-audioplayer","plugin_tags-html5","plugin_tags-mp3","plugin_tags-podcast","plugin_category-media","plugin_category-social-and-sharing","plugin_contributors-dennisknake","plugin_committers-dennisknake"],"banners":{"banner":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/banner-772x250.png?rev=3366751","banner_2x":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/banner-1544x500.png?rev=3366751","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/icon-128x128.png?rev=3366751","icon_2x":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/icon-256x256.png?rev=3366751","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/screenshot-1.png?rev=3368706","caption":"Global Settings Menu"},{"src":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/screenshot-2.png?rev=3368706","caption":"Different appearences"},{"src":"https:\/\/ps.w.org\/ds-custom-audio-player\/assets\/screenshot-3.png?rev=3366627","caption":"Gutenberg Support"}],"raw_content":"<!--section=description-->\n<p>The <strong>DS Custom Audio Player<\/strong> 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.<\/p>\n\n<p>Comes with Language files for German, French, Spanish and Italian Wordpress Installations<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Customizable player width and colors (buttons, icons, background)<\/li>\n<li>Normal, compact and super compact view modes<\/li>\n<li>Metadata display (Artist - Title) read directly from audio files (MP3, OGG, FLAC, M4A, AAC)<\/li>\n<li>Optional volume control with instant mute\/unmute<\/li>\n<li>Optional download button (filename based on metadata or original file name)<\/li>\n<li>Optional playback speed button (cycles through 1x \/ 1.5x \/ 2x)<\/li>\n<li>Optional heading text displayed above the player (centered, italic, in theme font)<\/li>\n<li>Responsive design that works on desktop and mobile devices<\/li>\n<li>Lightweight: no external libraries required<\/li>\n<li>Accessibility-friendly controls (ARIA labels, keyboard navigation)<\/li>\n<li>Works with both <strong>Gutenberg (Block Editor)<\/strong> and the <strong>Classic Editor<\/strong><\/li>\n<\/ul>\n\n<p>This plugin uses the text domain <code>ds-custom-audio-player<\/code>.<\/p>\n\n<h3>Shortcode Usage<\/h3>\n\n<p>Basic example:<\/p>\n\n<p>[dscap_audio src=\"https:\/\/example.com\/audio\/song.mp3\"]<\/p>\n\n<h3>Available attributes (override global defaults):<\/h3>\n\n<ul>\n<li><code>src<\/code> \u2013 <strong>required<\/strong>, URL to the audio file.  <\/li>\n<li><code>width<\/code> \u2013 CSS value, e.g. <code>400px<\/code> or <code>100%<\/code>.  <\/li>\n<li><code>color<\/code> \u2013 Button background color, e.g. <code>#0073e6<\/code>.  <\/li>\n<li><code>bg<\/code> \u2013 Player background color.  <\/li>\n<li><code>icon<\/code> \u2013 SVG icon color, e.g. <code>#ffffff<\/code>.  <\/li>\n<li><code>compact<\/code> \u2013 <code>0<\/code> = normal view incl. Metadata, <code>1<\/code> = compact view, <code>2<\/code> = super compact view <\/li>\n<li><code>show_volume<\/code> \u2013 <code>1<\/code> = show volume control, <code>0<\/code> = hide.<\/li>\n<li><code>show_download<\/code> \u2013 <code>1<\/code> = show download button, <code>0<\/code> = hide.<\/li>\n<li><code>show_speed<\/code> \u2013 <code>1<\/code> = show playback speed button, <code>0<\/code> = hide.<\/li>\n<li><code>heading<\/code> \u2013 optional heading text displayed above the player (max. 50 characters).<\/li>\n<li><code>show_heading<\/code> \u2013 <code>1<\/code> = show heading, <code>0<\/code> = hide.<\/li>\n<li><code>align<\/code> \u2013 alignment: <code>left<\/code>, <code>center<\/code>, or <code>right<\/code>.<\/li>\n<\/ul>\n\n<p>Example with overrides:<\/p>\n\n<p>[dscap_audio src=\"https:\/\/example.com\/audio\/podcast.mp3\n\" width=\"100%\" color=\"#ff0000\" icon=\"#000000\" compact=\"1\" show_download=\"0\" align=\"center\"]<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder <code>ds-custom-audio-player<\/code> to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin in the WordPress backend under <strong>Plugins \u2192 Installed Plugins<\/strong>.<\/li>\n<li>Configure default values under <strong>Settings \u2192 Custom Audio Player<\/strong>.<\/li>\n<li>Insert the shortcode <code>[dscap_audio src=\"URL\"]<\/code> into posts or pages or use the <strong>DS Custom Audio Player Block<\/strong> in Gutenberg.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20audio%20formats%20are%20supported%3F\"><h3>Which audio formats are supported?<\/h3><\/dt>\n<dd><p>All formats supported by the browser, including MP3, OGG, WAV, FLAC, M4A, and AAC.<br \/>\nMetadata extraction works best with MP3, OGG, and FLAC.<\/p><\/dd>\n<dt id=\"can%20i%20place%20multiple%20players%20on%20one%20page%3F\"><h3>Can I place multiple players on one page?<\/h3><\/dt>\n<dd><p>Yes, you can add as many shortcodes or blocks as you like per page.<\/p><\/dd>\n<dt id=\"does%20it%20work%20in%20the%20gutenberg%20block%20editor%3F\"><h3>Does it work in the Gutenberg Block Editor?<\/h3><\/dt>\n<dd><p>Yes, the DS Custom Audio Player provides a custom block that you can insert directly in Gutenberg.<\/p><\/dd>\n<dt id=\"will%20my%20old%20shortcodes%20still%20work%3F\"><h3>Will my old shortcodes still work?<\/h3><\/dt>\n<dd><p>Yes. Shortcodes from earlier plugin versions like <code>[custom_audio]<\/code> are automatically replaced with <code>[dscap_audio]<\/code> for backward compatibility.<\/p><\/dd>\n<dt id=\"how%20does%20the%20download%20file%20naming%20work%3F\"><h3>How does the download file naming work?<\/h3><\/dt>\n<dd><p>If metadata (Artist\/Title) is available \u2192 <code>Artist - Title.mp3<\/code>.<br \/>\nOtherwise, the original filename is used.<\/p><\/dd>\n<dt id=\"is%20it%20accessibility-friendly%3F\"><h3>Is it accessibility-friendly?<\/h3><\/dt>\n<dd><p>Yes, all controls use ARIA labels and are keyboard-navigable.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.7.0<\/h4>\n\n<ul>\n<li>New: Optional playback speed button (cycles through 1x \/ 1.5x \/ 2x) \u2013 enable via global settings or shortcode attribute <code>show_speed<\/code>.<\/li>\n<li>New: Optional heading text above the player \u2013 configurable in global settings, displayed centered, italic and in the theme's body font. Enable via global settings or shortcode attributes <code>show_heading<\/code> \/ <code>heading<\/code>.<\/li>\n<li>Fix: Player CSS was not loaded in the WordPress Site Editor (Full Site Editing \/ block themes), causing buttons and icons to appear unstyled.<\/li>\n<li>Fix: Focus ring color inconsistency on the speed button.<\/li>\n<li>Fix: Radio buttons and checkboxes in the settings page were vertically misaligned in some language installations.<\/li>\n<li>Translations updated for German, Spanish, French and Italian.<\/li>\n<\/ul>\n\n<h4>2.6.1<\/h4>\n\n<p>Bugfix: Gutenberg editor no longer shows \"Invalid parameter(s): attributes\" when \"Show volume control\" or \"Show download button\" is unchecked in global settings.\nClassic Editor: Inserting an audio file via \"Add Media\" now correctly inserts [dscap_audio src=\"...\"] instead of the WordPress default [audio ...][\/audio] shortcode.<\/p>\n\n<h4>2.6<\/h4>\n\n<p>Added Super Compact View\nTranslation fixes<\/p>\n\n<h4>2.5.2<\/h4>\n\n<p>Bugfix: More reliable display of total Audio File length from start<\/p>\n\n<h4>2.5.1<\/h4>\n\n<p>Minor fixes for WordPress.org submission requirements. Legacy shortcode handling improved.<\/p>\n\n<h4>2.5<\/h4>\n\n<p>Added Gutenberg block compatibility and improved shortcode rendering.<\/p>\n\n<p>...<\/p>","raw_excerpt":"DS Custom Audio Player adds a modern, responsive and customizable HTML5 audio player. Works in Gutenberg Block Editor and Classic Editor.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/252502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=252502"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/dennisknake"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=252502"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=252502"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=252502"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=252502"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=252502"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=252502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}