The Podcast Plugin is for Grav CMS. This plugin creates the following:
Installing the Podcast plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.
The simplest way to install this plugin is via the Grav Package Manager (GPM) through your system's terminal (also called the command line). From the root of your Grav install type:
bin/gpm install podcastThis will install the Podcast plugin into your /user/plugins directory within Grav. Its files can be found under /your/site/grav/user/plugins/podcast.
To install this plugin, just download the zip version of this repository and unzip it under /your/site/grav/user/plugins. Then, rename the folder to podcast. You can find these files on GitHub or via GetGrav.org.
You should now have all the plugin files under
/your/site/grav/user/plugins/podcastNOTE: This plugin is a modular component for Grav which requires the following to operate:
- Grav Core
- Admin
- Breadcrumbs
- Feed
- GetId3, along with its accompanying getID3 php library
...and any other required plugins the above list requires.
Before configuring this plugin, you should copy the user/plugins/podcast/podcast.yaml to user/config/plugins/podcast.yaml and only edit that copy.
Here is the default configuration and an explanation of available options:
enabled: trueDefaults plugin to enabled after installation
After installing and enabling the plugins, the admin form will now have three new page templates:
The general folder structure using only series will look like this:
Using no series will look like this:
Non-series episodes can exist next to series:
A podcast RSS feed is created at PAGENAME.rss of all episodes underneath the channel, including ones within series. RSS tags are filled with the appropriate data submitted in the admin form for a podcast channel/ episode.
Example: If a podcast channel is created at at http://www.example.com/mypodcast, then the url for the podcast RSS feed is found at http://www.example.com/mypodcast.rss
Used to group episodes, a podcast series page should be a child page to a podcast channel. Multiple series can exist as child pages of a podcast channel. A podcast RSS feed is also available at SERIESNAME.rss, but it will only contain episodes that are child pages to the series.
Example: If a podcast series is created at at http://www.example.com/mypodcast/series1, then the url for the podcast RSS feed is found at http://www.example.com/mypodcast/series1.rss
These should be created as child pages of either a podcast channel or a podcast series. Note: Episodes won't show up in the RSS feed if there is no podcast audio attached. Episodes can use the built-in publish_date field to schedule publishing of the page, and the RSS feed will use publish_date, falling back to just date if found.
Submit any issues you find to the issue queue.