Template examples

First you have to load the embed_video_tags template tags in your template:

{% load embed_video_tags %}

Simple embeding of video:

{% video item.video as my_video %}
    {{ my_video|embed:'small' }}
{% endvideo %}

Default sizes are tiny (420x315), small (480x360), medium (640x480), large (960x720) and huge (1280x960). You can set your own size:

{{ my_video|embed:'800x600' }}

Usage of variables:

{% video item.video as my_video %}
    URL: {{ my_video.url }}
    Thumbnail: {{ my_video.thumbnail }}
    Backend: {{ my_video.backend }}
{% endvideo %}

There is a simplier way, if you don’t need work with parameters as my_video.url or my_video.thumbnail and you want to use just embed tag.

{{ 'http://www.youtube.com/watch?v=guXyvo2FfLs'|embed:'large' }}


We recommend to use sorl-thumbnail to change thumbnail size.

Model examples

Using the EmbedVideoField provides you validation of URLs.

from django.db import models
from embed_video.fields import EmbedVideoField

class Item(models.Model):
    video = EmbedVideoField()  # same like models.URLField()

Admin mixin examples

Use AdminVideoMixin in admin.py.

from django.contrib import admin
from embed_video.admin import AdminVideoMixin
from .models import MyModel

class MyModelAdmin(AdminVideoMixin, admin.ModelAdmin):

admin.site.register(MyModel, MyModelAdmin)

Custom backends

If you have specific needs and default backends don’t suits you, you can write your custom backend.


from embed_video.backends import VideoBackend

class CustomBackend(VideoBackend):
    re_detect = re.compile(r'http://myvideo\.com/[0-9]+')
    re_code = re.compile(r'http://myvideo\.com/(?P<code>[0-9]+)')

    pattern_url = 'http://play.myvideo.com/c/%s/'
    pattern_thumbnail_url = 'http://thumb.myvideo.com/c/%s/'

You can also overwrite VideoBackend methods, if using regular expressions isn’t good enough for you.



Low level API examples

You can get instance of VideoBackend in your python code thanks to detect_backend():

from embed_video.backends import detect_backend

my_video = detect_backend('http://www.youtube.com/watch?v=H4tAOexHdR4')

Table Of Contents

Previous topic

Installation & Setup

Next topic

Example project

This Page