From d05d6085994bdfbb3d5bf7a375c9ba371c3825f8 Mon Sep 17 00:00:00 2001 From: Juda Kaleta Date: Sat, 1 Jun 2013 15:01:52 +0200 Subject: [PATCH] Usage --- README | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/README b/README index 0145c71..35a9624 100644 --- a/README +++ b/README @@ -3,3 +3,61 @@ django-embed-video Django app for easy embeding YouTube and Vimeo videos. + +Installation +------------ + + pip install django-embed-video + + +Examples +--------- + +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 video %} + {{ video|embed:'small' }} + {% endvideo %} + +Default sizes are `tiny` (420x315), `small` (480x360), `medium` (640x480), +`large` (960x720) and `huge` (1280x960). You can set your own size: + + {{ video|embed:'800x600' }} + +Usage of variables: + + {% video item.video as video %} + URL: {{ video.url }} + Thumbnail: {{ video.thumbnail }} + {% endvideo %} + + +Model examples +*************** + +Using the EmbedVideoField you provide validation of correct URL. + + from django.db import models + from embed_video.fields import EmbedVideoField + + class Item(models.Model): + video = EmbedVideoField() # same like models.URLField() + + +TODO +----- + +- provide AdminEmbedVideoMixin +- Vimeo thumbnail + + + + +