Difference between revisions of "Album"

From NeuCart Documentation
Jump to: navigation, search
Line 13: Line 13:
 
* The PDF product that will be added to the cart when someone uses the "Add to Cart" link for the PDF on the player. Also, a navigation link will also be created to point to that product.
 
* The PDF product that will be added to the cart when someone uses the "Add to Cart" link for the PDF on the player. Also, a navigation link will also be created to point to that product.
  
<!--
+
=== Bulk-Add Tracks by Category ===
 +
In addition to adding tracks one-by-one, the Album Form View page allows administrators to add multiple tracks at one time. By using the "Add multiple tracks from category" button, an administrator can select a category of MP3 products and add all those MP3s as tracks at once. Since most stores configure categories such that all MP3s of the same album are in one category, this functionality makes the process of creating albums much faster.
  
The NeuCart albums feature, introduced in NeuCart 4.73, allows you to configure samples of multiple tracks to play in one player. This functionality works in most modern browsers via the HTML5 audio element.  
+
=== Configure Products to Display the Album ===
 +
After an album is configured, a [[product]] must be configured to display the album. There are two ways to do this:
 +
* The common way is to set a product's "Media Player Type" to "Use NeuCart HTML5 Album Player", and then to select the name of the album that should appear for the product.
 +
* The less common option is to add magic text anywhere in the product's description. This text, in the format '''~neucart_album:2~''' (where "2" represents the ID of the album) will be replaced with the album with the ID of 2. For this reason, the album IDs display while editing albums.
  
While the functionality is referred to as an "Album", you can use the functionality for any collection of audio files that you want to display on the same page.
+
== See also ==
Configuration
+
{{nb music}}
The configuration fields for an album include context-sensitive help, so this documentation will not go into further detail on those fields.
+
 
+
Once you have configured an album, how do you get it to display on your product's detail page? There are two ways:
+
For a product's "Media Player Type" or "Mobile Media Player Type", choose "Use NeuCart HTML5 Album Player". Then select the name of the album that will appear for your product.
+
Anywhere in the product's description, you can add the text ~neucart_album:#~ and that text will be replaced with one of the albums you have configured. For example, if you add the text ~neucart_album:2~ , your album with an ID of "2" will be inserted into that position.
+
-->
+

Revision as of 02:59, 11 July 2014

An album, or perhaps more accurately an album player, is configured in NeuCart's Admin Area as a way to display multiple audio samples within one box, while having both navigation links and "Add to Cart" links in the display area. While the functionality is referred to as an "Album", this feature can be used to group any collection of products with audio files that a customer may want to see.

Information icon.svg
This feature or functionality was introduced in version 4.73.
Music Approve icon.svg
This article discusses music features or functionality.

Configuration

Within the Albums Form View page, an administrator configures the basic properties of an album, and also the individual tracks within the album. Each track is configured with:

  • The name of the track as it appears in the album player. This field can include HTML if necessary (a <br> tag to create multiple lines is common).
  • The sample audio file that will play when the play button is pressed.
  • The MP3 product that will be added to the cart when someone uses the "Add to Cart" link for the MP3 on the player. Also, a navigation link will also be created to point to that product.
  • The PDF product that will be added to the cart when someone uses the "Add to Cart" link for the PDF on the player. Also, a navigation link will also be created to point to that product.

Bulk-Add Tracks by Category

In addition to adding tracks one-by-one, the Album Form View page allows administrators to add multiple tracks at one time. By using the "Add multiple tracks from category" button, an administrator can select a category of MP3 products and add all those MP3s as tracks at once. Since most stores configure categories such that all MP3s of the same album are in one category, this functionality makes the process of creating albums much faster.

Configure Products to Display the Album

After an album is configured, a product must be configured to display the album. There are two ways to do this:

  • The common way is to set a product's "Media Player Type" to "Use NeuCart HTML5 Album Player", and then to select the name of the album that should appear for the product.
  • The less common option is to add magic text anywhere in the product's description. This text, in the format ~neucart_album:2~ (where "2" represents the ID of the album) will be replaced with the album with the ID of 2. For this reason, the album IDs display while editing albums.

See also

Music Features and Functionality

Album Audio Preferences Sample Audio Files

Learning series: Music Features and Functionality