Skip to main content

Getting Started

The Podlove Web Player is a WordPress plugin. In this tutorial we assume that you have a running WordPress installation. Make sure that you match our general system requirements before you get started.

1 Installation#

  • Login to your WordPress administration and navigate to Plugins.
  • Click Add New, search for Podlove Web Player
  • Install the plugin and Activate it

2 Basic Configuration#

  • Navigate to Settings > Podlove Web Player
  • Click Configuration > Add to create a new Web Player configuration
  • Enter an identifier that matches your purpose (We will use this configuration on episode pages, therefore we call it episode but also the podcast name could be a good fit)
  • Press Add to create the configuration

Optional: In case you want to use the integrated Subscribe Button#

  • On the configuration page scroll to Subscribe Button
  • Enter your RSS Feed
  • Add clients for your subscribers:
    • Select the clients you want to support
    • Configure as needed
  • Hit Save to save your changes
info

Blue clients will work out of the box, green clients will need some additional configuration.

3 Customize your Theme#

  • Navigate to Settings > Podlove Web Player
  • Click Themes > Add to create a new Web Player Theme
  • Enter an identifier that matches your purpose (We will use this theme on episode pages, therefore we call it episode but also the podcast name could be a good fit)
  • Adjust the Colors to match your scheme (You should see the changes in the preview on the right side)
  • Hit Save to save your changes

4 Default Settings#

  • Navigate to Settings > Podlove Web Player
  • Click Settings to see the Web Player settings
  • Select your newly created configuration from step 2 as the Default Configuration
  • Select your newly created theme from step 3 as the Default Theme
  • Hit Save to save your changes

5 Usage in Posts & Pages#

Shortcode#

  • Create/edit a page or a post
  • Insert the following shortcode:
[podlove-web-player title="Podlove Web Player" show="Podlovers" poster="https://docs.podlove.org/assets/web-player/episode.png" src="https://files.podlovers.org/LOV003.mp3" size="76976929" duration="01:31:18.610"]
  • Hit Publish
  • Visit the page or post to see the player in action

Gutenberg Block#

  • Create a page or a post
  • Add a new block to the page
  • Select Podlove Web Player
  • Select Custom
  • Adjust the Settings
    • Select your Config
    • Select your Theme
  • Add Audio information:
    • Set a Title for the audio file
    • Upload the audio File to wordpress and select it
    • Select the file Type
    • Set the file Size in bytes
  • Add Episode information:
    • Set the episode Title
    • Add the episode Duration
    • Upload the episode Poster to wordpress and select it
  • Add Show information:
    • Set the show Title
  • Hit Publish
  • Visit the page or post to see the player in action

6 Integrate with Podlove Publisher#

  • Make sure you have the latest Publisher installed
  • Go to Podlove > Podcast Settings and select the Player Tab
  • Select Podlove Web Player 5 and hit Save Changes
  • Go to Podlove > Templates and add episode.player() to the default template
  • Make sure to insert the Template into your episodes