Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A simplistic podcast manager module for the Mezzanine CMS.
Python
branch: master
Failed to load latest commit information.
podcast Properly import settings. Make a note about the file upload size in R…
.gitignore Initial commit of mezzanine-podcast.
LICENSE
MANIFEST.in Initial commit of mezzanine-podcast.
README.rst Properly import settings. Make a note about the file upload size in R…
setup.py Initial commit of mezzanine-podcast.

README.rst

Mezzanine Podcast

This is a simple podcast manager module for the Mezzanine CMS. It adds the ability to upload audio files, notes, and some metadata for the files. Two views are provided, one for a listing of podcasts and one for displaying details about a single podcast. Sample templates are included. The sample detail template uses the HTML5 audio tag to stream the audio.

The module allows for uploads in ogg/vorbis format and mp4/aac format. This covers all major browsers that support HTML5. If you need to target other browsers (specifically Internet Explorer <= IE8) you'll need to provide a Flash fallback player such as jPlayer.

Installation

You have two main options for installing. You can install mezzanine-podcast to your system package directory or just extract the source and put the podcast directory in your mezzanine project root.

If you choose to use the first option, I recommend you use virtualenv or equivalent to isolate the package since it uses a rather generic podcast package name.

Option 1 - Install into system packages or virtualenv:

easy_install https://github.com/carpie/mezzanine-podcast/tarball/master

Option 2 - Install in your mezzanine project root:

wget https://github.com/carpie/mezzanine-podcast/tarball/master -O - | tar -zxvf -
cp -r carpie-mezzanine-podcast-<hash>/podcast <path_to_your_mez_prj>/

Usage

To use:

  • Add podcast to your INSTALLED_APPS in settings.py in your mezzanine project.

  • Add ("^podcasts/", include("podcast.urls")), to your project's urls.py.

  • Add ogg support to the file browser by putting the following block in your settings.py file:

    # Add ogg to the filebrowser's music extensions
    FILEBROWSER_EXTENSIONS = {
        'Folder': [''],
        'Image': ['.jpg','.jpeg','.gif','.png','.tif','.tiff'],
        'Video': ['.mov','.wmv','.mpeg','.mpg','.avi','.rm'],
        'Document': ['.pdf','.doc','.rtf','.txt','.xls','.csv'],
        'Audio': ['.mp3','.mp4','.wav','.aiff','.midi','.m4p', '.ogg'],
        'Code': ['.html','.py','.js','.css']
    }
    
  • From your mezzanine project run:

    ./manage.py migrate podcast
    

Now, the podcast list page should be available at the podcasts/ url. You can now add podcasts through the normal admin interface. If you add a page with the same name as the slug (e.g. podcasts) the contents of the page will be shown before the podcast list when the slug is visited.

Customization

To override the default templates, create the template files templates/podcast/podcast_list.html and templates/podcast/podcast_detail.html in your mezzanine project.

To change the slug from the default of podcasts:

  • Add PODCAST_SLUG = my_slug to local_settings.py.
  • Change the slug in urls.py to match, or set up the url to use the one imported from settings.
  • Create a Page with a title matching the slug.

If you are audio files are larger than the 10 MB default, you can change the upload limit by setting FILEBROWSER_MAX_UPLOAD_SIZE (in bytes) in local_settings.py.

Something went wrong with that request. Please try again.