PS PrestaShop Principiante

Hreflang Manager: tag hreflang multilingua e multinegozio

Installare, configurare, visualizzare in anteprima e sottoporre ad audit i tag hreflang di PrestaShop, senza override.

Aggiornato Versione del modulo 2.0.0

Presentazione

Hreflang Manager scrive i tag <link rel="alternate" hreflang> delle pagine per indicare a Google le versioni linguistiche e regionali di una stessa pagina. Ne scrive un solo set per pagina, solo sulle pagine canoniche e indicizzabili, e solo verso le versioni che esistono davvero.

Compatibile con PrestaShop da 1.7.8 a 9.x, negozio singolo e multinegozio (uno o più domini). La versione 2.0.0 non contiene alcun override e non modifica alcun file del tema.

Panoramica di Hreflang Manager: punteggio, versioni attive e rilevamento dei conflitti (tema, SEO, sitemap, override)
Panoramica di Hreflang Manager

Novità della versione 2.0

  • Niente più override: il modulo funziona con gli hook. L’override di FrontController della 1.0.0 viene rimosso con l’aggiornamento.
  • Un solo set di tag: scritto nella variabile del tema o tramite l’hook displayHeader, con una protezione che rimuove i duplicati.
  • Versioni verificate: nessun link verso un prodotto inattivo, non tradotto o assente da un negozio; nessun tag su 404, pagine noindex, elenchi filtrati e combinazioni.
  • Back office riprogettato: assistente di configurazione, mappa lingua × paese → negozio, anteprima dei tag, audit con punteggio, rilevamento dei conflitti, modalità test.
  • Sitemap XML hreflang facoltativa, cache per pagina, compatibilità con PrestaShop 1.7.8 e interfaccia in 8 lingue.

Installazione e aggiornamento

  1. In Moduli > Gestione moduli, fare clic su Carica un modulo e inviare il file ZIP.
  2. Il modulo si apre in Parametri negozio > Traffico & SEO > Hreflang Manager.
  3. Finché non è configurata alcuna versione, il modulo non modifica le pagine. Avviare l’Assistente di configurazione.

L’aggiornamento dalla 1.0.0 conserva versioni e gruppi. I valori scritti in modo errato vengono corretti quando la correzione è certa (en_UK diventa en-GB, fr_BE diventa fr-BE), viene mantenuto un solo x-default per gruppo, il vecchio override viene rimosso dalla procedura di PrestaShop e il menu passa sotto Traffico & SEO. Un rapporto viene visualizzato nella panoramica.

In multinegozio, installare il modulo nel contesto «Tutti i negozi» e verificare che sia attivato su ogni negozio di un gruppo: in caso contrario, le sue pagine non rimandano alle altre versioni e Google ignora le coppie. Il rilevatore di conflitti lo segnala.

Assistente di configurazione

L’assistente legge i negozi, i relativi domini (HTTP o HTTPS), il paese e le lingue attive, quindi propone un valore hreflang per ogni coppia negozio e lingua:

  • una lingua venduta in un solo negozio riceve solo la lingua (fr): si rivolge a tutti i francofoni;
  • una lingua venduta in più negozi riceve il paese di ciascun negozio (fr-FR, fr-BE) affinché Google mostri il negozio corretto;
  • l’x-default proposto è la lingua principale del negozio predefinito.

I valori vengono verificati durante l’inserimento. Nulla cambia sulle pagine prima del salvataggio.

Assistente di configurazione: negozi, domini e lingue rilevati, valori hreflang e x-default proposti
Assistente di configurazione

Versioni, gruppi e mappa

Ogni riga è una versione: un negozio, una lingua, un valore hreflang, un’origine pubblica facoltativa (se il negozio è servito su un altro dominio), un interruttore di attivazione e la scelta dell’x-default. Una sola versione x-default per gruppo.

La mappa lingua × paese → negozio mostra quale negozio serve quale mercato. Le versioni in grigio non vengono stampate (inattive, o lingua disattivata nel negozio).

I gruppi collegano negozi che puntano gli uni agli altri. Il contenuto viene abbinato per id (catalogo condiviso) oppure esclusivamente tramite mappatura manuale (cataloghi separati). La mappatura collega due id di un prodotto, una categoria, una pagina CMS, una marca o un fornitore; funziona in entrambe le direzioni e resta coerente in tutto il gruppo.

Versioni e mappa lingua × paese → negozio, con verifica dei codici hreflang durante la digitazione
Versioni e mappa lingua × paese → negozio, con verifica dei codici hreflang durante la digitazione

Regole applicate

Il modulo segue le linee guida di Google Search Central sulle versioni localizzate:

  • URL assoluti con il protocollo e il dominio di ogni negozio; spazi e caratteri non consentiti codificati.
  • Autoriferimento e link di ritorno: ogni versione elenca tutte le altre e se stessa, con lo stesso set su tutte le versioni.
  • Codici validi: lingua ISO 639-1, paese ISO 3166-1 alpha-2 facoltativo, script ISO 15924 facoltativo. en-UK, gli underscore, un paese da solo o es-419 vengono rifiutati con un suggerimento.
  • Solo versioni esistenti: prodotto attivo e visibile, categoria attiva e accessibile ai visitatori, pagina CMS attiva e indicizzabile, marca o fornitore attivo, tradotti nella lingua di destinazione.
  • Solo pagine canoniche e indicizzabili: nessun tag su 404, pagine noindex, elenchi filtrati o ordinati, URL di combinazione, carrello, account e ricerca, né quando il tag canonical indica un altro indirizzo.
  • Paginazione: la pagina 2 di una categoria punta alla pagina 2 delle altre versioni (configurabile).

Anteprima dei tag

Inserire un URL del negozio o scegliere un esempio (home page, prodotto, categoria, pagina 2, pagina CMS). Il modulo legge la pagina dal server e visualizza la diagnostica (pagina canonica, noindex, versione assente…), ogni tag con il relativo controllo e, affiancati, l’head atteso e l’head effettivamente stampato. Possono essere letti solo i domini della propria installazione.

Anteprima dei tag di una pagina prodotto: tag attesi e visualizzati, ogni alternativa verificata
Anteprima dei tag di una pagina prodotto
Estratto del codice sorgente della sezione head: tag hreflang attesi e quelli visualizzati dalla pagina
Estratto del codice sorgente della sezione head

Audit

L’audit legge un campione di pagine dei propri domini (home page, prodotti, categorie con pagina 2, pagine CMS, marche, fornitori, altre pagine), ciascuna in tutte le sue versioni, quindi verifica: risposta 200, indicizzabilità, tag canonical, valori, URL assoluti, autoriferimento, link di ritorno, duplicati, x-default e un solo set per pagina. Visualizza un punteggio, gli errori e gli avvisi raggruppati per regola con la correzione da apportare, la cronologia degli audit e un’esportazione CSV.

Avviato con il modulo su «Disattivato», l’audit valuta i tag nativi di PrestaShop: l’immagine seguente mostra questo risultato su un negozio dimostrativo (link di ritorno mancanti sulle pagine 2, x-default assente).

Audit hreflang dei tag nativi di PrestaShop: punteggio, errori, avvisi e correzioni suggerite
Audit hreflang dei tag nativi di PrestaShop

L’audit non chiama alcun servizio esterno e legge solo gli indirizzi dichiarati nei negozi. Se il server non riesce a raggiungere il proprio dominio (Docker, NAT, DNS locale), la richiesta passa dall’interfaccia locale del server con lo stesso nome host.

Conflitti e altre fonti

La panoramica elenca ciò che può generare tag hreflang oltre al modulo, senza mai modificarne le impostazioni:

  • il tema (Classic, Hummingbird e la maggior parte dei temi stampano $urls.alternative_langs);
  • DataFirefly All in One SEO se la sua opzione «Gestisci hreflang» è attiva: la protezione mantiene un solo set e un pulsante esegue Hreflang Manager per ultimo;
  • le sitemap di DataFirefly Sitemap o della suite SEO che contengono alternative;
  • gli altri moduli contenenti codice hreflang, il vecchio override della 1.0.0, un modulo disattivato in un negozio del gruppo, i negozi serviti in HTTP.

Il pulsante Verifica ora le home page legge la home page di ogni negozio come un visitatore e conta i tag e i duplicati.

Impostazioni

  • Stato: online, modalità test (visitatori e motori di ricerca vedono i tag originali, solo l’anteprima e l’audit vedono i nuovi) o disattivato.
  • Dove stampare i tag: automatico (variabile del tema se il tema la stampa, altrimenti hook displayHeader), variabile del tema o hook.
  • Protezione anti-duplicati e rimozione dei tag di PrestaShop dove il modulo non ne stampa (404, noindex, elenchi filtrati…).
  • Paginazione, rispetto del tag canonical, altre pagine con versioni (più venduti, nuovi prodotti, promozioni, contatti, negozi fisici, elenchi di marche e fornitori) e pagine di moduli consentite (module/controller).
  • Sitemap XML hreflang: facoltativa, una per negozio, all’indirizzo /module/datafireflyhreflang/sitemap. Ogni indirizzo elenca tutte le sue versioni con xhtml:link, compreso se stesso. La sitemap va dichiarata manualmente in Google Search Console o in robots.txt.
  • Cache: le alternative di una pagina vengono calcolate una volta e poi lette con una sola query; vengono ricalcolate quando si salva un prodotto, una categoria, una pagina CMS, una marca o un fornitore, e interamente quando cambia una versione, un gruppo, una lingua o un negozio.
Impostazioni: output unico, protezione anti-duplicati, paginazione, sitemap XML hreflang e cache
Impostazioni

Se anche DataFirefly Sitemap o la suite SEO inseriscono hreflang nella propria sitemap, dichiarare a Google una sola di queste sitemap, oppure verificare che riportino le stesse informazioni.

Sicurezza e permessi

  • Ogni modifica richiede il permesso «Modifica» sulla scheda Hreflang Manager e il token di sicurezza del back office; un profilo in sola lettura può consultare, visualizzare l’anteprima ed esportare.
  • L’anteprima e l’audit rifiutano qualsiasi indirizzo esterno ai domini del negozio (nessun accesso a un URL arbitrario).
  • Gli URL stampati nell’head vengono sottoposti a escape; l’esportazione CSV neutralizza le celle che iniziano con =, +, - o @.

Disinstallazione

La disinstallazione elimina le 6 tabelle del modulo (versioni, gruppi, negozi dei gruppi, mappatura, cache, audit), le sue impostazioni e la sua scheda. Non ci sono file del tema né override da ripulire.

Risoluzione dei problemi

Nessun tag su una pagina

Aprire l’anteprima su questo URL: la diagnostica indica il motivo (pagina noindex, filtrata, di combinazione, canonical verso un altro indirizzo, versione unica, lingua senza versione, modalità test…).

Tag duplicati

Attivare la protezione anti-duplicati, quindi consultare «Conflitti e altre fonti»: un modulo o il tema stampa i propri tag.

Una versione è inattiva da un solo lato, il modulo è disattivato in un negozio del gruppo, oppure una cache a pagina intera serve una vecchia pagina. Svuotare la cache del modulo (Impostazioni) e quella del negozio.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza