Skip to main content

Embed PeerTube videos into Wagtail

Project description

wagtailembedpeertube

Embed PeerTube videos into Wagtail.

Introduction

Wagtail has a great support of oEmbed for embedding content. Unfortunately, the oEmbed mechanism is based on services domain names and URI; and this is prone to centralization since it limits to a short list of selected providers.

By the way, there is already hundreds instances and it will probably grow with years - see PeerTube instances.

This app brings oEmbed support for decentralized PeerTube instances. To do this, it only focuses on a string URI filtering, allowing all services from any domain name.

Installation

  1. Install using pip:

    pip install wagtailembedpeertube
    
  2. Add wagtailembedpeertube to your INSTALLED_APPS setting somewhere after wagtail.embeds:

    INSTALLED_APPS = [
        ...
        "wagtail.embeds",
        ...
        "wagtailembedpeertube",
        ...
    ]
    
  3. Configure embed finders in WAGTAILEMBEDS_FINDERS setting to add PeerTube's one at the end, i.e.:

    WAGTAILEMBEDS_FINDERS = [
        {
            "class": "wagtail.embeds.finders.oembed",
        },
        {
            "class": "wagtailembedpeertube.finders",
        },
    ]
    

    Since the first matching finder will be used, wagtailembedpeertube should be declared as last because others finders are matching domain names and may be more precise. See Configuring embed “finders” for more details.

Usage

That's it! You should now be able to embed any PeerTube content using the EmbedBlock:

from wagtail.embeds.blocks import EmbedBlock

class MyStreamField(blocks.StreamBlock):
    ...

    embed = EmbedBlock()

Development

To setup a development environment, clone this repository and follow the installation steps but replace the installation from PyPi by:

pip install -e .[test]

The Python code is formatted and linted thanks to flake8, isort and black. To ease the use of this tools, the following commands are available:

  • make lint: check the Python code syntax and imports order
  • make format: fix the Python code syntax and imports order

License

This extension is mainly developed by Cliss XXI and licensed under the AGPLv3+. Any contribution is welcome!

Project details


Download files

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

Files for wagtailembedpeertube, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size wagtailembedpeertube-0.2.0-py3-none-any.whl (16.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size wagtailembedpeertube-0.2.0.tar.gz (20.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page