DfGpsr SW: guia completo
Instalar, configurar e explorar o DfGpsr SW: informações de segurança GPSR (fabricante, pessoa responsável na UE, advertências, documentos) nas suas páginas de produto, com valores de recurso por canal de venda, para Shopware 6.5, 6.6 e 6.7.
O DfGpsr SW apresenta nas suas páginas de produto Shopware as informações de segurança tornadas obrigatórias pelo regulamento (UE) 2023/988, o regulamento geral de segurança dos produtos (GPSR), aplicável desde 13 de dezembro de 2024. O Shopware não oferece nada de nativo sólido neste ponto. O DfGpsr SW preenche esse vazio com campos personalizados por produto, valores de recurso globais configuráveis por canal de venda, e apresentação automática sob a descrição do produto. A extensão foi deliberadamente construída sem componente de administração à medida e sem JavaScript no storefront: um único ZIP instala-se de forma idêntica no Shopware 6.5, 6.6 e 6.7, sem qualquer compilação. Este guia cobre a instalação, a configuração global, o preenchimento por produto, a tradução, a personalização do template e a resolução de problemas.
O DfGpsr SW é uma ferramenta técnica de apresentação. Ajuda-o a apresentar as informações exigidas, mas a exatidão e a completude dos dados introduzidos continuam a ser da sua responsabilidade, tal como a avaliação da aplicabilidade do regulamento aos seus produtos. Este guia não constitui aconselhamento jurídico. Em Portugal, a fiscalização do mercado cabe à ASAE.
O que o GPSR impõe
Na venda online, o regulamento (UE) 2023/988 impõe que cada oferta apresente claramente, antes da compra:
- o fabricante: nome, morada postal e endereço eletrónico;
- a pessoa responsável estabelecida na UE (artigo 16.º) quando o fabricante está estabelecido fora da União: nome, morada postal e endereço eletrónico;
- as advertências e informações de segurança na língua do país visado.
O DfGpsr SW cobre estas três exigências, mais uma lista de documentos de segurança (manuais, fichas de dados de segurança, certificados) e um interruptor de ocultamento para as referências fora do âmbito do regulamento.
Instalação
- Transfira o arquivo
DfGpsr-v1.0.0.zipa partir da sua conta DataFirefly. - Copie a pasta descomprimida
DfGpsrparacustom/plugins/do seu Shopware, ou instale o ZIP em Administração → Extensões → As minhas extensões → Carregar extensão. - Execute a instalação e a ativação:
bin/console plugin:refresh bin/console plugin:install --activate DfGpsr bin/console cache:clear - Na instalação, a extensão cria o seu conjunto de campos personalizados
df_gpsrna entidade produto. Na desinstalação sem conservação dos dados, esse conjunto de campos e todos os seus valores são eliminados.
Compatível com Shopware 6.5.x, 6.6.x e 6.7.x numa única base de código. Não é necessário qualquer build de storefront ou de administração, e a extensão não acrescenta qualquer dependência Composer. É isso que garante a instalação idêntica nas três versões, incluindo a nova administração da 6.7.
Configuração global (valores de recurso)
Abra Extensões → As minhas extensões → DataFirefly GPSR Compliance → ⋯ → Configurar. A configuração está organizada em cartões:
- Geral: ativar a apresentação do bloco, mostrar ou não o título da secção, e uma opção de apresentação forçada mesmo sem dados (reservada a theming e depuração).
- Fabricante por predefinição: nome, morada postal e email usados quando um produto não define o seu próprio fabricante.
- Pessoa responsável na UE por predefinição: nome, morada postal e email.
- Textos de segurança por predefinição: advertências e informações de segurança genéricas.
Todos estes valores são configuráveis por canal de venda graças ao seletor nativo do Shopware no topo da configuração. Selecione um canal para lhe atribuir valores específicos, ou deixe «Todos os canais de venda» para valores comuns.
Se vende a sua própria marca, preencha o fabricante uma só vez na configuração global: todo o catálogo fica coberto sem tocar nos produtos. Os campos por produto servem então apenas para as exceções.
Preencher um produto
Abra um produto em Catálogos → Produtos, e depois o separador Especificações → Campos personalizados. O grupo GPSR: segurança do produto reúne os seguintes campos:
- Ocultar as informações GPSR para este produto: interruptor a ativar para as referências fora do âmbito do regulamento.
- Fabricante: nome, morada postal, endereço de email.
- Pessoa responsável na UE: nome, morada postal, endereço de email.
- Advertências e Informações de segurança: editores de texto formatado.
- Documentos de segurança: um por linha, no formato
Etiqueta|URLou apenas um URL.
A regra de resolução é simples: para cada campo, a extensão usa o valor do produto se estiver preenchido, caso contrário recorre ao valor predefinido do canal de venda. O campo «Documentos» não tem valor de recurso global, é próprio de cada produto.
Formato dos documentos de segurança
Introduza um documento por linha. São aceites dois formatos:
Manual de utilização|https://exemplo.com/manual.pdf
Ficha de dados de segurança|https://exemplo.com/fds.pdf
https://exemplo.com/certificado.pdfCom o formato Etiqueta|URL, a etiqueta torna-se o texto clicável; um URL isolado aparece tal como está. Todas as ligações abrem num novo separador.
Tradução
Os campos são campos personalizados normais do Shopware: traduzem-se produto a produto através do seletor de idioma da administração, no topo da ficha do produto. Preencha por exemplo as advertências em português para o idioma PT, e depois passe para DE para introduzir a versão alemã.
As etiquetas do bloco no storefront (título «Segurança do produto», «Fabricante», «Pessoa responsável na UE» e outras) são fornecidas nativamente em cinco idiomas: francês, inglês, alemão, espanhol e italiano. Aparecem automaticamente segundo o idioma do canal de venda, sem configuração.
Lembre-se de fornecer as advertências na língua de cada país visado: o GPSR exige que as informações de segurança sejam compreensíveis pelo consumidor do mercado em causa.
Apresentação no storefront
O bloco GPSR é injetado automaticamente na página de detalhe do produto, logo a seguir à descrição, no bloco Twig page_product_detail_description_content_text. Apresenta o fabricante e a pessoa responsável lado a lado, e depois as advertências, as informações de segurança e a lista de documentos. O bloco oculta-se automaticamente quando não há dados disponíveis, nem no produto nem na configuração global.
Personalizar o template
O componente de apresentação está isolado em views/storefront/component/df-gpsr/gpsr-info.html.twig e é injetado através de views/storefront/page/product-detail/description.html.twig. Para mover o bloco ou alterar a sua renderização, sobreponha um destes dois ficheiros no seu tema. O estilo de base é inline e deliberadamente neutro, fácil de substituir pelas suas próprias classes.
FAQ e resolução de problemas
O GPSR aplica-se à minha loja? Se vende produtos de consumo não alimentares a clientes situados na UE, muito provavelmente sim. O regulamento aplica-se desde 13 de dezembro de 2024 à maioria dos produtos, incluindo os vendidos online e importados de países terceiros.
O bloco não aparece. Verifique que a opção «ativar a apresentação» está marcada na configuração, que o produto ou a configuração global contém pelo menos um dado, e que o interruptor «Ocultar» não está ativo no produto. Limpe a cache depois de qualquer alteração de configuração.
O bloco aparece mas vazio. É provavelmente a opção «apresentar mesmo sem dados» deixada ativa: desative-a para voltar ao comportamento normal (ocultamento automático).
Os meus campos personalizados aparecem como simples campo de texto na administração 6.7. O mapeamento dos componentes de campos personalizados evoluiu com a administração Meteor. Se um campo de morada aparecer como input simples em vez de uma área de texto, é apenas um pormenor de apresentação da administração sem impacto no storefront; comunique-o ao suporte para um ajuste.
Os valores predefinidos não se aplicam. Verifique que preencheu a configuração para o canal de venda certo. Um valor definido em «Todos os canais de venda» é substituído por um valor específico do canal se este existir.
O que acontece na desinstalação? Com a opção de eliminação dos dados, o conjunto de campos df_gpsr e todos os valores introduzidos nos produtos são eliminados. Sem essa opção, os dados são conservados para uma reinstalação posterior.