music-player-for-woocommerce
Last commit date
addons
1 month ago
css
1 month ago
feedback
1 month ago
inc
1 month ago
js
1 month ago
languages
1 month ago
pagebuilders
1 month ago
vendors
1 month ago
views
1 month ago
widgets
1 month ago
banner.php
1 month ago
readme.txt
1 month ago
wcmp.php
1 month ago
readme.txt
369 lines
| 1 | === Music Player for WooCommerce === |
| 2 | Contributors: codepeople |
| 3 | Donate link: https://wcmp.dwbooster.com |
| 4 | Tags: woocommerce, audio player, music player, playlists, multivendor |
| 5 | Requires at least: 3.5.0 |
| 6 | Tested up to: 7.0 |
| 7 | Stable tag: 1.8.3 |
| 8 | License: GPLv2 or later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Music Player for WooCommerce includes the MediaElement.js music player in the pages of the products with audio files associated. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | Features of the Music Player for WooCommerce, Dokan, WCFM Marketplace, and MultivendorX: |
| 16 | |
| 17 | ♪ Integrate a music player into the WooCommerce products, Dokan, WCFM Marketplace, and MultivendorX |
| 18 | ♪ Includes an audio player that supports formats: OGA, MP3, WAV, WMA |
| 19 | ♪ Supports M3U, M3U8 playlists |
| 20 | ♪ Includes multiple skins for the Music Player |
| 21 | ♪ Supports all most popular web browsers and mobile devices |
| 22 | ♪ Includes a widget to insert a playlist on sidebars |
| 23 | ♪ Includes a block to insert the playlists on pages using Gutenberg |
| 24 | ♪ Includes a widget to insert the playlists on pages using Elementor |
| 25 | ♪ Includes a widget for inserting the playlists on pages with Page Builder by SiteOrigin |
| 26 | ♪ Includes a control for inserting the playlists on pages with BeaverBuilder |
| 27 | ♪ Includes an element for inserting the playlists on pages with Visual Composer |
| 28 | ♪ Includes a module for inserting the playlists on pages with DIVI |
| 29 | |
| 30 | Note: for the other editors, insert directly the playlists' shortcodes. |
| 31 | |
| 32 | Music Player for WooCommerce includes the MediaElement.js music player in the pages of the products with audio files associated, and in the store's pages. It allows the integration with the multivendor stores generated with Dokan, WCFM Marketplace, and MultivendorX. Furthermore, the plugin allows selecting between multiple skins. |
| 33 | |
| 34 | MediaElement.js is an music player compatible with all major browsers: Internet Explorer, Firefox, Opera, Safari, Chrome and mobile devices: iPhone, iPad, Android. The music player is developed following the html5 standard. The music player supports the following file formats: MP3, WAV, WMA and OGA. |
| 35 | |
| 36 | The basic version of the plugin, available for free from the WordPress Directory, has the features needed to include a music player in the pages of the products and the store. |
| 37 | |
| 38 | [youtube https://youtu.be/kWbvyWuzBtk] |
| 39 | |
| 40 | **Premium Features** |
| 41 | |
| 42 | * Allows playing the audio files in secure mode to prevent unauthorized downloading of the audio files. |
| 43 | * Allows to define the percent of the audio file's size to be played in secure mode. |
| 44 | |
| 45 | [youtube https://youtu.be/e8LpVzhK_1s] |
| 46 | |
| 47 | **Supports integration with plugins:** |
| 48 | |
| 49 | * WooCommerce |
| 50 | * Dokan |
| 51 | * WCFM - Marketplace |
| 52 | * WC Vendors |
| 53 | * MultivendorX |
| 54 | * Advanced AJAX Product Filters by berocket |
| 55 | * Load More Products for WooCommerce by berocket |
| 56 | * Themify - WooCommerce Product Filter by Themify |
| 57 | * YITH WooCommerce Ajax Product Filter by YITH |
| 58 | * WOOF - Products Filter for WooCommerce by realmag777 |
| 59 | * Product Filter by WooBeWoo |
| 60 | |
| 61 | Support post_type like auctions, included by third-party plugins. |
| 62 | |
| 63 | And third-party players like: |
| 64 | |
| 65 | * Compact Audio Player |
| 66 | * CP Media Player |
| 67 | * HTML5 Audio Player |
| 68 | * MP3 jPlayer |
| 69 | |
| 70 | == Installation == |
| 71 | |
| 72 | **To install Music Player for WooCommerce, follow these steps:** |
| 73 | |
| 74 | 1. Download and unzip the plugin |
| 75 | 2. Upload the entire "woocommerce_music_player" directory to the "/wp-content/plugins/" directory |
| 76 | 3. Activate the plugin through the "Plugins" menu in "WordPress" |
| 77 | 4. Go to the products pages to configure the players. |
| 78 | |
| 79 | == Interface == |
| 80 | |
| 81 | **Global Settings of Music Players** |
| 82 | |
| 83 | The global settings are accessible through the menu option: "Settings/Music Player for WooCommerce". |
| 84 | |
| 85 | * Include music player in all all products: checkbox to include the music player in all products. |
| 86 | * Include in: radio button to decide where to display the music player, in pages with a single entry, multiple entries, or both (both cases by default). |
| 87 | * Include players in cart: checkbox to include the music players on the cart page or not. |
| 88 | * Merge in grouped products: in grouped products, display the "Add to cart" buttons and quantity fields in the players rows. |
| 89 | * Player layout: list of available skins for the music player. |
| 90 | * Show a single player instead of one player per audio file. |
| 91 | * Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all. |
| 92 | * Play all: play all players in the page (one after the other). |
| 93 | * Loop: plays the audio player on the product page in a loop. |
| 94 | * Player controls: determines the controls to include in the music player. |
| 95 | * Visualizer: For "all controls" mode, display the visualizer component over the player. |
| 96 | * Display the player's title: show/hide the name associated to the downloadable file. |
| 97 | * Protect the file: checkbox to playback the songs in secure mode (only available in the pro version of the plugin). |
| 98 | * Percent of audio used for protected playbacks: integer number from 0 to 100, that represents the percent of the size of the original audio file that will be used in the audio file for demo (only available in the pro version of the plugin). |
| 99 | * Apply the previous settings to all products pages in the website: tick the checkbox to apply the previous settings to all products overwriting the products' settings. |
| 100 | |
| 101 | **Google Analytics Integration** |
| 102 | |
| 103 | * Tracking id: Enter the tracking id in the property settings of Google Analytics account. |
| 104 | |
| 105 | **Setting up the Music Players through the products' pages** |
| 106 | |
| 107 | The Music Players are configured from the products pages, the Dokan interface, WCFM Marketplace, and MultivendorX. |
| 108 | |
| 109 | **Settings Interface** |
| 110 | |
| 111 | * Include music player: checkbox to include the music player in the product's page, or not. |
| 112 | * Include in: radio button to decide where to display the music player, in pages with a single entry, multiple entries, or both (both cases by default). |
| 113 | * Merge in grouped products: in grouped products, display the "Add to cart" buttons and quantity fields in the players rows. |
| 114 | * Player layout: list of available skins for the music player. |
| 115 | * Show a single player instead of one player per audio file. |
| 116 | * Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all. |
| 117 | * Play all: play all players in the page (one after the other). |
| 118 | * Loop: plays the audio player on the product page in a loop. |
| 119 | * Player controls: determines the controls to include in the music player. |
| 120 | * Visualizer: For "all controls" mode, display the visualizer component over the player. |
| 121 | * Display the player's title: show/hide the name associated to the downloadable file. |
| 122 | * Protect the file: checkbox to playback the songs in secure mode (only available in the pro version of the plugin). |
| 123 | * Percent of audio used for protected playbacks: integer number from 0 to 100, that represents the percent of the size of the original audio file that will be used in the audio file for demo (only available in the pro version of the plugin). |
| 124 | * Select my own demo files: checkbox to use different audio files for demo, than the audio files for selling (only available in the pro version of the plugin). |
| 125 | * Demo files: section similar to the audio files for selling, but in this case it allows to select different audio files for demo, and their names (only available in the pro version of the plugin). |
| 126 | |
| 127 | [youtube https://youtu.be/jydVqEUe9YY] |
| 128 | |
| 129 | **How the Pro version of the Music Player for WooCommerce protect the audio files?** |
| 130 | |
| 131 | If the "Protect the file" checkbox was ticked in the product's page, and was entered an integer number through the attribute: "Percent of audio used for protected playbacks", the plugin will create a truncated copy of the audio files for selling (or the audio files for demo) into the "/wp-content/plugins/wcmp" directory, to be used as demo. The sizes of the audio files for demo are a percentage of the sizes of the original files (the integer number entered in the player's settings). So, the users cannot access to the original audio files, from the public pages of the products. |
| 132 | |
| 133 | **Music Player for WooCommerce - Playlist Widget** |
| 134 | |
| 135 | The widget allows to include a playlist on sidebars, with the downloadable files associated to all products with the music player enabled, or for only some of the products. |
| 136 | |
| 137 | The widget settings: |
| 138 | |
| 139 | * Title: the title of the widget on sidebar. |
| 140 | * Products IDs: enter the ids of products to include in the playlist, separated by comma, or the * symbol to include all products. |
| 141 | * Playlist layout: select between the new playlist layout and the original one. |
| 142 | * Player layout: select the layout of music players (the widget uses only the play/pause control) |
| 143 | * Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all. This attribute has a global scope, and will modify the default settings. |
| 144 | * Play all: play all players in the page (one after the other). This attribute has a global scope, and will modify the default settings. |
| 145 | * Highlight the current product: if the checkbox is ticked, and the user is in the page of a product, and it is included in the playlist, the corresponding item would be highlighted in the playlist. |
| 146 | * Continue playing after navigate: if the checkbox is ticked, and there is a song playing when navigates, the player will continue playing after loading the webpage, in the same position. |
| 147 | |
| 148 | Note: In mobiles devices where the direct action of user is required for playing audios and videos, the plugin cannot start playing dynamically. |
| 149 | |
| 150 | |
| 151 | **Music Player for WooCommerce - [wcmp-playlist] shortcode** |
| 152 | |
| 153 | The `[wcmp-playlist]` shortcode allows to include a playlist on the pages' contents, with all products, or for some of them. |
| 154 | |
| 155 | The shortcode attributes are: |
| 156 | |
| 157 | * products_ids: enter the ids of products to include in the playlist, separated by comma, or the * symbol to include all products |
| 158 | |
| 159 | `[wcmp-playlist products_ids="*"]` |
| 160 | |
| 161 | * title: enter the title text to display prominently above the playlist |
| 162 | |
| 163 | `[wcmp-playlist products_ids="*" title="My Playlist"]` |
| 164 | |
| 165 | * product_categories: this feature enables you to load all products belonging to one or multiple categories at once, eliminating the need to enter their IDs individually. To filter by product categories, simply input their slugs, separated by commas |
| 166 | |
| 167 | `[wcmp-playlist products_ids="*" product_categories="category-1,category-2"]` |
| 168 | |
| 169 | * product_tags: just like filtering by product categories, you can also filter products by tags. To do this, simply enter the tag slugs, separated by commas |
| 170 | |
| 171 | `[wcmp-playlist products_ids="*" product_tags="tag-1,tag-2"]` |
| 172 | |
| 173 | * layout: allows to select the new or original layouts with the values: new or classic ("new" is the value by default) |
| 174 | |
| 175 | `[wcmp-playlist products_ids="*" layout="new"]` |
| 176 | |
| 177 | * player_style: select the layout of music players (the playlist displays only the play/pause control) |
| 178 | |
| 179 | `[wcmp-playlist products_ids="*" player_style="mejs-classic"]` |
| 180 | |
| 181 | * highlight_current_product: if the playlist is included in a product's page, the corresponding item would be highlighted in the playlist |
| 182 | |
| 183 | `[wcmp-playlist products_ids="*" highlight_current_product="1"]` |
| 184 | |
| 185 | * continue_playing: if there is a song playing when navigates, the player will continue playing after loading the webpage in the same position |
| 186 | |
| 187 | `[wcmp-playlist products_ids="*" continue_playing="1"]` |
| 188 | |
| 189 | Note: In mobiles devices where the direct action of user is required for playing audios and videos, the plugin cannot start playing dynamically. |
| 190 | |
| 191 | * controls: allows to configure the controls to be used with the players on playlist. The possible values are: track or all, to include only a play/pause button or all player's controls respectively: |
| 192 | |
| 193 | `[wcmp-playlist products_ids="*" controls="track"]` |
| 194 | |
| 195 | * loop: plays all playlist items in an endless loop. The accepted values are: 1 or 0 |
| 196 | |
| 197 | `[wcmp-playlist products_ids="*" loop="1"]` |
| 198 | |
| 199 | * cover: allows to include the featured images in the playlist. The possible values are: 0 or 1, 0 is the value by default |
| 200 | |
| 201 | `[wcmp-playlist products_ids="*" cover="1"]` |
| 202 | |
| 203 | * purchased_only: includes only the audio files associated with the purchased products (Plugin commercial version) |
| 204 | |
| 205 | `[wcmp-playlist products_ids="*" purchased_only="1"]` |
| 206 | |
| 207 | * purchased_products: generates the list of products purchased by the logged user (Plugin commercial version) |
| 208 | |
| 209 | `[wcmp-playlist purchased_products="1"]` |
| 210 | |
| 211 | |
| 212 | **Hooks (actions and filters)** |
| 213 | |
| 214 | * wcmp_before_player_shop_page: action called before the players containers in the shop pages. |
| 215 | * wcmp_after_player_shop_page: action called after the players containers in the shop pages. |
| 216 | * wcmp_before_players_product_page: action called before the players containers in the products pages. |
| 217 | * wcmp_after_players_product_page: action called after the players containers in the products pages. |
| 218 | |
| 219 | * wcmp_audio_tag: filter called when the audio tag is generated. The callback function receives four parameters: the audio tag, the product's id, the file's id, URL to the audio file; |
| 220 | * wcmp_file_name: filter called when the file's name is included with the player. The callback function receives three parameters: the file's name, the product's id, and the file's id; |
| 221 | |
| 222 | * wcmp_widget_audio_tag: filter called when the audio tag is generated as a widget on sidebars. The callback function receives four parameters: the audio tag, the product's id, the file's id, URL to the audio file; |
| 223 | * wcmp_widget_file_name: filter called when the file's name is included with the player as a widget on sidebars. The callback function receives three parameters: the file's name, the product's id, and the file's id; |
| 224 | |
| 225 | * wcmp_purchased_product: filter called to know if the product was purchased or not. The callback function receives two parameters: false and the product's id. |
| 226 | |
| 227 | * wcmp_ffmpeg_time: filter called to determine the duration of truncated copies of the audio files for demos when the FFmpeg application is used to generate them. |
| 228 | |
| 229 | **Other recommended plugins** |
| 230 | |
| 231 | * If your project is a music store, and WooCommerce is more than you need it is possible to use [Music Store plugin](https://wordpress.org/plugins/music-store/ "Music Store") |
| 232 | * Or if you need a general purpose music and video player, not especific for WooCommerce, [CP Media Player - Audio Player and Video Player plugin](https://wordpress.org/plugins/audio-and-video-player/ "CP Media Player - Audio Player and Video Player") |
| 233 | |
| 234 | == Frequently Asked Questions == |
| 235 | |
| 236 | = Q: Why the audio file is played partially? = |
| 237 | |
| 238 | A: If you decide to protect the audio files, the plugin creates a truncated version of the file to be used as demo and prevent that the original file be copied by unauthorized users. |
| 239 | |
| 240 | = Q: Why the music player is not loading on page? = |
| 241 | |
| 242 | A: Verify that the theme used in your website, includes the function wp_footer(); in the template file "footer.php" or the template file "index.php" |
| 243 | |
| 244 | = Q: What can I do if the woocommerce_music_player directory exists and the premium version of plugin cannot be installed? = |
| 245 | |
| 246 | A: Go to the plugins section in WordPress, deactivate the free version of Music Player for WooCommerce, and delete it ( Don't worry, this process don't modify players configured with the free version of the plugin), and finally install and activate the premium version of plugin. |
| 247 | |
| 248 | = Q: Can be modified the size of audio files played in secure mode? = |
| 249 | |
| 250 | A: In the pro version of the plugin the files for demo are generated dynamically to prevent the access to the original files. |
| 251 | |
| 252 | Each time save the data of a product, the files for demo are deleted and generated again, so, you simply should modify the percentage of the audio file to be used for demo in the product's page. |
| 253 | |
| 254 | == Screenshots == |
| 255 | 01. Music players in the store's pages |
| 256 | 02. Music player in the products pages |
| 257 | 03. Music player skins |
| 258 | 04. Music player settings |
| 259 | 05. Playlist widget |
| 260 | 06. Inserting the playlist in Gutenberg |
| 261 | 07. Inserting the playlist in Elementor |
| 262 | 08. Inserting the playlist with Page Builder by SiteOrigin |
| 263 | 09. Inserting the playlist BeaverBuilder |
| 264 | 10. Inserting the playlist Visual Composer |
| 265 | |
| 266 | == Changelog == |
| 267 | |
| 268 | = 1.8.3 = |
| 269 | |
| 270 | * Improves the Elementor integration module. |
| 271 | |
| 272 | = 1.8.2 = |
| 273 | |
| 274 | * Improves the WordPress 7.0 integration. |
| 275 | |
| 276 | = 1.8.1 = |
| 277 | |
| 278 | * Implements integration with the new WordPress Connectors API, allowing custom skins to be generated using the AI providers configured in WordPress. |
| 279 | |
| 280 | = 1.8.0 = |
| 281 | |
| 282 | * Updates the .htaccess file within the wcmp directory to resolve conflicts caused by certain server configurations. |
| 283 | |
| 284 | = 1.7.9 = |
| 285 | |
| 286 | * Implements the Divi 5 Playlist module. |
| 287 | * Improves the security of the playlist preview generation module. |
| 288 | |
| 289 | = 1.7.8 = |
| 290 | |
| 291 | * Enhances the initial setup. |
| 292 | |
| 293 | = 1.7.7 = |
| 294 | |
| 295 | * Enables players quickly with a simple, intuitive setup. |
| 296 | |
| 297 | = 1.7.6 = |
| 298 | |
| 299 | * Resolved a conflict with the latest WooCommerce minicart implementation. |
| 300 | |
| 301 | = 1.7.5 = |
| 302 | |
| 303 | * Prevents a positioning issue when using the player in certain WordPress themes. |
| 304 | * Fixes an issue with the visualizer on playlists. |
| 305 | |
| 306 | = 1.7.4 = |
| 307 | |
| 308 | * Implements a visualizer component over the player. |
| 309 | |
| 310 | = 1.7.3 = |
| 311 | |
| 312 | * Modifies the skin generator module to use a better AI model. |
| 313 | |
| 314 | = 1.7.2 = |
| 315 | |
| 316 | * Ensure compatibility with the latest WooCommerce update. |
| 317 | |
| 318 | = 1.7.1 = |
| 319 | |
| 320 | * Updated the player-loading module to ensure compatibility with a wider range of website builders and themes. |
| 321 | |
| 322 | = 1.7.0 = |
| 323 | |
| 324 | * The plugin update introduces a new Skin Generator module that leverages AI to create fully personalized player skins. |
| 325 | |
| 326 | = 1.6.3 = |
| 327 | |
| 328 | * Explicitly include a .htaccess file in the wp-content/uploads/wcmp to prevent directory indexing on misconfigured servers. |
| 329 | |
| 330 | = 1.6.2 = |
| 331 | |
| 332 | * Purges the Elementor cache during the plugin settings update. |
| 333 | |
| 334 | = 1.6.1 = |
| 335 | |
| 336 | * Fixes an issue with the Show a single player option in the products settings. |
| 337 | |
| 338 | = 1.6.0 = |
| 339 | |
| 340 | * Enhances the plugin security by ensuring that player settings for specific products are deleted only after the associated products have been removed. Special thanks to domiee13 and patchstack.com for their valuable contributions. |
| 341 | |
| 342 | = 1.5.1 = |
| 343 | |
| 344 | * Resolves a warning in the WordPress editor's playlist block. |
| 345 | |
| 346 | = 1.5.0 = |
| 347 | |
| 348 | * The plugin update lets you enter Google Drive sharing URLs and automatically converts them into direct Google Drive download links. |
| 349 | |
| 350 | = 1.4.5 = |
| 351 | |
| 352 | * Ensures full compatibility with WordPress 6.8. |
| 353 | |
| 354 | = 1.4.4 = |
| 355 | |
| 356 | * Automatically clears the website's cache upon saving the plugin settings. |
| 357 | |
| 358 | = 1.4.3 = |
| 359 | |
| 360 | * Resolves an issue where selecting multiple downloadable files in the product settings affected the download links within the playlists. |
| 361 | |
| 362 | = 1.4.2 = |
| 363 | |
| 364 | * Introduces a title attribute in the Playlist shortcode, allowing users to specify a title that will be displayed prominently above the playlist. |
| 365 | |
| 366 | = 1.4.1 = |
| 367 | = 1.4.0 = |
| 368 | |
| 369 | * Implements two new attributes in the Playlist shortcode for filtering the products by the product categories and tags. |