Instalar el plugin de PrestaShop

Con el módulo de PrestaShop, su configurador de configento.app aparece directamente en la ficha de producto de su tienda PrestaShop. Sus clientes componen el producto, ven el precio total al instante y añaden la configuración terminada al carrito habitual. El pedido, los impuestos y el envío se gestionan después con normalidad en PrestaShop. Usted edita sus componentes en el panel de administración integrado, sin salir del back office.

Requisitos

• PrestaShop 9 (el módulo está hecho para PrestaShop 9.0 y posteriores; las versiones anteriores no pueden instalarlo)
• Las URL amigables (Friendly URLs) deben estar activadas en su tienda. Solo así el módulo puede conectarse con configento.app – consulte Solución de problemas.
• Acceso al back office de PrestaShop con permiso para instalar módulos
• Un acceso al portal de servicio para el servicio con el que desea conectar la tienda
• Al menos un componente publicado – los borradores sin publicar no se pueden seleccionar en la tienda

Qué motor de frontend funciona

El módulo de PrestaShop 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, la vista 360°, el autocompletado o la cantidad predefinida – no están disponibles en PrestaShop. Encontrará el resumen en Motor de frontend: Legacy o V3.

Descargar el módulo

El módulo lo obtiene en configento.app, en Ajustes → Integraciones, tarjeta PrestaShop 9, botón Descargar el módulo. 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 módulo

En el back office

1. Abra el gestor de módulos de su back office de PrestaShop y suba el archivo ZIP del módulo. No lo descomprima antes.
2. Instale el módulo configento.app.

Durante la instalación, el módulo añade su propio elemento de menú configento.app en la sección Catálogo.

Por línea de comandos

Si tiene acceso a la línea de comandos, copie la carpeta descomprimida configento en el directorio modules/ de su tienda y ejecute en el directorio de la tienda:

php bin/console prestashop:module install configento

El nombre técnico del módulo es configento. Asegúrese de que la carpeta pertenezca después al usuario del servidor web.

Conectar con configento.app

La conexión se establece una sola vez desde el back office. No necesita copiar ningún token.

1. Abra Catálogo → configento.app.
2. Verá la tarjeta Mit configento.app verbinden (por ahora, el módulo muestra esta tarjeta y sus botones en alemán). Haga clic en Verbinden.
3. Se le redirigirá al portal de servicio. Inicie sesión y confirme la conexión.
4. Después volverá al back office, y el panel de administración de configento.app se abrirá directamente en la página.

Al conectar, el módulo prepara también todo lo que necesita la ficha de producto: obtiene las credenciales de su tienda y notifica los dominios de su tienda a configento.app (consulte Autorizar el dominio de la tienda).

Cada usuario del back office se conecta por separado. La conexión vale para la cuenta de usuario que la ha establecido, no para toda la tienda. Si un compañero trabaja con su propio acceso, verá de nuevo la tarjeta Mit configento.app verbinden la primera vez que abra Catálogo → configento.app.

Encima del panel de administración integrado aparecen la dirección de correo electrónico de su acceso al portal y el botón Verbindung trennen (desconectar).

Editar componentes en el back office

Una vez conectado, Catálogo → configento.app abre el panel de administración de configento.app directamente en el back office. 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.

Autorizar el dominio de la tienda

El configurador solo se carga en dominios autorizados para su servicio. El módulo notifica los dominios de su tienda al conectar, pero no los autoriza por sí mismo:

1. En el panel de administración de configento.app, abra Ajustes → Dominios.
2. En la sección Notificados por las tiendas conectadas aparecen los dominios notificados de su tienda PrestaShop.
3. Elija el tipo, por ejemplo Producción, y haga clic en Añadir a la licencia.

Se notifican las direcciones de tienda activas, también las demás tiendas de una multitienda. Si más adelante se añade un dominio nuevo, introdúzcalo usted mismo en Ajustes → Dominios o vuelva a conectar el módulo. Más información: Configuración global.

Vincular un producto con un componente

1. Abra el producto en el back office.
2. El módulo añade la sección configento.app al producto.
3. En Component, seleccione el componente de la lista. Con el campo de búsqueda situado encima lo encontrará por título o ID. La lista muestra los componentes publicados de su servicio conectado.
4. Guarde el producto.

Un producto tiene exactamente un componente. Para desvincularlo, elija — not linked — y guarde.

Si la lista no se puede cargar – por ejemplo, porque su cuenta de usuario aún no está conectada –, la sección muestra en su lugar un campo sencillo. Introduzca allí el ID del componente, tal como aparece en su ficha en la vista general de componentes.

En una multitienda, la vinculación vale para la tienda en la que está editando el producto.

Qué ocurre en la tienda

En la ficha de producto

• El configurador aparece justo debajo del precio, encima de la zona de compra.
• Precio: Se muestra el precio del producto más el recargo de la configuración. El precio en la zona de compra de su tema se actualiza con cada selección. Se calcula con el tipo impositivo que PrestaShop aplica a este producto.
• Con o sin impuestos: El configurador muestra los precios igual que su tienda. Si el grupo de clientes del visitante ve los precios sin impuestos – por ejemplo, un grupo B2B – o los impuestos están desactivados en la tienda, los recargos también son netos, y PrestaShop añade el impuesto por sí mismo, igual que con el precio del producto. En caso contrario, el configurador calcula con impuestos, con el tipo impositivo del producto. Así, un mismo componente funciona en tiendas con ajustes de impuestos muy distintos.
• Moneda: Si su tienda tiene varias monedas, el configurador muestra el precio total y los recargos de cada valor en la moneda del visitante. La conversión usa los tipos de cambio de su tienda. Para ello, la moneda en la que el componente lleva sus precios debe estar creada en su tienda.
• Combinación: Si el cliente elige otra combinación, por ejemplo otra talla, el configurador sigue con su precio como precio base y con sus atributos. Al carrito va la combinación elegida.
• Imagen del producto: Si su componente genera una imagen de producto combinada, aparece como primera imagen propia en la galería de imágenes de su tema, con su propia miniatura. Sus clientes pueden cambiar entre sus fotos y la configuración; en cuanto cambian algo, la vista vuelve a la configuración. Los temas sin galería de imágenes muestran la imagen en lugar de la foto del producto.
• Cantidad: Si el cliente cambia la cantidad, la configuración se conserva.

Añadir al carrito

El botón Añadir al carrito de su tema añade la configuración al carrito, no el producto sin más. Antes, el configurador comprueba los campos obligatorios y salta a la primera característica que falta.

configento.app vuelve a calcular el precio en el servidor al añadir el artículo. Por lo tanto, lo que se muestra en el navegador no puede llegar manipulado al carrito. Después, el artículo pasa directamente al carrito.

Carrito, pago y pedido

• La línea muestra dos datos: Configuración con el resumen de la selección y Vista previa con la imagen de producto combinada.
• El carrito, el proceso de pago, la confirmación del pedido y el pedido muestran la imagen combinada en lugar de la foto del catálogo. Los invitados sin cuenta de cliente también la ven a través de la referencia del pedido.
• El recargo está incluido en el precio de la línea. PrestaShop calcula los impuestos como de costumbre.

Cambiar la configuración

Cada línea configurada del carrito tiene el enlace Cambiar la configuración. Lleva de vuelta a la ficha de producto, y el configurador muestra la selección guardada. Cuando el cliente añade la configuración modificada al carrito, sustituye a la línea anterior.

Listados de productos

En los listados de categorías y de búsqueda, PrestaShop oculta el botón de compra directa en los productos configurables, para que nadie añada el producto al carrito sin configuración. El botón hacia la ficha de producto se llama allí Configurar ahora.

Datos del producto en fórmulas

Las características del tipo de datos Atributo de producto leen valores del producto de PrestaShop, para que una fórmula pueda calcular, por ejemplo, con el ancho, el peso o la talla. Como código, introduzca en la característica:

Si un código existe varias veces, gana el origen situado más arriba en la tabla. Los nombres de las características y de los grupos de atributos valen en el idioma del visitante – en una tienda multilingüe, póngales el mismo nombre en todos los idiomas; si no, la característica queda vacía en los demás idiomas.

Cuando el cliente cambia de combinación, las características reciben los valores de la nueva combinación. La comprobación del precio al añadir al carrito calcula con los mismos valores. El módulo nunca entrega el precio de compra, los datos del proveedor, la ubicación en el almacén ni las descripciones, porque los valores aparecen en el código fuente de la ficha de producto. Más sobre este tipo de datos: Características de cálculo.

Pedidos en el back office

En la página del pedido del back office, el módulo muestra la tarjeta Configuraciones (configento.app). Para cada línea configurada verá:

• el producto y la cantidad, el componente y el Recargo verificado – el precio que configento.app confirmó al añadir el artículo
• todas las características con su valor, también las que el cliente no vio, como cálculos ocultos. Llevan la indicación no visible para el cliente.
• la imagen de producto combinada, si el componente genera una
• el botón Descargar la configuración (JSON) con la configuración completa como archivo, por ejemplo para la fabricación

Estado de la suscripción en el back office

Si hay algo que hacer con su suscripción a configento.app, el módulo muestra un aviso en la parte superior de cada página del back office, con el enlace Gestionar la suscripción al portal de servicio:

Si configento.app deja de dar servicio a su tienda, las fichas de producto muestran la frase Este producto no se puede configurar en este momento. en lugar del configurador. Así ningún cliente se encuentra con un configurador que no carga. El módulo consulta el estado como máximo una vez por hora; tras una renovación, el aviso puede tardar hasta una hora en desaparecer.

Desconectar

Verbindung trennen, encima del panel de administración integrado, desconecta su cuenta de usuario – en el módulo y en el portal de servicio.

Importante: Mientras otro usuario del back office siga conectado, el configurador sigue funcionando en la tienda. Cuando se desconecta el último usuario conectado, el módulo borra también las credenciales de la tienda – el configurador desaparece entonces de todas las fichas de producto hasta que alguien vuelva a conectarse.

Desinstalar el módulo

Al desinstalarse, el módulo elimina sus conexiones, las vinculaciones entre productos y componentes y las configuraciones guardadas de los carritos abiertos. Los pedidos conservan su resumen y su imagen de vista previa.

Antes de desinstalar, desvincule el componente de cada producto (— not linked —) y haga clic una vez en Verbindung trennen. De lo contrario, los productos siguen siendo «configurables» para PrestaShop, y la autorización en el portal de servicio se mantiene.

Solución de problemas

1. Tras «Verbinden» aparece un mensaje de error, o el portal rechaza la conexión – compruebe si las URL amigables (Friendly URLs) de su tienda están activadas. Sin ellas, el módulo no puede crear la dirección de retorno que exige el portal de servicio.
2. «Conectado, pero no se ha podido obtener el token de la tienda» – la conexión existe, pero faltan las credenciales para la ficha de producto. Desconecte y vuelva a conectar.
3. En la ficha de producto no aparece ningún configurador – o bien el producto no tiene ningún componente vinculado, o bien ya no hay ningún usuario del back office conectado. Compruebe ambas cosas en Catálogo → configento.app y en el producto.
4. «No se pudo cargar el componente (HTTP 401)» – el dominio de su tienda no está autorizado. Consulte Autorizar el dominio de la tienda.
5. Falta la lista de componentes en el producto, solo hay un campo de entrada – su cuenta de usuario no está conectada o el portal de servicio no estaba disponible en ese momento. Conéctese en Catálogo → configento.app o introduzca directamente el ID del componente.
6. «No se ha podido comprobar el precio en este momento. Inténtalo de nuevo en un momento.» – la comprobación de precios de configento.app no estuvo disponible durante un instante, o la moneda del componente no está creada en su tienda. No se ha añadido nada al carrito; el cliente puede volver a intentarlo enseguida. Si el mensaje se repite, busque en el registro de su tienda entradas con «configento: Preisprüfung nicht verfügbar».
7. «Esta configuración ya no es válida. Vuelve a componerla.» – el componente se modificó mientras el cliente configuraba. La única solución es recargar la página y volver a componer la configuración.
8. 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 catálogo.
9. «Este producto no se puede configurar en este momento.» – su suscripción a configento.app ya no da servicio a la tienda. Consulte Estado de la suscripción en el back office.
10. Una característica de atributo de producto queda vacía – el código no coincide, o la característica o el grupo de atributos tiene otro nombre en el idioma del visitante. Consulte Datos del producto en fórmulas.

Próximos pasos

• Crear su primer componente
• Motor de frontend: Legacy o V3
• Configurar precios
• Configuración global