MP3 VPlayer

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.