Placer votre centre d’aide dans un sous-dossier avec Netlify
Hébergez votre centre d’aide à un chemin d’accès sur 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 satisfait à 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 d’accès tel que /help, puis cliquez sur Configurer le sous-répertoire. Copiez l’Hôte proxy qui vous est indiqué (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 à 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 qu’à partir de 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 connaître 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 Dépanner 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.