Settings

The app offers several settings. By default, they are:

PODCAST_SINGULAR = True

PODCAST_ID = 1

PODCAST_EPISODE_LIMIT = None

PODCAST_NO_ARTWORK = 'podcast/img/no_artwork.png'

PODCAST_PAGINATE_BY = 10

PODCAST_ALLOWED_TAGS = ['p', 'ol', 'ul', 'li', 'a', 'i', 'em', 'b', 'strong']

PODCAST_SINGULAR

A boolean indicating display of multiple podcast shows.

The app displays a single show by default. If you would like to display multiple shows, set the PODCAST_SINGULAR variable in settings.py.

PODCAST_SINGULAR = False

If you have multiple shows, you might want to edit the URL pattern in urls.py from podcast/ to podcasts/, although the difference is purely cosmetic.

from django.urls import include, path

urlpatterns = [
    # ...
    path('podcasts/', include('podcast.urls')),
]

PODCAST_ID

An integer indicating the primary key of the show to display; used when PODCAST_SINGULAR is True. Concept modeled after the SITE_ID setting used in the Sites application.

The app displays the first show by default.

PODCAST_EPISODE_LIMIT

An integer indicating the number of episodes to display in a show feed or None to display all episodes. Formerly the limit was an arbitrary 50 episodes.

The app displays all episodes in a show feed by default.

PODCAST_NO_ARTWORK

A string indicating the path to an image used when artwork is lacking; used for shows, episodes, and video enclosures.

Although the path can be customized in the setting, you’re probably better off overriding the image look up at the project level; that is, creating a new image at myproject/static/podcast/img/no_artwork.png.

PODCAST_PAGINATE_BY

An integer indicating how many items to display in a list view or in a detail view of related objects; used for shows and episodes.

PODCAST_ALLOWED_TAGS

A list indicating which HTML tags are allowed for display in output; used for show summaries and episode notes. The database can store HTML, but tags not specified in the list are stripped out, and the remaining output is wrapped in <![CDATA[...]]> tags. Uses the Bleach Python package.

The list includes HTML tags specified in the iOS 11 Apple Podcasts update by default. The list also includes the conspicuously absent <li> and <strong> tags, which appear to be an oversight on Apple’s part because <ol>, <ul>, and <b> are present in the original list. Note that the specification confusingly specifies a subset of fewer tags: <p>, <ol>, <ul>, and <a>.