README.md

WAGTAIL EMBED VIDEOS

Simple app that works similar to wagtailimages, but for embedding YouTube and Vimeo videos and music from SoundCloud. It's an integration of django-embed-video

WARNING

With recent changes to keep up with Wagtail current versions, we do not support versions <= 1.6!

Latest version only suports django>=1.11 and wagtail>=2.0

REQUIREMENTS

    pip install wagtail-embed-videos

    wagtailimages

Quick start

1. Add "embed_video" and "wagtail_embed_videos" to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = (
        ...
        'embed_video',
        'wagtail_embed_videos',
        ...
    )
   

2. Run python manage.py makemigrations to create the migration for wagtail_embed_videos models

3. Run python manage.py migrate to create the models of wagtail_embed_videos app

4. Using wagtail_embed_videos:

    from wagtail_embed_videos.edit_handlers import EmbedVideoChooserPanel
   
    class VideoBasedModel(models.Model):
        video = models.ForeignKey(
            'wagtail_embed_videos.EmbedVideo',
            verbose_name="Video",
            null=True,
            blank=True,
            on_delete=models.SET_NULL,
            related_name='+'
        )
        ...
        panels = [EmbedVideoChooserPanel('video')]
   
    # accessing the EmbedVideoField() in the model 'wagtail_embed_videos.EmbedVideo'
    # this is the field used for storing the url of the embed video
    video_based_model_instanse.video.url
   
    # accessing the thumbnail image in the model 'wagtailimages'
    # this is a foreign key to model Image
    video_based_model_instanse.video.thumbnail
   

5. For render your video in a template put {% load embed_video_tags%} for load template tags and put this code where you want render your video:

    ```html
    {% video VideoBasedModel.video.url as video %}
            {% video video 'small' %}
    {% endvideo %}
    ```
   

6. Check django-embed-video for more documentation

Release Notes

v0.4.1

• Wagtail version >= 2.0 supported;
• Django version >= 2.0 supported;
• Dropped support for Wagtail < 2.0;

v0.3.0

• Changed the structure of "AbstractEmbedVideo", because "TagSearchable" is not used anymore;

v0.2.5

• This is the last version compatible with Wagtail <= 1.6, because TagSearchable was deprecated and then removed.