vardot / ckeditor_media_embed
Adds the Media Embed CKEditor plugins to Drupal.
Installs: 369
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 5
Forks: 0
Type:drupal-module
Requires
- drupal/core: ^8.9.0 || ~9.0.0
This package is auto-updated.
Last update: 2024-10-13 23:27:41 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
-
Easiest
- Install Drupal Console.
- Enable CKEditor media embed module.
- Run
drupal ckeditor_media_embed:install
.
-
Harder
- Download the [Full "dev" package for CKEditor](https://github.com/ckeditor/ckeditor-dev/archive/latest. zip).
- Unzip the package and place its contents into
DRUPAL_ROOT/libraries/ckeditor
. - Clear the cache
-
Hardest
- Download the following plugins:
- Media Embed
- Media Semantic Embed
- Media Embed Base
- Auto Embed
- Auto Link
- Notification
- Notification Aggregator
- Text Match (As of CKEditor 4.11)
- Unzip and place the contents for each plugin in the the following directory:
DRUPAL_ROOT/libraries/ckeditor/plugins/PLUGIN_NAME
- Clear the cache
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.
- Go to the 'Text formats and editors' configuration page:
-
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.
- Media Embed
- Media Semantic Embed
- Media Embed Base
- Auto Embed
- Auto Link
- Notification
- Notification Aggregator
- Text Match
MAINTAINERS
Current maintainers:
- Jonathan DeLaigle (grndlvl) - https://www.drupal.org/u/grndlvl