Plugin Documentation

Detailed documentation about all features and settings of the Music Store.

How it works?

The Music Store is distributed as a WordPress plugin that is recognized by a clear interface and easy interaction flow. The following video tutorials describe the installation, configuration and use of the Music Store:

Music Store Premium, Installation and Use(*)
Buying Products(*)

Note: My apologies, the plugin development is ahead of the video's edition, and the interface is not totally update in the tutorial.

Installation

To install the WordPress plugin follow these steps:

  1. Download the plugin to your computer.
  2. Go to the plugins section in WordPress
  3. If has been installed another version of the plugin, deactivate it, and then press the corresponding "Delete" button.
  4. Press the "Add New" button at top of section.
  5. Press the "Upload Plugin" button, and select the zipped file downloaded in the first step.
  6. Finally, install and activate the plugin.

Setting Up the Music Store

Music Store can be set up via the menu: "Settings / Music Store". 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.

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 filtering by artist: Inserts a field into the Music Store webpage that allows to filter products by artists.

Allow filtering by album: Inserts a field into the Music Store webpage that allows to filter products by albums.

Allow multiple pages: Allows paging of music store products.

Items per page: Defines the number of products per page in the Music Store.

Use friendly URLs on products: Allows to use friendly URLs in the products pages.

Store layout: Allows select one of the multiple layouts available for the store.

Player style: Select the audio player style from the list.

Play all: Play all songs in the webpage, one after the other.

Percent of audio used for protected playbacks: Percent of audio to play in secure mode.

Explain text for protected playbacks: Text displayed below the music player in secure mode.

Share in social networks: Display a group of buttons for sharing the songs and collections in the social networks(like Facebook, Twitter and Google+)

Facebook app id for sharing in Facebook: App id for sharing the website's links in Facebook.

Payment Gateway

Enable PayPal Payments: Allows the sale of products through PayPal.

Use Paypal Sandbox: Uses the PayPal Sandox instead the real PayPal account.

PayPal email: Enter the email address associated with the PayPal account.

Currency Code: The currency code in which payments are accepted.

Currency Symbol: 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 include multiple audio files in the same purchase.

Hide the shopping cart icon from the store and products pages?: Allows to hide the shopping cart icon from the pages of the store and products, to prevent the icon be diplayed by duplicated if was inserted directly through shortcodes or widgets.

Pay what you want: The prices of products are hidden in the public webpage and in their places are displayed input boxes to let the buyers pay the amount they consider adequate. If the "Pay what you want" option is enabled then the exclusive prices are not taken into account. The amounts entered by the buyers are compared with the base price of the products and if the values are under the base prices then the Music Store displays the text entered in the "price under minimum" message.

Label of price box: Text to display above the price box if the "Pay what you want" option is ticked.

Price under minimum message: Text to display if the "Pay what you want" option is ticked, and the amount entered by the buyer is under the base price defined in the product.

Download links valid for: The download links are valid a specific number of days after the purchase.

Number of downloads allowed by purchase: Restricts the amount of downloads to a number specific of times.

Allows to pack all purchased audio files as a single ZIP file.

Increase the download page security: Requests the email used in product's purchase from the download page.

Restrict the access to registered users only: Pair of checkboxes to display the "Buy Now" buttons, and the download links for free products, for the registered users only.

Licenses: Allows enter the URLs to the web pages with the licenses for free products, regular purchases and exclusive purchases.

Note: The links to the licenses for regular or exclusive purchases are sent to the buyers in the same email with the download links. In the case of free downloads, the links to the license are displayed just beside the download links.

Discount Settings

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.

Coupons Settings

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

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 Products

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 (Fig.1)

Music Store Song Section
Fig.1 Music Store Song Section

To enter a new song press "Add New".

The interface for entering data pertaining to a song is described below (Fig. 2):

Song Edition Interface
Fig.2 Song Edition Interface

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.

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 (Fig. 3)

Music Store Collection Section
Fig.3 Music Store Collection Section

To enter a new song press the "Add New".

Collection setup interface(fig.4)

Collection Edition Interface
Fig.4 Collection Edition Interface

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.

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 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 (Fig. 5), the action displays a setup screen (Fig. 6)

Music Store Insertion Button
Fig.5 Music Store Insertion Button

Interface

Music Store Insertion Interface
Fig.6 Music Store Insertion Interface

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 prefer to insert the music store directly in template: <?php print do_shortcode('[music_store]'); ?>

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.

Music Store Shortcode and Attributes

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"]

Inserting a Product in a Page/Post

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)

Product Insertion
Fig.7 Product Insertion Interface

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: <?php print do_shortcode('[music_store_product id="3"]'); ?>

Inserting products and products list on webpages and sidebars

Inserting a Products List in a Page/Post

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)

Products List Insertion
Fig.8 Products List Insertion Interface

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: <?php print do_shortcode('[music_store_product_list columns="1" number="3" type="top_rated"]'); ?>

The shortcode for products list includes supports other attributes like:

products: to display singles and collections, or only singles, or only collections: [music_store_product_list columns="1" number="3" type="top_rated" products="collections"]

genre: accepts a genre's id or slug, or multiple genres ids and/or slugs: [music_store_product_list columns="1" number="3" type="top_rated" genre="the-genre-slug"]

album: accepts a album's id or slug, or multiple albums ids and/or slugs: [music_store_product_list columns="1" number="3" type="top_rated" album="the-album-slug"]

artist: accepts a artist's id or slug, or multiple artists ids and/or slugs: [music_store_product_list columns="1" number="3" type="top_rated" artist="the-artist-slug"]

Inserting a Counter of Products Sold in a Page/Post

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)

Insertion Interface for Sales Counter
Fig.9 Insertion Interface for Sales Counter

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: <?php print do_shortcode('[music_store_sales_counter min_length="3" style="alt_digits"]'); ?>

Inserting the Shopping Cart

Pressing the button of shopping cart inserts a shortcode in the page's content: [music_store_shopping_cart]

Available Widgets

The Available Widgets for Insert the Products, Products List and Sales Counter in the Website's Sidebars
Fig.10 The Available Widgets for Insert the Products, Products List and Sales Counter in the Website's Sidebars

Sales Report

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" (Fig. 11)

Sales Reports
Fig.11 Sales Reports

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 (Fig. 12)

Filtering Sales Report
Fig.12 Filtering Sales Report

From the "Export to CSV" button, it is possible to export the sales reports of the time interval, to a CSV file in the local computer.

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 figures.

The sales reports section includes a section to replace all purchases associated to an email address, by another email address.

Importing Multiple Audio Files at Once

To import multiple audio files at once, and create a new song for selling for each audio file, with the data embedded in the ID3 tags, press the "Songs Importer" submenu, or the tab of equal name.

Music Store Importer Section
Fig.1 Music Store Importer Section

Press the "Upload/Select files" button, to display the "Media Library" dialog. Through the Media Library is possible upload new files, or select the files uploaded to WordPress previously. The action displays the list of selected songs, with a checkbox to prevent process the file, and a delete link.

The interface of the Importer Section includes multiple options to use the ID3 tags embedded in the audio files, to generate the information of the songs, like: artist, albums names, genres, and year.

Finally, press the "Importer" button.