Podcasts and Episodes¶
Django Cast provides comprehensive podcast support built on top of its blogging functionality. This section covers both podcast configuration and episode management.
Podcasts¶
Podcasts are blogs that have some additional features to better support podcasting.
There are some additional fields that are available for podcasts:
Itunes Artwork¶
The image that will be used in the podcast feed as the iTunes artwork.
Episodes¶
Podcast episodes are Wagtail pages that have a podcast page as a parent. They have the same features as blog posts, but with some additional fields for better podcast support.
Cover Image¶
In addition to the effect setting a cover image for a post has, setting a cover image for an episode will also be used in the Podlove Web Player. Podlove posters use an automatically generated max-512x512 WebP rendition to keep image sizes reasonable. It is also used for social previews via the automatically generated 1200x630 social rendition.
If no cover image is set for the episode, the blog’s cover image will be used.
Podcast Audio¶
The podcast_audio field is required for an episode. It is used for the enclosure tag in the podcast feed.
Promote > Title¶
This will be used as the title of the episode in the Podlove Web Player.
Promote > Description¶
This will be used as the description of the episode in the Podlove Web Player.
Keywords¶
Keywords are set in the podcast feed as the iTunes keywords tag.
Contributors¶
Episode contributors are reusable Wagtail snippets for people who should be credited on podcast episodes and in Podcasting 2.0 feed metadata.
Create contributors in Wagtail under Contributors. They remain available as snippets under Snippets > Contributors as well. A contributor has a display name, a stable slug, a default episode role, an optional avatar, an optional short bio, and ordered profile links. Profile links use fixed service choices such as Website, GitHub, Mastodon, Twitter/X, LinkedIn, and YouTube. The first ordered profile link is used as the default episode link.
Contributors have a global visible flag. Turning it off hides that person
from public episode pages and podcast feeds without deleting existing episode
assignments.
On an episode edit page, use the Contributors panel to add ordered contributors. Each assignment chooses a contributor, a role of Host or Guest, and optionally one of the contributor’s links to use for that episode. After a contributor is selected, the link field only offers that contributor’s profile links. New assignments use the contributor’s default role and first ordered profile link, but editors can still change both fields per episode. The same contributor may appear on an episode under more than one role (for example as both Host and Guest), but a given (contributor, role) pair can only be assigned once per episode. Episode assignments may reference one of the contributor’s existing links; links that are in use cannot be deleted or moved to another contributor until those assignments are updated.
Public episode templates receive episode_contributors in context. The
built-in themes render those assignments on episode detail pages. Custom themes
that override episode body templates should render episode_contributors or
include cast/contributors.html to show episode credits. Use this filtered
context value instead of iterating episode.contributor_assignments directly;
it omits contributors whose global visible flag is disabled. Contributor
avatars are served as fill-80x80|format-webp renditions so the original
upload is not used as a thumbnail.
Podcast feed items emit one podcast:person element for each visible
assignment. The element text is the contributor display name, role is the
episode assignment role, img is the contributor avatar rendition URL when
configured, and href is the selected assignment link when configured.
Explicit¶
Explicit content is set in the podcast feed as the iTunes explicit tag. The available options are:
Yes: Content is suitable for the age group it’s rated for
No: Content does not contain anything explicit and is safe for general audiences
Explicit: Contains adult content or strong language, not recommended for younger audiences
Block¶
Indicates whether the episode is blocked from iTunes or not.