# 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… - Página: - Idioma: es - Actualizado el: 2026-07-10 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfcustomizer/index.md), [en](https://www.datafirefly.com/en/documentation/dfcustomizer/index.md), [de](https://www.datafirefly.com/de/documentation/dfcustomizer/index.md), [it](https://www.datafirefly.com/it/documentation/dfcustomizer/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcustomizer/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcustomizer/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcustomizer/index.md) - Índice: ## 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. **Nota:** solo es posible una personalización por par _producto / combinación_ y por 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. **Limitación:** una personalización por par producto/combinación y por carrito. ## 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.