Guida all’installazione, configurazione e implementazione del modulo Kowal TrustedUs

Obiettivo del modulo

Kowal TrustedUs è un modulo universale Magento 2 per presentare aziende, clienti, partner, fornitori, brand e case study nello store.

Il modulo può essere utilizzato come:

• sezione Chi si è affidato a noi,
• elenco di partner o fornitori,
• portfolio delle realizzazioni,
• base di case study,
• sezione che mostra le applicazioni dei prodotti,
• strumento per rafforzare il linking interno nello store.

Dopo l’ultimo ampliamento, i widget possono portare a pagine interne di case study, ad esempio:

/trusted-us/vitcas

In questa pagina vengono visualizzate le voci dello stesso gruppo e i prodotti a esse associati.

Requisiti

Prima dell’installazione, assicurati che lo store soddisfi i requisiti:

• funziona su Magento 2,
• ha accesso a Composer,
• ha accesso al repository del modulo,
• ha configurato le credenziali di accesso al repository Composer Kowal,
• consente l’esecuzione dei comandi bin/magento,
• è stato eseguito un backup del codice e del database prima dell’implementazione in produzione.

Installazione tramite Composer

1. Aggiunta del repository Composer

Nella directory principale di Magento esegui:

Riceverai via e-mail, dopo l’acquisto, le credenziali di accesso al repository Composer, ovvero l’indirizzo e-mail del cliente e il token di licenza. Sono disponibili anche nell’area cliente dopo aver effettuato l’accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l’indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.

composer config repositories.kowal composer https://repo.kowal.store

2. Aggiunta del token di accesso

Configura le credenziali di accesso al repository Composer Kowal:

composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

3. Installazione del modulo

composer require kowal/module-trustedus

4. Abilitazione del modulo

Nome del modulo Magento:

Kowal_TrustedUs

Abilita il modulo:

php bin/magento module:enable Kowal_TrustedUs

5. Aggiornamento dello schema del database

php bin/magento setup:upgrade

Questo comando creerà o aggiornerà le tabelle del modulo, incluso il campo group_slug utilizzato per le pagine interne dei case study.

6. Pulizia della cache

php bin/magento cache:flush

Installazione in modalità produzione

Nell’ambiente di produzione è consigliato il processo standard di deployment Magento.

Sequenza di esempio:

composer require kowal/module-trustedusphp bin/magento module:enable Kowal_TrustedUsphp bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Se lo store dispone di una propria pipeline CI/CD, i passaggi sopra indicati devono essere adattati al processo di deployment dello store.

Aggiornamento di un’installazione esistente

Se il modulo è già installato, aggiornalo tramite Composer:

composer update kowal/module-trustedus

Quindi esegui:

php bin/magento setup:upgradephp bin/magento cache:flush

In modalità produzione:

php bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Configurazione nel pannello di amministrazione

Accesso all’elenco delle aziende

Dopo l’installazione, nel pannello Magento vai a:

Content -> Zaufali nam -> Firmy

A seconda della configurazione del menu, la voce può essere disponibile anche nella sezione:

Trusted Us -> Firmy

Aggiunta di un’azienda o di un case study

Quando aggiungi una nuova voce, completa i dati di base:

• Nome dell’azienda - nome del cliente, partner, fornitore, brand o progetto.
• Indirizzo del sito (URL) - indirizzo esterno opzionale; attualmente i widget collegano internamente se la voce ha impostato lo slug del gruppo.
• Gruppo case study / slug URL - slug globale utilizzato per raggruppare le voci e creare il link interno.
• Nome del progetto - titolo della realizzazione o del case study descrittivo.
• Breve descrizione del progetto - contenuto presentato accanto alla voce.
• Icona - logo dell’azienda o del brand.
• Attiva - determina se la voce è visibile sul frontend.
• Mostra nel widget delle aziende in evidenza - determina se la voce verrà inserita nel widget in evidenza.
• Ordine - ordinamento delle voci.
• Products - prodotti associati alla voce.

Configurazione del raggruppamento e dei link interni

Il campo Gruppo case study / slug URL serve a collegare più voci della stessa azienda in un’unica pagina interna.

Esempio:

vitcas

Tutte le voci attive con lo stesso slug saranno visibili nella pagina:

/trusted-us/vitcas

Se inserisci un valore con spazi o lettere maiuscole, il modulo lo salverà come slug sicuro.

Esempio:

Tandem Baits

verrà salvato come:

tandem-baits

Configurazione dei prodotti associati

Nella sezione Prodotti / moduli associati seleziona i prodotti da assegnare alla specifica azienda, realizzazione o case study.

Queste associazioni sono utilizzate in due punti:

• nella scheda prodotto, dove il modulo può mostrare aziende o realizzazioni associate,
• nella pagina case study /trusted-us/{slug}, dove i prodotti vengono presentati in una griglia simile a quella delle categorie di prodotti.

Configurazione del widget standard

Nella modifica di una pagina CMS, homepage, landing page o blocco CMS aggiungi il widget:

Kowal: Zaufali nam

Parametri disponibili:

• Titolo - intestazione della sezione.
• Limite - numero massimo di voci visualizzate.
• Mostra il nome del progetto - indica se il nome del progetto deve essere visibile sotto il logo.

Se la voce ha il campo group_slug compilato, il clic sul logo porta alla pagina interna:

/trusted-us/{slug}

Se group_slug è vuoto, la voce resta senza link.

Configurazione del widget delle aziende in evidenza

Nella modifica CMS aggiungi il widget:

Kowal: Zaufali nam - wyróżnione firmy

Parametri disponibili:

• Intestazione - testo principale della sezione.
• Limite - numero massimo di voci visualizzate.

Il widget mostra solo le voci attive che hanno selezionata l’opzione:

Pokaż w widgecie wyróżnionych firm

Come il widget standard, può collegare a pagine interne di case study in base al campo group_slug.

Sezione nella scheda prodotto

Se a un prodotto sono assegnate aziende o case study, il modulo può mostrare automaticamente una sezione nella scheda prodotto.

La sezione presenta:

• logo dell’azienda,
• nome dell’azienda,
• nome del progetto,
• breve descrizione del progetto.

Questo consente di mostrare un utilizzo reale del prodotto e rafforzare la credibilità dell’offerta.

Pagine case study

Le pagine case study sono disponibili all’indirizzo:

/trusted-us/{slug}

Esempio:

/trusted-us/vitcas

Nella pagina vengono visualizzati:

• tutte le voci attive con lo stesso group_slug,
• descrizioni dei case study,
• logo dell’azienda,
• prodotti assegnati a ciascuna voce,
• griglia prodotti simile alla griglia di categoria.

Queste pagine aumentano il numero di link interni e creano un percorso aggiuntivo:

widget -> case study -> produkt

Supporto di più store view

Il modulo supporta contenuti dipendenti dalla store view per i campi:

• nome del progetto,
• breve descrizione del progetto.

I campi globali, come nome dell’azienda, logo, stato di attività, ordinamento, prodotti associati e group_slug, sono comuni all’intera voce.

Directory media

I loghi vengono salvati nella directory:

pub/media/kowal/trustedus/

Prima del deployment, assicurati che la directory pub/media sia condivisa o sincronizzata correttamente tra gli ambienti, se lo store funziona in un’architettura multi-server.

Checklist di deployment

Prima del deployment:

• esegui un backup del database,
• esegui un backup del codice o assicurati che il deployment sia riproducibile dal repository,
• verifica l’accesso al repository Composer,
• verifica l’indirizzo e-mail del cliente e il token di licenza per il repository Composer Kowal,
• pianifica una finestra di deployment se lo store è in produzione.

Dopo il deployment:

• esegui setup:upgrade,
• pulisci la cache,
• in modalità produzione esegui la compilazione DI e il deployment degli static content,
• verifica che il modulo sia attivo,
• aggiungi o modifica un’azienda di test,
• imposta group_slug,
• assegna un prodotto,
• aggiungi il widget su una pagina CMS di test,
• clicca sul logo e verifica la pagina /trusted-us/{slug},
• controlla che la griglia prodotti visualizzi i prodotti assegnati al case study,
• controlla la scheda prodotto con le voci assegnate.

Comandi diagnostici

Verifica dello stato del modulo:

php bin/magento module:status Kowal_TrustedUs

Verifica dell’elenco dei moduli Kowal:

php bin/magento module:status | grep Kowal

Pulizia della cache:

php bin/magento cache:flush

Ricompilazione DI:

php bin/magento setup:di:compile

Problemi più comuni

Il widget non collega alla pagina case study

Verifica che la voce abbia compilato il campo:

Grupa case study / slug URL

L’elemento senza group_slug non viene collegato alla pagina interna.

La pagina /trusted-us/{slug} non funziona

Verifica:

• se esiste una voce attiva con il relativo group_slug,
• se è stato eseguito setup:upgrade,
• se la cache è stata pulita,
• se il modulo Kowal_TrustedUs è attivo.

I prodotti non compaiono nella pagina case study

Verifica:

• se i prodotti sono assegnati alla voce dell’azienda,
• se i prodotti sono attivi,
• se i prodotti sono visibili nel catalogo o nella ricerca,
• se i prodotti sono disponibili nella store view corrente.

Le modifiche non sono visibili dopo il deployment

Pulisci la cache Magento:

php bin/magento cache:flush

In modalità produzione esegui anche:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -f

Disinstallazione

Disabilitazione del modulo:

php bin/magento module:disable Kowal_TrustedUsphp bin/magento setup:upgradephp bin/magento cache:flush

Rimozione del pacchetto Composer:

composer remove kowal/module-trustedus

Prima di rimuovere il modulo dalla produzione, verifica che lo store non utilizzi widget, blocchi CMS o contenuti dipendenti dal modulo.