vardot/ckeditor_media_embed

Adds the Media Embed CKEditor plugins to Drupal.

2.0.1 2020-10-13 13:21 UTC

This package is auto-updated.

Last update: 2024-11-13 23:44:09 UTC


README

  • Introduction
  • Requirements
  • Installation
  • Configuration
  • Additional Plugins
  • Maintainers

INTRODUCTION

A module that adds support for CKEditor plugins Media Embed, Semantic Media Embed, and Auto Embed to Drupal core's CKEditor.

REQUIREMENTS

Install CKEditor plugins

INSTALLATION

Install the module per normal https://www.drupal.org/documentation/install/modules-themes/modules-8 then follow the instructions for installing the CKEditor plugins below.

CONFIGURATION

Install and enable CKEditor media embed module.

  • WYSIWYG

    • Go to the 'Text formats and editors' configuration page: /admin/config/content/formats, and for each text format/editor combo where you want to embed URLs, do the following:
    • Drag and drop the 'Media Embed' or the 'Semantic Media Embed' button into the Active toolbar.
    • If the text format uses the 'Limit allowed HTML tags and correct faulty HTML' filter, use the 'Semantic Media Embed' and read the instructions for the 'Semantic Media Embed' below.
  • Semantic Media Embed

    If you are using the 'Semantic Media Embed' button be sure to do the following:

    • Enable the 'Convert Oembed tags to media embeds' filter.
    • If the text format uses the 'Limit allowed HTML tags and correct faulty HTML' filter, add <oembed> to the 'Allowed HTML tags' field. (This should happen automatically however, in some cases it does not. See https://www.drupal.org/node/2689083.)
  • Field formatter

    The field formatter allows link fields to be rendered via the configured oembed service provider.

    • Navigate to "Manage display" for the content type, after adding a "Link" field.
    • Select the "Oembed element using CKEditor Media Embed provider" format for the link field you wish.

ADDITIONAL PLUGINS

This module also includes all additional non-core dependencies for the Media Embed CKEditor plugin.

MAINTAINERS

Current maintainers: