PodcasterPlugin
Docs

Setup

Maurice Renck •
#kirby#plugin#podcaster#setup

This plugin comes with a blueprint and template for the RSS feed. In addition you may need a template for the episode listing on your website.

How to structure your Podcast

In order to configure the feed correctly, you first have to think how you would like to structure the pages of your Podcast.

There are three recommended ways to structure your Podcast (but you can do it however you like):

  1. Flat
  2. By Season
  3. By Year

1. Flat

This structure is the simplest but may become a bit cluttered over time. In this case you have a flat structure with the feed and the episode on one level:

2. By season

This structure might be the best one for most Podcasts. In this case you have a deeper structure splitter into seasons with the feed and the season pages on one level and the episode as children of the season pages:

3. By year

This structure works the same as the seasonal one, but it is splitter by year with the feed and the yearly pages on one level and the episodes as children of the yearly pages:

Create the feed

It is recommended to create a parent page for all the pages of your Podcast. I will call it „My Podcast“ in this example. This page should have a blueprint/template which can later on list all episodes.

Create the feed page within your Podcast page:

  1. Open the Podcast page (My Podcast)
  2. Create a new draft
  3. Select Podcaster Feed as a template
  4. Create the page

!NOTE If you cannot see the template Podcaster Feed make sure

  • The plugin is correctly installed
  • The blueprint of the parent page allows to create pages with the podcasterfeed template.

Fill in at least the:

Switch to the RSS Settings tab and fill out:

The Podcast ID should be a simple string, representing our Podcasts name. For example my-podcast

The Podcast Link should be a link to the landing page of your Podcast.

Next

Creating Episodes

This plugin does not provide a blueprint for episodes but it does provide a tab blueprint to extend your existing blueprints.

Prepare a blueprint

If you have a blog your could extend your post blueprint. If you don’t have any fitting blueprint, you can use this very simple example:

title: Episode
num: '{{ page.date.toDate("YmdHi") }}'
tabs:
  podcast:
    extends: tabs/podcasterepisode
  content:
    sections:
      basic_stuff:
        type: fields
        fields:
          date:
            label: Date
            type: date
            default: today
            required: true
          text:
            label: Text
            type: textarea
            size: large

If you do have a fitting template, you can extend it with:

tabs:
  podcast:
    extends: tabs/podcasterepisode

Create an episode

Create an episode within your chose structure. I’ll use the seasonal structure in the example. So I will

  1. Open the panel
  2. Go to the My Podcast page
  3. Create a child page named Season 01 with the same listing template used by My Podcast
  4. Go into Season 01
  5. Create a new page with my episode template

Now fill in at least the required fields:

Publish the episode page and the season page.

Add episodes to the feed

Now we can add episodes to the feed:

  1. Open the panel
  2. Go to your podcast
  3. Open the feed
  4. Go to RSS Settings
  5. Edit Source Pages
  6. Add the page containing your episodes, in my case this is Season 01
  7. Save the changes
  8. Open the page

You should now see the new episode in the RSS feed.

Publishing the Podcast

You are set up now and can publish the RSS feed. If your feed is still a draft:

  1. Open the panel
  2. Go to your podcast
  3. Set the feed page to unlisted
  4. Open the feed
  5. Copy the URL
  6. Submit the URL to the directories of your choice

Congratulations! Your Podcast is live!

!NOTE Go ahead and start configuring Podcaster Analytics to see how many people are listing to your Podcasts.

← Back to Docs