Instalar el plugin de WooCommerce y WordPress

Con el plugin de WordPress lleva sus configuradores de configento.app a cualquier página de su sitio WordPress, con un bloque o un shortcode. Si WooCommerce está instalado, el configurador aparece también en la ficha de producto: sus clientes componen el producto, ven el precio total al instante y añaden la configuración terminada al carrito habitual. configento.app comprueba el precio en el servidor. Usted edita sus componentes en el panel de administración integrado, sin salir de wp-admin.

Requisitos

• WordPress 6.6 o posterior y PHP 8.1 o posterior. Para la tienda, además WooCommerce 9 o posterior.
• Enlaces permanentes legibles: en Ajustes → Enlaces permanentes, un ajuste distinto de Simple. Solo así el plugin puede conectarse con configento.app; consulte Solución de problemas.
• Un usuario de WordPress con permiso para instalar plugins y cambiar ajustes (administrador).
• Un acceso al portal de servicio para el servicio con el que desea conectar el sitio.
• Al menos un componente publicado.

Qué motor de frontend funciona

El plugin carga siempre el motor V3. El ajuste Motor de frontend del componente no influye aquí. Las funciones que solo existen en Legacy, como el acordeón, el autocompletado o la cantidad predefinida, no están disponibles en WordPress. Encontrará el resumen en Motor de frontend: Legacy o V3.

Descargar el plugin

El plugin lo obtiene en configento.app, en Ajustes → Integraciones, tarjeta WordPress / WooCommerce, botón Descargar plugin. Recibe un archivo ZIP: no lo descomprima.

Si la pestaña está bloqueada, acepte primero el contrato de encargo de tratamiento en Ajustes → Tratamiento de datos.

Instalar el plugin

1. En wp-admin, abra Plugins → Añadir nuevo plugin y haga clic arriba en Subir plugin.
2. Elija el archivo ZIP y haga clic en Instalar ahora.
3. Haga clic en Activar plugin.

El plugin añade el elemento de menú configento en wp-admin. Por línea de comandos: wp plugin install configento-wordpress-*.zip --activate.

Una versión nueva se instala igual: WordPress pregunta si debe sustituir el plugin instalado. La conexión y las vinculaciones se conservan.

Conectar con configento.app

La conexión se establece una sola vez desde wp-admin. No necesita copiar ninguna clave.

1. Abra el elemento de menú configento.
2. Verá la tarjeta Conectar su cuenta de configento.app. Haga clic en Conectar con configento.app.
3. Se le redirigirá al portal de servicio. Inicie sesión y confirme la conexión.
4. Después volverá a wp-admin, y el panel de administración de configento.app se abrirá directamente en la página.

Si los enlaces permanentes están en Simple, la tarjeta muestra en lugar del botón un aviso que indica dónde cambiarlo.

Al conectar, el plugin prepara también todo lo que necesitan sus páginas: obtiene las credenciales de su sitio y notifica su dominio a configento.app (consulte Autorizar el dominio). Si su servicio es una instancia Enterprise propia, el portal de servicio la indica al conectar y el plugin trabaja con esa instancia.

Cada usuario de WordPress se conecta por separado. La conexión vale para la cuenta de usuario que la ha establecido. Si un compañero trabaja con su propio acceso, verá de nuevo la tarjeta para conectar la primera vez que abra configento. El configurador de sus páginas sigue funcionando mientras al menos un usuario esté conectado.

Encima del panel de administración integrado aparecen la dirección de correo electrónico de su acceso al portal y el botón Desconectar.

Editar componentes en wp-admin

Una vez conectado, configento abre el panel de administración de configento.app directamente en wp-admin. Allí crea componentes, mantiene características, valores, precios y reglas y los publica, exactamente igual que en admin.configento.app. Los fundamentos están en Crear su primer componente.

Si la página permanece abierta mucho tiempo, la sesión del panel integrado acaba caducando. El plugin la renueva entonces en segundo plano; no necesita recargar la página.

Autorizar el dominio

El configurador solo se carga en dominios autorizados para su servicio. El plugin notifica el dominio de su sitio, pero no lo autoriza por sí mismo. Mientras no esté autorizado, la página configento muestra un aviso.

1. En el panel de administración integrado, abra Ajustes → Dominios.
2. En la sección Notificados por las tiendas conectadas aparece el dominio de su sitio con la indicación WooCommerce.
3. Elija el tipo, por ejemplo Producción o Staging, y haga clic en Añadir a la licencia.

El dominio se notifica al conectar y cada vez que cambia la dirección del sitio en Ajustes → Generales, por ejemplo al pasar de un entorno de prueba al dominio definitivo. Después solo hay que añadir el dominio nuevo a la licencia. Más información: Configuración global.

Mostrar un configurador en una página

En cualquier página y en cualquier entrada, también sin WooCommerce, por ejemplo para configuradores de solicitud con el botón de acción.

Con el bloque

1. En el editor de bloques, inserte el bloque Configurador configento (categoría Incrustados).
2. En Configurador, elija el componente de la lista. La lista muestra los componentes de su servicio conectado. Si no se puede cargar, introduzca en su lugar el ID del configurador, tal como aparece en la ficha de la vista general de componentes.
3. Opcionalmente, en la barra lateral, en Ajustes:
   • Altura mínima, por ejemplo 600px. Evita que la página salte mientras se carga el configurador.
   • Selección de idioma: los visitantes pueden cambiar entre los idiomas del configurador.

En el editor, el bloque solo indica qué configurador aparece. El configurador en sí lo ve en la vista previa y en la página.

Con el shortcode

Para el editor clásico y los maquetadores:

[configento id="10722"]

Qué ocurre

• El configurador aparece en el idioma de la página. Los sitios multilingües (por ejemplo con WPML o Polylang) lo muestran así automáticamente en el idioma correcto; si falta una traducción, usa otra disponible.
• El script del configurador solo se carga en páginas con configurador.
• El código fuente de la página no contiene ninguna clave de acceso ni ningún token: el configurador obtiene un token de corta duración a través de su sitio. Por eso, los plugins de caché pueden almacenar en caché las páginas con configurador.
• Si el sitio no está conectado, solo los editores con sesión iniciada ven un aviso; los visitantes no ven nada.

WooCommerce: vincular un producto con un componente

1. Abra el producto en Productos.
2. La caja Datos del producto tiene la pestaña configento.
3. En Configurador, elija el componente de la lista. Si no se puede cargar, aparece en su lugar el campo ID del configurador.
4. Actualice el producto.

Un producto tiene exactamente un componente. Para desvincularlo, elija Sin configurador. El precio del producto es el precio base; la configuración se suma como recargo.

Qué ocurre en la tienda

En la ficha de producto

• El configurador aparece encima del botón Añadir al carrito.
• Precio: el precio de la ficha de producto muestra el precio del producto más la configuración y se actualiza con cada selección; es el importe que cobra el carrito. En los productos variables cuenta la variación elegida: su precio más la configuración aparece donde WooCommerce muestra el precio de la variación.
• Con o sin impuestos: el configurador muestra los precios igual que su tienda. Si WooCommerce muestra los precios sin impuestos o los impuestos están desactivados, los recargos también son netos. En caso contrario, calcula con el tipo impositivo que WooCommerce aplica a este producto y a este cliente.
• Moneda: el componente debe llevar sus precios en la moneda de su tienda.
• Cantidad: si bloquea la cantidad en el carrito en el componente (consulte Configuración del componente), la ficha de producto no muestra ningún campo de cantidad y cada configuración se queda con cantidad 1 en el carrito.

Añadir al carrito

El botón Añadir al carrito añade la configuración al carrito, no el producto sin más. Antes, el configurador comprueba los campos obligatorios y marca lo que falta.

configento.app vuelve a calcular el precio en el servidor al añadir el artículo. También la descripción de la configuración que acompaña al pedido la crea configento.app a partir de la selección comprobada. Por lo tanto, lo que se muestra en el navegador no puede llegar manipulado al carrito. Esto vale tanto para el carrito clásico como para el bloque Carrito.

Listados de productos

En los listados de la tienda, de categorías y de búsqueda, el botón de los productos vinculados se llama Configurar y lleva a la ficha de producto. Así nadie añade el producto al carrito sin configuración, tampoco mediante un bloque Carrito o la Store API.

Carrito, pago y pedido

• La línea muestra Configuración con el resumen de la selección.
• Si el componente genera una imagen de producto combinada, el carrito, el pago, la vista del pedido en wp-admin y los correos del pedido muestran esta imagen en lugar de la foto del producto.
• La misma configuración por segunda vez da una línea con cantidad 2 (con la cantidad bloqueada, WooCommerce avisa en su lugar de que el producto ya está en el carrito); otra configuración obtiene su propia línea.
• El pedido, los correos del pedido y la cuenta del cliente muestran la configuración en la línea.
• El plugin es compatible con las tablas de pedidos de WooCommerce (HPOS).

Cambiar la configuración

En el carrito clásico, cada línea configurada tiene el enlace Cambiar la configuración; en el bloque Carrito lleva allí el nombre del producto. La ficha de producto muestra entonces la selección guardada. Cuando el cliente añade la configuración modificada al carrito, sustituye a la línea anterior y vuelve al carrito.

Datos para el ERP y la fabricación

En cada línea del pedido, el plugin guarda, además de la Configuración visible, campos ocultos que las interfaces y exportaciones pueden leer:

Estado de la suscripción

Si hay algo que hacer con su suscripción a configento.app, la página configento muestra un aviso con el enlace Abrir el portal. Si configento.app deja de dar servicio a su sitio, las páginas muestran la frase Este configurador no está disponible en este momento. en lugar del configurador, y WooCommerce ya no acepta configuraciones en el carrito. El plugin consulta el estado como máximo una vez por hora.

Desconectar

Desconectar, encima del panel de administración integrado, desconecta su cuenta de usuario, en el plugin y en el portal de servicio.

Importante: mientras otro usuario siga conectado, el configurador sigue funcionando. Cuando se desconecta el último usuario conectado, el plugin borra también las credenciales del sitio; el configurador desaparece entonces de todas las páginas hasta que alguien vuelva a conectarse.

Borrar el plugin

Al borrarlo en Plugins, el plugin elimina las conexiones, las credenciales y el estado de la suscripción guardado. La vinculación del producto y las configuraciones de los pedidos anteriores se conservan.

Haga clic una vez en Desconectar antes de borrar. De lo contrario, la autorización en el portal de servicio se mantiene.

Qué datos van a configento.app

• Al conectar: la dirección de su sitio y la dirección de retorno a wp-admin, al portal de servicio.
• Después: el dominio de su sitio, para que el configurador pueda cargarse allí, y consultas sobre el estado de la suscripción.
• En páginas con configurador: los navegadores de sus visitantes cargan el configurador desde configento.app y le envían los valores elegidos.
• En el carrito: la selección y el tipo impositivo del producto, para comprobar el precio.

Antes de conectar, el plugin no envía ninguna solicitud al exterior.

Solución de problemas

1. En lugar del botón «Conectar con configento.app» aparece un aviso sobre los enlaces permanentes: elija en Ajustes → Enlaces permanentes un ajuste distinto de Simple. El portal de servicio exige una dirección de retorno que termine en /configento/connect/callback.
2. «No se pudo cargar el componente (HTTP 401)»: el dominio de su sitio no está autorizado. Consulte Autorizar el dominio.
3. En la página no aparece ningún configurador: ¿hay un componente elegido en el bloque o en el shortcode y al menos un usuario conectado? Los editores con sesión iniciada ven un aviso en ese lugar.
4. Falta la lista de configuradores, solo hay un campo para el ID: el sitio no está conectado o configento.app no estaba disponible en ese momento. Conéctese en configento o introduzca directamente el ID.
5. «Configure primero el producto en su página.»: el producto iba a entrar en el carrito sin configuración, por ejemplo mediante un bloque de listado o de carrito. Los productos vinculados solo se compran a través de su ficha de producto.
6. «No se ha podido comprobar el precio en este momento. Inténtelo de nuevo en un momento.»: la comprobación del precio no estuvo disponible durante un instante, o el componente lleva sus precios en una moneda distinta de la de su tienda. El motivo lo encuentra en WooCommerce → Estado → Registros, en las entradas de la fuente configento.
7. «Esta configuración ya no es válida. Vuelva a componerla.»: el componente se modificó mientras el cliente configuraba. Recargue la página y vuelva a componer la configuración.
8. «Este producto no se puede configurar en este momento.»: su suscripción a configento.app ya no da servicio al sitio. Consulte Estado de la suscripción.
9. «La tienda aún no está configurada: desconecte y vuelva a conectar.»: al conectar no se pudieron obtener las credenciales para sus páginas. Desconecte y vuelva a conectar.
10. Falta la imagen de la configuración en el carrito: el componente no genera ninguna imagen de producto combinada. En ese caso, el carrito muestra la foto del producto.

Próximos pasos

• Crear su primer componente
• Configuración del componente
• El botón de acción
• Configuración global