Skip to main content

Django app for easy embeding YouTube and Vimeo videos and music fromSoundCloud.

Project description

Django app for easy embedding YouTube and Vimeo videos and music from SoundCloud.

https://travis-ci.org/yetty/django-embed-video.png?branch=master https://coveralls.io/repos/yetty/django-embed-video/badge.png?branch=master https://pypip.in/v/django-embed-video/badge.png https://pypip.in/d/django-embed-video/badge.png

Documentation

Documentation is here: http://django-embed-video.rtfd.org/

Quick start

  1. Install django-embed-video:

    pip install django-embed-video

    or from sources

    pip install git+https://github.com/yetty/django-embed-video.git
  2. Add embed_video to INSTALLED_APPS in your Django settings.

  3. If you want to detect HTTP/S in template tags, you have to set request context processor in settings.TEMPLATE_CONTEXT_PROCESSORS:

    TEMPLATE_CONTEXT_PROCESSORS = (
        ...
        'django.core.context_processors.request',
    )
  4. Usage of template tags:

    {% load embed_video_tags %}
    
    The video tag:
    {% video item.video as my_video %}
      URL: {{ my_video.url }}
      Thumbnail: {{ my_video.thumbnail }}
      Backend: {{ my_video.backend }}
    
      {% video my_video "large" %}
    {% endvideo %}
    
    Or embed shortcut:
    {% video my_video '800x600' %}
  5. Usage of model fields

    from django.db import models
    from embed_video.fields import EmbedVideoField
    
    class Item(models.Model):
        video = EmbedVideoField()  # same like models.URLField()

Release 1.1.0 (dev)

No changes yet.

Release 1.0.0 (May 01, 2015)

Backward incompatible changes:

  • filter embed_video_tags.embed has been removed

  • changed behaviour of extra params in video tag (#34, #36)

Backward compatible changes:

  • added support for Django 1.7 and Django 1.8

  • added support for Vimeo channels (#47)

  • fix resizing of SoundCloud iframe (#41)

Release 0.11 (July 26, 2014)

  • add support for YouTube mobile urls (#27)

  • fix passing parameters in calling request library (#28)

  • fix validation of urls (#31)

Release 0.10 (May 24, 2014)

  • video tag accepts kwargs (#20)

  • video tag will not crash anymore with None passed as url (#24)

Release 0.9 (Apr. 04, 2014)

  • Add VideoBackend.template_name and rendering embed code from file.

  • Allow relative sizes in template tag (#19).

  • Fix handling invalid urls of SoundCloud. (#21).

  • Catch VideoDoesntExistException and UnknownBackendException in template tags and admin widget.

  • Add base exception EmbedVideoException.

Release 0.8 (Feb. 22, 2014)

  • Add EMBED_VIDEO_TIMEOUT to settings.

  • Fix renderering template tag if no url is provided (#18)

  • If EMBED_VIDEO_TIMEOUT timeout is reached in templates, no exception is raised, error is just logged.

  • Fix default size in template tag. (See more…)

Release 0.7 (Dec. 21, 2013)

  • Support for sites running on HTTPS

  • embed filter is deprecated and replaced by video filter.

  • caching for whole backends was removed and replaced by caching properties

  • minor improvements on example project (fixtures, urls)

Release 0.6 (Oct. 04, 2013)

  • Ability to overwrite embed code of backend

  • Caching backends properties

  • PyPy compatibility

  • Admin video mixin and video widget

Release 0.5 (Sep. 03, 2013)

  • Added Vimeo thumbnails support

  • Added caching of results

  • Added example project

  • Fixed template tag embed

  • Fixed raising UnknownIdException in YouTube detecting.

Release 0.4 (Aug. 22, 2013)

Release 0.3 (Aug. 20, 2013)

  • Security fix: faked urls are treated as invalid. See this page for more details.

  • Fixes:

    • allow of empty video field.

    • requirements in setup.py

  • Added simplier way to embed video in one-line template tag:

    {{ 'http://www.youtube.com/watch?v=guXyvo2FfLs'|embed:'large' }}
  • backend variable in video template tag.

    Usage:

    {% video item.video as my_video %}
        Backend: {{ my_video.backend }}
    {% endvideo %}

Release 0.2 (June 25, 2013)

  • Support of SoundCloud

Release 0.1 (June 1, 2013)

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-embed-video-1.0.0.zip (30.1 kB view details)

Uploaded Source

Built Distribution

django_embed_video-1.0.0-py2-none-any.whl (25.6 kB view details)

Uploaded Python 2

File details

Details for the file django-embed-video-1.0.0.zip.

File metadata

File hashes

Hashes for django-embed-video-1.0.0.zip
Algorithm Hash digest
SHA256 52c6a8e451944db5d123cc57989f47b4aea7ab9f3635f4b7c88b57101d537c40
MD5 665b6114bae6fd94565f31315a7d8241
BLAKE2b-256 22fb95833f4844eb35dd71da3edca62d8c23eee18d0df8924f372c1d0541347e

See more details on using hashes here.

File details

Details for the file django_embed_video-1.0.0-py2-none-any.whl.

File metadata

File hashes

Hashes for django_embed_video-1.0.0-py2-none-any.whl
Algorithm Hash digest
SHA256 06d4cf1132adbed1fef08cd7c3f9a075dd8b8ec7fac5f0e3d7b257f60e792958
MD5 9b5517918884c514b5c8443fb6ee2562
BLAKE2b-256 c06c33516823fb8c052e01f04e37baf07fbbc5520176eab2d58ded7bf38d80df

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page