Personalización de Producto (grabado, texto, imagen) — Guía completa

Presentación

El módulo Personalización de Producto permite a tus clientes personalizar un artículo directamente desde la ficha de producto: introducir un texto / grabado (con fuente y color) o subir una imagen. La personalización se muestra como vista previa en vivo sobre la foto del producto — posicionamiento arrastrando, tamaño y rotación ajustables — y cada opción puede aplicar un recargo de precio (importe fijo o porcentaje) añadido automáticamente al carrito.

El módulo es compatible con PrestaShop 8.x y 9.x. Crea sus propias tablas y no sobrescribe las fichas de producto existentes: la personalización se gestiona mediante opciones que creas, segmentadas por categoría y afinables producto por producto.

Instalación

1. Comprime la carpeta dfcustomizer (o usa directamente el archivo dfcustomizer.zip proporcionado).
2. En el back-office, abre Módulos > Gestor de módulos.
3. Haz clic en Subir un módulo y suelta el archivo ZIP.
4. Una vez instalado, haz clic en Configurar para crear tus opciones.

Durante la instalación, el módulo crea las tablas necesarias (dfc_option y sus tablas relacionadas, dfc_product_override, dfc_customization) y registra los hooks de visualización en la ficha de producto, el carrito y el pedido.

Configuración: crear una opción

Ve a Módulos > dfcustomizer > Configurar para crear y gestionar tus opciones de personalización. Cada opción define un tipo de personalización, su impacto en el precio y su ámbito de aplicación.

Tipo de personalización

• Texto / grabado: el cliente introduce un texto. Puedes ofrecer una elección de fuente y color (ambos opcionales).
• Subida de imagen: el cliente sube un archivo en formato JPG, PNG o WEBP.

Impacto en el precio

Cada opción puede añadir un recargo al precio del producto:

• un importe fijo (sin IVA), o
• un porcentaje del precio del producto.

El recargo se muestra en tiempo real del lado del cliente y se traslada al carrito (ver la sección Carrito y precio).

Segmentación por categoría

Marca las categorías a las que debe aplicarse la opción: la opción solo aparecerá en los productos de esas categorías. Si no se marca ninguna categoría, la opción se aplica a todo el catálogo.

Override por producto

En la ficha de producto (pestaña Módulos), cada producto dispone de un ajuste de override. Puede:

• heredar las opciones definidas por las categorías (comportamiento por defecto);
• elegir sus propias opciones específicamente para ese producto;
• desactivar por completo la personalización para ese producto.

Lado del cliente (front-office)

En la ficha de producto, el cliente introduce su texto (fuente, color) o sube su imagen. La personalización se muestra inmediatamente como vista previa en vivo sobre la foto del producto:

• posicionamiento arrastrando sobre la imagen;
• controles de tamaño y rotación para ajustar el resultado.

El recargo de precio ligado a las opciones elegidas se muestra en vivo. Al añadir al carrito, la personalización y una vista previa aplanada en formato PNG se guardan para recuperarlas con el pedido.

Carrito y precio

El recargo se añade al precio del artículo en el carrito mediante una regla de precio vinculada al carrito (SpecificPrice asociada al id_cart). Se recalcula en cada guardado del carrito y se elimina automáticamente si el producto se retira del carrito.

Lado del pedido

Back-office

En la página de un pedido, un panel «Personalizaciones de producto» resume cada personalización: el texto introducido, el archivo del cliente descargable y la vista previa generada. Dispones de todo lo necesario para la producción (grabado, impresión, etc.).

Front-office

El cliente encuentra un recordatorio de sus personalizaciones en el detalle de su pedido.

Notas técnicas

• Tablas creadas: dfc_option (+ dfc_option_lang y dfc_option_category), dfc_product_override, dfc_customization.
• Recargo de precio: aplicado mediante SpecificPrice vinculado al carrito (id_cart), recalculado en cada guardado del carrito y eliminado si se retira el producto.
• Archivos del cliente: almacenados en modules/dfcustomizer/uploads/, carpeta cuya ejecución de PHP está bloqueada por un archivo .htaccess por seguridad.

Resolución de problemas

La opción de personalización no aparece en la ficha de producto

Comprueba que la opción está activa y que sus categorías incluyen la categoría del producto (o que no hay ninguna categoría marcada para apuntar a todo el catálogo). Después revisa el override por producto (pestaña Módulos de la ficha): la personalización no debe estar desactivada para ese producto. Por último, vacía la caché de PrestaShop.

El recargo de precio no aparece en el carrito

El recargo se recalcula al guardar el carrito. Comprueba que la opción tiene un impacto en el precio (importe fijo o porcentaje) y recarga el carrito. Si el producto se retiró y se volvió a añadir, hay que rehacer la personalización.

La subida de imagen es rechazada

Solo se aceptan los formatos JPG, PNG y WEBP. Comprueba el formato del archivo así como el tamaño máximo de subida permitido por tu alojamiento (upload_max_filesize / post_max_size de PHP).

Desinstalación

La desinstalación elimina los hooks y la configuración del módulo. Haz una copia de seguridad previa de los archivos de cliente en modules/dfcustomizer/uploads/ y de los datos de personalización de los pedidos si deseas conservarlos.

FAQ

¿El módulo es compatible con PrestaShop 9?

Sí, el módulo es compatible con PrestaShop 8.x y 9.x.

¿Puedo cobrar por la personalización?

Sí. Cada opción puede aplicar un recargo, como importe fijo (sin IVA) o porcentaje del precio del producto, añadido automáticamente al carrito.

¿Puedo limitar una opción a ciertos productos?

Sí, de dos maneras: mediante la segmentación por categoría de la opción, y mediante el override por producto que permite a cada ficha heredar, elegir sus propias opciones o desactivar la personalización.

¿Puede el cliente añadir varias personalizaciones al mismo artículo?

Solo se guarda una personalización por par producto/combinación y por carrito.