Gestore di Tag Hreflang: configurazione e aiuto
Avvio rapido
- Carica e installa lo ZIP di mprhreflang.
- Seleziona un negozio nel Back Office e apri "Improve" > Hreflang > Configurazione.
- Lascia "Genera tag hreflang" attivo e scegli Tipi di pagina.
- Imposta Includi x-default e Lingua predefinita, poi fai clic su "Salva le impostazioni del negozio".
- Verifica che SEO Revolution non gestisca la stessa generazione di hreflang.
- Apri un prodotto tradotto in ogni lingua e controlla il sorgente della pagina.
- 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
- Apri un prodotto o una categoria tradotti in ogni lingua e visualizza il sorgente HTML.
- Cerca
rel="alternate"e verifica i codici lingua, gli URL di destinazione e l'autoreferenza. Apri ogni destinazione. - 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.
- Controlla un elenco filtrato e pagina 2. Il modulo non dovrebbe generare il proprio insieme di alternative per queste varianti.
- 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.
- 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
L'output del negozio spariva prima della configurazione iniziale
Le fonti escluse rimuovevano le alternative native
Pagine non correlate rimandavano alle home page linguistiche
L'editor hreflang poteva non aprirsi
Le etichette delle destinazioni usavano la lingua errata
Un posizionamento rimosso tornava automaticamente
L’amministrazione del modulo poteva non aprirsi
Traduzioni mancanti
Richieste funzionalità
4
Implementato
Collegamenti hreflang automatici tra negozi
Destinazioni linguistiche mirate
Mappature reciproche delle pagine multinegozio
Esclusione di entità
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.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.