=== Music Store === Contributors: codepeople Donate link: http://wordpress.dwbooster.com/content-tools/music-store Tags:audio,audio player,music,music player,e-commerce,ecommerce,facebook,google,google+,html5,mp3,ogg,wav,paypal,player,secure player,sell music,sell,shop,sidebar,social,social network,songs,store,twitter,widget,post,plugin,posts,page,admin,image,images,comments,shortcode Requires at least: 3.5.0 Tested up to: 4.2 Stable tag: 1.0.16 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Music Store is an online store for selling audio files: music, speeches, narratives, everything audio. In Music Store, secure payments with PayPal. == Description == Music Store features: ♪ Allows selling audio files via PayPal ♪ Allows a custom setup of the online store ♪ Includes an audio player that supports formats: OGA, MP3, WAV, WMA ♪ Includes multiple layouts for the Music Store ♪ Allows sharing songs in social networks (ex: Facebook, Twitter, Google+) ♪ Supports all most popular web browsers and mobile devices ♪ Includes a module to track sales statistics Music Store is an online store for selling audio files: music, speeches, narratives, everything audio. With Music Store your sales will be safe, with all the security PayPal offers. Music Store protects your audio files, preventing them from being downloaded without permission. Music Store includes an audio player compatible with all major browsers: Internet Explorer, Firefox, Opera, Safari, Chrome and mobile devices: iPhone, iPad, Android. The audio player is developed following the html5 standard; in old browsers the music player uses alternative technologies like Flash and Silverlight. The Music Store audio player supports the following file formats: MP3, WAV, WMA and OGA. **More about the Main Features:** * Allows selling audio files via PayPal. * Allows a custom setup of the online store, with ability to paging and sorting the results by popularity or price. * Allows to associate additional information to the products. * Includes an audio player that supports formats: OGA, MP3, WAV, WMA. * Allows to share the songs and collections in the social networks (like Facebook, Twitter and Google+). * Supports all most popular web browsers: Internet Explorer, Firefox, Chrome, Safari, Opera, and mobile devices such as iPhone, iPad and Android. For older browsers, the media player provides support for Flash and Silverlight. * Includes a module to track sales statistics, with animated charts. The base plugin, available for free from the WordPress Plugin Directory has all the features you need to create an Music Store on your website. **Premium Features** * Allows selling collections. Audio files can be grouped into collections or albums (advanced version of plugin). * Includes a shopping cart * Offers secure Audio Playback that prevents unauthorized downloading of audio files. * Allows to filter products by types of files: Singles or Collections. * Allows selling product exclusively. * Allows to create discounts. * Allows to entering discount coupons. * Allows to insert a Song or Album in a post, page or template. In the Free version of plugin, the songs and albums are available only from the Music Store webpage, in the premium version of plugin is possible to insert the songs and collection directly in a post, page, or template. * Allows to insert a list of products in a post, page or template. In the Free version of plugin, the songs are available only from the Music Store webpage, but in the premium version Music Store is possible to insert list of products directly in a post, page, or template. The list can load the top rated products, the newest products, or the top selling. * Allows to insert a counter of sold products in your website. * Allows to insert a product, a products list, or a sold products counter, as a widget in the website sidebars. * Allows to import multiple audio files at once, and extracts the information of the songs, like: title, artist, genres, albums names, and year, from the ID3 tags. **Demo of Premium Version of Plugin** [http://demos.net-factor.com/music-store/wp-login.php](http://demos.net-factor.com/music-store/wp-login.php "Click to access the Administration Area demo") [http://demos.net-factor.com/music-store/](http://demos.net-factor.com/music-store/ "Click to access the Public Page") **Important** The theme used in your website, should include the wp_footer function in the footer.php template or the index.php template. Are safe the downloads links? 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 three 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. If you want more information about this plugin or another one don't doubt to visit my website: [http://wordpress.dwbooster.com](http://wordpress.dwbooster.com "CodePeople WordPress Repository") [youtube http://www.youtube.com/watch?v=IIuf2otMFyM] Installing and using the free version of the Music Store [youtube http://www.youtube.com/watch?v=bl5qDtJ4eHo] Installing and using the premium version of the Music Store [youtube http://www.youtube.com/watch?v=hgMCAehy2N0] Inserting a product, and product list, on a web page and sidebars. Premium version of plugin. == Installation == **To install Music Store, follow these steps:** 1. Download and unzip the plugin 2. Upload the entire "music-store" directory to the "/wp-content/plugins /" directory 3. Activate the plugin through the 'Plugins' menu in "WordPress" 4. Go to Settings > Music Store and set up your store. == Interface == **Setting up Music Store** Music Store can be set up via the menu: "Settings / Music Store" or the new submenu "Music Store / Store Settings". The setup screen offers general settings for the Music Store, allows to enter PayPal data to process sales, and texts necessary for email notifications. **Settings Interface** The setup interface includes the following fields: * Music Store URL: Enter the URL of the webpage where the Music Store is inserted. The URL of the store will be used to return from the product page to the store page. Tip: If the Music Store URL is defined, the list of songs that belong to an album, artist or genre, are displayed in the same page of music store, with the corresponding options for filtering. * Allow to filter by type: Inserts a field into the Music Store webpage that allows to filter products by type (including Singles, Collections or all products) * Allow to filter by genre: Inserts a field into the Music Store webpage that allows to filter products by their genre. * Allow to filter by artist: Inserts a field into the Music Store webpage that allows to filter products by the artist. * Allow to filter by album: Inserts a field into the Music Store webpage that allows to filter products by the album they belong. * Allow multiple pages: Allows paging of music store products. * Store layout: Allows select one of the multiple layouts available for the store. * Items per page: Defines the number of products per page in the Music Store. * Player style: Select the audio player style from the list. * Percent of audio used for protected playbacks: Percent of audio to play in secure mode (advanced version of plugin). * Explain text for protected playbacks: Text displayed below the music player in secure mode (advanced version of plugin). * Share in social networks: Display a group of buttons for sharing the songs and collections in the social networks(like Facebook, Twitter and Google+) **Payment gateway data** * Enable PayPal Payments: Allows the sale of products through PayPal. * PayPal email: Enter the email address associated with the PayPal account. * Currency: Symbol of the currency in which payments are accepted. * PayPal language: Preferred language of the PayPal interface. * PayPal button: Select the PayPal button design. * or use a shopping cart: Allows to activate a shopping cart, in place of sell each product separately (advanced version of plugin). * Increase the download page security: Requests the email used in product's purchase from the download page. * Pack all purchased audio files as a single ZIP file: Allows to download all files in the same purchase as only one zipped file. This option may be limited by configurations of the web server (advanced version of plugin). **Discount Settings (advanced version of plugin)** * Display discount promotions in the music store page: Allows to display all discounts promotions at the bottom of music store. * Percent of discount: Enter the percent of discount to the sell price. * Valid for sales over than: Condition for apply the discount. * Valid from: First day to apply the discount rules. * Valid to: Last day to apply the discount rules. * Promotional text: Text for promote the discounts. **Coupon Settings (advanced version of plugin)** * Percent of discount: Enter the percent of discount to the sell price. * Coupon: Enter a valid coupon code. * Valid from: The coupon is valid from start date. * Valid to: The coupon is valid until end date. **Notification Settings**, both for buyers to complete a payment, and the store manager * Notification "from" email: E-mail address that will appear as the sender of notifications. * Send notification to email: Email address where a notification is sent after each sale. * Subject of user confirmation email: Subject of the confirmation email sent to the customer when making the purchase. * Email confirmation to user: Body of message sent to the client when making the purchase. The message should include the tag %INFORMATION% which will be replaced by the purchase data. * Subject of email notification to admin: Subject of email notification sent to the administrator when a purchase is made. * Email notification to admin: Body of the email message sent to the administrator when a purchase is made. The message text should include the tag %INFORMATION%, which will be replaced by the purchase data. **Creating content** Two types of products can be sold through the Music Store: songs or collections. **Creating songs** To enter a song in the store please press the menu option "Music Store Song" to open the relevant section. Initially it displays the list of songs entered previously and a set of data associated with the song (screenshot-2) To enter a new song press "Add New". The interface for entering data pertaining to a song is described below (screenshot-3): * Enter Title Here: Enter the title of the song. * Description: Description of the song. This field is optional, but offers the opportunity to provide additional information about the song or the authors. * Sales Price: Retail price of the song. * Sales Price(Exclusively): Price for selling songs in exclusive. A song sold in exclusive is removed from the store's page. * Comes as a single: To allow sale of song as a single, mark the checkbox. If the checkbox is left unchecked, the song can only be sold as part of a collection. * Audio file for sale: URL of the audio file to sell. The button associated with the field displays the WordPress media gallery making it easy to select the file. * Audio file for demo: URL file audio demo. The button associated with the field displays the WordPress media gallery making it easy to select the file. * Protect File: Checkbox that enables secure playback of the song to avoid being downloaded while testing. The safe playback is created by cutting the track and not allowing it to download completely. Users who try to steal audio files, only get a snippet of the song. Note: If a song is not defined as demo but the Protect File field is marked, then this file will also be used for demo purposes. * Artist: Select the artist (or artists) from the list or enter a new one if it is not yet on the list. * Album including the song: Select the album or albums where the song is included or enter a new one. Note: The album field is purely informative and has no impact on collections for sale. * Cover: URL of the cover image. The button associated with the field displays the WordPress media gallery making it easy to select the file. * Duration: Enter the duration of the song. * Publication Year: Enter the year of the song. * Additional Information: URL of a webpage with additional information about the song. To define discounts in product's price for specific dates(advanced version of plugin). * New price: The price of product in discount dates. * Valid from: First day of discounting. * Valid to: Last day of discounting. * Promotional text: Text for promote the discounts. The column on the right includes a form to enter the song's genre. **Creating collections** To enter a song in the store, please press the menu option "Music Store Collection" to open the relevant section. It initially displays the list of collections entered previously, as well as a set of data associated with the track (screenshot-4) To enter a new song press the "Add New". Collection setup interface: (screenshot-5): * Enter Title Here: Enter the title of the collection. * Description: Description of the collection. This field is optional, but provides the opportunity to enter additional information on the collection or authors. * Sales Price: Retail price of the collection. * Sales Price(Exclusively): Price for selling collections in exclusive. A collection sold in exclusive is removed from the store's page. * Songs of collection: Select songs to be sold as part of the collection. The songs must have been previously defined in the section of songs and be public. If the song is still being edited, it can not be added to the collection. * Artist: Select the artist (or artists for the collection) from the artists list or enter a new one if it is not yet on the list. * Cover: URL of the cover image. The button associated with the field displays the WordPress media gallery making it easy to select the file. * Publication Year: Enter the year of the collection in case it represents an album. * Additional Information: URL to a webpage with additional information on the collection. To define discounts in product's price for specific dates(advanced version of plugin). * New price: The price of product in discount dates. * Valid from: First day of discounting. * Valid to: Last day of discounting. * Promotional text: Text for promote the discounts. The column on the right includes a form to enter the collection’s genre. **Publishing the Music Store** The Music Store can be posted on a page or post of WordPress. To insert the Music Store go to the relevant section (page or post) and select where you want the Music Store, or create a new page / post. In the editing section of the page/post, press the Music Store insertion button (screenshot-6), the action displays a setup screen (screenshot-7) **Interface for insertion dialog of Music Store** * Filter results by products type: by default, displays only products that belong to a specified type. * Columns: Defines the number of columns for the store products. * Filter results by genres: By default, displays the products filtered by specified genre. * Filter results by artist: Displays the products filtered by artist. * Filter results by album: Displays the products filtered by album. The insertion process generates a shortcode which will be replaced by the store when it is displayed on the website. The shortcode in a post or page has the structure [music_store], if prefere to inser the music store directly in template: Note: After inserting the store on a page of your WordPress, it is advisable to copy the URL of the relevant page, and enter in the Music Store's setup section, to allow the users to return to the store from the product page. **Interface for insertion dialog of product (Song or Collection) in a page or post (the interface is available as a widget for inserting a product in the website's sidebars) (this option is available only for premium version of Music Store)** * Enter the Song or Collection ID: the ID of a song or collection appear in the product URL. The insertion process generates a shortcode which will be replaced by the product data when page is displayed on the website. The shortcode in a post or page has the structure [music_store_product id="3"](replace the number 3 by the ID of song or collection), if prefer to insert the product directly in template: **Interface for insertion dialog of product list in a page or post (the interface is available as a widget for inserting the products list in the website's sidebars) (this option is available only for premium version of Music Store)** * Select the type of products list (top rated products, the newest products, or the top selling). * Enter the number of products to display on list. * Enter the number of columns(if the products list is inserted in a website's sidebar, it is recommended to use only one column). The insertion process generates a shortcode which will be replaced by the products list when page is displayed on the website. The shortcode in a post or page has the structure [music_store_product_list columns="1" number="3" type="top_rated"], if prefer to insert the product directly in template: **Interface for insertion dialog of sales counter in a page or post (the interface is available as a widget for inserting the counter in the website's sidebars) (this option is available only for premium version of Music Store)** * Select the numbers design. * Enter the minimum length of counter number. The insertion process generates a shortcode which will be replaced by the counter when page is displayed on the website. The shortcode in a post or page has the structure [music_store_sales_counter min_length="3" style="alt_digits"], if prefer to insert the product directly in template: **Sale Statistics** When a sale takes place, a notification email is sent to the Music Store administrator. However, sales can also be reviewed in Sales Reports. To do this, go to the stores' setup page: "Settings / Music Store" and once there, open the section "Sales Reports" (screenshot-9), or go to the "Sales Reports" from the "Music Store" submenu: "Music Store / Sales Report" The Reports section allows you to filter sales reports over a specific period, by default it shows the current day's sales. It also shows sales' totals for the selected period and the currency of the sales (screenshot-10) After select a specific time period it is possible to load some charts with graphical information about sales. For example: Sales by country, sales by currencies and sales by products. You can delete a sales report from the list of sales. This may be useful in case of a refund granted to a buyer, and allows to keep your sales statistics updated with the actual purchases. **Translations** The Music Store uses the English language by default, but includes the following language packages: * Spanish * French * German * Dutch Note: The languages packages are generated dynamically. If detects an error in the translation, please, contact us to correct it. == Frequently Asked Questions == = 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: 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: AddType application/octet-stream mp3 ogv oga ogg wav Header set Content-Disposition attachment = 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:
popularity: {song.popularity}
- Open the collection.tpl.html and collection_multiple.tpl.html files in the text editor, and removes the snippet of code:
popularity: {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. == Screenshots == 01. Music Store Item 02. Music Store Song Section 03. Song Edition Interface 04. Music Store Collection Section 05. Collection Edition Interface 06. Music Store Insertion Button 07. Music Store Insertion Interface 08. Product Insertion Interface 09. Products List Insertion Interface 10. Insertion Interface for Sales Counter 11. The Available Widgets for Insert the Products, Products List and Sales Counter in the Website's Sidebars 12. Filtering Sales Report 13. Sales Reports 14. Available layouts 15. Songs Importer Section == Changelog == = 1.0.16 = * Includes changes in the store's layouts, and modifies the interface for the songs edition. The premium version of the plugin allows selling products exclusively. = 1.0.15 = * Corrects an open redirect vulnerability = 1.0.14 = * Corrects a conflict in the sales reports, with the Sell Downloads plugin. = 1.0.13 = * Modifies the store's layouts. = 1.0.12 = * Modifies the styles in the dark layout. = 1.0.11 = * Modifies the way that post types are registered to allow using custom permalinks. = 1.0.10 = * Modifies the appearance of the music store. = 1.0.9 = * Implements a new feature in the Music Store plugin, and modifies its interface. = 1.0.8 = * Modifies the styles of the filtering section, in the store's page. = 1.0.7 = * Improves the extraction of the URL of website in a multisite WordPress installation. * The Pro version includes a download link with the collections that are distributed for free, to allow download all audio files in an unique zipped file. = 1.0.6 = * Includes the Featured Image as part of songs, and collections, because some plugins and themes use the featured Images on post types. * Uses functions included since WordPress 3.5.0, that modifies the requirements. = 1.0.5 = * Modifies some styles in the store to prevent conflicts with the styles defined by the themes. = 1.0.4 = * Improves the selection of website's URL. = 1.0.3 = * Combines the filtering options in the store with AND, in place of OR, returning more coherent results. * Corrects an ambiguity in the filtering options when the name of Album, or the Artist are simple numbers. = 1.0.2 = * Displays the number of products returned by the filtering combinations. * Improves the appearance of the store in mobiles devices. = 1.0.1 = * Improves the plugin documentation. * Fixes an issue with tabs in pages of songs and collections. * Modifies some styles associated to the pages of songs. * Increases the security of purchased files. * Improves the visualization of products prices. * Modifies the design of download page. * Allows ordering the products in the store by publication date. * Allows to insert multiple pages, with separated music stores. * Improves the design of Music Store in mobile devices. * Allows sharing the pages of the songs in the social networks. * Optimize the queries to database. * Modifies the design of the lists of artists, albums and genres, in the music store pages. * Includes a column with the IDs of the products, in the products list on admin section. * Checks the available memory on web server to avoid errors downloading the purchased files. * Corrects the content-type headers, in the download process. * Fixes an issue with the covers of the songs. * Improves the store visualization in themes with responsive designs. * Restores the original file name of purchased file in the download process. * Includes new features in the sales reports for filtering the sales for different criteria, and includes charts to follow the sales trend easier. * Allows define a limit of downloads by product purchased, and reset the download links. * Fixes an issue in the store's pagination. * Includes multiple layouts. * Includes the option for filtering the songs by album. * Set a timeout in the download page if the IPN has not been notified from PayPal. = 1.0 = * First version released. == Upgrade Notice == = 1.0.16 = * Includes changes in the store's layouts, and modifies the interface for the songs edition. The premium version of the plugin allows selling products exclusively. Important note: If you are using the Professional version don't update via the WP dashboard but using your personal update link. Contact us if you need further information: http://wordpress.dwbooster.com/support = 1.0.15 = * Corrects an open redirect vulnerability = 1.0.14 = * Corrects a conflict in the sales reports, with the Sell Downloads plugin. = 1.0.13 = * Modifies the store's layouts. = 1.0.12 = * Modifies the styles in the dark layout. = 1.0.11 = * Modifies the way that post types are registered to allow using custom permalinks. = 1.0.10 = * Modifies the appearance of the music store. = 1.0.9 = * Implements a new feature in the Music Store plugin, and modifies its interface. = 1.0.8 = * Modifies the styles of the filtering section, in the store's page. = 1.0.7 = * Improves the extraction of the URL of website in a multisite WordPress installation. * The Pro version includes a download link with the collections that are distributed for free, to allow download all audio files in an unique zipped file. = 1.0.6 = * Includes the Featured Image as part of songs, and collections, because some plugins and themes use the featured Images on post types. * Uses functions included since WordPress 3.5.0, that modifies the requirements. = 1.0.5 = * Modifies some styles in the store to prevent conflicts with the styles defined by the themes. = 1.0.4 = * Improves the selection of website's URL. = 1.0.3 = * Combines the filtering options in the store with AND, in place of OR, returning more coherent results. * Corrects an ambiguity in the filtering options when the name of Album, or the Artist are simple numbers. = 1.0.2 = * Displays the number of products returned by the filtering combinations. * Improves the appearance of the store in mobiles devices.