Creare collegamenti (link) agli articoli del Supporto Mozilla è fondamentale per fornire ai nostri utenti un accesso diretto all'assistenza di cui hanno bisogno. Esistono due modi principali per creare questi link, e il metodo scelto dipende dalla fonte da cui si desidera creare il link. Questa guida illustra entrambi i metodi per garantire che i link siano efficaci, aiutando gli utenti a trovare facilmente i contenuti di supporto appropriati.
Indice dei contenuti
Link a SUMO interni al prodotto (in-product links)
Per i link inseriti nell'interfaccia del browser Firefox o Firefox per Android, è necessario utilizzare una struttura URL specifica. Questa struttura consente al CX Content Team di modificare la destinazione del link senza interrompere le funzionalità di Firefox. Abbiamo definito obiettivi specifici per vari argomenti, consentendoci di indirizzare gli utenti agli articoli più pertinenti in base a fattori come il sistema operativo o la versione di Firefox. Questa flessibilità consente di apportare aggiornamenti o modifiche direttamente in Kitsune, senza dover apportare modifiche al codice di Firefox.
Ecco il formato per creare link in-product agli articoli SUMO:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
%VERSION%/%OS%/%LOCALE%/
sono placeholders (segnaposto). Gli sviluppatori sono responsabili del loro popolamento dinamico nel codice sorgente.Esempio:
https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
In questa struttura:
%VERSION%
si riferisce alla versione di Firefox.%OS%
rappresenta il sistema operativo dell'utente.%LOCALE%
specifica le impostazioni di lingua e regione dell'utente.TOPIC
indica l'oggetto dell'articolo di supporto e può essere qualsiasi stringa di testo.
Per i link specifici di Firefox per Android, l'URL deve includere /1/mobile
per distinguerlo dai link destinati alla versione desktop.
Evitare i reindirizzamenti alle àncore
I reindirizzamenti a specifiche àncore all'interno degli articoli sono fragili e possono smettere facilmente di funzionare se la struttura della pagina cambia. Per evitare link non funzionanti, creare sempre un link alla pagina principale dell'articolo. Questo garantisce che i link rimangano validi e che gli utenti possano accedere alle informazioni necessarie indipendentemente dagli aggiornamenti alle sezioni interne dell'articolo.
Link di proprietà web a SUMO
Quando si creano link da proprietà web esterne a Firefox, omettere la parte relativa alle impostazioni locali dell'URL. Questa pratica consente al sistema SUMO di rilevare automaticamente e indirizzare l'utente alla versione linguistica appropriata dell'articolo in base alle impostazioni del browser.
Quindi, ad esempio, per creare un link all'articolo Update Firefox to the latest release:
- Utilizzare
https://support.mozilla.org/kb/update-firefox-latest-release
- Non utilizzare
https://support.mozilla.org/en-US/kb/update-firefox-latest-release
Link da altre fonti
Se non si crea un link da Firefox o da un sito web (ad esempio un'app, un prodotto, un'email, ecc.), probabilmente si desidera utilizzare l'URL (senza la stringa relativa alle impostazioni locali) e identificare la fonte.
Esempio:
https://support.mozilla.org/kb/update-firefox-latest-release?utm_source=nameofsource
Creare un link abbreviato mzl.la
Per informazioni su come creare un link abbreviato mzl.la, fare riferimento a Come ottenere un link mzl.la abbreviato.
Domande?
Se devi impostare un link all'interno del prodotto, compila un ticket Content Request Bugzilla. Per qualsiasi domanda, scrivi un paio di righe in questo thread di supporto.