Con el fragmento HTML, su configurador de configento.app aparece en cualquier página de WordPress, como herramienta de presupuesto o de solicitud en su sitio web. No necesita ningún plugin: basta con una etiqueta <script> y un <div> en el bloque HTML personalizado. Los visitantes montan su producto, ven el precio al instante y le envían su solicitud con el botón de acción: por correo electrónico, como PDF o a su propia URL.
Plugin para WooCommerce en el 4.º trimestre de 2026: para tiendas WooCommerce lanzaremos un plugin propio en el cuarto trimestre de 2026. Añade la configuración al carrito con un precio verificado. Hasta entonces, el fragmento también funciona en páginas de WooCommerce, pero solo como herramienta de solicitud; consulte WooCommerce.
Qué necesita
- Un acceso a configento.app: el fragmento HTML está incluido a partir del plan Basic; para probarlo basta con la prueba de 14 días.
- Al menos un componente publicado. El fragmento siempre muestra la última versión publicada.
- Una cuenta de usuario de WordPress con el rol Administrador o Editor; consulte Quién puede añadir scripts.
Paso 1: Preparar el fragmento y el dominio
- En el admin, abra Ajustes → Integraciones, haga clic en Generar en la tarjeta HTML5 (V3 Beta) y copie el Fragmento JavaScript V3 con Copiar.
- En Ajustes → Dominios, introduzca el dominio de su sitio WordPress sin
https://, p. ej.www.misitio.es. Si hace pruebas en un sitio de staging, introduzca también su dominio. - En el fragmento, sustituya
YOUR_TEMPLATE_IDpor el ID de su componente. Lo encontrará en la vista general de componentes, p. ej. ID 10722.
Los pasos en detalle están en Integración fragmento HTML.
Paso 2: Insertar el fragmento en WordPress
En el editor de bloques
- Abra la página o la entrada en el editor.
- Añada el bloque HTML personalizado en el lugar deseado (con + o escribiendo
/html). - Pegue el fragmento en el bloque.
- Guarde la página y ábrala en el navegador.
No use el bloque Párrafo ni otro bloque de texto: allí WordPress elimina la etiqueta <script>.
En el editor clásico
Cambie a la pestaña Texto arriba a la derecha (no Visual) y pegue allí el fragmento.
Con un maquetador
Los maquetadores tienen su propio elemento para código HTML, por ejemplo el widget HTML de Elementor o el módulo Código de Divi. Pegue allí el fragmento. Algunos maquetadores solo muestran el configurador en la vista previa o en la página publicada, no en el modo de edición.
En varias páginas
La etiqueta <script> solo debe aparecer una vez en cada página. Si una página tiene varios configuradores, cada uno solo necesita su propio <div data-configento …>. Si usa el mismo configurador en muchas páginas, guarde el bloque HTML como patrón sincronizado; así lo cambia en un solo lugar.
Quién puede añadir scripts
WordPress solo permite etiquetas <script> a los usuarios con permiso para HTML sin filtrar. En un sitio normal, son los roles Administrador y Editor. Si un Autor o un Colaborador guarda la página, WordPress elimina el script y el configurador no aparece. En una red de WordPress (multisitio), solo pueden hacerlo los Superadministradores.
Si alguien sin este permiso edita una página con el fragmento, el script puede perderse al guardar. Compruebe después la página en el navegador.
Precio, resumen e imagen
Sin más atributos, el fragmento no muestra precio ni resumen. Lo más sencillo en una página de WordPress es:
data-configento-embed-mode="admin-preview"Así, el título, la barra de precio y el resumen aparecen dentro del propio configurador, como en la vista previa del admin. Si quiere colocar el precio o la imagen en otro lugar, por ejemplo junto a un título, cree los elementos de destino en el mismo bloque HTML; consulte Integración fragmento HTML.
El aspecto lo adapta a su tema con CSS: Personalizar el diseño (CSS).
Sitios multilingües
Si su sitio es multilingüe gracias a un plugin de traducción, cada idioma tiene su propia página. Indique allí el idioma correspondiente en el fragmento, p. ej. data-configento-locale="es_ES" en la página en español. También puede dejar que el visitante elija el idioma en el configurador; consulte Integración fragmento HTML.
Recibir solicitudes
En un sitio web sin tienda, el botón de acción completa la configuración. Le envía la solicitud por correo electrónico y, si lo desea, una copia con PDF al visitante, genera un presupuesto en PDF o pasa la configuración a su propia URL. El Captcha protege contra el spam.
Para pasar la solicitud a un formulario existente, lea la selección mediante la interfaz JavaScript.
Optimización y caché
La caché de páginas no es un problema: el fragmento es HTML estático y el configurador carga sus datos por sí mismo.
Sin embargo, los plugins que retrasan, combinan o aplazan JavaScript pueden ralentizar el configurador o impedir que se cargue: entonces solo aparece tras mover el ratón o no aparece. En esos plugins, añada configento.js o cloud.configento.app a la lista de exclusiones de JavaScript.
WooCommerce
Para WooCommerce lanzaremos un plugin propio en el cuarto trimestre de 2026. Muestra el configurador en la página de producto, verifica el precio en el servidor y añade la configuración con su recargo al carrito de WooCommerce, como nuestros plugins para Magento, Shopware, Shopify y PrestaShop.
Hasta entonces, también puede usar el fragmento en una tienda WooCommerce, por ejemplo en la descripción del producto. Allí muestra el configurador y el precio, pero no añade nada al carrito. Mientras tanto, úselo como herramienta de solicitud con el botón de acción.
El antiguo plugin de WooCommerce de la nube clásica ya no se desarrolla.
Solución de problemas
| Lo que ve | Causa y solución |
|---|---|
| Nada, ningún recuadro | Se eliminó el script: el fragmento no se insertó en el bloque HTML personalizado, o la página la guardó un usuario sin permiso para HTML sin filtrar. Consulte Quién puede añadir scripts. |
| El configurador solo aparece tras mover el ratón, o no aparece | Un plugin de optimización retrasa el script. Consulte Optimización y caché. |
«No se pudo cargar el componente (HTTP 401)» con Requesting host not authorized |
Falta el dominio en Ajustes → Dominios; introduzca también los dominios de staging. |
| «No se pudo cargar el componente (HTTP 404)» | YOUR_TEMPLATE_ID sin sustituir, ID incorrecto o componente aún no publicado. |
| Se ve el configurador, pero no el precio | Falta data-configento-embed-mode="admin-preview" o data-configento-price-mount. |
Encontrará más casos en la solución de problemas de Integración fragmento HTML.