Paragraphs Entity Embed
Permite incrustar entidades de párrafo directamente en los campos del editor WYSIWYG de CKEditor.
paragraphs_entity_embed
Instalar
composer require 'drupal/paragraphs_entity_embed:^3.0'
Overview
Paragraphs Entity Embed conecta el módulo Paragraphs con CKEditor, permitiendo a los editores de contenido insertar contenido de párrafos enriquecido y estructurado directamente dentro de los campos del editor de texto. Este módulo crea un flujo de trabajo fluido donde los usuarios pueden crear nuevos elementos de párrafo o reutilizar los existentes dentro de su contenido WYSIWYG.
El módulo proporciona un tipo de entidad personalizado llamado 'Embedded Paragraphs' que actúa como contenedor para las referencias de párrafos. Cuando un usuario hace clic en el botón Paragraphs en CKEditor, se abre un diálogo modal donde puede crear un nuevo párrafo o seleccionar un párrafo incrustado existente mediante autocompletado. Los párrafos incrustados se renderizan en línea dentro del contenido de texto utilizando un modo de visualización especial 'embed'.
Este enfoque es particularmente útil para sitios que desean mantener componentes de contenido consistentes y reutilizables mientras dan a los editores la flexibilidad de colocarlos en cualquier parte de su texto, no solo en campos de párrafo dedicados.
Features
- Integración con CKEditor con un botón de barra de herramientas dedicado para insertar párrafos en el contenido WYSIWYG
- Interfaz de diálogo modal para crear nuevos párrafos o seleccionar párrafos incrustados existentes
- Funcionalidad de autocompletado para encontrar y reutilizar rápidamente párrafos incrustados creados anteriormente
- Tipo de entidad personalizado 'Embedded Paragraphs' que almacena referencias de párrafos con etiquetas para fácil identificación
- Plugin de filtro que procesa y renderiza los párrafos incrustados cuando se muestra el contenido
- Filtrado por tipo de párrafo para restringir qué tipos de párrafo pueden incrustarse mediante botones de incrustación específicos
- Soporte de edición con doble clic para modificar rápidamente los párrafos incrustados en CKEditor
- Integración del menú contextual en CKEditor para editar párrafos incrustados
- Modo de visualización 'embed' dedicado para párrafos que controla cómo aparecen cuando están incrustados
- Widget de campo que extiende el widget estándar de Paragraphs para gestionar referencias de párrafos incrustados
Use Cases
Incrustar bloques de llamada a la acción dentro del texto del artículo
Los editores de contenido pueden crear componentes de párrafo de llamada a la acción reutilizables (con botones, imágenes y texto estilizado) e insertarlos en cualquier punto dentro del texto del cuerpo de su artículo, no solo al principio o al final del contenido.
Insertar destacados de productos en publicaciones de blog
Los sitios de comercio electrónico pueden definir párrafos de avance de productos y permitir que los autores de blogs incrusten destacados de productos directamente dentro del contenido de sus publicaciones, creando una experiencia de lectura fluida.
Reutilizar citas de testimonios en múltiples páginas
Cree párrafos de testimonios una vez e incrústelos en múltiples piezas de contenido. La función de autocompletado facilita encontrar y reutilizar testimonios existentes sin tener que recrearlos.
Añadir elementos interactivos a contenido extenso
Para sitios con tipos de párrafo complejos como acordeones, pestañas o galerías de medios, los editores pueden incrustar estos elementos interactivos en cualquier parte de su contenido de texto en lugar de estar limitados a posiciones de campo fijas.
Tips
- Cree un modo de visualización 'Embed' dedicado para cada tipo de párrafo con la visibilidad y formato de campos apropiados para la visualización en línea dentro del contenido de texto
- Use etiquetas descriptivas al crear párrafos incrustados para que sean fáciles de encontrar mediante el autocompletado al reutilizarlos
- Considere crear un rol de editor de contenido con los permisos apropiados de incrustación de párrafos para controlar quién puede crear y gestionar párrafos incrustados
- Pruebe el renderizado de párrafos incrustados tanto en el modo de visualización predeterminado como en el modo de visualización embed para asegurar un estilo consistente
Technical Details
Admin Pages 2
/admin/config/content/embed
Gestione los botones de incrustación incluyendo el botón de incrustación de Paragraphs. El botón de Paragraphs se crea automáticamente al instalar el módulo y puede configurarse aquí.
/admin/structure/paragraphs_entity_embed/{paragraphs_type}
Interfaz administrativa para editar entidades de párrafos incrustados directamente.
Permisos 5
Hooks 2
hook_entity_type_build
Añade una clase de formulario personalizada al tipo de entidad embedded_paragraphs para manejar el formulario del diálogo de CKEditor
hook_preprocess_html
Oculta elementos de la página (barra de herramientas, pie de página, barras laterales) al mostrar el formulario de incrustación de párrafos en un iframe dentro del diálogo de CKEditor
Troubleshooting 4
Asegúrese de que el botón Paragraphs se haya añadido a la configuración de la barra de herramientas para su formato de texto. Vaya a Configuración > Formatos de texto y editores, edite su formato y arrastre el botón Paragraphs a la barra de herramientas activa.
Habilite el filtro 'Display embedded paragraphs' para su formato de texto. También verifique que el orden de los filtros sea correcto - los filtros de entity embed generalmente deben ejecutarse después de la corrección HTML.
Verifique que haya creado tipos de párrafo y que el botón de incrustación no esté configurado para filtrar tipos de párrafo a una selección vacía.
Configure el modo de visualización 'Embed' para sus tipos de párrafo en Estructura > Tipos de párrafo > [tipo] > Gestionar visualización. Seleccione el modo de visualización 'Embed' y configure qué campos deben mostrarse.
Security Notes 3
- El permiso 'administer paragraphs entity embed' está marcado como restringido y solo debe otorgarse a administradores de confianza
- Los usuarios necesitan tanto acceso al formato de texto como los permisos apropiados de incrustación de párrafos para insertar párrafos incrustados
- El contenido de párrafos incrustados está sujeto a los mismos controles de acceso que el tipo de contenido padre