Description
MP3 VPlayer lets you embed MP3 files in WordPress with a clean custom player. It supports direct MP3 URLs, post-level audio metadata, playlists built from categories/tags/custom taxonomies, optional artwork, seeking, volume controls, and responsive layouts.
Key Features
- Responsive Player – Compact layout designed for desktop and mobile
- Single Track Shortcode – Play any MP3 URL directly
- Optional Track Details – Add title, artist, and cover artwork in the shortcode
- Post Meta Integration – Save an MP3 URL, title, artist, and artwork on supported post types
- WordPress Media Library – Choose audio and artwork directly from the editor
- Taxonomy Playlists – Build playlists from categories, tags, or custom taxonomies
- Player Controls – Play/pause, previous/next, seeking, mute, and volume
- Automatic Track Advance – Moves to the next playlist track when the current track ends
- Featured Image Fallback – Uses the post featured image as artwork when no dedicated artwork is set
- Multiple Player Support – Multiple players can appear on the same page without playing over each other
- Accessible Controls – Keyboard-focusable buttons, range controls, and ARIA labels
- Theme-Safe Styling – Player CSS uses plugin-specific class names to reduce conflicts with themes and page builders
Shortcode Examples
Single MP3 file:
[mp3_vplayer mp3file=”https://example.com/song.mp3″]
The title is automatically derived from the filename when no title is supplied.
Single file with title and artist:
[mp3_vplayer mp3file=”https://example.com/song.mp3″ title=”My Song” artist=”Artist Name”]
Single file with cover artwork:
[mp3_vplayer mp3file=”https://example.com/song.mp3″ title=”My Song” artist=”Artist Name” cover=”https://example.com/cover.jpg”]
Current post’s saved MP3:
[mp3_vplayer]
Category playlist:
[mp3_vplayer category=”rock”]
Tag playlist:
[mp3_vplayer tag=”meditation”]
Custom taxonomy playlist:
[mp3_vplayer taxonomy=”product_cat” category=”music”]
Autoplay request:
[mp3_vplayer category=”ambient” autoplay=”true”]
Modern browsers may block autoplay until the visitor interacts with the page.
Backward Compatibility
Older direct-file aliases remain supported:
[mp3_vplayer file="https://example.com/song.mp3"]
[mp3_vplayer url="https://example.com/song.mp3"]
[mp3_vplayer src="https://example.com/song.mp3"]
Privacy
MP3 VPlayer does not send analytics or collect visitor data. Audio playback occurs in the visitor’s browser using the MP3 URL configured by the site owner. The optional admin review reminder stores only local per-user dismissal/review state in WordPress user meta; it sends no tracking data.
Screenshots
Installation
- Upload the plugin to WordPress or install it from the WordPress plugin directory.
- Activate MP3 VPlayer.
- Go to Settings > MP3 VPlayer and select the post types that should display the MP3 meta box.
- Use
[mp3_vplayer]for a post’s saved audio, or supply an MP3 URL directly in the shortcode.
FAQ
-
Why did an older version show “Unknown” under a direct MP3 URL?
-
Older releases used “Unknown” as a fallback artist. From version 1.0.9 onward, the artist row is hidden when no artist is supplied.
-
How is the title chosen for a direct MP3 URL?
-
If you do not supply
title, MP3 VPlayer derives a readable title from the MP3 filename. For example,my-favorite-song.mp3becomesMy Favorite Song. -
Can I add cover artwork?
-
Yes. Use the
cover,artwork, orimageshortcode attribute for direct files. For post-based tracks, use the Artwork field in the MP3 meta box. If that is empty, the post featured image is used when available. -
What audio formats are supported?
-
MP3 VPlayer is designed for MP3 files and serves them through the browser’s native HTML5 audio support.
-
Can I use this with WooCommerce products?
-
Yes. Enable the meta box for Products and use the appropriate taxonomy, for example
[mp3_vplayer taxonomy="product_cat" category="music"]. -
Can I create playlists from custom post types?
-
Yes, as long as the selected taxonomy is attached to that post type and the posts contain an MP3 URL.
-
Does it work with page builders?
-
The shortcode can be used anywhere WordPress shortcodes are processed, including common page builders and Gutenberg shortcode blocks.
-
Can I have multiple players on one page?
-
Yes. Each player is initialized independently. Starting one player automatically pauses another MP3 VPlayer instance that is already playing.
-
Is autoplay guaranteed?
-
No. Browsers commonly block autoplay with sound until the visitor interacts with the page. MP3 VPlayer requests autoplay only when you explicitly enable it and otherwise respects browser policy.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“MP3 VPlayer” is open source software. The following people have contributed to this plugin.
Contributors
Translate “MP3 VPlayer” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.13
- Fixed Play/Pause icon switching while audio is actively playing.
- Player now uses an explicit
is-playingbutton state plus SVG attribute toggling for reliable browser behavior. - Added
aria-pressedand synchronized Play/Pause state on play, playing, pause, and ended events.
1.0.12
- Tightened the player into a true compact top-aligned control cluster.
- Kept Play/Pause, title/artist, and volume controls together instead of spreading them across the card.
- Forced title and artist onto adjacent lines with fixed compact line heights to resist theme/page-builder spacing rules.
- Moved the seek bar immediately below the primary controls.
- Restored full-width player cards while keeping their contents grouped at the upper-left.
- Added stronger height, alignment, and flex resets for theme compatibility.
1.0.11
- Added a compact, non-modal WordPress admin review prompt.
- Review prompt waits 7 days after activation before appearing.
- Dismissing the prompt or choosing “Maybe later” hides it for 30 days.
- Clicking “Leave a review” permanently stops the prompt for that admin user.
- Review prompt is shown only to administrators and never appears on the public site.
1.0.10
- Rebuilt the player into a compact two-row layout.
- Removed decorative artwork/icon from the playback interface.
- Moved the Play/Pause control to the leading position beside track metadata.
- Moved volume control next to track metadata for a tighter desktop layout.
- Added stronger theme-resistant sizing/reset rules to prevent stretched controls.
- Improved responsive layout for narrow screens.
1.0.9
- Fixed theme/page-builder CSS collisions that could distort the player layout and artwork icon.
- Removed the forced “Unknown” artist label when no artist is supplied.
- Added optional
title,artist,author,cover,artwork, andimageshortcode attributes. - Added dedicated artwork support in the WordPress editor, with featured-image fallback for post-based tracks.
- Added working volume, mute, and seek controls.
- Rebuilt front-end JavaScript without a jQuery dependency.
- Improved multiple-player behavior so starting one player pauses other MP3 VPlayer instances.
- Improved keyboard interaction and accessibility labels.
- Simplified autoplay behavior to respect modern browser restrictions instead of repeatedly retrying blocked playback.
- Improved direct-file title generation from filenames.
- Fixed shortcode examples to consistently use
[mp3_vplayer]. - Improved taxonomy query handling and ignored empty MP3 URLs.
- Removed unnecessary full-site cache flushing during uninstall.
- Updated asset versioning to 1.0.9.
1.0.0
- Initial release.
- Single tracks and taxonomy playlists.
- Configurable post-type meta box.
- Play/pause, previous/next, seeking, and playlist support.