Héberger votre centre d’aide dans un sous-dossier avec Netlify
Diffusez votre centre d’aide à un chemin d’un site hébergé sur Netlify, par exemple yourcompany.com/help, à l’aide de règles de proxy dans netlify.toml.
Un moyen de paiement doit être enregistré ; un essai avec une carte répond à cette exigence. Les propriétaires et les administrateurs peuvent modifier ce paramètre.
Définir le sous-dossier dans Ferndesk
Dans Centre d’aide > Personnaliser > Domaine personnalisé, choisissez Sous-dossier personnalisé, saisissez le domaine de votre site et un chemin tel que /help, puis cliquez sur Configurer le sous-répertoire. Copiez l’Hôte proxy qui s’affiche (il ressemble à yourcompany.hc.ferndesk.com). Les exemples ci-dessous utilisent /help et www.yourcompany.com ; remplacez-les par vos propres valeurs.
Ajouter les règles
Ajoutez ces règles dans netlify.toml, avant toute règle générique telle que /*. Utilisez netlify.toml, et non un fichier _redirects : Netlify n’envoie des en-têtes de requête personnalisés que depuis netlify.toml.
[[redirects]]
from = "/help"
to = "https://PROXY_HOST/"
status = 200
force = true
headers = {X-Ferndesk-Base-Path = "/help", X-Ferndesk-Original-Host = "www.yourcompany.com"}
[[redirects]]
from = "/help/*"
to = "https://PROXY_HOST/:splat"
status = 200
force = true
headers = {X-Ferndesk-Base-Path = "/help", X-Ferndesk-Original-Host = "www.yourcompany.com"}
[[redirects]]
from = "/_ferndesk/*"
to = "https://PROXY_HOST/_ferndesk/:splat"
status = 200
force = true
headers = {X-Ferndesk-Base-Path = "/help", X-Ferndesk-Original-Host = "www.yourcompany.com"}Remplacez PROXY_HOST par votre hôte proxy et www.yourcompany.com par l’hôte de votre site, puis déployez. Pour en savoir plus sur la syntaxe des règles, consultez le guide de Netlify sur les réécritures et les proxys.
Vérifier que tout fonctionne
Ouvrez https://www.yourcompany.com/help. Votre centre d’aide devrait s’afficher avec sa mise en forme, et les liens entre les articles devraient rester sur votre domaine. En cas de problème, consultez Résoudre les problèmes de votre centre d’aide.
Pour utiliser plutôt un sous-domaine ou un autre hébergeur, consultez Connecter un domaine personnalisé à votre centre d’aide.