Una guida sui link agli articoli di supporto

Contributors Contributors Ultima modifica:

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.

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

Nota: le sezioni %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.

Nota: quando si crea un segnaposto SUMO per provare un link interno al prodotto, il segnaposto deve essere pubblicato e mantenuto sotto administration affinché funzioni correttamente. Una volta che il contenuto è finalizzato e pronto per la pubblicazione, l'articolo dovrebbe essere rimosso dall'amministrazione per renderlo visibile agli utenti finali.
La creazione di link interni al prodotto deve essere coordinata tramite un ticket Content Request Bugzilla, che sarà gestito dal CX Content Team. Si prega di non tentare di creare manualmente questi link, poiché devono essere impostati in Kitsune prima di poter funzionare correttamente.

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.

Ulteriori informazioni

Questi bravi collaboratori hanno contribuito alla scrittura di questo articolo:

Illustration of hands

Collabora

Impara e condividi la tua esperienza con gli altri. Rispondi alle domande e migliora la nostra Knowledge Base.

Ulteriori informazioni