=== MP3 VPlayer ===
Contributors: VijeetDeliwala
Donate link: https://vijeetdeliwala.com/donate/
Tags: mp3, audio player, music player, playlist, audio
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.0.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A sleek, Amazon Music-inspired MP3 player with playlist support for any taxonomy.

== Description ==

MP3 VPlayer is a beautiful, feature-rich audio player plugin for WordPress that allows you to embed MP3 files with an elegant, modern interface inspired by Amazon Music.

= Key Features =

* **Sleek Modern Design** - Amazon Music-inspired interface with gradient backgrounds
* **Flexible Shortcode** - Play single tracks or create playlists from any taxonomy
* **Universal Compatibility** - Works with categories, tags, and custom taxonomies
* **Meta Box Integration** - Add MP3 URLs directly to posts, pages, or custom post types
* **Full Player Controls** - Play/Pause, Next, Previous, Volume, and Progress seeking
* **Autoplay Support** - Optional autoplay for playlists
* **Responsive Design** - Mobile-friendly and works on all devices
* **Keyboard Shortcuts** - Space for play/pause, Shift+Arrows for navigation
* **Customizable** - Choose which post types display the MP3 meta box

= Perfect For =

* Music websites and blogs
* Podcast sites
* Audio learning platforms
* Musicians and bands
* Audio portfolios
* Any site hosting audio content

= Shortcode Examples =

**Single MP3 File:**
`[mp3-vplayer file="<url>"]`

**Playlist from Categories:**
`[mp3-vplayer category="rock"]`

**Playlist from Custom Taxonomy:**
`[mp3-vplayer taxonomy="product_cat" category="music"]`

**Multiple Categories with Autoplay:**
`[mp3-vplayer category="jazz,blues" autoplay="true"]`

**Tags Playlist:**
`[mp3-vplayer taxonomy="post_tag" category="meditation"]`

= How It Works =

1. Install and activate the plugin
2. Go to Settings > MP3 VPlayer to choose which post types should have the MP3 URL meta box
3. Add MP3 URLs to your posts/pages using the meta box
4. Assign posts to categories or tags
5. Use the shortcode to display the player anywhere
6. The player automatically creates playlists from posts with MP3 URLs in the selected taxonomy

= Support =

Need help? Visit our [support forum](https://wordpress.org/support/plugin/mp3-vplayer/).

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "MP3 VPlayer"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin zip file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded zip file and click "Install Now"
5. Activate the plugin

= Configuration =

1. Go to Settings > MP3 VPlayer
2. Select which post types should have the MP3 URL meta box
3. Save changes
4. Start adding MP3 URLs to your posts

== Frequently Asked Questions ==

= What audio formats are supported? =

The plugin supports MP3 files. Browser support for other formats (like OGG, WAV) may vary.

= Can I use this with WooCommerce products? =

Yes! Enable the meta box for "Products" in settings, then use `taxonomy="product_cat"` in your shortcode.

= Can I create playlists from custom post types? =

Absolutely! Enable the meta box for your custom post type in settings, then use the appropriate taxonomy in your shortcode.

= How do I style the player to match my theme? =

You can override the CSS by adding custom styles to your theme's style.css file. The main container class is `.mp3-vplayer`.

= Does it work with page builders? =

Yes, the shortcode works with all major page builders including Elementor, Divi, Beaver Builder, and Gutenberg.

= Can I have multiple players on one page? =

Yes, you can use the shortcode multiple times on the same page with different parameters.

= Is it mobile responsive? =

Yes, the player is fully responsive and works beautifully on all devices.

= Can I disable autoplay? =

Yes, autoplay is disabled by default. Only add `autoplay="true"` if you want it enabled.

== Screenshots ==

1. Player interface with single track
2. Player with playlist expanded
3. Settings page for post type selection
4. Meta box in post editor
5. Player on mobile device
6. Multiple shortcode examples

== Changelog ==

= 1.0.0 =
* Initial release
* Sleek Amazon Music-inspired design
* Support for single tracks and playlists
* Works with any taxonomy (categories, tags, custom)
* Meta box for all post types
* Configurable post type support
* Full player controls
* Autoplay option
* Keyboard shortcuts
* Responsive design

== Upgrade Notice ==

= 1.0.0 =
Initial release of MP3 VPlayer.

== Additional Info ==

= Privacy =

This plugin does not collect or store any user data. All audio playback happens directly in the user's browser.

= Credits =

Developed with ❤️ for the WordPress community.

= Support Development =

If you find this plugin helpful, please consider [leaving a review](https://wordpress.org/support/plugin/mp3-vplayer/reviews/) or [making a donation](https://vijeetdeliwala.com/donate/).