djangocms-audio 2.0.0

Installation

For a manual install:

• run pip install djangocms-audio

• add djangocms_audio to your INSTALLED_APPS

• run python manage.py migrate djangocms_audio

Configuration

Note that the provided templates are very minimal by design. You are encouraged to adapt and override them to your project’s requirements.

This addon provides a default template for all instances. You can provide additional template choices by adding a DJANGOCMS_AUDIO_TEMPLATES setting:

DJANGOCMS_AUDIO_TEMPLATES = [
    ('feature', _('Featured Version')),
]

You’ll need to create the feature folder inside templates/djangocms_audio/ otherwise you will get a template does not exist error. You can do this by copying the default folder inside that directory and renaming it to feature.

MP3 and OGG files are allowed by default. We recommend using MP3 as it’s supported across all major browsers. You can change the default setting by overriding:

DJANGOCMS_AUDIO_ALLOWED_EXTENSIONS = ['mp3', 'ogg', 'wav']

Running Tests

You can run tests by executing:

virtualenv env
source env/bin/activate
pip install -r tests/requirements.txt
python setup.py test