# DataFirefly Fix Product Category: asociar los productos a sus categorías padre

> Instalación Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP, o copie la carpeta dffixproductcategory en el directorio /modules/ de su tienda…

- Página: <https://www.datafirefly.com/es/documentation/dffixproductcategory/>
- Idioma: es
- Actualizado el: 2026-09-28
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dffixproductcategory/index.md), [en](https://www.datafirefly.com/en/documentation/dffixproductcategory/index.md), [de](https://www.datafirefly.com/de/documentation/dffixproductcategory/index.md), [it](https://www.datafirefly.com/it/documentation/dffixproductcategory/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffixproductcategory/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffixproductcategory/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffixproductcategory/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Instalación

Instale el módulo desde **Módulos > Gestor de módulos > Subir un módulo** enviando el archivo ZIP, o copie la carpeta `dffixproductcategory` en el directorio `/modules/` de su tienda y haga clic en Instalar.

La instalación añade la pestaña **Corrección de categorías de producto** en el menú Catálogo y registra los hooks del modo automático. No se crea ninguna tabla: el módulo solo escribe en la tabla nativa `category_product`.

La corrección masiva añade asociaciones en todo el catálogo. Haga una copia de seguridad de la tabla `category_product` antes de la primera corrección, para poder volver atrás si el resultado no encaja con su organización.

## Funcionamiento

Para cada categoría de un producto, el módulo sube por el árbol hasta lo más alto y añade las categorías padre a las que el producto aún no está asociado. Se tienen en cuenta todas las categorías del producto, no solo su categoría por defecto.

Ejemplo: un producto asociado solo a _Zapatillas > Running > Trail_ se añade a _Running_ y a _Zapatillas_. La categoría Raíz nunca se añade, y la categoría Inicio solo si la opción correspondiente está activa.

- No se elimina ninguna asociación existente.
- La categoría por defecto del producto nunca se modifica: la ruta de navegación y la URL del producto no cambian.
- El producto se coloca en la última posición de cada categoría añadida, lo que conserva su orden manual.
- El árbol se lee a partir del padre de cada categoría, por lo que el resultado es correcto aunque el árbol anidado de PrestaShop no se haya regenerado.

## Corrección masiva

Abra **Catálogo > Corrección de categorías de producto**. El panel Corrección masiva procesa todo el catálogo por lotes, con una barra de progreso.

### Simular

Haga clic en **Simular**. No se escribe nada. Los contadores indican el número de productos en el alcance, los productos a corregir y las asociaciones que faltan. La tabla de vista previa lista los 100 primeros productos afectados con las categorías que recibirán.

### Corregir el catálogo

Haga clic en **Corregir el catálogo** y confirme. Los lotes se encadenan hasta el final del catálogo y el contador Asociaciones añadidas muestra el resultado. Puede relanzar la corrección en cualquier momento: los productos ya corregidos no se modifican.

### Solo productos activos

Marque esta casilla para limitar la simulación y la corrección a los productos activos de la tienda actual. Por defecto se procesan todos los productos, incluidos los desactivados, para que estén bien clasificados el día que los vuelva a activar.

## Configuración

### Incluir la categoría Inicio

Desactivado por defecto. Una vez activado, la categoría Inicio se añade como cualquier otro padre. En multitienda, cada tienda tiene su propia categoría Inicio y el ajuste se aplica a cada una.

### Modo automático al guardar un producto

Activado por defecto. Cada producto creado o modificado se asocia a sus categorías padre. El proceso tiene lugar al final de la petición, después de guardar las categorías del producto, lo que cubre la ficha de producto de PrestaShop 8 y 9, la importación CSV y el webservice.

### Modo automático al mover una categoría

Activado por defecto. Cuando cambia la categoría padre de una categoría, todos los productos de su rama se asocian a los nuevos padres. Modificar el nombre o la descripción no desencadena nada. Los antiguos padres siguen asociados a los productos: quítelos a mano si es necesario.

### Categorías excluidas

Seleccione las categorías que nunca deben añadirse como padre, por ejemplo una categoría escaparate de Ofertas o Novedades. El campo de filtro encuentra una categoría por su nombre, y Ctrl (Cmd en Mac) permite seleccionar varias. Una categoría excluida se salta, pero sus propios padres se siguen añadiendo.

### Tamaño del lote

Número de productos procesados por petición durante la corrección masiva, de 20 a 2000. El valor por defecto, 200, sirve para la mayoría de alojamientos. Redúzcalo si una petición supera el tiempo máximo de ejecución de su servidor.

## Navegación por facetas

Tras cada adición de asociaciones, el módulo vacía la caché de bloques de filtros de `ps_facetedsearch`, para que los filtros de las categorías padre tengan en cuenta los nuevos productos. Como las asociaciones existen en la base de datos, no hace falta la opción de mostrar los productos de las subcategorías en el módulo de navegación por facetas.

## Buenas prácticas

- Lance una simulación antes de la primera corrección y revise la vista previa para validar el resultado.
- Configure las exclusiones antes de la corrección masiva, no después: el módulo nunca quita una asociación ya creada.
- Tras una importación grande, relance una corrección masiva para comprobar que no falta ningún producto.
- Vacíe la caché de la tienda si un listado no muestra enseguida los nuevos productos.

## Resolución de problemas

### El modo automático no se activa para algunos empleados

PrestaShop omite los hooks de un módulo cuando el perfil del empleado conectado no tiene el permiso **Ver** en ese módulo (**Parámetros avanzados > Equipo > Permisos**, sección Módulos). Conceda este permiso a los perfiles que modifican el catálogo, o lance una corrección masiva después de sus cambios.

### Una categoría quitada a un producto vuelve al guardar

Es el comportamiento esperado del modo automático: se vuelve a añadir cualquier categoría padre de una categoría del producto. Añada esa categoría a las exclusiones, o quite también del producto la subcategoría correspondiente.

### La corrección masiva se detiene con un error

Reduzca el tamaño del lote y vuelva a lanzarla: los productos ya procesados se omiten en la siguiente pasada. Los errores del modo automático se registran en **Parámetros avanzados > Registros** y nunca bloquean el guardado del producto.

## Compatibilidad

- PrestaShop 8.0 a 9.x, el mismo ZIP cubre ambas ramas.
- Multitienda y multiidioma.
- Arquitectura ModuleAdminController, sin dependencia de Composer.
- Interfaz disponible en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.
