Paragraphs Entity Embed Assets
Paragraphs Entity Embed Assets extends Drupal's Paragraphs Entity Embed functionality by allowing the CSS and JavaScript assets required by embedded Paragraphs to be loaded into CKEditor. This helps editors see embedded Paragraph components more accurately while editing content.
Features
- Loads selected theme component CSS and JavaScript assets into CKEditor.
- Allows administrators to configure which assets are available for embedded Paragraphs.
- Supports selecting assets from the site's theme components.
- Allows assets to be associated with configured Paragraphs Entity Embed buttons.
- Restricts configured assets to the Paragraph types that use the corresponding embed buttons.
- Helps ensure embedded Paragraphs have the appropriate styling and behavior while being edited in CKEditor.
- Keeps CKEditor-specific styles and scripts isolated from the rest of the Drupal administration interface.
- Uses Tagify to provide an autocomplete-enabled interface for selecting and managing CSS and JavaScript assets.
- Supports multiple asset selections while making it easier to find theme component files in sites with a large number of available assets.
This module is particularly useful when editors need a more accurate WYSIWYG experience for embedded Paragraph components. Instead of seeing unstyled or incorrectly styled embedded content, CKEditor can load the component assets needed to represent the embedded content.
Post-Installation
After installing the module, configure the assets that should be available to CKEditor.
Go to /admin/config/content/paragraphs-entity-embed-assets.
From the configuration page, administrators can select the appropriate theme component CSS and JavaScript assets and associate them with the Paragraphs Entity Embed buttons used by the site.
Tagify provides autocomplete functionality for the asset selection fields, allowing administrators to quickly search for and select CSS and JavaScript files without having to work with long, difficult-to-navigate lists.
After configuration, use a CKEditor text format that has the corresponding Paragraphs Entity Embed button enabled. When a Paragraph is embedded through CKEditor, the configured component assets are loaded into the editor so that the embedded content can be displayed with the appropriate styling and behavior.
The module does not create a new content type. It works with existing Paragraph types and Paragraphs Entity Embed configuration.
Additional Requirements
This module requires:
- Drupal 10 or later.
- Paragraphs.
- Paragraphs Entity Embed.
- Tagify.
The site must have Paragraphs Entity Embed buttons configured for the Paragraphs that are intended to be embedded through CKEditor.
Recommended modules/libraries
No additional Drupal modules are required beyond the dependencies listed above.
The module is designed to work particularly well with component-based Drupal themes where individual components provide their own CSS and JavaScript assets.
Similar projects
Paragraphs Entity Embed provides the ability to embed Paragraph entities into rich-text content. Paragraphs Entity Embed Assets addresses the additional editor experience by making the CSS and JavaScript assets required by those embedded components available inside CKEditor.
This module is useful for sites where embedded Paragraphs depend on component-specific frontend assets that are not automatically available in the editor.
Supporting this Module
This module is maintained as an open-source Drupal project. Contributions, issue reports, testing, documentation improvements, and code contributions are welcome through the Drupal.org project page.
Community Documentation
Documentation and examples can be added to this section as they become available.
For issues, feature requests, and contributions, please use the project's issue queue on Drupal.org.