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.
Table des matières
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
%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.
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.