Gestore di Tag Hreflang: configurazione e aiuto

Avvio rapido

  1. Carica e installa lo ZIP di mprhreflang.
  2. Seleziona un negozio nel Back Office e apri "Improve" > Hreflang > Configurazione.
  3. Lascia "Genera tag hreflang" attivo e scegli Tipi di pagina.
  4. Imposta Includi x-default e Lingua predefinita, poi fai clic su "Salva le impostazioni del negozio".
  5. Verifica che SEO Revolution non gestisca la stessa generazione di hreflang.
  6. Apri un prodotto tradotto in ogni lingua e controlla il sorgente della pagina.
  7. Conferma che le destinazioni alternative siano disponibili e che x-default punti alla destinazione di fallback idonea che hai selezionato.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installa e seleziona un negozio

Nel Back Office, apri Moduli > "Module Manager", scegli "Upload a module" e carica lo ZIP del modulo. Installalo, poi fai clic su "Configure". Nelle versioni precedenti di PrestaShop, usa la pagina Moduli corrispondente.

"Configure" apre "Improve" > Hreflang > "Gruppi". Apri Configurazione per le impostazioni del negozio. In multinegozio, seleziona un negozio prima di visualizzare o salvare le sue impostazioni. Il modulo inizializza ogni negozio separatamente.

Il modulo genera link alle lingue alternative nell'head della pagina tramite displayHeader. Non crea traduzioni e non aggiunge un blocco visibile nel negozio. Prepara prima pagine tradotte e attive e codici lingua corretti.

Configura le alternative linguistiche native

Apri Configurazione > Generale.

Impostazione Valore predefinito Cosa fare
"Genera tag hreflang" Sì Attiva la generazione del modulo per questo negozio.
Includi x-default Sì Includi una destinazione di fallback quando esiste nell'insieme risolto.
Lingua predefinita Lingua predefinita del negozio, memorizzata come 0 Scegli una lingua attiva se vuoi un x-default locale diverso.
Tipi di pagina Tutti e sei selezionati Scegli "Pagina iniziale", "Prodotti", "Pagine delle categorie", "Pagine dei contenuti", "Pagine dei marchi" e "Pagine dei fornitori".

Fai clic su "Salva le impostazioni del negozio". Le alternative native collegano le traduzioni disponibili nel negozio corrente. Il modulo usa la generazione di link di PrestaShop per le pagine di entità supportate. I codici lingua provengono da language_code, con ripiego su iso_code, e vengono normalizzati in minuscolo.

I risultati di ricerca, gli elenchi filtrati, la paginazione oltre pagina 1 e le pagine dei moduli sono esclusi dalle alternative generate. Il modulo non genera link di fallback per gli altri tipi di pagine. Nelle pagine di catalogo idonee che gestisce, sopprime i link alle lingue alternative del tema per evitare duplicati.

Se SEO Revolution gestisce la generazione hreflang in questo negozio, la configurazione mostra un avviso e queste impostazioni non cambiano l'output nel negozio. Scegli un solo responsabile. Disattiva la generazione hreflang di SEO Revolution se vuoi affidarla a questo modulo.

Escludi pagine e lingue

Apri Configurazione > Esclusioni di pagine e usa "Escludi pagine e lingue". La selezione predefinita è vuota e non esclude nulla. Seleziona entità o regole del selettore, poi fai clic su "Salva le impostazioni del negozio".

Selezionare una categoria esclude la pagina della categoria. Usa "Prodotti per categoria" quando intendi i prodotti di quella categoria. Escludere la lingua corrente sopprime l'intero insieme di tag della pagina. Esegui il controllo delle esclusioni in Integrità se la schermata segnala che non è stato possibile aggiornare le esclusioni.

Crea un gruppo hreflang

Usa "Gruppi" quando le traduzioni native non bastano. Un gruppo seleziona le pagine sorgenti e assegna destinazioni per lingua. Puoi usare entità di destinazione o URL personalizzati.

Campo Valore predefinito del nuovo gruppo Cosa fare
Nome Vuoto Inserisci un nome interno del gruppo.
Abilitato Sì Disattiva per smettere di applicare il gruppo.
Priorità 10 I valori più bassi vengono elaborati prima. A parità di valore viene usato prima il gruppo più vecchio.
Ambito "Locale" Scegli lingue automatiche locali del negozio o destinazioni reciproche esplicite condivise.
Solo pagina iniziale No Attiva per un gruppo della homepage e svuota entrambi i selettori sorgente.
"Codice x-default condiviso" Vuoto Per un gruppo condiviso, inserisci un codice di destinazione o lascia vuoto per omettere x-default. I gruppi locali usano le impostazioni del negozio.
Pagine di origine Vuoto Seleziona le pagine a cui si applica questo gruppo. Una selezione vuota non corrisponde a nulla.
"Restringi i prodotti (facoltativo)" Vuoto Restringi ulteriormente i prodotti sorgente. I prodotti devono corrispondere a entrambi i selettori.
Destinazioni per lingua Nessuna sostituzione Scegli un negozio/lingua di destinazione e la stessa entità sorgente, un'entità selezionata o un URL personalizzato, secondo le esigenze.

Per esempio, seleziona "Prodotti per categoria" per una categoria di abbigliamento e restringi con un attributo Rosso. Questo si applica ai prodotti corrispondenti, anziché a ogni prodotto o alla pagina della categoria stessa.

Usa "Scegli la destinazione" o "Modifica" nella tabella delle lingue. Le righe locali senza sostituzioni usano "Stessa pagina (automatico)". "Rimuovi la sostituzione" ripristina questo comportamento. Usa Salva gruppo, poi controlla lo stato e l'anteprima. Un gruppo condiviso richiede destinazioni idonee e accesso a ogni negozio partecipante. Le pagine abbinate devono avere contenuti equivalenti; i soli URL reciproci non stabiliscono l'equivalenza.

Verifica l'output e risolvi i problemi

  1. Apri un prodotto o una categoria tradotti in ogni lingua e visualizza il sorgente HTML.
  2. Cerca rel="alternate" e verifica i codici lingua, gli URL di destinazione e l'autoreferenza. Apri ogni destinazione.
  3. Controlla x-default solo quando la sua lingua/destinazione è idonea. L'output nativo richiede almeno due destinazioni linguistiche distinte. I collegamenti tra negozi o i gruppi possono fornire alternative per un negozio altrimenti monolingue.
  4. Controlla un elenco filtrato e pagina 2. Il modulo non dovrebbe generare il proprio insieme di alternative per queste varianti.
  5. Se non compaiono tag, controlla il contesto del negozio, la licenza, "Genera tag hreflang", Tipi di pagina, le esclusioni, lo stato dei gruppi e la gestione da parte di SEO Revolution. Le pagine di destinazione disattivate o non disponibili vengono omesse.
  6. Se il salvataggio viene rifiutato, verifica i diritti di visualizzazione/modifica del dipendente e l'accesso a tutti i negozi partecipanti. Ricarica un modulo scaduto o non valido invece di aggirare i controlli del token.

Il modulo genera i tag nell'head. Non esporta hreflang nelle sitemap. Non aggiunge JavaScript nel negozio per generare i tag.

Personalizza il template

Il template sorgente è modules/mprhreflang/views/templates/hook/hreflang.tpl. Per personalizzarlo, inserisci una copia in themes/your-theme/modules/mprhreflang/views/templates/hook/hreflang.tpl usando il meccanismo di override dei template dei moduli del tuo tema.

Il template attuale riceve l'insieme finale, inclusa un'eventuale riga x-default, in mprhreflang_links. Mantieni l'escape dell'output:

{if isset($mprhreflang_links)}
{foreach from=$mprhreflang_links item=link}
<link rel="alternate" hreflang="{$link.lang|escape:'html':'UTF-8'}" href="{$link.url|escape:'html':'UTF-8'}" />
{/foreach}
{/if}

Non ripristinare il vecchio ciclo separato mprhreflang_xdefault. Un insieme risolto potrebbe contenere en-us, fr-fr, de-de e x-default con i rispettivi URL completi.

Disattiva o disinstalla

Disattiva "Genera tag hreflang" per negozio per sospendere la generazione. Rivedi i collegamenti condivisi quando ritiri un negozio. Disinstalla tramite "Module Manager" per rimuovere menu del modulo, preferenze, configurazione e schema appartenente al modulo. Salva le definizioni dei gruppi che ti servono prima di disinstallare. Licenza, Assistenza, Aggiorna e Integrità sono disponibili nel menu Hreflang.

Compatibilità

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Domande

Ancora nessuna domanda su questo modulo

Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.

Problemi noti

9

PrestaShop 9 rifiutava i salvataggi validi

RisoltoAggiornato:
Risolto nella versione: 1.6.2
Il salvataggio delle impostazioni hreflang su PrestaShop 9 poteva essere rifiutato con un messaggio di token non valido.

L'output del negozio spariva prima della configurazione iniziale

RisoltoAggiornato:
Risolto nella versione: 1.5.3
L'output hreflang poteva sparire prima che le impostazioni specifiche del negozio fossero inizializzate.

Le fonti escluse rimuovevano le alternative native

RisoltoAggiornato:
Risolto nella versione: 1.5.3
L'esclusione di una fonte reciproca poteva rimuovere erroneamente i link alternativi nativi della pagina.

Pagine non correlate rimandavano alle home page linguistiche

RisoltoAggiornato:
Risolto nella versione: 1.5.3
Le pagine sconosciute potevano ricevere link alternativi errati verso le home page linguistiche e le pagine potevano ricevere insiemi concorrenti di link alternativi.

L'editor hreflang poteva non aprirsi

RisoltoAggiornato:
Risolto nella versione: 1.5.3
L'editor dei gruppi poteva fallire durante la preparazione della barra degli strumenti.

Le etichette delle destinazioni usavano la lingua errata

RisoltoAggiornato:
Risolto nella versione: 1.5.3
Le etichette delle destinazioni prodotto potevano essere risolte in una lingua diversa da quella selezionata.

Un posizionamento rimosso tornava automaticamente

RisoltoAggiornato:
Risolto nella versione: 1.5.3
Un posizionamento del modulo rimosso intenzionalmente poteva essere registrato di nuovo automaticamente.

L’amministrazione del modulo poteva non aprirsi

RisoltoAggiornato:
Risolto nella versione: 1.0.11
L’apertura dell’amministrazione del modulo poteva interrompersi con un errore nei negozi privi del supporto necessario per formattare i prezzi.

Traduzioni mancanti

RisoltoAggiornato:
Risolto nella versione: 1.0.6
Alcune etichette contenenti apostrofi restavano non tradotte.

Richieste funzionalità

4

Implementato

Collegamenti hreflang automatici tra negozi

Implementato
Collega automaticamente prodotti, categorie e pagine CMS con gli stessi ID di entità tra i negozi selezionati. Puoi collegare le pagine con ID diversi usando gruppi manuali.

Destinazioni linguistiche mirate

Implementato
Crea gruppi hreflang e scegli la pagina di destinazione per ogni lingua tramite un selettore di pagine.

Mappature reciproche delle pagine multinegozio

Implementato
Collega le pagine corrispondenti tra negozi, pubblica link linguistici reciproci e visualizza in anteprima le mappature personalizzate.

Esclusione di entità

Implementato
Escludi le entità selezionate dall'output hreflang personalizzato.

Registro modifiche

v1.0.72026-05-04

  • Addedcomplete FR/DE/ES/IT/PL translations
Versioni precedenti

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-14

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • Addedx-default hreflang tag with configurable language mapping
  • Improvedmulti-shop hreflang generation: correctly resolves cross-shop product URLs
  • Fixedhreflang tags missing on CMS category pages with URL rewriting enabled
  • Addedsitemap integration: hreflang alternates exported alongside sitemap entries

v1.0.02025-12-10

  • Initialrelease: automatic hreflang link tags for all front-office page types
  • InitialCovers product, category, CMS, and home pages across all active shop languages
  • InitialConfigurable language-to-locale code mapping via admin panel
  • InitialSelf-referencing hreflang included on each page as per Google guidelines

v1.1.02025-08-11

  • Addedsupport for region subtags (e.g. en-GB, fr-FR) with per-language configuration
  • Improvedpage type coverage: search results, brand, and supplier pages now included
  • Fixedincorrect locale code mapping for Portuguese (Brazil) vs Portuguese (Portugal)
  • Addedadmin audit view showing all hreflang tags generated for a given URL

Demo

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su