Agrupar Productos como Variantes en PrestaShop: Documentación del Módulo (dfproductlinker)

El módulo DF ProductLinker (dfproductlinker) vincula fichas de producto distintas para mostrarlas como un solo artículo con un selector de color, talla o cualquier otro atributo. Cada variante sigue siendo un producto completo con su propia URL. Es el movimiento inverso de DF ProductSplitter, que divide un producto con combinaciones en productos separados.

Instalación

1. Descargue el ZIP desde su cuenta de cliente DataFirefly.
2. En el back-office, vaya a Módulos > Gestor de módulos > Subir un módulo y envíe el ZIP.
3. Al instalarse, el módulo crea sus tablas y la pestaña Catálogo > Variantes vinculadas.
4. Abra la configuración del módulo para comprobar la posición del selector.

El módulo funciona en PrestaShop 8.0 a 9.x con el mismo ZIP, en multitienda y multiidioma. Sus textos se entregan en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.

Principio: grupos y ejes

Un grupo reúne varios productos. Un eje es un grupo de atributos nativo de PrestaShop, por ejemplo Color o Talla: los valores, los colores hexadecimales, las texturas y las traducciones introducidos en Catálogo > Atributos y características se reutilizan tal cual. Cada producto del grupo recibe un valor en cada eje.

Un producto solo puede pertenecer a un grupo. Los productos no se modifican: el grupo se guarda en las tablas del módulo.

Crear un grupo

Vaya a Catálogo > Variantes vinculadas y luego Añadir un grupo.

1. Introduzca el nombre del grupo. Se usa internamente y como nombre de reserva en los datos estructurados.
2. En Ejes, haga clic en Añadir un eje. El módulo propone primero un grupo de atributos de tipo color. Para cada eje, elija la visualización (automática, muestra de color, miniatura de foto del producto, botón de texto, lista desplegable) y la propiedad de los datos estructurados (color, talla, material, estampado o no declarada).
3. En Productos del grupo, busque los productos por nombre, referencia o ID. Las flechas del teclado y la tecla Intro seleccionan un resultado. Los productos que ya están en otro grupo aparecen en gris.
4. Para cada producto, compruebe el valor de cada eje. Se rellena automáticamente cuando aparece en el nombre del producto. Un valor ausente se resalta en naranja y la línea de estado bajo la tabla indica cuántos productos están afectados, o si dos productos tienen los mismos valores.
5. Guarde. El módulo le avisa si sale de la página con cambios sin guardar.

El orden de las líneas del grupo es el orden de las muestras en la tienda. El botón Ordenar según el orden de los atributos coloca las líneas en el orden definido en el catálogo, útil para tallas S, M, L, XL.

Lo que ve el cliente

En cada ficha del grupo, el selector muestra el nombre del eje y el valor actual, por ejemplo Color: Rojo, y después los valores disponibles. Al pasar el ratón, la etiqueta muestra el valor señalado. El valor actual aparece enmarcado; los demás son enlaces a la ficha correspondiente.

• Con varios ejes, un clic en un color abre el producto que conserva la talla actual. Si esa combinación no existe, el módulo abre la variante más cercana dando prioridad a un producto en stock, y la muestra se dibuja con borde discontinuo.
• Una variante sin stock se muestra atenuada y tachada, u oculta según el ajuste.
• Un valor de color sin código hexadecimal ni textura se muestra como texto en una muestra alargada.
• El selector también aparece en la vista rápida de las páginas de categoría, encima del botón de añadir al carrito.

Ajustes del módulo

• Posición del selector: antes del bloque nativo de combinaciones (recomendado), después de ese bloque, en el hook displayProductAdditionalInfo o solo en el hook de tema displayDfProductLinker.
• Selector CSS del bloque nativo de combinaciones: por defecto .product-variants, .product__variants. Si nada coincide en su tema, el selector permanece en el hook.
• Etiqueta del eje, precio de cada variante (modos imagen y botón), formato de imagen de las miniaturas.
• Variantes sin stock: atenuadas u ocultas.
• Color de acento, forma (redonda o cuadrada con esquinas redondeadas) y tamaño de las muestras. El tamaño mediano ofrece una zona táctil de 44 px, recomendada en móvil.
• Muestras en los listados de productos, número máximo de muestras y cambio de imagen al pasar el ratón.
• Un solo producto por grupo, visibilidad de los demás productos y producto mostrado: vea la sección siguiente.
• URL canónica de las variantes y datos estructurados ProductGroup: vea la sección SEO.

Para una ubicación a medida, elija la posición hook de tema y añada esta línea en la plantilla de producto de su tema: {hook h='displayDfProductLinker' product=$product}.

Un solo producto por grupo en las categorías

Esta opción muestra una sola miniatura por grupo en los listados de categoría. Los demás productos del grupo pasan a visibilidad Solo búsqueda (o En ninguna parte según el ajuste): sus fichas siguen en línea con su URL y las muestras de la miniatura enlazan con ellas.

• Producto mostrado: el primero del grupo o el primero en stock. En el segundo caso, se recalcula en cada movimiento de stock.
• La visibilidad original de cada producto se guarda. Se restaura cuando desactiva la opción, desactiva el grupo, quita un producto de su grupo o desinstala el módulo.
• Si cambia a mano la visibilidad de un producto oculto, su valor pasa a ser el nuevo valor original.
• El botón Resincronizar la visibilidad de la configuración vuelve a aplicar la regla a todos los grupos. Úselo si un empleado sin permisos sobre el módulo ha modificado productos, ya que PrestaShop no ejecuta entonces los hooks del módulo.

SEO: datos estructurados y URL canónica

El módulo añade en cada ficha del grupo un bloque JSON-LD ProductGroup con hasVariant y variesBy. Cada variante figura con su nombre, URL, referencia, EAN13 si es válido, imagen, valor en cada eje, el precio mostrado al cliente y su disponibilidad. El nombre del grupo se toma del nombre del producto sin sus valores, en el idioma del visitante. Desactive la opción si otro módulo ya genera este bloque.

Por defecto, cada variante conserva una URL canónica hacia sí misma: cada color se indexa por separado. Si sus fichas de color son casi idénticas, la opción Canónica hacia el producto principal del grupo dirige la canónica de todas las variantes al producto principal, es decir, el producto mostrado en los listados si la opción de un solo producto por grupo está activa y, si no, el primer producto activo del grupo.

Asistente de agrupación automática

Desde la lista de grupos, haga clic en Asistente de agrupación automática. Detecta los productos que son el mismo artículo en varios colores o tallas.

1. Elija una categoría o todo el catálogo.
2. Marque los grupos de atributos a detectar, por ejemplo Color y Talla. Los valores deben existir como valores de atributo y aparecer en el nombre del producto.
3. Elija la regla: nombres idénticos una vez quitados los valores, o referencias con la misma raíz (TSH01-RED y TSH01-BLUE).
4. Haga clic en Vista previa, desmarque los grupos que no quiera y luego Crear los grupos seleccionados.

Los productos que ya están en un grupo se ignoran, y el análisis abarca 5.000 productos por ejecución.

Importación y exportación CSV

El botón Importar / exportar CSV abre la página dedicada. La exportación genera una línea por producto, en el mismo formato que la importación. Columnas:

group_id;group_name;group_active;axes;product_id;product_reference;product_name;values
;Camiseta Basic;1;Color|Talla;;TSH01-NAVY-M;;Color:Azul marino|Talla:M

• Un grupo se identifica por group_id o, si no, por su nombre exacto. Cada grupo presente en el archivo se sustituye por sus líneas; los grupos ausentes no se modifican.
• Un producto se localiza por product_id o, si no, por product_reference, que debe ser única en el catálogo. product_name es informativo.
• values contiene pares Eje:Valor separados por |, con los nombres de los grupos de atributos y de los valores en cualquier idioma de la tienda.
• El separador ; o , se detecta automáticamente. Archivo UTF-8, 5 MB como máximo.

La importación se hace en dos pasos: Analizar el archivo muestra los grupos creados o sustituidos, los valores de atributo que se crearán y cada línea rechazada con su motivo; Ejecutar la importación la lleva a cabo. Dos opciones: Mover los productos que ya pertenecen a otro grupo y Crear los valores de atributo que faltan (su color queda vacío, a completar en el catálogo).

Ficha de producto del back-office

En la pestaña Módulos de la ficha de producto, el panel DF ProductLinker indica el grupo del producto y el valor de cada producto del grupo, con un enlace para editar el grupo. Si el producto no está en ningún grupo, un enlace crea un grupo a partir de este producto.

Preguntas frecuentes

El selector no aparece en una ficha

Compruebe que el grupo está activo, que la ficha forma parte del grupo, que al menos dos productos del grupo están activos y que al menos un eje tiene dos valores distintos. Si eligió la posición hook de tema, el hook displayDfProductLinker debe estar en la plantilla de producto.

El selector aparece debajo del botón del carrito

El selector CSS del bloque nativo de combinaciones no coincide con ningún elemento de su tema. Indique la clase del bloque de combinaciones de su tema en la configuración.

Las muestras no aparecen en los listados

La opción debe estar activada y el primer eje del grupo debe mostrarse como muestra de color o miniatura de foto. Su tema debe llamar al hook nativo displayProductListReviews en la miniatura del producto, como hace el tema Classic.

¿Puedo combinar el módulo con combinaciones nativas?

Sí. Un caso habitual: un producto por color, cada uno con combinaciones de talla. El selector del módulo gestiona los colores y el bloque nativo gestiona las tallas.