PowerPress Playlist Shortcode

The Blubrry PowerPress Playlist shortcode is a playlist shortcode based on the WordPress playlist shortcode designed specifically for podcasting. Styling and functionality is the same, though shortcode options are different.

[powerpress_playlist]

The PowerPress Playlist shortcode is available in PowerPress 6.0 and newer.

Note: The short code must be entered in lowercase.

Note: “list” refers to the actual list of episodes, “now playing” refers to the currently playing episode at the top of the playlist.

Enable the PowerPress Playlist

To enable, go to PowerPress Settings page, scroll to the bottom to the section titled “Advanced Options”. Check the box for “PowerPress playlist player” and then click ‘save changes’.

PowerPress Playlist Shortcode Attributes

The Blubrry PowerPress shortcode supports many optional attributes for customizing the playlist.

The following attributes control the look and function of the playlist:

  • limit – Set limit to number of episodes in the list (default is 10)
  • type – Specify the type of playlist either ‘audio’ (default) or ‘video’
  • style – Specify the playlist style ‘light (default), ‘dark’, or custom
  • images – Display podcast artwork in the now playing area, ‘true’ (default) or ‘false’
  • image – Set a specific default image to display in the now playing area, (.e.g. http://example.com/path/to/image.png)
  • itunes_subtitle – Display the iTunes subtitle in the now playing area, ‘true’ or ‘false’ (default)
  • date – Display post date in the list, ‘true’ (default) or ‘false’
  • title – NOTE: The list and the currently playing episode will always have the blog post title.
  • links – Provide links to post page in the now playing area, ‘true’ (default) or ‘false’
  • ids – Specify a comma separated list of blog post IDs to display within the playlist exclusively. (For PowerPress 7.0+)

The following attributes control which episodes based on podcast channel, category podcasting, post type podcasting, and/or taxonomy podcasting appear in the playlist:

  • channel – Specify the channel/feed post type slug name for custom podcast channels or custom podcast post types
  • post_type – Specify post type for custom post type podcasting
  • category – Specify a category, value can be either the category ID, slug, or name (ID is optimal)
  • term_taxonomy_id – Specify a specific term taxonomy ID (for Taxonomy podcasting)
  • program_titles_by_taxonomy – Specify taxonomy to display program title in playlist (e.g. ‘category’ to display category program titles (EXPERIMENTAL)

Simple Example using playlist to display latest 10 audio episodes in a page

[powerpress_playlist]

Example playlist using specific poster image showing the latest 20 episodes

[powerpress_playlist image="http://example.com/wp-content/uploads/300x300.png" limit=20]

Example playlist for custom podcast channel using slug ‘audio-m4a’

[powerpress_playlist slug="audio-m4a"]

and if you are using post type podcasting:

[powerpress_playlist post_type="post_type_slug" slug="audio-m4a"]

Example displaying titles of podcasts based on category (or other taxonomy)

[powerpress_playlist program_titles_by_taxonomy="category"]

Include the iTunes subtitle for the currently playing episode in playlist

[powerpress_playlist itunes_subtitle=true]

Example assigning specific blog posts to exclusively show in the playlist]

[powerpress_playlist ids="2241, 2239, 2237"]

Note: The “ids” attribute was added to PowerPress 7.0.

Custom Style Example

This is a rather advanced option targeted toward theme developers. You can come up with your one styling for the playlist by specifying your own style name (other than “light” and “dark”.

[powerpress_playlist style="blue"]

WordPress will add the following class to your playlist, which allows you to set specific styling for everything contained within the playlist in your theme’s CSS.

.wp-playlist-blue {
 background: #003366;
 color: #FFFFFF;
}

Please see the CSS file found in WordPress core wp-includes\js\mediaelement\wp-mediaelement.css for examples.