Entity Embed

Entity Embed allows any entity to be embedded within a text area using a WYSIWYG editor.

Requirements

8.x-1.x

• Editor and Filter modules included with Drupal core.
• Embed

7.x-3.x

Drupal 7.37 or later patched with #2105841-97: Xss filter() mangles image captions and title/alt/data attributes.

• Editor CKEditor - A submodule of the Editor module.
• Entity Reference - 7.x-1.2 or later.

7.x-2.x

Drupal 7.37 or later.

• Filter module included with Drupal core.
• Chaos Tools
• CKEditor - The latest development release.
  • CKEditor - Version 4.3 or later.
  • CKEditor Line Utilities plugin - Compatible with the installed version of CKEditor.
  • CKEditor Widget plugin - Compatible with the installed version of CKEditor.
• Dialog
• Entity
• jQuery Update - Configured to use jQuery 1.7 or higher.

7.x-1.x

All 2.x requirements, minus the Dialog module.

Installation

• Entity Embed can be installed via the standard Drupal installation process.
• Enable the entity-embed filter Display embedded entities for the desired text formats from the Text Formats configuration page.
• If the Limit allowed HTML tags filter is enabled, add <drupal-entity data-*> to the Allowed HTML tags.
• To enable the WYSIWYG plugin, move the entity-embed E button into the Active toolbar for the desired text formats.
• Optionally enable the Align images filter to allow positioning of embedded entities and/or the Track images uploaded via a Text Editor filter to track the usage of embedded file entities.

The 7.x-1.x and 7.x-2.x versions of Entity Embed also require you to:

• Ensure that version 4.3 or later of the CKEditor library is installed.
• Install the CKEditor Line Utilities plugin.
• Install the CKEditor Widget plugin.
• Configure the jQuery Update module to use jQuery 1.7 or higher.
• Disable CKEditor's Advanced Content Filter for each of the text formats.

By default, Entity Embed includes a single button for embedding nodes. Additional buttons can be added from the configuration page.

Development

Development of the 8.x branch of Entity Embed is taking place on GitHub.

Resources

• Demo video by Chandan Singh the incredible GSOC 2014 student who helped drive this module forward.

Related Modules

• URL Embed: allows URLs to be embedded within a text area using a WYSIWYG editor.
• Entity Browser: When enabled, offers a more advanced embedded entity selection workflow.
• Media: When embedding file entities, allows files to be selected using the media browser.