Ultima modifica:
2 giorni, 15 ore ago
Quando gli ingegneri o i product manager Mozilla creano un link a un articolo di supporto di SUMO dall'interno di un prodotto (come Firefox), dovrebbero sempre utilizzare un URL stabile, non il link diretto all'articolo. I link diretti cambiano quando il titolo o lo slug dell'articolo vengono aggiornati, il che può danneggiare il funzionamento dei link interni al prodotto. I link stabili proteggono da questo problema e garantiscono che gli utenti raggiungano sempre la pagina giusta.
Questo articolo spiega perché i link stabili sono importanti, come formattarli per le diverse piattaforme e come impostarne uno utilizzando la dashboard di Kitsune.
Indice dei contenuti
Perché i link stabili sono importanti
L'utilizzo di link diretti agli articoli di supporto (come https://support.mozilla.org/en-US/kb/example-article) può causare problemi:
- Si danneggiano facilmente: gli URL degli articoli cambiano se il titolo cambia, a meno che il redattore non conservi manualmente lo slug.
- Non sono localizzabili: i link diretti includono una lingua specifica, il che non è ideale per gli utenti di altre lingue e Paesi.
- Sono più difficili da gestire: non è possibile aggiornarli globalmente se utilizzati direttamente nel prodotto.
Al contrario, i link stabili:
- Rimangono coerenti, anche se l'URL dell'articolo cambia
- Rilevano automaticamente la localizzazione corretta
- Possono essere reindirizzati o aggiornati centralmente se necessario
Formato dei link per gli articoli di supporto interni al prodotto
Utilizzare un formato standardizzato per costruire link di supporto stabili per i prodotti desktop e mobili:
Note:
-
%VERSION%,%OS%e%LOCALE%vengono compilati automaticamente dal prodotto. - Il team di SUMO crea i campi
<slug>e<product>. - Sostituire
<slug>con lo slug univoco creato.
Questo formato garantisce che gli utenti vengano indirizzati all'articolo localizzato corretto.
Esempio:https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/recommendations-firefox-new-tab
Come impostare un link stabile interno al prodotto in Kitsune
Per creare un reindirizzamento stabile, seguire questi passaggi nella dashboard di amministrazione di Kitsune.
- Accedere alla dashboard di amministrazione di Kitsune.
- Sotto INPRODUCT, fare clic su Redirects.
- Fare clic su nell'angolo in alto a destra.
- Compilare i campi obbligatori Product, Topic e Target, come descritto nella sezione Campi di reindirizzamento sottostante.
- Fare clic su .
- Condividere il link stabile completato con l'ingegnere o il product manager, utilizzando il formato interno al prodotto:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/<slug>
Campi di reindirizzamento
| Campo | Descrizione |
|---|---|
| Product | Utilizzare firefox per desktop o mobile per i prodotti mobili di Firefox.
|
| Topic (slug) |
Inserire un identificatore breve e univoco per l'articolo. Questo diventerà parte del link stabile.
Nota: lo slug non deve corrispondere all'URL effettivo dell'articolo di destinazione. Scegliere qualcosa di significativo e coerente per l'utilizzo nel prodotto.
|
| Target |
Il percorso dell'articolo di supporto a cui si desidera reindirizzare. Includere solo la parte da Example:
Nota: è possibile includere un'ancora (ad esempio,
kb/customize-items-on-firefox-new-tab-page#w_weather) per creare un link a una sezione specifica. Le ancore funzionano solo nella versione inglese e potrebbero non funzionare in altre localizzazioni. |
Suggerimenti
- I link stabili garantiscono la localizzazione: gli utenti verranno reindirizzati automaticamente alla loro lingua preferita quando disponibile.
- È possibile aggiornare o eliminare i reindirizzamenti stabili in un secondo momento tramite l'interfaccia di amministrazione di Kitsune.
- Utilizzare questo metodo ogni volta che si crea un link da:
- Messaggi "Ulteriori informazioni" interni al prodotto
- Flussi di onboarding
- Messaggi di errore o di avviso
- Finestre modali di aiuto contestuale
