Django Brightcove

Manages the integration of brightcove videos in a django project. It extends the the Brightcove library developed by Jonathan Beluch: https://pypi.python.org/pypi/brightcove/0.2

It basically add a form field to easily integrate brightcove account video in the django admin or any form. And adds a template tag to fast integrate a brightcove video in a template.

Install

It is strongly recommanded to install this theme from GIT with PIP onto you project virtualenv.

From PyPi

pip install django-brightcove

From Github

https://github.com/RevSquare/django-brightcove#egg=django-brightcove

Setup

Before starting, you will need a Brightcove API token in order to connect to brightcove: http://docs.brightcove.com/en/video-cloud/media/guides/managing-media-api-tokens.html

The first step is to add the app in your installed apps list in settings.py

INSTALLED_APPS = (
    ...
    'django_brightcove'
    ...
)

The you will need to declare the loaders you want to add in your settings.py file

BRIGHTCOVE_TOKEN = 'YOUR_TOKEN..'

Finally you will need to add the django-brightcove urls to your Root URLCONF

urlpatterns = patterns('',
    ...

    (r'^django_brightcove', include('django_brightcove.urls')),
    ...
)

Add a Brightcove video to a model

Simply add the Brightcove field manager to it.

from django.db import models
from django_brightcove.fields import BrightcoveField


class MyModel(models.Model):
    brightcove = BrightcoveField()

Template tags

You can easily insert a video with a built in template tag.

The first step is to list your brightcove player id and key in your settings file.

BRIGHTCOVE_PLAYER = {
    'default': {
        'PLAYERID': 'a_default_player_id',
        'PLAYERKEY': 'a_default_player_key',
    },
    'single': {
        'PLAYERID': 'another_player_id',
        'PLAYERKEY': 'another_player_key',
    },
}

Then within your template, simply call for the player tag and pass your video id and eventualy a specific brightcove player type. By default the tag with the key set as 'default' in settings.BRIGHTCOVE_PLAYER dictionary.

{% load brightcove %}

<div class="player">{% brightcove_player object.brightcove_id player='single' %}</div>

You can also pass height and width to the template tag, ie:

{% load brightcove %}

<div class="player">{% brightcove_player object.brightcove_id width=480 height=270 %}</div>

You will also need to add the Brightcove javascript library

<script type="text/javascript" src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script>

Contribution

Please feel free to contribute. Any help and advices are much appreciated.

ixc / django-brightcove Goto Github PK