SW Shopware 6 Shopware Principiante

DfGpsr SW — Guida completa

Installare, configurare e utilizzare DfGpsr SW: informazioni di sicurezza GPSR (produttore, persona responsabile UE, avvertenze, documenti) sulle sue schede prodotto, con valori di riserva per canale di vendita, per Shopware 6.5, 6.6 e 6.7.

Aggiornato Versione del modulo 1.0.0

DfGpsr SW mostra sulle sue schede prodotto Shopware le informazioni di sicurezza rese obbligatorie dal Regolamento (UE) 2023/988 — il Regolamento generale sulla sicurezza dei prodotti (GPSR), in vigore dal 13 dicembre 2024. Shopware non offre nulla di nativo e solido in materia. DfGpsr SW colma questa lacuna con campi personalizzati per prodotto, valori di riserva globali configurabili per canale di vendita e visualizzazione automatica sotto la descrizione del prodotto. Il plugin è costruito deliberatamente senza componenti di amministrazione personalizzati e senza JavaScript storefront: un unico ZIP si installa in modo identico su Shopware 6.5, 6.6 e 6.7, senza compilazione. Questa guida copre l’installazione, la configurazione globale, l’inserimento dati per prodotto, la traduzione, la personalizzazione del template e la risoluzione dei problemi.

DfGpsr SW è uno strumento tecnico di visualizzazione. La aiuta a presentare le informazioni richieste, ma l’esattezza e la completezza dei dati inseriti restano sua responsabilità, così come la valutazione dell’applicabilità del regolamento ai suoi prodotti. Questa guida non costituisce consulenza legale.

Cosa impone il GPSR

Per la vendita online, il Regolamento (UE) 2023/988 impone che ogni offerta mostri chiaramente, prima dell’acquisto:

  • il produttore: nome, indirizzo postale e indirizzo elettronico;
  • la persona responsabile stabilita nell’UE (articolo 16) quando il produttore è stabilito fuori dall’Unione: nome, indirizzo postale e indirizzo elettronico;
  • le avvertenze e le informazioni di sicurezza nella lingua del paese di destinazione.

DfGpsr SW copre questi tre requisiti, più un elenco di documenti di sicurezza (manuali, schede di sicurezza, certificati) e un interruttore di occultamento per gli articoli fuori dall’ambito del regolamento.

Installazione

  1. Scarichi l’archivio DfGpsr-v1.0.0.zip dal suo account DataFirefly.
  2. Copi la cartella decompressa DfGpsr in custom/plugins/ del suo Shopware, oppure installi lo ZIP tramite Amministrazione → Estensioni → Le mie estensioni → Carica estensione.
  3. Installi e attivi: 
    bin/console plugin:refresh
bin/console plugin:install --activate DfGpsr
bin/console cache:clear
  4. All’installazione, il plugin crea il suo set di campi personalizzati df_gpsr sull’entità prodotto. Alla disinstallazione senza conservare i dati, questo set e tutti i suoi valori vengono rimossi.

Compatibile con Shopware 6.5.x, 6.6.x e 6.7.x su un unico codebase. Non è richiesto alcun build di storefront o di amministrazione, e il plugin non aggiunge alcuna dipendenza Composer. È questo che garantisce un’installazione identica sulle tre versioni, inclusa la nuova amministrazione della 6.7.

Configurazione globale (valori di riserva)

Apra Estensioni → Le mie estensioni → DataFirefly GPSR Compliance → ⋯ → Configura. La configurazione è organizzata in schede:

  • Generale: attivare la visualizzazione del blocco, mostrare o nascondere il titolo della sezione, e un’opzione per forzare la visualizzazione anche senza dati (riservata a theming/debug).
  • Produttore predefinito: nome, indirizzo postale ed e-mail usati quando un prodotto non definisce il proprio produttore.
  • Persona responsabile UE predefinita: nome, indirizzo postale ed e-mail.
  • Testi di sicurezza predefiniti: avvertenze e informazioni di sicurezza generiche.

Tutti questi valori sono configurabili per canale di vendita tramite il selettore nativo di Shopware in cima alla configurazione. Selezioni un canale per assegnargli valori specifici, oppure lasci «Tutti i canali di vendita» per valori comuni.

Se vende il proprio marchio, inserisca il produttore una sola volta nella configurazione globale: tutto il catalogo è coperto senza toccare i prodotti. I campi per prodotto servono allora solo per le eccezioni.

Compilare un prodotto

Apra un prodotto in Cataloghi → Prodotti, poi la scheda Specifiche → Campi personalizzati. Il gruppo GPSR — Sicurezza del prodotto riunisce i seguenti campi:

  • Nascondi le informazioni GPSR per questo prodotto: interruttore da attivare per gli articoli fuori dall’ambito del regolamento.
  • Produttore: nome, indirizzo postale, indirizzo e-mail.
  • Persona responsabile UE: nome, indirizzo postale, indirizzo e-mail.
  • Avvertenze e Informazioni di sicurezza: editor di testo formattato.
  • Documenti di sicurezza: uno per riga, nel formato Etichetta|URL o semplicemente un URL.

La regola di risoluzione è semplice: per ogni campo, il plugin usa il valore del prodotto se impostato, altrimenti ripiega sul valore predefinito del canale di vendita. Il campo «Documenti» non ha un valore di riserva globale — è specifico di ciascun prodotto.

Formato dei documenti di sicurezza

Inserisca un documento per riga. Sono accettati due formati:

Manuale d'uso|https://esempio.com/manuale.pdf
Scheda di sicurezza|https://esempio.com/sds.pdf
https://esempio.com/certificato.pdf

Con il formato Etichetta|URL, l’etichetta diventa il testo cliccabile; un URL da solo viene mostrato così com’è. Tutti i link si aprono in una nuova scheda.

Traduzione

I campi sono campi personalizzati standard di Shopware: si traducono prodotto per prodotto tramite il selettore di lingua dell’amministrazione, in cima alla scheda prodotto. Inserisca ad esempio le avvertenze in francese per la lingua FR, poi passi a DE per inserire la versione tedesca.

Le etichette del blocco storefront (titolo «Sicurezza del prodotto», «Produttore», «Persona responsabile nell’UE», ecc.) sono fornite in modo nativo in cinque lingue: italiano, inglese, francese, tedesco e spagnolo. Vengono mostrate automaticamente in base alla lingua del canale di vendita, senza configurazione.

Ricordi di fornire le sue avvertenze nella lingua di ciascun paese di destinazione: il GPSR esige che le informazioni di sicurezza siano comprensibili per il consumatore del mercato di riferimento.

Visualizzazione storefront

Il blocco GPSR viene iniettato automaticamente nella pagina di dettaglio del prodotto, subito dopo la descrizione, nel blocco Twig page_product_detail_description_content_text. Presenta il produttore e la persona responsabile fianco a fianco, poi le avvertenze, le informazioni di sicurezza e l’elenco dei documenti. Il blocco si nasconde automaticamente quando non ci sono dati disponibili — né sul prodotto né nella configurazione globale.

Personalizzare il template

Il componente di visualizzazione è isolato in views/storefront/component/df-gpsr/gpsr-info.html.twig e iniettato tramite views/storefront/page/product-detail/description.html.twig. Per spostare il blocco o modificarne la resa, sovrascriva uno di questi due file nel suo tema. Lo stile di base è inline e volutamente neutro, facile da sostituire con le sue classi.

FAQ e risoluzione dei problemi

Il GPSR si applica al mio negozio? Se vende prodotti di consumo non alimentari a clienti situati nell’UE, molto probabilmente sì. Il regolamento si applica dal 13 dicembre 2024 alla maggior parte dei prodotti, compresi quelli venduti online e importati da paesi terzi.

Il blocco non viene visualizzato. Verifichi che l’opzione «attivare la visualizzazione» sia selezionata nella configurazione, che il prodotto o la configurazione globale contenga almeno un valore, e che l’interruttore «Nascondi» non sia attivato sul prodotto. Svuoti la cache dopo ogni modifica della configurazione.

Il blocco viene visualizzato ma è vuoto. Probabilmente è l’opzione «mostra anche senza dati» rimasta attiva: la disattivi per tornare al comportamento normale (occultamento automatico).

I miei campi personalizzati appaiono come un semplice campo di testo nell’admin 6.7. La mappatura dei componenti dei campi personalizzati si è evoluta con l’amministrazione Meteor. Se un campo indirizzo appare come un input semplice invece di un’area di testo, è solo un dettaglio di visualizzazione admin senza impatto sullo storefront; lo segnali al supporto per una regolazione.

I valori predefiniti non si applicano. Verifichi di aver compilato la configurazione per il canale di vendita corretto. Un valore impostato su «Tutti i canali di vendita» viene sovrascritto da un valore specifico del canale se esiste.

Cosa succede alla disinstallazione? Con l’opzione di eliminazione dei dati, il set di campi df_gpsr e tutti i valori inseriti sui prodotti vengono rimossi. Senza di essa, i dati vengono conservati per una reinstallazione successiva.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza