Metadata-Version: 2.1
Name: wagtail-embedvideos
Version: 0.5.1
Summary: Embed Videos for Wagtail CMS
Home-page: https://github.com/bashu/wagtail-embedvideos
Author: InfoPortugal S.A.
Author-email: suporte24@infoportugal.com
Maintainer: Basil Shubin
Maintainer-email: basil.shubin@gmail.com
License: BSD License
Download-URL: https://github.com/bashu/wagtail-embedvideos/zipball/master
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Wagtail
Classifier: Framework :: Wagtail :: 2
Description-Content-Type: text/x-rst
Provides-Extra: develop
Provides-Extra: test
License-File: LICENSE
License-File: AUTHORS

wagtail-embedvideos
===================

.. image:: https://img.shields.io/pypi/v/wagtail-embedvideos.svg
    :target: https://pypi.python.org/pypi/wagtail-embedvideos/

.. image:: https://img.shields.io/pypi/dm/wagtail-embedvideos.svg
    :target: https://pypi.python.org/pypi/wagtail-embedvideos/

.. image:: https://img.shields.io/github/license/bashu/wagtail-embedvideos.svg
    :target: https://pypi.python.org/pypi/wagtail-embedvideos/

.. image:: https://img.shields.io/travis/bashu/wagtail-embedvideos.svg
    :target: https://travis-ci.com/github/bashu/wagtail-embedvideos/

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

Maintained by `Basil Shubin <https://github.com/bashu>`_,  and some great
`contributors <https://github.com/bashu/wagtail-embedvideos/contributors>`_.

.. image:: https://raw.githubusercontent.com/bashu/wagtail-embedvideos/develop/screenshot.png
   :target: https://raw.githubusercontent.com/bashu/wagtail-embedvideos/develop/screenshot.png
   :align: center
   :width: 600px

Compatibility
~~~~~~~~~~~~~

The current version is tested for compatiblily with the following:

- Wagtail versions 2.7 to 2.11
- Django versions 2.2 to 3.2
- Python versions 3.6 and 3.9

Requirements
~~~~~~~~~~~~

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

Installation
============

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

.. code-block:: shell

    pip install wagtail-embedvideos

Setup
=====

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

Then add the following settings:

.. code-block:: python

    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``.

.. code-block:: python

    # 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:

.. code-block:: html+django

    <!-- 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 <https://github.com/bashu/wagtail-embedvideos/>`_ was originally started by `InfoPortugal, S.A. <https://github.com/infoportugal/>`_ who has now unfortunately abandoned the project.

License
=======

``wagtail-embedvideos`` is released under the BSD license.

.. _django-embed-video: https://github.com/jazzband/django-embed-video/


