Link Interni Automatici per Shopware 6

Panoramica

DfInternalLinking automatizza il collegamento interno del tuo negozio Shopware 6. Definisci regole che associano una parola chiave a una pagina di destinazione (prodotto, categoria o URL libero) e il plugin trasforma le occorrenze di quella parola chiave in link contestuali all’interno delle descrizioni prodotto e dei blocchi di contenuto CMS.

Compatibilità

• Shopware 6.5.x, 6.6.x e 6.7.x
• PHP 8.1 o superiore, secondo i requisiti della tua versione di Shopware
• Multicanale: configurazione indipendente per canale di vendita
• Amministrazione tradotta in inglese, tedesco, francese, spagnolo e italiano

Installazione

Dall’amministrazione

1. Vai su Estensioni > Le mie estensioni.
2. Clicca su Carica estensione e seleziona il file ZIP del plugin.
3. Clicca su Installa e attiva l’estensione con l’interruttore.

Da riga di comando

Estrai la cartella del plugin in custom/plugins/ ed esegui:

bin/console plugin:refresh
bin/console plugin:install --activate DfInternalLinking
bin/console cache:clear

Se installi dai sorgenti invece che da uno ZIP precompilato, ricostruisci l’amministrazione:

./bin/build-administration.sh

Configurazione generale

Apri Impostazioni > Sistema > Estensioni, poi le impostazioni di DfInternalLinking. Ogni opzione può essere definita a livello globale o per canale di vendita.

• Attiva il collegamento — attiva o disattiva l’iniezione dei link. Predefinito: attivo.
• Numero massimo di link per pagina — budget globale di link iniettati su una stessa pagina, su tutte le regole. Predefinito: 5.
• Modalità silo — applica una regola solo se la sua destinazione condivide un ramo di categoria con la pagina corrente. Predefinito: disattivato.
• Aggiungi nofollow — aggiunge l’attributo rel nofollow ai link generati. Predefinito: disattivato.
• Classe CSS dei link — classe applicata a ogni link generato, per personalizzarlo nel tuo tema. Predefinito: df-internal-link.

Creare una regola parola chiave

Il plugin aggiunge una voce Link interni al menu Marketing dell’amministrazione. Clicca su Aggiungi regola per aprire il modulo.

• Parola chiave — l’espressione da individuare nei tuoi contenuti. Il rilevamento non distingue maiuscole e rispetta i confini di parola.
• Tipo di destinazione — Prodotto, Categoria o URL personalizzato.
• Prodotto / categoria di destinazione — il selettore mostrato dipende dal tipo scelto. L’URL SEO canonico viene generato automaticamente da Shopware per il canale corrente.
• URL di destinazione — campo visualizzato solo per il tipo URL personalizzato. Accetta un URL assoluto o un percorso relativo.
• Numero massimo di link per pagina — limite specifico di questa regola, applicato in aggiunta al budget globale.
• Priorità — le regole sono elaborate per priorità crescente. A parità di priorità, la parola chiave più lunga viene applicata per prima.
• Lingua — limita la regola a una sola lingua. Lascia vuoto per applicarla a tutte.
• Canale di vendita — limita la regola a un solo canale. Lascia vuoto per applicarla a tutti.
• Attivo — disattiva temporaneamente una regola senza eliminarla.

Dove vengono iniettati i link

Il plugin elabora i seguenti contenuti:

• La descrizione del prodotto nelle pagine prodotto
• I blocchi di contenuto di tipo testo e HTML delle pagine prodotto, di navigazione (categorie) e landing

L’analisi viene eseguita sull’albero HTML ed elabora solo i nodi di testo. Le seguenti aree vengono sempre ignorate:

• L’interno dei link esistenti
• I titoli dal livello 1 al 6
• I tag di script e di stile
• I pulsanti

Due protezioni completano questo comportamento: i confini di parola Unicode impediscono qualsiasi sostituzione all’interno di una parola e una pagina non si collega mai a sé stessa.

La modalità silo

La modalità silo è pensata per cataloghi strutturati in universi tematici. Quando è attiva, una regola viene applicata solo se la sua destinazione condivide almeno un ramo di categoria con la pagina in fase di rendering.

In pratica, su una scheda prodotto collocata nel ramo Escursionismo, verranno applicate solo le regole che puntano ad altri prodotti o categorie di quel ramo. Le regole che puntano a un altro ramo vengono ignorate. Questo concentra l’autorevolezza dei link all’interno di ogni silo e rafforza la coerenza tematica percepita dai motori di ricerca.

Il report delle pagine orfane

Dall’elenco delle regole, clicca su Report pagine orfane. Il report elenca:

• I prodotti attivi che nessuna regola attiva prende di mira
• Le categorie attive di tipo pagina che nessuna regola attiva prende di mira

Tre statistiche accompagnano ogni tabella: il numero totale di elementi attivi, il numero di elementi collegati e il numero di orfani. Usa questo report come tabella di marcia: ogni pagina orfana è una pagina che non riceve alcun link interno dal tuo catalogo.

Cache e messa in produzione

Svuota la cache dopo una sessione di modifica delle regole:

bin/console cache:clear

Puoi anche usare il pulsante di svuotamento della cache disponibile nell’amministrazione di Shopware.

Risoluzione dei problemi

Nessun link appare nel negozio

• Verifica che il collegamento sia attivo nella configurazione per il canale di vendita interessato.
• Verifica che la regola sia attiva e che la sua lingua e il suo canale corrispondano alla pagina consultata.
• Svuota la cache dello storefront.
• Assicurati che la parola chiave sia effettivamente presente nella descrizione, al di fuori di un link o di un titolo.

Meno link del previsto

Il budget globale per pagina è stato raggiunto. Aumenta il valore nella configurazione o riduci il limite delle regole meno prioritarie.

Una regola viene ignorata su alcune pagine

Probabilmente la modalità silo è attiva e la destinazione della regola appartiene a un altro ramo di categoria. Disattiva la modalità silo o collega la destinazione al ramo corretto.

Una parola chiave rimanda al posto sbagliato

Due regole concorrenti puntano allo stesso testo. Regola la priorità: il valore più basso viene elaborato per primo.

Disinstallazione

Durante la disinstallazione, se non selezioni l’opzione di conservazione dei dati, la tabella delle regole viene eliminata. Le tue descrizioni prodotto e i tuoi contenuti CMS restano intatti, poiché non sono mai stati modificati.