wagtail-embedvideos 0.5.12

Embed Videos for Wagtail CMS

Simple app that works similar to wagtailimages, but for embedding YouTube and Vimeo videos and music from SoundCloud.

The current version is tested for compatiblily with the following:

• Wagtail versions 2.7 to 2.15

• Django versions 2.2 to 3.2

• Python versions 3.6 and 3.9

Maintained by Basil Shubin, and some great contributors.

Installation

First install the module, preferably in a virtual environment. It can be installed from PyPI:

pip install wagtail-embedvideos

Requirements

You must have django-embed-video installed and configured, see the django-embed-video documentation for details and setup instructions.

Setup

Make sure the project is configured for django-embed-video.

Then add the following settings:

INSTALLED_APPS += (
    "wagtail_embed_videos",
)

Then run ./manage.py migrate to create the required database tables.

Usage

In models, implement as a ForeignKey relation, same as wagtailimages.

# models.py

from wagtail.core.models import Page, PageBase

from wagtail_embed_videos import get_embed_video_model_string
from wagtail_embed_videos.edit_handlers import EmbedVideoChooserPanel

class CustomPage(Page):
    video = models.ForeignKey(
        get_embed_video_model_string(),
        null=True, blank=True,
        on_delete=models.SET_NULL,
        related_name='+'
    )

    # ...

    content_panels = [
            EmbedVideoChooserPanel('video'),
    ]

In templates, load the embed_video_tags library in every template where you want to use it:

<!-- custom_page.html -->

{% load embed_video_tags %}

{% video self.video.url as my_video %}
    {% video my_video 'small' %}
{% endvideo %}

Check django-embed-video documentation for more details.

Contributing

If you like this module, forked it, or would like to improve it, please let us know! Pull requests are welcome too. :-)

Credits

wagtail-embedvideos was originally started by InfoPortugal, S.A. who has now unfortunately abandoned the project.

License

wagtail-embedvideos is released under the BSD license.

Changes

0.5.12 (2022-04-20)

• Fixed broken imports.

0.5.11 (2021-12-13)

• Added ru translation.

0.5.10 (2021-12-06)

• Fixed stupid typo.

0.5.9 (2021-12-06)

• Wagtail version >= 2.15 supported.

0.5.8 (2021-11-12)

• Wagtail version >= 2.14 supported.

0.5.7 (2021-11-11)

• Wagtail version >= 2.13 supported.

0.5.6 (2021-11-10)

• Wagtail version >= 2.12 supported.

0.5.5 (2021-11-09)

• Wagtail version >= 2.11 supported.

0.5.4 (2021-11-08)

• Wagtail version >= 2.10 supported.

0.5.3 (2021-11-07)

• Replacing broken 0.5.2 release.

0.5.2 (2021-11-06)

• Wagtail version >= 2.9 supported.

0.5.1 (2021-11-05)

• Wagtail version >= 2.8 supported.

0.5.0 (2021-11-04)

• Wagtail version >= 2.4 supported.

• Dropped support for Python < 3.x.

0.4.1 (2018-08-22)

• Wagtail version >= 2.x supported.

• Django version >= 2.x supported.

• Dropped support for Wagtail < 2.x.

0.3.0 (2017-04-24)

• Changed the structure of “AbstractEmbedVideo”, because “TagSearchable” is not used anymore.

0.2.5 (2017-02-09)

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