{"id":316576,"date":"2026-06-15T17:19:47","date_gmt":"2026-06-15T17:19:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/valacuhi-mp3-player\/"},"modified":"2026-06-15T17:19:30","modified_gmt":"2026-06-15T17:19:30","slug":"valacuhi-mp3-player","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/valacuhi-mp3-player\/","author":23503409,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.4.6","stable_tag":"0.4.6","tested":"7.0","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Valacuhi MP3 Player","header_author":"Maksim Navakouski","header_description":"A lightweight MP3 album player with metadata extraction, embedded artwork, autoplay, download buttons and download counters.","assets_banners_color":"485760","last_updated":"2026-06-15 17:19:30","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/valacuhi.com\/music-to-go\/","header_author_uri":"https:\/\/valacuhi.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":30,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.4.6":{"tag":"0.4.6","author":"valacuhi","date":"2026-06-15 17:19:30"}},"upgrade_notice":{"0.4.6":"<p>*WordPress.org review-response update: prefixed identifiers, migration-safe CPT update, and stricter path\/input hardening.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3573502,"resolution":"128x128","location":"assets","locale":"","width":127,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3573502,"resolution":"256x256","location":"assets","locale":"","width":255,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3573502,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":488},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3573502,"resolution":"772x250","location":"assets","locale":"","width":772,"height":244}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.4.6"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[5719,452,708,1494,220],"plugin_category":[50],"plugin_contributors":[267279],"plugin_business_model":[],"class_list":["post-316576","plugin","type-plugin","status-publish","hentry","plugin_tags-album","plugin_tags-audio","plugin_tags-mp3","plugin_tags-music-player","plugin_tags-playlist","plugin_category-media","plugin_contributors-valacuhi","plugin_committers-valacuhi"],"banners":{"banner":"https:\/\/ps.w.org\/valacuhi-mp3-player\/assets\/banner-772x250.png?rev=3573502","banner_2x":"https:\/\/ps.w.org\/valacuhi-mp3-player\/assets\/banner-1544x500.png?rev=3573502","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/valacuhi-mp3-player\/assets\/icon-128x128.png?rev=3573502","icon_2x":"https:\/\/ps.w.org\/valacuhi-mp3-player\/assets\/icon-256x256.png?rev=3573502","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Valacuhi MP3 Player helps musicians and creators publish album-style MP3 playlists directly on WordPress.\nIt is intentionally lightweight: no external frontend libraries, no bloated builders, and no paid add-on dependency for core playback\/download workflows.\nIt keeps the setup simple and fast while offering a feature combination that is often split across paid tiers in other plugins.<\/p>\n\n<p>Features include:\n- Album custom post type\n- Shortcode embed: [valacuhi_mp3_player id=\"123\"]\n- Play\/Pause, Previous\/Next, seek bar\n- Mute\/Unmute and Mix mode\n- MP3 metadata extraction (title, artist, album, genre, duration)\n- Embedded artwork extraction from MP3 files\n- Per-track and album ZIP download buttons with counters\n- Premium lightweight v0.4 interface\n- v0.4.3 unified inline SVG control icon family\n- v0.4.4 mobile control-row polish and clearer Mix active state<\/p>\n\n<h3>Notes for Site Owners<\/h3>\n\n<ul>\n<li>Download counters are transient-based lightweight counters.<\/li>\n<li>They are useful for UI feedback, not long-term analytics.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/valacuhi-mp3-player<\/code> directory, or install via WordPress Plugins screen.<\/li>\n<li>Activate the plugin through the <code>Plugins<\/code> screen in WordPress.<\/li>\n<li>Go to <code>Albums<\/code> and create a new album.<\/li>\n<li>Set featured image (album art fallback).<\/li>\n<li>Add MP3 files in <code>Album Tracks<\/code> metabox.<\/li>\n<li>(Optional) Add Album ZIP URL.<\/li>\n<li>Publish album.<\/li>\n<li>Find the album ID:\n\n<ul>\n<li>Open <code>Albums -&gt; All Albums<\/code>.<\/li>\n<li>Hover the album title or click <code>Edit<\/code>.<\/li>\n<li>In the browser URL, find <code>post=123<\/code> or <code>post.php?post=123<\/code>.<\/li>\n<li>Use that number in the shortcode.<\/li>\n<\/ul><\/li>\n<li>Use shortcode <code>[valacuhi_mp3_player id=\"YOUR_ALBUM_ID\"]<\/code> on any page\/post.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20users%20can%20do%20in%20the%20player%3F\"><h3>What Users Can Do in the Player?<\/h3><\/dt>\n<dd><ul>\n<li>Select any track from the list<\/li>\n<li>Play\/Pause<\/li>\n<li>Previous\/Next track<\/li>\n<li>Seek through progress bar<\/li>\n<li>Mute\/Unmute<\/li>\n<li>Toggle Mix mode<\/li>\n<li>Download individual tracks<\/li>\n<li>Download entire album ZIP (if configured)<\/li>\n<\/ul><\/dd>\n<dt id=\"why%20are%20style%20changes%20not%20visible%20after%20update%3F\"><h3>Why are style changes not visible after update?<\/h3><\/dt>\n<dd><ul>\n<li>F12, then right click on Reload button and choose \"Empty cache and hard reload\".<\/li>\n<li>Plugin version updates append <code>?ver=0.4.6<\/code> to CSS\/JS for cache busting.<\/li>\n<\/ul><\/dd>\n<dt id=\"what%20about%20metadata%20behavior%3F\"><h3>What about Metadata Behavior?<\/h3><\/dt>\n<dd><ul>\n<li>Title: MP3 <code>title<\/code> tag, fallback to filename<\/li>\n<li>Artist\/Album\/Genre: shown only when tag exists<\/li>\n<li>Duration: extracted from MP3 metadata<\/li>\n<li>Artwork: embedded MP3 image preferred; album featured image used as fallback<\/li>\n<\/ul><\/dd>\n<dt id=\"why%20is%20metadata%20missing%20for%20some%20tracks%3F\"><h3>Why is metadata missing for some tracks?<\/h3><\/dt>\n<dd><p>Metadata is read from MP3 tags. If tags are missing in the file, those fields stay empty.<\/p><\/dd>\n<dt id=\"why%20does%20artwork%20not%20appear%3F\"><h3>Why does artwork not appear?<\/h3><\/dt>\n<dd><p>Artwork is extracted from embedded MP3 image frames. If an MP3 has no embedded image, the album featured image is used.<\/p><\/dd>\n<dt id=\"are%20download%20counters%20permanent%20analytics%3F\"><h3>Are download counters permanent analytics?<\/h3><\/dt>\n<dd><p>No. Counters use lightweight transients and are intended as simple UI feedback.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.4.6<\/h4>\n\n<ul>\n<li>Prefixed CPT identifier from <code>album<\/code> to <code>valacuhi_album<\/code> for directory compatibility<\/li>\n<li>Added one-time migration of legacy <code>album<\/code> posts to the new prefixed CPT<\/li>\n<li>Prefixed transient keys and AJAX action names to avoid cross-plugin collisions<\/li>\n<li>Reworked media URL-to-path resolution to use robust WordPress APIs<\/li>\n<li>Hardened track URLs POST handling for stricter validation\/sanitization flow<\/li>\n<\/ul>\n\n<h4>0.4.5<\/h4>\n\n<ul>\n<li>Switched audio metadata\/artwork parsing to WordPress core APIs<\/li>\n<li>Plugin Check remediation pass for submission readiness<\/li>\n<li>Packaging cleanup for WordPress.org review<\/li>\n<\/ul>\n\n<h4>0.4.4<\/h4>\n\n<ul>\n<li>Mobile-only control-row polish for small screens<\/li>\n<li>Centered Album CTA when it wraps to second row<\/li>\n<li>Stronger Mix on\/off visual state clarity<\/li>\n<\/ul>\n\n<h4>0.4.3<\/h4>\n\n<ul>\n<li>Unified inline SVG icon family for controls (prev\/play-pause\/next\/mix\/volume\/download)<\/li>\n<li>Kept Play\/Pause visually larger while secondary controls remain equal-sized<\/li>\n<li>Improved consistent icon rendering across environments<\/li>\n<\/ul>\n\n<h4>0.4<\/h4>\n\n<ul>\n<li>Premium lightweight UI refresh (Frosted Light style)<\/li>\n<li>Improved visual hierarchy, controls, and track list styling<\/li>\n<li>WordPress.org hardening improvements<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Added genre extraction and display<\/li>\n<li>Added mute\/unmute and mix controls<\/li>\n<li>Title fallback from MP3 title to filename<\/li>\n<\/ul>\n\n<h4>0.3<\/h4>\n\n<ul>\n<li>Playback reliability improvements<\/li>\n<li>Embedded artwork shown in player and list<\/li>\n<li>Metadata extraction and progress UX improvements<\/li>\n<\/ul>","raw_excerpt":"A lightweight MP3 album player with metadata extraction, embedded artwork, download buttons and download counters.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/316576","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=316576"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/valacuhi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=316576"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=316576"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=316576"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=316576"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=316576"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=316576"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}