Problèmes d’affichage du contenu et de fonctionnalité

Les icônes ne s’affichent pas correctement sur le site utilisateur

Dans certains cas, les icônes sur le site utilisateur peuvent ne pas s’afficher correctement, surtout lorsqu’il y a un grand nombre d’icônes pour différentes navigations. La principale raison des icônes cassées est une modification involontaire de la famille FontAwesome fournie par Document360. Cela se produit lorsque des modifications d’autres classes ou des balises HTML sur le site utilisateur modifient involontairement les paramètres de police des icônes.
Pour éviter ce problème,

• Assurez-vous que les modifications du style ou des définitions de classe du site n’affectent pas les classes FontAwesome ou les paramètres de la famille de polices.

• Lorsque vous ciblez des éléments spécifiques, vérifiez que les styles liés aux icônes restent intacts et ne sont pas écrasés.

Étapes à résoudre :

1. Inspecter l’icône cassée :

1. Utilisez les outils de développement de votre navigateur pour inspecter le site utilisateur.

2. Cliquez sur l’icône cassée avec l’outil de sélection pour identifier le problème.

2. Vérifiez le CSS personnalisé :

1. Accédez à Paramètres () > site de la base de connaissances > Personnaliser le site > CSS et JavaScript personnalisés dans le portail de la base de connaissances.

2. Examinez toutes les règles de police appliquées à différentes classes. Dans certains cas, les changements de police peuvent involontairement s’appliquer à des classes plus larges, affectant les icônes.

3. Assurez-vous que les changements de police ne concernent que les classes spécifiques qui les exigent. Cela aidera à préserver les paramètres par défaut de Font Awesome et à éviter tout impact involontaire sur les icônes.

La page ne répond pas lors de la correction d’un article

Erreur : La page ne fonctionne pas. example.com Je t’ai redirigé trop de fois. ERR_TOO_MANY_REDIRECTS.

Lors de la modification d’un article, la page peut devenir non réactive ou afficher des erreurs liées aux redirections. Parmi les causes courantes, on trouve :

• Un cache navigateur obsolète interférant avec le chargement des pages

• Un article de grande taille avec trop d’images, de tableaux ou de contenu long

• Balises HTML de fermeture incorrectes ou manquantes (surtout dans Markdown)

• Redirections excessives dues à une configuration incorrecte de l’article

• Problèmes liés à la plateforme affectant tous les articles, pas seulement un spécifique

Étapes à résoudre :

• Vide le cache, recharge le navigateur et vérifie si le problème persiste. Un cache corrompu ou obsolète peut interférer avec le fonctionnement de la page.

• Utilisez une fenêtre privée/incognito. Cela permet d’écarter les problèmes liés au cache et aux cookies.

• Identifiez l’ampleur du problème. Vérifiez si le problème concerne tous les articles ou seulement un spécifique.

  Si tous les articles sont affectés :

  • Générez un fichier HAR et envoyez-le à support@document360.com pour analyse.

  • Allez dans () > Knowledge base portal > Général et activez le bouton d’accès au Support pour que l’équipe de support puisse enquêter.

  Si un article spécifique est affecté :

  • Les articles volumineux peuvent causer des problèmes de performance. Envisagez de diviser le contenu en articles plus petits et de les organiser selon les catégories appropriées.

  • Assurez-vous que toutes les balises HTML de l’article ont des balises de fermeture correspondantes (par exemple, <table>, <div>, <p>), en particulier au format Markdown.

• Si le problème persiste, contactez support@document360.com avec les détails suivants :

  • Une capture d’écran du problème

  • Le fichier HAR pour l’analyse

  • L’accès au support est activé dans votre projet

Chargement du site de la base de connaissances sans style CSS

Ce problème survient généralement lorsque le site est accessible depuis un réseau où les domaines Document360 sont bloqués ou non listés par votre entreprise ou organisation.

Étapes à résoudre :

1. Vérifiez si le site fonctionne correctement lorsqu’il est accessible depuis un autre réseau. Si c’est le cas, le problème est probablement lié aux restrictions réseau.

2. Pour résoudre ce problème, mettez en liste blanche les domaines suivants dans vos paramètres réseau afin d’assurer un accès et une fonctionnalité appropriés.

Les photos de profil des utilisateurs/lecteurs sont cassées

Les photos de profil des utilisateurs ou des lecteurs peuvent sembler défaillantes sur le site de la base de connaissances. Ce problème survient lorsque le type de contenu de l’image est mal identifié, empêchant ainsi le chargement correct.

Étapes à résoudre :

1. Ouvrez n’importe quel article sur le site de la base de connaissances et vérifiez si la photo de profil du contributeur semble défectueuse.

2. Faites un clic droit dans l’onglet du navigateur, cliquez sur Inspecter, puis allez dans l’onglet Réseau dans le panneau Devtools .

3. Localisez la requête qui charge l’image de profil et vérifiez le type de contenu :

   • Si c’est « texte/plain », l’image ne se chargera pas correctement.

   • Si c’est « image/jpeg », « application/octet-stream » ou un autre format valide, l’image devrait bien se charger.

   

4. Essayez de retélécharger la photo de profil :

   • Accédez à votre projet dans le portail de la base de connaissances.

   • Cliquez sur votre icône de profil en haut à droite.

   • Sélectionnez Mon profil dans le menu déroulant.

   • Dans le panneau Mon profil , cliquez sur Modifier puis sur l’icône Modifier () près de la photo de profil.

   • Téléchargez l’image de profil que vous souhaitez.

   

5. Si le problème persiste, générez un fichier HAR et soumettez un ticket de support à support@document360.io pour enquête approfondie.

Problème lors de la soumission de retours sur un article

Les causes possibles de ce problème sont des restrictions de sécurité du contenu, des problèmes réseau ou de pare-feu, des extensions de navigateur, des conflits de mise en cache ou des soucis temporaires de serveur. Ces facteurs peuvent bloquer la soumission de retours ou empêcher des actions comme aimer, refuser ou commenter un article.

Étapes à résoudre :

1. Vérifiez si vous pouvez aimer ou ne pas aimer l’article.

2. Assurez-vous de pouvoir saisir des commentaires dans la section de texte des retours.

3. Essayez de cliquer sur le bouton Soumettre pour voir si le retour est enregistré.

4. Déterminez si le problème concerne un seul article ou tous les articles.
   

   Vérifiez les erreurs :

5. Ouvrez la console développeur du navigateur (Clic droit > Inspecter >onglet Console).

6. Recherchez toute erreur de la console liée à la politique de sécurité du contenu (CSP).

7. Capturez une capture d’écran du message d’erreur.

8. Ouvre l’onglet Réseau dans les outils développeurs du navigateur.

9. Reproduisez le problème et exportez le journal réseau sous forme de fichier HAR.

10. Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360

11. Fournissez les détails suivants :

    • Captures d’écran d’erreur de la console

    • HAR avec journaux réseau

    • Enregistrement à l’écran du problème

Adaptation du code personnalisé pour le modèle Single Page Application (SPA) dans Document360

Avec la transition du site Document360 vers un modèle d’application à page unique (SPA), tout JavaScript personnalisé dépendant des événements de rafraîchissement de page pourrait ne plus fonctionner comme prévu. Cela s’explique par le fait que les SPA actualisent uniquement le contenu de l’article, et non toute la page.

Voici les zones où les utilisateurs peuvent injecter du JavaScript personnalisé dans le portail Document360 :

1. JavaScript personnalisé

   1. Naviguez dans () dans la barre de navigation de gauche du portail de la base de connaissances.

   2. Dans le panneau de navigation de gauche, allez au Knowledge base site > Site customization > Custom CSS & JavaScript.

2. Intégrations HTML personnalisées

   1. Naviguez dans Connections Connexions () dans la barre de navigation de gauche et sélectionnez Intégrations.

   2. Sélectionnez HTML personnalisé dans le menu déroulant en haut à gauche.

Solution recommandée

Pour garantir la compatibilité avec le modèle SPA, mettez à jour votre JavaScript personnalisé pour utiliser l’événement articleload . Cet événement se déclenche lorsque le contenu de l’article se rafraîchit à jour, garantissant que vos scripts fonctionnent parfaitement dans la nouvelle architecture.

1. Remplacez tout code qui dépend des événements de mise à jour de page par un abonnement à l’événement articleload .

2. Utilisez l’extrait de code suivant pour adapter vos scripts personnalisés :

   panel.addEventListener('articleload', function() {
     // Your custom JavaScript code here
   });

3. Testez vos scripts mis à jour pour vous assurer qu’ils fonctionnent correctement dans l’environnement SPA.

   Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360