The Jamco Media Albums plugin extends the built-in WordPress playlist shortcode, allowing the user to add detailed information about an album or playlist, including track descriptions, purchase/listening options, and other album information.

Settings

Album settings are divided into three categories: General settings, album section headings, and album list (archive) settings.

General Settings

Album Slug
Used when setting individual permalinks for each album, or when viewing the albums list (archive) page.

Default Track Artist
Value to use if an imported audio is missing the artist name.

Use Album Name for Track Album
If an imported track is missing the album name, use the album’s title as the album name.

Include Track Numbers in Tracks List
When displaying an album, prepend the track name with it’s numeric position in the album tracks.

Playlist Control Style
Which WordPress playlist style to use when displaying the playlist. Available options are Light or Dark.

Exclude Albums from Site Search
Use if you prefer not to have album details included in your global site search. When left unchecked, this can be set on an album by album basis.

Noindex All Albums
Use to discourage search engines from crawling your album pages.

Delete All Plugin Data on Uninstall
Check this option to remove all album post data and settings from the database when the plugin is removed.

Album Section Headings

Each of these entries corresponds to the headings displayed for each section on individual album pages. If left blank, the heading will not be displayed for that section. Individual headings can also be overridden on any album page.

Albums List Settings

These settings correspond to text used when displaying the albums list (archive) page, and the link back to the albums list from any album page.

Add/Edit Album

To add an album, click the Add Album button from the albums list or from the edit album page.

Primary Sections

Album Description

Rich text field used to describe the album or provide album details. This description will be displayed on the album page, the albums list, and can be shown within shortcodes as needed.

Tracks

List of tracks for the album along with settings for the Tracks section on the album page.

Override Track Listing heading text
Check this to enable entering custom track heading text for this album. If you prefer not to display a heading for the tracks section, you can either set the global heading text to empty, or check this checkbox and leave the text field blank.

Update the original media files’ title, description, artist and album on save
WordPress stores metadata for media files when they are uploaded to the media library. If you plan to reuse media files across your site and want to update those metadata values, check this checkbox and those values will be updated when you save the album. Note that this checkbox defaults to unchecked, so you must check this anytime you save your album if you wish to update the media metadata.

Add Tracks
To add one or more track, click the Add Tracks button. From there you can selected uploaded audio files from the media library, or upload new files as needed.

Files will be added to the track list in the order they are selected, but once added you can change the order of the tracks as needed.

Track List Management
In addition to adding tracks, you can reorder or remove tracks as needed.

1. Drag to Reorder
Using the three horizontal lines, you can drag a track to a new position on the page

2. Actions: Move track up/down/remove track
The action buttons allow you to perform one of three tasks on a track; you can move the track up one position, down one position, or remove it entirely.

Reviews

This section is intended for overviews of reviews your album has received, and will be displayed immediately after the album cover, description, and playlist on the album page.

As with the tracks section heading, you can override or remove the reviews section heading text.

Purchase Options

The Purchase Options section allows you to choose from various platforms to display link buttons on the album pages where visitors can purchase or listen to your album.

Click Add Purchase Option to add a provider, and choose from the list of platforms. One you’ve selected a provider, enter the URL pointing to your album/music listing on that platform.

If your provider is not listed, choose Other and enter text to be displayed on the button along with the URL to your album/music listing. Each option listed will be displayed as a button on the appropriate page.

Like the tracks list, you can rearrange the list of providers to your preferred order.

Production Details

Use the Production Details section to list production information, such as producer, engineer, recording dates, or personnel.

Other Notes

The Other Notes section can be used for any additional information about your album.

Sidebar Sections

Album Cover

Cover image to display.

Release Date

Release date is used for the display order of albums on the albums list (archive) page. Albums without a release date will be displayed alphabetically after the last album with a release date set.

Hide Track List

Hides the track list section on the album page. Useful if your tracks lack detailed descriptions or you prefer to only display the album playlist.

Search Engine Visibility

When checked discourages search engines from indexing your album pages.

Shortcodes

Shortcodes are available to embed album information on any page.

jamco_album
Displays the album information with selected sections.

Parameters:

  • id – The album ID (required)
  • title (default: false)
  • description (default: true)
  • purchase_links (default: true)
  • playlist (default: true)
  • reviews (default: false)
  • tracks (default: false)
  • notes (default: false)
  • production (default: false)
  • link_to_album (default: true)

Except for id, all parameters are optional, and accept “true” or “false” as values. Include desired parameters in the shortcode override default settings. For example:

[jamco_album id="1234" purchase_links="false" link_to_album="false"]

The album cover image will always be displayed with this shortcode.

jamco_playlist
Displays the album playlist, with a small set of optional sections.

Parameters:

  • id – The album ID (required)
  • title
  • album_cover
  • description
  • link_to_album

Except for id, all parameters are optional, accept “true” or “false” as values, and default to false. To display additional sections, include those parameters set to true.

[jamco_playlist id="1234" album_cover="true"]