WordPress.org

Plugin Directory

Music Store

Music Store is an online store for selling audio files: music, speeches, narratives, everything audio. In Music Store, secure payments with PayPal.

Q: Why the sales button don't show?

A: First, go to the settings page of music store and be sure the PayPal checkbox is checked, and has defined the seller's email. Second, in case of collections, be sure the collection has a price defined and songs associated. Third, in case of songs, be sure the song has a price defined and a audio file associated.

Q: Why the songs don't displays on music store?

A: If you want to sale a song as a single, it is required to check the "Sell as a single" checkbox in the song data form.

Q: Why the audio file is played partially?

A: If you decide to protect the audio file, the audio file is played partially in demo to avoid its copy by users and software unauthorized.

Q: Why the music player is not loading on page?

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"

Q: What can I do if the music-store directory exists and the premium version of plugin cannot be installed?

A: Go to the plugins section in WordPress, deactivate the free version of Music Store, and delete it ( Don't worry, this process don't modify the songs created with the free version of plugin), and finally install and activate the premium version of plugin.

Q: Does allow the music store a different payment gateway than PayPal?

A: I'm sorry, but the current version of plugin allows PayPal only.

Q: Can the customers pay directly with its credit cards?

A: The restriction is imposed by PayPal. Please, check that your PayPal account allow to charge directly from the credit cards of customers.

Q: Is possible the selling of songs in exclusive?

A: Yes, from the "Music Store pro" v5.0.16 it is possible to define exclusive prices. The songs that are purchased in exclusive, are removed from the store's page, and are moved in the administration section to a new list of products, the list of products that were sold in exclusive.

Tip: If was defined a discount for a song, it is not applied to the exclusive sales.

Q: How to display different numbers design in the sales counter?

A: To use your own numbers design, you must create a new directory with the name of new style in "/wp-content/plugins/music-store/ms-core/images/counter", and upload to the new folder, an image in gif format, for each digit from 0 to 9.

Q: Is possible modify the appearance of music store?

A: The design of each section of Music Store, is determined from templates located in "/wp-content/plugins/music-store/ms-templates".

The "ms-templates" directory contains multiple files, some of them for songs, and others for collections.

The template files:

  • song.tpl.html and collection.tpl.html are used in the Music Store's page.
  • song_single.tpl.html and collection_single.tpl.html are used in particular pages of songs and collections.
  • song_multiple.tpl.html and collection_multipl.tpl.html are used in pages of multiple entries like: archives and search result page.

Q: Is possible promote a product, or products list?

A: It is possible promote a product or products list, from the website's sidebars, or directly from the content of pages or posts.

To promote the products on sidebars, go to the widgets section, and inserts the corresponding widget on sidebar.

To promote the products from the content of pages and posts, go to the page and press the corresponding icon over the contents editor.

Q: Are safe the products' downloads?

A: The security in the access to songs files is determined in different ways.

  • The song files can't be accessed directly. The purchased files are stored in a special directory called ms-downloads, the ms-downloads directory includes a .htaccess file that forbid the access from browser. The file can be accessed only through a server side script that validates the purchase.

  • The Music Store determines the validity of download links based in two options, available in the settings page of plugin. -- It is possible define a time period, in days, where a download link is considered valid. If a user tries to download a purchased product, the Music Store checks the date of purchasing.

-- It is possible define a limit of downloads by purchase. If a user tries to download a product, the Music Store checks how many downloads have been made.

-- The Music Store may be configured to request the email address used in the purchasing to check the validity of download link.

Q: How forcing to the browser to download the songs distributed for free?

A: If a song is distributed for free, the music store redirects to the user directly to the audio file, and the browser will play the audio file, or download it, depending of headers sent by the server, and if the audio file is supported by the browser or not. Sometimes the browser plays the audio file, instead of download it.

If you want forcing the file download, you should modify the headers sent by the server. To force it, creates a .htaccess file, in "/wp-content/uploads" directory, with the following content:

    <FilesMatch "\.(?i:mp3|ogv|oga|ogg|wav)$>       
    AddType application/octet-stream mp3 ogv oga ogg wav        
    Header set Content-Disposition attachment       
    </FilesMatch>       

Q: How to forbid the access to the audio files in the "uploads" directory, from browsers?

A: The Music Store uploads the audio files to the subdirectories of "/wp-content/uploads" directory. To protect the audio files in the "uploads" directory, uploads a .htaccess file to the "/wp-content/uploads" directory, whose content would be:

    <FilesMatch "\.(mp3|wav|oga|ogg)$">     
    Deny from All   
    </FilesMatch>       

Q: Can I customize the store's design?

A: The plugin includes some different designs that can be selected through the settings option "Store Layout", but you can create a new once, duplicating an of available store's layouts, and edit its style.css file

Q: How can be hidden the popularity of the products from the store's page?

A: To hide the popularity from the store's page you, should edit the template files of store's products, located in the "/wp-content/plugins/music-store/ms-templates":

    song.tpl.html   
    song_mutiple.tpl.html   
    collection.tpl.html      
    collection.tpl.html     

Note: If you are using the free version of the plugin, your copy of plugin includes only the song templates.

  • Open the song.tpl.html and song_multiple.tpl.html files in the text editor your choice, and removes the snippet of code:

    <!-- SONG POPULARITY -->    
    <tpl ifset="song.popularity">   
    <div class="song-popularity">   
    <span class="label">popularity: </span> {song.popularity}   
    </div>  
    </tpl ifset="song.popularity">  
    
  • Open the collection.tpl.html and collection_multiple.tpl.html files in the text editor, and removes the snippet of code:

    <!-- COLLECTION POPULARITY -->    
    <tpl ifset="collection.popularity">     
    <div class="collection-popularity">     
    <span class="label">popularity: </span> {collection.popularity}     
    </div>      
    </tpl ifset="collection.popularity">        
    

Q: How can be modified the size of audio files that are played in safe mode?

A: The files for demo can be generated dynamically by the plugin (in the pro version of the plugin), to avoid that users can download the original files without purchase them.

From the settings page of the store is possible define the percentage of the audio file for demo, and the plugin creates a copy of the audio file, truncating the original file to be used for demo.

To protect the resources of web server, the music store does not generates the audio files for demo, each time a song is played, the music store uses the files created previously, that are stored in the "ms-temp" directory. So, after modify the percentage of audio file for demo, you should delete the files located in the "/wp-content/plugins/music-store/ms-temp" directory.

Note: If you are using the Pro version of the plugin, greater than or equal to 5.0.2, it is not required delete the files in the "ms-temp" directory, the files are deleted dynamically by the plugin, when the percentage of the audio file for demo is modified.

Q: How to display the tracks list in the collections pages with a predetermined order?

A: The tracks are associated to the collections through the "Songs of collections" list. Each time a song is selected, the plugin generates a button over the songs list. The order followed in the songs selection, would be the same order in the tracks list on the public webpage.

Q: How I can sell only collections, and not individual songs?

A: To sell only collections, and not individual songs, you only should uncheck the checkbox: "Sell as a single", from the songs.

In this case the "filtering by type" is not necessary in the store's page, so, to hide this filtering option, you only should go to the store's settings and uncheck the option "Allow to filter by type"

Q: It is possible to sell different versions of a song?

A: In our plugin each song includes only one audio file for selling. If you need sell different versions of a same song, for example, full song, ring tone, etc. each of them with their own price, you should use collections.

First, creates all songs by separated, with its corresponding audio file and price.

Second, for each title, creates a collection, and selects all songs versions, created in the first point, corresponding to the title, and assigns a price to the collection.

Third, use the attribute: load="collections", in the store's shortcode.

Fourth, and finally, the "filtering by type" won't be needed in the store's page, go to the store's settings and untick the option "Allow to filter by type"

Q: How can be modified the store's settings in a specific page?

A: The store is inserted in a page through the shortcode [music_store].

The [music_store] shortcode accepts a list of attributes to configure a specific store.

load: With the "load" attribute can be selected the elements to be loaded by default in the store ("singles", for loading only songs, and "collections" to load only the songs collections). If you want sell in the store singles and collections, you don't need to include the "load" attribute.

    [music_store load="collections"]        
    [music_store load="singles"]        

columns: Enter the number of columns to display the products in the store with a grid format. By default the value of "columns" attribute is 1.

    [music_store columns="3"]       

genre: To display in the store only the songs and collections that belong to a specific genre, should be defined the "genre" attribute with the genre's slug, or the genre's ID.

    [music_store genre="pop"]     
    [music_store genre="2"]     

Note: To determine the genre's ID, go to the menu option "Music Store > Set Genres", press the "edit" link of genre, and pay attention to the URL in the browser, the genre ID is passed as the parameter "tag_ID"

artist: To display only the products of a specific artist, defines the "artist" attribute with the artist's slug, or the artist's ID.

    [music_store artist="artist-name"]        
    [music_store artist="3"]        

Note: To determine the artist's ID, go to the menu option "Music Store > Set Artists", press the "edit" link of artist, and pay attention to the URL in the browser, the artist's ID is passed as the parameter "tag_ID"

album: To display only the products in a specific album, defines the "album" attribute with the album's slug, or the album's ID.

    [music_store album="let-it-be"]        
    [music_store album="12"]        

Note: To determine the album's ID, go to the menu option "Music Store > Set Albums", press the "edit" link of album, and pay attention to the URL in the browser, the album's ID is passed as the parameter "tag_ID"

You can use to a combination of parameters in the same shortcode:

    [music_store columns="3" load="collections"]        

From the shortcode it is possible to hide the elements in the header section of the music store's page: the filtering options, or the "order by":

filter_by_type: The values allowed are 1 or 0, and shows or hide the filtering by product's type.

    [music_store columns="3" filter_by_type="1"]        

filter_by_genre: The values allowed are 1 or 0, and shows or hide the filtering by genre.

    [music_store columns="3" filter_by_genre="1"]        

filter_by_album: The values allowed are 1 or 0, and shows or hide the filtering by album.

    [music_store columns="3" filter_by_album="1"]        

filter_by_artist: The values allowed are 1 or 0, and shows or hide the filtering by artist.

    [music_store columns="3" filter_by_artist="1"]        

show_order_by: The values allowed are 1 or 0, and shows or hide the "Order by" options.

    [music_store columns="3" show_order_by="1"]     

order_by: The values allowed are: plays, price, post_title, post_date. Allows ordering the products in the store's page by the criteria defined in the attribute.

    [music_store columns="3" order_by="post_title"]        

Q: I've inserted a shortcode to insert a particular song in a page; but it is loading with the same layout that the songs in the store. Can be loaded the song or collection with all fields, with the layout used in the particular page of the product?

A: The shortcode to insert a product has the structure: [music_store_product id="10"]. The "id" attribute represents the product's id. The products' ids are displayed as the first column in the songs or collection lists.

The product's shortcode accepts another attribute, to decide the layout to use: the "single" layout, with all the product's fields, or the "store" layout, with the fields that are displayed in the store's page.

    [music_store_product id="10" layout="single"]       
    [music_store_product id="10" layout="store"]        

Q: Is there any restriction on the size of the audio files to upload to the server?

A: The limit in the files sizes to be upload to the server is not imposed by the plugin. The Music Store delegates the upload process to the Media Library of WordPress. The limits are imposed by directives in the PHP.ini file, directly by your hosting provider.

If you need additional information about the PHP directives involved in this process, visit the following link: http://php.net/manual/en/ini.core.php#ini.post-max-size

Q: Are there any restriction in the download the purchased files in a zipped file?

A: The zipped files are created in memory, so the PHP script in your web server, should manage the amount of memory sufficient to create the zipped file with all purchased audio files. To take an idea about the amount of memory required, uses as reference the peak in the sum of size of audio files in the bigger purchase, before enabling the zip option.

Q: A customer that has purchased a product from the store, has not downloaded the song in the time interval defined in the store's settings. What can I do in this case?

A: In this case you only should go to the sales reports of the store, through the menu option: "Music Store/Sales Report", and select the time period where the purchase was made. In the product list will be displayed all sales in the time interval selected. Finally, you should press the "Reset Time and Downloads" button corresponding to the customer's purchase.

Now, your user can download the product by a new time period.

Q: How to know the products purchased for a customer?

A: Go to the sales reports, and type the customer's email in the input box named "buyer", and select a time interval where could be occurred the sales, and finally press the "Search" button.

If you are not sure about the customer email, you can use a partial email address ( is not necessary to know the exact email address). About the time interval, if you are not sure about the date where the sales occurred, select as the "From" data a sufficient far away date.

Q: How can be customized the download page?

A: The download page is a special page, that is populated at runtime. By default the page is empty, but the download links are added at the end of page when it is visited by the users. This page, can be edited like any other page in WordPress. You simply should open the page for edition, and modify its content.

I suggest you that the last information in your download page, be a text indicating that the links below are the download links to the purchased files.

Q: Why the customers are not receiving the download links after purchase the songs?

A: Please, be sure you have enabled the IPN (Instant Payment Notification) in your PayPal account. If the IPN is not enabled in your PayPal account, the website is not notified after the payments, and the download link is not generated, and the notification email with the download link is not sent to the customers.

PayPal will ask you for the URL of the IPN in the activation process, use the URL to your website's homepage to activate the IPN, because the "Music Store" will send to PayPal the correct IPN's URL.

Q: The IPN is enabled in my PayPal account, but the customers are not receiving the emails with the download links.

A: If the IPN is enabled in your PayPal account, and the purchases have been registered in the sales report, but your customers are not receiving the emails with the download links, there are two probable reasons:

  1. The email should be sent through SMTP. In this case you should install in your WordPress one of the available plugins for SMTP integration, in the WordPress directory.

  2. The web server allows send emails directly, but the email address entered in the "Notification from email" attribute, is an email address that not belongs to the same domain of the website. In this case, the main email services classify the emails as a possible identity fishing, and delete the email by security. You should enter in this attribute an email address belonging to the same website's domain.

Q: How the customers can return automatically to the download page after purchase a song?

A: This option is related directly with the PayPal settings, and not with the Music Store. Please, follows the indications below:

Note: The description applies for the new interface of PayPal.

From the homepage of your PayPal account, press the "Seller preferences" option. In the seller's profile there is an option titled "Website preferences", with the text "Bring customers back to my website after they pay with PayPal.", please, press the "change" link associated with this option, and set the auto return to "ON". PayPal requires you enter the URL to the return page, use in this case the URL to your website's homepage, because the Music Store sends the correct URL in the sale process.

PayPal notifies the payments to the website asynchronously, so can occur that the user returns to the download page, before the payment notification, so, the sale has not been registered yet. In this case the download page displays a timer, and checks again the validity of purchase.

Q: The download page is displaying a 404 Error, page not found

A: By default the Music Store generates the page called "Download Page", with its content empty. The content of the "Download Page" is generated dynamically with the download links to purchased products, but sometimes, the websites administrators decide delete this page because think that is not important. If it is the case you only should restore the download page, from the trash list, to the list of published pages. If you have emptied the trash list, you only should create a new page with the slug: ms-download-page

Q: The shopping cart page is displaying a 404 Error, page not found

A: By default the Music Store generates the page called "Shopping Cart", with its content empty. The content of the "Shopping Cart" page is generated dynamically, and includes a table with the products selected, a button to continue shopping, a button to complete the payment, and the input box for entering the coupon code, but as its content is empty by default ( its content is generated in execution time ), the websites administrators sometimes decide delete this page because think that is not important. If it is the case you only should restore the shopping cart page, from the trash list, to the list of published pages. if you have emptied the trash list, you only should create a new page with the slug: ms-shopping-cart

Q: Can be sold tangible products with the music store?

A: For selling tangible products, like CDs, DVDs, etc. is required an additional module for asking to the customers its postal address, furthermore will be required add to the products prices the shipping cost, and finally accept the selection of number of copies. With the Music Store, none of these modules are included, because are not needed for selling digital files, this is the reason our plugin is recommended only for selling digital files.

Q: Can be created multiple products at time, or should be created one by one?

A: The pro version of the Music Store includes a new section (the importer section) that allows create multiple products at the same time. The better results are obtained if the audio files have defined the ID3 tags with the correct information.

To proceed importing multiple songs, follow the steps below:

  1. Go to the menu option: "Music Store/Songs Importer"

  2. Press the "Upload/Select files" button to display the "Media Library". From the media library it is possible select the files existent in the library, or activate the "Upload Files" tab, and upload new files to the library.

  3. Enter a base price that will be applied to all imported songs.

  4. Check any of the attributes: artist, albums names, genres, or year, if you want extract the artist name, the album name, the genre, or the year, from the ID3 tags of the MP3 files, and assign these data to the imported products.

  5. Finally, press the "Import" button.

The importer will create a new product for each audio file, with the information included in the ID3 tags.

Requires: 3.5.0 or higher
Compatible up to: 4.2.2
Last Updated: 2015-7-6
Active Installs: 3,000+

Ratings

3.7 out of 5 stars

Support

6 of 9 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says it works.
0 people say it's broken.

100,1,1
100,5,5
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
0,1,0 100,1,1
100,1,1 100,1,1