Instrucțiuni de instalare, configurare și implementare a modulului Kowal TrustedUs

Scopul modulului

Kowal TrustedUs este un modul universal Magento 2 pentru prezentarea companiilor, clienților, partenerilor, furnizorilor, brandurilor și studiilor de caz în magazin.

Modulul poate fi utilizat ca:

• secțiune 'Ne-au acordat încredere',
• listă de parteneri sau furnizori,
• portofoliu de realizări,
• bază de studii de caz,
• secțiune care arată utilizările produselor,
• instrument pentru consolidarea linkurilor interne în magazin.

După cea mai recentă extindere, widgeturile pot trimite către pagini interne de tip studiu de caz, de exemplu:

/trusted-us/vitcas

Pe o astfel de pagină sunt afișate înregistrări din aceeași grupă și produsele atribuite acestora.

Cerințe

Înainte de instalare, asigură-te că magazinul îndeplinește cerințele:

• rulează pe Magento 2,
• are acces la Composer,
• are acces la repository-ul modulului,
• are configurat un token GitHub, dacă repository-ul este privat,
• permite rularea comenzilor bin/magento,
• are backup pentru cod și baza de date înainte de implementarea în producție.

Instalare prin Composer

1. Adăugarea repository-ului Composer

În directorul rădăcină Magento, rulează:

composer config repositories.kowal.trusted.us vcs https://github.com/kowalco/trusted-us

2. Adăugarea tokenului de acces

Dacă repository-ul este privat, adaugă tokenul GitHub:

composer config --global --auth github-oauth.github.com 

3. Instalarea modulului

composer require kowal/module-trustedus

4. Activarea modulului

Numele modulului Magento:

Kowal_TrustedUs

Activează modulul:

php bin/magento module:enable Kowal_TrustedUs

5. Actualizarea schemei bazei de date

php bin/magento setup:upgrade

Această comandă va crea sau actualiza tabelele modulului, inclusiv câmpul group_slug utilizat pentru paginile interne de studii de caz.

6. Curățarea cache-ului

php bin/magento cache:flush

Instalare în modul de producție

În mediul de producție este recomandat procesul standard de implementare Magento.

Exemplu de secvență:

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

Dacă magazinul are propriul pipeline CI/CD, pașii de mai sus trebuie adaptați la procesul de implementare al magazinului.

Actualizarea unei instalări existente

Dacă modulul este deja instalat, actualizează-l prin Composer:

composer update kowal/module-trustedus

Apoi rulează:

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

În modul de producție:

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

Configurare în panoul de administrare

Accesarea listei de companii

După instalare, mergi în panoul Magento la:

Content -> Zaufali nam -> Firmy

În funcție de configurația meniului, intrarea poate fi disponibilă și în secțiunea:

Trusted Us -> Firmy

Adăugarea unei companii sau a unui studiu de caz

Când adaugi o înregistrare nouă, completează datele de bază:

• Numele companiei - numele clientului, partenerului, furnizorului, brandului sau proiectului.
• Adresa site-ului (URL) - adresă externă opțională; în prezent, widgeturile fac link intern dacă înregistrarea are setat slugul grupului.
• Grupă studiu de caz / slug URL - slug global folosit pentru gruparea înregistrărilor și construirea linkului intern.
• Numele proiectului - titlul realizării sau al studiului de caz descriptiv.
• Scurtă descriere a proiectului - conținutul prezentat lângă înregistrare.
• Icon - logo-ul companiei sau al brandului.
• Activă - decide dacă înregistrarea este vizibilă pe frontend.
• Afișează în widgetul companiilor evidențiate - decide dacă înregistrarea va ajunge în widgetul evidențiat.
• Ordine - sortarea înregistrărilor.
• Products - produsele asociate cu înregistrarea.

Configurarea grupării și a linkurilor interne

Câmpul Grupă studiu de caz / slug URL este utilizat pentru conectarea mai multor înregistrări ale aceleiași companii pe o singură pagină internă.

Exemplu:

vitcas

Toate înregistrările active cu același slug vor fi vizibile pe pagina:

/trusted-us/vitcas

Dacă introduci o valoare cu spații sau litere mari, modulul o va salva ca slug sigur.

Exemplu:

Tandem Baits

va fi salvat ca:

tandem-baits

Configurarea produselor asociate

În secțiunea Produse / module asociate, selectează produsele care trebuie atribuite unei anumite companii, realizări sau unui studiu de caz.

Aceste asocieri sunt utilizate în două locuri:

• pe pagina produsului, unde modulul poate afișa companii sau realizări asociate,
• pe pagina studiului de caz /trusted-us/{slug}, unde produsele sunt prezentate într-un grid similar cu cel al categoriei de produse.

Configurarea widgetului standard

În editarea paginii CMS, paginii principale, landing page-ului sau blocului CMS, adaugă widgetul:

Kowal: Zaufali nam

Parametri disponibili:

• Titlu - antetul secțiunii.
• Limită - numărul maxim de înregistrări afișate.
• Afișează numele proiectului - dacă numele proiectului trebuie să fie vizibil sub logo.

Dacă înregistrarea are completat câmpul group_slug, clicul pe logo duce la pagina internă:

/trusted-us/{slug}

Dacă group_slug este gol, înregistrarea rămâne fără link.

Configurarea widgetului pentru companii evidențiate

În editarea CMS, adaugă widgetul:

Kowal: Zaufali nam - wyróżnione firmy

Parametri disponibili:

• Antet - textul principal al secțiunii.
• Limită - numărul maxim de înregistrări afișate.

Widgetul afișează doar înregistrările active care au bifată opțiunea:

Pokaż w widgecie wyróżnionych firm

La fel ca widgetul standard, poate face link către pagini interne de studii de caz pe baza câmpului group_slug.

Secțiune pe pagina produsului

Dacă produsul are companii sau studii de caz atribuite, modulul poate afișa automat o secțiune pe pagina produsului.

Secțiunea prezintă:

• logo-ul companiei,
• numele companiei,
• numele proiectului,
• o scurtă descriere a proiectului.

Acest lucru permite prezentarea utilizării reale a produsului și consolidarea credibilității ofertei.

Pagini de studii de caz

Paginile de studii de caz sunt disponibile la adresa:

/trusted-us/{slug}

Exemplu:

/trusted-us/vitcas

Pe pagină sunt afișate:

• toate înregistrările active cu același group_slug,
• descrierile studiilor de caz,
• logo-ul companiei,
• produsele atribuite fiecărei înregistrări,
• gridul de produse similar cu gridul categoriei.

Aceste pagini măresc numărul de linkuri interne și creează un traseu suplimentar:

widget -> case study -> produkt

Suport pentru mai multe store view-uri

Modulul acceptă conținut dependent de store view pentru câmpurile:

• numele proiectului,
• scurta descriere a proiectului.

Câmpurile globale, precum numele companiei, logo-ul, statusul de activitate, sortarea, produsele asociate și group_slug, sunt comune pentru întreaga înregistrare.

Director media

Logourile sunt salvate în directorul:

pub/media/kowal/trustedus/

Înainte de implementare, asigură-te că directorul pub/media este partajat sau sincronizat corect între medii, dacă magazinul funcționează într-o arhitectură multi-server.

Checklist de implementare

Înainte de implementare:

• realizează backupul bazei de date,
• realizează backupul codului sau asigură-te că implementarea poate fi reprodusă din repository,
• verifică accesul la repository-ul Composer,
• verifică tokenul GitHub, dacă este necesar,
• planifică fereastra de implementare, dacă magazinul rulează în producție.

După implementare:

• rulează setup:upgrade,
• curăță cache-ul,
• în modul de producție rulează compilarea DI și deployment static content,
• verifică dacă modulul este activ,
• adaugă sau editează o companie de test,
• setează group_slug,
• atribuie produsul,
• adaugă widgetul pe o pagină CMS de test,
• fă clic pe logo și verifică pagina /trusted-us/{slug},
• verifică dacă gridul de produse afișează produsele atribuite studiului de caz,
• verifică pagina produsului cu înregistrările atribuite.

Comenzi de diagnosticare

Verificarea statusului modulului:

php bin/magento module:status Kowal_TrustedUs

Verificarea listei de module Kowal:

php bin/magento module:status | grep Kowal

Curățarea cache-ului:

php bin/magento cache:flush

Recompilarea DI:

php bin/magento setup:di:compile

Cele mai frecvente probleme

Widgetul nu face link către pagina studiului de caz

Verifică dacă înregistrarea are completat câmpul:

Grupa case study / slug URL

Elementul fără group_slug nu este legat prin link de pagina internă.

Pagina /trusted-us/{slug} nu funcționează

Verifică:

• dacă există o înregistrare activă cu acel group_slug,
• dacă a fost rulat setup:upgrade,
• dacă a fost curățat cache-ul,
• dacă modulul Kowal_TrustedUs este activ.

Produsele nu apar pe pagina studiului de caz

Verifică:

• dacă produsele sunt atribuite înregistrării companiei,
• dacă produsele sunt active,
• dacă produsele sunt vizibile în catalog sau în motorul de căutare,
• dacă produsele sunt disponibile în store view-ul curent.

Modificările nu sunt vizibile după implementare

Curăță cache-ul Magento:

php bin/magento cache:flush

În modul de producție, execută și:

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

Dezinstalare

Dezactivarea modulului:

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

Eliminarea pachetului Composer:

composer remove kowal/module-trustedus

Înainte de eliminarea modulului din producție, trebuie verificat dacă magazinul nu folosește widgeturi, blocuri CMS sau conținut dependent de modul.