Mai întâi, identifică integrarea existentă

Tema, modulele și tag managerul pot încărca același serviciu în locuri diferite. Verifică paginile de produs, coșul, checkout-ul și formularele, atât pentru vizitatori autentificați, cât și pentru cei neautentificați.

Stabilește ce trebuie păstrat înainte să dezactivezi integrarea veche: evenimente de conversie, preferințe de consimțământ sau validări ale formularelor. Lucrează într-un mediu de test și verifică versiunea Magento și arhitectura temei.

Adaugă fonturile în sursa temei

Pentru o temă bazată pe biblioteca UI Magento, Adobe recomandă fișierele de font în web/fonts și declararea lor în web/css/source/_typography.less din tema proprie. Nu modifica tema implicită sau fișierele generate styles-m.css: modificările trebuie să reziste regenerării resurselor.

Exemplul următor ilustrează declararea unui font local. Înlocuiește numele și calea cu fișierele licențiate ale proiectului. Pentru o temă fără biblioteca UI, folosește mecanismul CSS și procesul de build al acelei teme.

.lib-font-face(
  @family-name: 'Project Sans',
  @font-path: '@{baseDir}fonts/project-sans-regular',
  @font-weight: 400,
  @font-style: normal,
  @font-display: swap
);

Migrează măsurarea, nu doar scriptul

O pagină vizualizată nu este echivalentă cu o comandă. Definește explicit evenimentele relevante: vizualizare produs, adăugare în coș, începere checkout și comandă confirmată. Verifică moneda, valoarea și eventualele dublări.

Dacă alegi Matomo sau altă platformă, verifică integrarea disponibilă pentru versiunea și frontend-ul magazinului. Un modul potrivit pentru o temă clasică poate necesita adaptări într-un frontend custom. Configurează datele trimise și evită includerea emailurilor sau a altor date ale clientului în evenimente fără o justificare clară.

Protejează endpoint-ul formularului

Adăugarea unui widget antispam în template nu este suficientă. Tokenul trebuie transmis și verificat de backend înainte de operația protejată. Cheia secretă rămâne pe server.

În cazul Turnstile, verifică și acțiunea și hostname-ul așteptat. Tratează tokenul expirat, reutilizat sau invalid ca verificare eșuată. Un mesaj clar trebuie să permită utilizatorului să repete verificarea fără să rescrie formularul.

Ce verificăm înainte de lansare

Parcurgem paginile și fluxurile afectate pe mobil și desktop. Verificăm fonturile și diacriticele, erorile din browser și eventualele blocări cauzate de Content Security Policy.

Pentru măsurare, comparăm evenimentele așteptate cu cele recepționate. Pentru formulare, testăm atât trimiterea validă, cât și lipsa sau invaliditatea tokenului. În checkout verificăm că schimbarea nu afectează plasarea comenzii.

Publicăm numai după validarea pe mediul de test și documentăm pașii de revenire. Costul corect al migrării include această verificare și întreținerea ulterioară, nu doar instalarea unei extensii.

Surse și documentație

Ediție revizuită a articolului publicat inițial pe Verosea în 2025.

Cum se aplică în proiectul tău?

Hai să discutăm ↗