DfGpsr SW — Guía completa

DfGpsr SW muestra en sus fichas de producto Shopware la información de seguridad obligatoria según el Reglamento (UE) 2023/988 — el Reglamento general de seguridad de los productos (RGSP), en vigor desde el 13 de diciembre de 2024. Shopware no ofrece nada nativo sólido al respecto. DfGpsr SW cubre ese vacío con campos personalizados por producto, valores de respaldo globales configurables por canal de venta y visualización automática debajo de la descripción del producto. El plugin está construido deliberadamente sin componentes de administración personalizados y sin JavaScript de storefront: un único ZIP se instala de forma idéntica en Shopware 6.5, 6.6 y 6.7, sin compilación. Esta guía cubre la instalación, la configuración global, la introducción de datos por producto, la traducción, la personalización de la plantilla y la resolución de problemas.

Qué exige el RGSP

Para la venta en línea, el Reglamento (UE) 2023/988 exige que cada oferta muestre claramente, antes de la compra:

• el fabricante: nombre, dirección postal y dirección electrónica;
• la persona responsable establecida en la UE (artículo 16) cuando el fabricante está establecido fuera de la Unión: nombre, dirección postal y dirección electrónica;
• las advertencias e información de seguridad en el idioma del país de destino.

DfGpsr SW cubre estos tres requisitos, además de una lista de documentos de seguridad (manuales, fichas de datos de seguridad, certificados) y un interruptor de ocultación para los artículos fuera del ámbito del reglamento.

Instalación

1. Descargue el archivo DfGpsr-v1.0.0.zip desde su cuenta DataFirefly.
2. Copie la carpeta descomprimida DfGpsr en custom/plugins/ de su Shopware, o instale el ZIP mediante Administración → Extensiones → Mis extensiones → Cargar extensión.
3. Instale y active:

   bin/console plugin:refresh
   bin/console plugin:install --activate DfGpsr
   bin/console cache:clear

4. En la instalación, el plugin crea su conjunto de campos personalizados df_gpsr en la entidad producto. Al desinstalar sin conservar los datos, este conjunto de campos y todos sus valores se eliminan.

Configuración global (valores de respaldo)

Abra Extensiones → Mis extensiones → DataFirefly GPSR Compliance → ⋯ → Configurar. La configuración está organizada en tarjetas:

• General: activar la visualización del bloque, mostrar u ocultar el título de la sección, y una opción para forzar la visualización incluso sin datos (reservada para theming/depuración).
• Fabricante por defecto: nombre, dirección postal y correo electrónico utilizados cuando un producto no define su propio fabricante.
• Persona responsable UE por defecto: nombre, dirección postal y correo electrónico.
• Textos de seguridad por defecto: advertencias e información de seguridad genéricas.

Todos estos valores son configurables por canal de venta mediante el selector nativo de Shopware en la parte superior de la configuración. Seleccione un canal para asignarle valores específicos, o deje «Todos los canales de venta» para valores comunes.

Rellenar un producto

Abra un producto en Catálogos → Productos, luego la pestaña Especificaciones → Campos personalizados. El grupo RGSP — Seguridad del producto reúne los siguientes campos:

• Ocultar la información RGSP para este producto: interruptor a activar para los artículos fuera del ámbito del reglamento.
• Fabricante: nombre, dirección postal, correo electrónico.
• Persona responsable UE: nombre, dirección postal, correo electrónico.
• Advertencias e Información de seguridad: editores de texto enriquecido.
• Documentos de seguridad: uno por línea, en formato Etiqueta|URL o simplemente una URL.

La regla de resolución es simple: para cada campo, el plugin utiliza el valor del producto si está definido, de lo contrario recurre al valor por defecto del canal de venta. El campo «Documentos» no tiene valor de respaldo global — es propio de cada producto.

Formato de los documentos de seguridad

Introduzca un documento por línea. Se aceptan dos formatos:

Manual de uso|https://ejemplo.com/manual.pdf
Ficha de datos de seguridad|https://ejemplo.com/fds.pdf
https://ejemplo.com/certificado.pdf

Con el formato Etiqueta|URL, la etiqueta se convierte en el texto clicable; una URL sola se muestra tal cual. Todos los enlaces se abren en una nueva pestaña.

Traducción

Los campos son campos personalizados estándar de Shopware: se traducen producto por producto mediante el selector de idioma de la administración, en la parte superior de la ficha de producto. Introduzca, por ejemplo, las advertencias en francés para el idioma FR, luego cambie a DE para introducir la versión alemana.

Las etiquetas del bloque storefront (título «Seguridad del producto», «Fabricante», «Persona responsable en la UE», etc.) se incluyen de forma nativa en cinco idiomas: español, inglés, francés, alemán e italiano. Se muestran automáticamente según el idioma del canal de venta, sin configuración.

Visualización en el storefront

El bloque RGSP se inyecta automáticamente en la página de detalle del producto, justo después de la descripción, en el bloque Twig page_product_detail_description_content_text. Presenta el fabricante y la persona responsable uno al lado del otro, luego las advertencias, la información de seguridad y la lista de documentos. El bloque se oculta automáticamente cuando no hay datos disponibles — ni en el producto ni en la configuración global.

Personalizar la plantilla

El componente de visualización está aislado en views/storefront/component/df-gpsr/gpsr-info.html.twig e inyectado mediante views/storefront/page/product-detail/description.html.twig. Para mover el bloque o modificar su representación, sobrescriba uno de estos dos archivos en su tema. El estilo de base es inline y deliberadamente neutro, fácil de reemplazar por sus propias clases.

FAQ y resolución de problemas

¿Se aplica el RGSP a mi tienda? Si vende productos de consumo no alimentarios a clientes situados en la UE, muy probablemente sí. El reglamento se aplica desde el 13 de diciembre de 2024 a la mayoría de los productos, incluidos los vendidos en línea e importados de terceros países.

El bloque no se muestra. Compruebe que la opción «activar la visualización» está marcada en la configuración, que el producto o la configuración global contiene al menos un valor, y que el interruptor «Ocultar» no está activado en el producto. Vacíe la caché tras cualquier cambio de configuración.

El bloque se muestra pero vacío. Probablemente sea la opción «mostrar incluso sin datos» dejada activa: desactívela para volver al comportamiento normal (ocultación automática).

Mis campos personalizados se muestran como un simple campo de texto en la admin 6.7. El mapeo de los componentes de campos personalizados evolucionó con la administración Meteor. Si un campo de dirección se muestra como un input simple en lugar de un área de texto, es solo un detalle de visualización admin sin impacto en el storefront; comuníquelo al soporte para un ajuste.

Los valores por defecto no se aplican. Compruebe que ha rellenado la configuración para el canal de venta correcto. Un valor definido en «Todos los canales de venta» se sobrescribe con un valor específico del canal si existe.

¿Qué ocurre al desinstalar? Con la opción de eliminación de datos, el conjunto de campos df_gpsr y todos los valores introducidos en los productos se eliminan. Sin ella, los datos se conservan para una reinstalación posterior.