10up / simple-podcasting

A simple podcasting solution for WordPress.
https://wordpress.org/plugins/simple-podcasting/
GNU General Public License v2.0
181 stars 29 forks source link
apple-podcasts block blocks episode gutenberg podcast podcasting simple-podcasting wordpress wordpress-plugin

Simple Podcasting for WordPress

Simple Podcasting

Support Level WordPress tested up to version GPLv2 License Dependency Review WordPress Playground Demo

E2E Test Unit Tests PHPCS PHP Compatibility CodeQL

Easily set up multiple podcast feeds using built-in WordPress posts. Includes a podcast block and podcast transcript block for the WordPress block editor (aka Gutenberg).

Overview

Podcasting is a method to distribute audio messages through a feed to which listeners can subscribe. You can publish podcasts on your WordPress site and make them available for listeners in Apple Podcasts and through direct feed links for other podcasting apps by following these steps:

Screenshot of podcast block

Requirements

Installation

  1. Install the plugin via the plugin installer, either by searching for it or uploading a .zip file.
  2. Activate the plugin.
  3. Head to Posts → Podcasts and add at least one podcast.
  4. Create a post and insert an audio embed (or a podcast block in the new WordPress editor) and select a Podcast feed to include it in.

Create your podcast

From the WordPress Admin, go to Podcasts. To create a podcast, complete all of the "Add New Podcast" fields and click "Add New Podcast".

Repeat for each podcast you would like to create.

Add content to your podcast

Submit your podcast feed to Apple Podcasts

Podcast setup Podcast in editor Podcast feed
Podcast setup Podcast in editor Podcast feed

Submit your podcast feed to Pocket Casts

How do I get my podcast featured on Pocket Casts?

The Featured section of Pocket Casts is human-curated. To ensure that all podcasts have an equal opportunity at being featured, selections are made on the basis of merit.

If you’d like to suggest your podcast for a featured spot, reach out to curation@pocketcasts.com.

For more information, read more.

How do I submit private and paid podcast feeds?

Follow this documentation to submit private and paid podcast feeds

Control how many episodes are listed on the feed

If you want to adjust the default number of episodes included in a podcast RSS feed, then utilize the following to do so...

<?php

add_filter( 'simple_podcasting_episodes_per_page', 'podcasting_feed_episodes_per_page' );

/**
 * Filter how many items are displayed on the feed
 * Default is 250
 *
 * @param int $qty Items count.
 * @return string
 */
function podcasting_feed_episodes_per_page( $qty ) {
    return 300;
}

Customize the RSS feed title

The <title> element of the RSS feed can be adjusted using the simple_podcasting_feed_title filter.

<?php

add_filter( 'simple_podcasting_feed_title', 'podcasting_feed_update_feed_title', 10, 2 );

/**
 * Filter the name of the of the feed channel
 *
 * @param $output Output to be modified.
 * @param $term WP_Term object representing the podcast
 * @return string
 */
function podcasting_feed_update_feed_title( $output, $term ) {
    $term_name = $term->name;

    return '10up Presents: ' . $term_name;
}

Customize RSS feed

If you want to modify RSS feed items output, there is a filter for that:

<?php

function podcasting_feed_item_filter( $feed_item = array(), $post_id = null, $term_id = null ) {
    if ( 42 === $post_id ) {
        $feed_item['keywords'] = 'one,two,three';
    }
    return $feed_item;
}
add_filter( 'simple_podcasting_feed_item', 'podcasting_feed_item_filter', 10, 3 );

Support Level

Stable: 10up is not planning to develop any new features for this, but will still respond to bug reports and security concerns. We welcome PRs, but any that include new features should be small and easy to integrate and should not include breaking changes. We otherwise intend to keep this tested up to the most recent version of WordPress.

Changelog

A complete listing of all notable changes to Simple Podcasting for WordPress are documented in CHANGELOG.md.

Contributing

Please read CODE_OF_CONDUCT.md for details on our code of conduct, CONTRIBUTING.md for details on the process for submitting pull requests to us, and CREDITS.md for a listing of maintainers of, contributors to, and libraries used by Simple Podcasting for WordPress.

Like what you see?