Guide pour les liens vers les articles d’assistance

Informations de la révision
  • Identifiant de la révision : 284233
  • Date de création :
  • Créateur : Mozinet
  • Commentaire : relecture avec retouches et corrections dont des formule genrée et espaces insécables
  • Vérifiée : Oui
  • Vérifiée :
  • Vérifiée par : Mozinet
  • Révision approuvée ? Oui
  • Est la révision courante ? Oui
  • Prêt pour la localisation : Non
Source de la révision
Contenu de la révision

La création de liens vers les articles du portail d’assistance Mozilla (SUMO) est essentielle pour fournir à nos internautes un accès immédiat à l’aide dont ils ont besoin. Il y a deux façons principales de mettre en place ces liens. La méthode à choisir dépend de l’endroit où vous créez le lien. Ce guide vous présente ces deux méthodes afin que vous puissiez créer des liens pertinents et aider les internautes à trouver facilement les contenus les plus appropriés du portail d’assistance.

Liens in-product vers SUMO

Pour les liens situés au sein de l’interface du navigateur Firefox ou Firefox pour Android, vous devez utiliser une structure d’URL particulière. Cette structure permet à l’équipe CX chargée du contenu (CX : expérience client) d’adapter la cible du lien sans altérer les fonctionnalités de Firefox. Nous avons défini des cibles spécifiques pour différents sujets, ce qui nous permet de rediriger les internautes vers les articles les plus pertinents en fonction de critères tels que le système d’exploitation ou la version de Firefox qu’ils utilisent. Cette structure flexible permet d’effectuer des mises à jour ou des modifications directement dans Kitsune, sans qu’il soit nécessaire de modifier le code de Firefox.

Voici le format à utiliser pour créer des liens in-product vers des articles SUMO :

https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC

Note : les éléments de code %VERSION%/%OS%/%LOCALE%/ sont des espaces réservés. Les membres de l’équipe d’ingénierie se chargent de les remplir dynamiquement dans le code source.

Exemple :

https://support.mozilla.org/1/firefox/13.0a2/Darwin/fr/prefs-privacy

Dans cette structure :

  • %VERSION% désigne la version de Firefox.
  • %OS% correspond au système d’exploitation de l’internaute.
  • %LOCALE% précise les paramètres de langue et de région de l’internaute.
  • TOPIC indique le sujet de l’article d’assistance et peut être une chaîne textuelle quelconque.

Pour les liens spécifiques à la version Firefox pour Android, l’URL doit inclure /1/mobile afin de les distinguer des liens destinés à la version pour ordinateur.

Note : lorsque vous créez un espace réservé SUMO pour tester un lien in-product, l’espace réservé doit être publié et conservé en mode administration pour qu’il fonctionne correctement. Une fois le contenu finalisé et prêt à être publié, l’article doit quitter le mode administration pour être visible par les internautes.
Pour la création de liens in-product, il faut ouvrir un ticket Bugzilla, qui sera géré par l’équipe CX. N’essayez pas de créer manuellement ces liens par vous-même, car ils doivent être configurés dans Kitsune avant de pouvoir fonctionner correctement.

Liens de propriété web vers SUMO

Lorsque vous créez des liens à partir de propriétés web externes à Firefox, ignorez la partie locale de l’URL. Cette méthode permet au projet SUMO de détecter et de rediriger automatiquement l’internaute vers la version linguistique appropriée de l’article, selon les paramètres de son navigateur.

Donc, par exemple, pour établir un lien vers l’article Mettre à jour Firefox vers la dernière version :

  • Utilisez https://support.mozilla.org/kb/update-firefox-latest-release
  • N’utilisez pas https://support.mozilla.org/en-US/kb/update-firefox-latest-release

Liens depuis un autre emplacement

Si vous n’établissez pas un lien depuis Firefox ou un site web (peut-être depuis une application, un produit, un e-mail, etc.), vous préfèrerez probablement utiliser l’URL (sans la chaîne locale) et identifier la source.

Exemple :

https://support.mozilla.org/kb/update-firefox-latest-release?utm_source=NomDeLaSource

Créer un lien court mzl.la

Consultez l’article Comment obtenir un lien court en mzl.la pour savoir comment créer un tel lien mzl.la.

Des questions ?

Si vous avez besoin de créer un lien in-product, veuillez remplir en anglais un ticket Bugzilla. Pour toute question, écrivez-nous également en anglais dans ce fil de discussion.

En savoir plus