Ce guide vous explique comment configurer et paramétrer le plugin Knowledge Base.
Installation
Pour installer Heroic Knowledge Base, vous aurez besoin d'une installation WordPress auto-hébergée de la version 5.8 ou supérieure. Vous pouvez installer le plugin de plusieurs manières :
- Depuis un fichier Zip : Dans le panneau d'administration WordPress, naviguez vers Plugins > Ajouter un nouveau, sélectionnez « Téléverser » et recherchez le fichier plugin zippé, puis cliquez sur installer maintenant.
- Téléversement FTP : À l'aide de votre programme FTP, téléversez le dossier plugin non zippé dans le dossier /wp-content/plugins/ de votre installation WordPress.
Une fois le plugin installé, vous devez l'activer. Cliquez sur Activer ou allez dans Extensions > Extensions installées et activez Heroic Knowledge Base.
Assistant de configuration
Après l'activation du plugin, vous serez automatiquement redirigé vers l'écran de l'assistant de configuration de Heroic Knowledge Base, qui vous guidera tout au long du processus d'activation et de configuration.
Activer le support et les mises à jour
Entrez votre clé de licence (trouvée dans l'onglet Licences de votre compte HeroThemes ou dans l'e-mail d'achat) pour activer le support, les mises à jour et les fonctionnalités intelligentes, y compris les rapports par e-mail et l'assistant d'aide.
À l'étape suivante, vous verrez un message confirmant que le site a été activé avec succès. Si vous ne parvenez pas à activer le site, vous pouvez continuer la configuration, mais le support, les mises à jour automatiques et les fonctionnalités intelligentes risquent de ne pas fonctionner correctement tant que cela n'est pas fait. Vous pouvez entrer/mettre à jour votre licence à tout moment depuis l'écran Knowledge Base > Paramètres, dans l'onglet Licences et mises à jour. Vous pouvez gérer les sites actifs depuis votre compte HeroThemes à tout moment.
Installation du contenu d'exemple et des extensions requises
La section de configuration vous permet d'installer du contenu de démonstration, y compris un certain nombre d'articles, de catégories et d'étiquettes, qui peuvent être utilisés pour tester la mise en page de la base de connaissances et donnent un excellent exemple de la façon dont la base de connaissances peut être structurée et étiquetée. Notez qu'il n'y a pas de bouton de désinstallation de démonstration, mais vous pouvez supprimer et modifier tous les articles, catégories et étiquettes après l'installation de l'échantillon. Pour installer le contenu de l'échantillon, sélectionnez Installer le contenu de l'échantillon, cela ne prend que quelques instants et crée et configure automatiquement une base de connaissances d'échantillon.
Depuis l'écran de configuration, les plugins requis et facultatifs peuvent être installés. Les options disponibles peuvent varier en fonction du niveau acheté. Sélectionnez les plugins que vous souhaitez installer et cliquez sur Installer la sélection pour continuer.
Configuration terminée
Une fois la configuration terminée, un message d'installation terminée s'affichera avec une liste des bases pour vous aider à démarrer avec Heroic Knowledge Base sur votre site.
Activation des mises à jour automatiques et du support
Afin de recevoir les mises à jour automatiques et le support premium, assurez-vous de saisir votre clé de licence lors de la configuration ou dans l'onglet Licence et mises à jour de la page des paramètres. Cela aidera à maintenir le bon fonctionnement de votre base de connaissances et à accéder rapidement au support en cas de besoin. La section support contient également un lien rapide vers cette documentation.
Ceci n'est pas requis si la base de connaissances est incluse dans votre thème.
L'assistant de configuration peut être consulté à nouveau à tout moment depuis la page Plugins > Installer des plugins en sélectionnant Assistant de configuration
Création et utilisation d'articles de base de connaissances
Il y aura maintenant un nouveau menu Base de connaissances dans le panneau d'administration de WordPress.
À partir de là, vous pouvez gérer les articles existants, créer de nouveaux articles et contrôler les catégories et les étiquettes de la base de connaissances. Les articles sont les composants de votre base de connaissances. Ils fonctionnent un peu comme tous les autres articles, mais ont leur propre archive, leurs propres catégories et leurs propres étiquettes.
Sélectionnez Ajouter un nouvel article pour créer un nouvel article de la base de connaissances Héroïque.
À partir de cette page, vous pouvez tout contrôler concernant votre article :
- Titre – Le titre de l'article
- Contenu – Le contenu principal de l'article
- Options – Ajouter des pièces jointes et autoriser le vote
- Format – Le format de l'article (peut être utilisé par le thème)
- Catégories – Catégories personnalisées de la base de connaissances sous lesquelles l'article sera classé.
- Étiquettes – Étiquettes personnalisées de la base de connaissances à associer à l'article.
La base de connaissances ajoute plusieurs autres métaboîtes, pour ajouter des fonctionnalités à vos articles.
Options de l'article
Des pièces jointes peuvent être ajoutées à un article ici. Sélectionnez Ajouter ou télécharger un fichier pour choisir les pièces jointes à ajouter à l'article.
Remarque : Le nombre de vues de l'article est calculé à partir des visites de page et ne peut être modifié que dans la base de données.
Options de vote
Désactiver le vote sur l'article individuel.
L'utilité est déterminée par les votes ; le réglage manuel de l'utilité dans cette boîte peut entraîner des incohérences dans le calcul de l'utilité.
Votes et commentaires
Cette section affiche les votes et les commentaires pour cet article. Vous pouvez rechercher des commentaires et trier par notes, utilisateurs, etc.
Supprimer les votes individuels en sélectionnant l'option correspondante à côté du vote.
Supprimer tous les votes en sélectionnant le bouton en bas de la section.
L'utilité de l'article peut être recalculée à partir des votes en utilisant le bouton Recalculer l'utilité (note) en bas de la section. Ceci est utile lorsque la note d'utilité n'est plus synchronisée avec les votes.
Recherche d'articles en direct
La base de connaissances offre une fonctionnalité de recherche en direct, les utilisateurs peuvent rechercher les articles de la base de connaissances. Les options de recherche en direct peuvent être contrôlées depuis Heroic KB > Paramètres > Recherche. Vous pouvez en savoir plus sur la fonctionnalité de recherche dans WordPress, ses limitations et ses améliorations dans notre guide sur la recherche WordPress.
Paramètres
Le menu des paramètres de Heroic KB > Paramètres vous permet de contrôler diverses options pour l'ensemble de la base de connaissances. Celles-ci sont divisées en plusieurs sections – y compris les Paramètres généraux, les Options d'archive, les Options d'article, les Options de recherche, qui peuvent être vues sur la gauche du panneau des paramètres.
Ces paramètres peuvent ne pas être visibles ou configurables, en fonction des fonctionnalités prises en charge par votre thème actif. Alternativement, ils peuvent être définis comme options du thème ou remplacés par le thème. Si un paramètre n'apparaît pas, cela signifie que le thème actuel ne prend en charge aucun paramètre configurable par l'utilisateur pour cet élément
Accueil & Paramètres généraux
Les paramètres généraux contrôlent un certain nombre d'options relatives à la façon dont la base de connaissances est affichée, telles que l'ordre de tri et le nombre d'articles à afficher dans les catégories et les tags.
Les paramètres Accueil et Général ne sont applicables qu'en mode de mise en page hérité
Options des catégories & Tags
Cette page d'options contrôle les paramètres des catégories et des tags de la base de connaissances.
Les paramètres Catégories et Étiquettes ne sont applicables qu'en mode de mise en page hérité
Options de l'article
La page d'options des articles contrôle les paramètres des articles individuels de la base de connaissances, tels que les options de méta et de commentaires. Notez que les options de commentaires peuvent également être contrôlées individuellement à partir de l'écran de modification de l'article et sur l'ensemble du site à partir des options de discussion de WordPress.
Les paramètres Article ne sont applicables qu'en mode de mise en page hérité
Options de recherche
La page des options de recherche contrôle les paramètres liés à la fonctionnalité de recherche de la base de connaissances. Vous pouvez en savoir plus sur la fonctionnalité de recherche de WordPress qui alimente la recherche de la base de connaissances, y compris comment l'étendre, dans notre article couvrant la recherche dans WordPress ici.
Les paramètres de recherche ne sont applicables qu'en mode de mise en page hérité
Paramètres des slugs
À partir de cet écran, vous pouvez définir les slugs pour la base de connaissances
La base de connaissances vous permet de définir des slugs personnalisés pour les articles, catégories et tags de la base de connaissances Heroic. Ceux-ci peuvent être contrôlés depuis Base de connaissances > Paramètres > Slugs. Lors de la mise à jour des slugs, vous devrez peut-être « vider » vos permaliens en visitant Paramètres > Permaliens, cela force WordPress à mettre à jour les slugs pertinents.
Le slug de la page d'accueil de la base de connaissances peut être contrôlé en modifiant cette page, voir l'onglet Accueil & Général pour un lien rapide vers l'écran de modification de la page d'accueil de la base de connaissances.
Barres latérales
Utilisez les paramètres de la barre latérale pour contrôler l'apparence des barres latérales dans la section de la base de connaissances. Vous pouvez ajouter des widgets aux barres latérales depuis Apparence > Widgets.
Les barres latérales ne sont applicables qu'en mode de mise en page hérité
Apparence
L'onglet apparence contrôle l'apparence générale de la base de connaissances. Selon votre thème, la plupart des contrôles de style seront généralement contrôlés par l'éditeur de modèles de WordPress.
Gestion des modèles de la base de connaissances
La gestion des modèles peut être effectuée dans les thèmes plus récents via le lien Apparence > Éditeur > Modèles, ou en cliquant sur Modifier le site sur n'importe quelle page dont vous souhaitez modifier le modèle.
Styles personnalisés
Cette page contrôle les styles généraux de la base de connaissances. Si vous souhaitez contrôler davantage les styles au-delà des options disponibles, vous devrez modifier votre thème.
Les styles personnalisés ne sont applicables qu'en mode de mise en page hérité
Commentaires sur les articles
Cette section vous permet de contrôler les commentaires, que vous pouvez utiliser pour obtenir des informations de la part des lecteurs afin d'apporter des ajustements et d'améliorer les articles. Tous les commentaires d'un article peuvent être consultés sur l'écran Modifier l'article.
Transferts
Offrez aux clients un moyen d'accéder rapidement à votre système de support grâce à la fonctionnalité de transferts. Plus de détails ci-dessous.
Licence et mises à jour
Pour activer les mises à jour automatiques et accéder au support premium, saisissez votre clé de licence sur cette page.
Notez que certains thèmes gèrent la licence et les mises à jour du plugin Base de connaissances et ne nécessiteront pas de saisie sur cette page.
Assistant d'aide
L'Assistant d'aide (anciennement appelé Intégration) est une fonctionnalité qui vous permet d'ajouter votre base de connaissances n'importe où sur le site WordPress actuel ou sur tout autre site (le site externe n'a pas besoin d'être WordPress), la base de connaissances sera affichée dans une petite barre en bas à droite du site.
Les paramètres d'intégration peuvent être contrôlés depuis Base de connaissances > Paramètres > Assistant d'aide. L'Assistant d'aide nécessite que votre site soit activé.
Notez que la fonctionnalité d'intégration nécessite que les articles soient publics, tout contenu caché ou restreint ne sera pas affiché correctement.
Rapports par e-mail
Les Rapports par e-mail sont des résumés hebdomadaires de votre base de connaissances envoyés directement aux adresses e-mail que vous spécifiez. Les rapports incluent le nombre d'examens hebdomadaires et la moyenne des commentaires / notes des articles. Les articles les plus consultés et les mieux notés sont également listés. Pour recevoir des rapports par e-mail, votre site doit être actif.
Les paramètres des rapports par e-mail sont contenus dans Base de connaissances > Paramètres > Rapports par e-mail.
Séparez plusieurs destinataires pour le rapport avec une virgule. Activez les rapports HTML pour une meilleure lisibilité.
Comme les rapports par e-mail dépendent de la capacité de votre site à envoyer et à délivrer des e-mails, vous devez vous assurer que votre site est actif.
Widgets de la base de connaissances
Heroic Knowledge Base est livré avec six widgets pour afficher des informations de la base de connaissances :
- Articles – Articles de la base de connaissances
- Auteurs – Auteurs de la base de connaissances
- Catégories – Catégories de la base de connaissances
- Recherche – Rechercher dans la base de connaissances depuis n'importe quelle page
- Table des matières – Afficher une table des matières. Ne fonctionne que sur les articles de la base de connaissances.
- Point de sortie – Capturer les visiteurs qui quittent votre base de connaissances vers un système interne/externe (voir la section ci-dessous)
Les widgets peuvent être activés depuis Apparence > Widgets et en les faisant glisser vers une zone de widget active, ce qui vous permet d'afficher des informations clés de la base de connaissances sur votre site.
Zones de widgets de la base de connaissances
Il existe des zones de widgets, indépendantes du thème, contrôlées par la base de connaissances :
- Barre latérale de la base de connaissances (Accueil) – pour la page d'accueil de la base de connaissances
- Barre latérale de la base de connaissances (Catégories et Étiquettes) – affichée dans les catégories et les étiquettes de la base de connaissances
- Barre latérale de la base de connaissances (Article) – affichée dans les articles de la base de connaissances
La manière dont ceux-ci sont affichés peut être contrôlée dans les options de la barre latérale de la base de connaissances, détaillées dans la section ci-dessus.
Transferts
Le cas d'utilisation le plus courant pour la base de connaissances est un portail pour dévier ou aider les demandes de support ou les requêtes de vente. Lorsqu'un visiteur accède à la base de connaissances mais qu'il crée ensuite un ticket de support ou remplit un formulaire de contact (ou accède à toute autre page dédiée), cela peut être suivi comme un transfert. Cela fonctionne pour les liens internes et externes. Il vous suffit de vous assurer que le widget de transfert est activé.
Ajouter le widget de transfert
Depuis Apparence > Widgets, sélectionnez le widget Point de sortie de la base de connaissances et faites-le glisser vers une zone de widget appropriée.
Une page et un widget factices seront automatiquement créés lors de la première installation du plugin.
Vous pouvez définir d'autres options telles que le titre, le texte et le texte du bouton.
Définir l'URL de la page de transfert
La page de transfert peut être définie à partir de l'URL du lien du widget ou depuis Paramètres > Options de transfert > URL de transfert par défaut. Il s'agit de la page vers laquelle vous souhaitez diriger les visiteurs s'ils ne trouvent pas de réponse à leur requête dans la base de connaissances.
Lorsqu'un utilisateur clique sur le lien de ce widget, l'emplacement de la base de connaissances source est enregistré et peut être analysé avec le module d'analyse (voir ci-dessous).
Analyses
La documentation sur l'analyse de la base de connaissances Heroic se trouve ici.
Conseils supplémentaires
Lien vers la base de connaissances
Vous pouvez lier n'importe lequel des articles de la base de connaissances comme n'importe quel autre article. Pour ajouter la base de connaissances à un menu, allez dans Apparence > Menus et ajoutez la page définie comme page d'accueil de votre base de connaissances.
Utiliser la base de connaissances comme page d'accueil
Pour utiliser la base de connaissances comme page d'accueil, définissez la Page d'accueil sur la page d'accueil de votre base de connaissances dans Paramètres > Lecture.
Vote et commentaires
Les visiteurs de la base de connaissances peuvent voter pour les articles. Lorsqu'un utilisateur vote positivement ou négativement, il peut ajouter des commentaires à un article, qui peuvent être consultés depuis l'écran « modifier l'article ». Les meilleurs articles et contributeurs reçoivent des badges, en fonction du support du thème.
Utiliser les articles dans les articles ou les pages
Les articles, catégories et tags de la base de connaissances sont autonomes, et vous pouvez les lier depuis n'importe quelle autre page ou article. La page d'archive des articles liste tous les autres articles et catégories par exemple www.example.com/articles.
Styliser la base de connaissances
Vous pouvez utiliser le fichier style.css de votre thème (ou de préférence un thème enfant) pour contrôler la plupart des aspects de la stylisation de la base de connaissances.
Catégories de la base de connaissances Heroic
Avec la base de connaissances Heroic, vous pouvez créer, modifier et contrôler des catégories personnalisées pour vos articles de base de connaissances.
Les catégories de la base de connaissances peuvent être créées de deux manières :
1. Depuis Base de connaissances > Catégories d'articles.
2. Depuis une page d'ajout/modification d'article, sous la catégorie de la base de connaissances.
Dans les thèmes compatibles, les images et les couleurs des catégories peuvent être contrôlées depuis la page Modifier la catégorie de la base de connaissances. Ces options apparaîtront si elles sont disponibles.
Contrôler l'ordre des articles
L'ordre des articles dans les catégories de la base de connaissances peut être défini en allant sur votre Tableau de bord WordPress > Heroic KB > Paramètres > Général. Faites défiler jusqu'à la section Catégories & Tags, où l'ordre des articles peut être géré à l'aide des options Trier par et Ordre de tri.
L'ordre des articles peut également être défini manuellement lorsque le paramètre Trier par dans les Paramètres généraux est défini sur Personnalisé. L'ordre des articles peut ensuite être défini à partir du menu Base de connaissances > Ordre des articles.
Sélectionnez simplement la catégorie que vous souhaitez réorganiser. Vous pouvez ensuite faire glisser et déposer les articles de cette catégorie pour les réorganiser. Cliquez sur Enregistrer l'ordre en bas de la page pour sauvegarder l'ordre des articles.
Contrôler l'ordre des catégories
L'ordre des catégories de la base de connaissances peut être contrôlé depuis la page Base de connaissances > Ordre des catégories d'articles. Faites glisser et déposez les catégories pour les réorganiser et modifier leur ordre d'affichage sur votre site. Cliquez sur Enregistrer l'ordre en bas de la page pour sauvegarder l'ordre des catégories.
Les options de catégorie parente et d'imbrication peuvent être contrôlées depuis la page Modifier la catégorie dans Base de connaissances > Catégories d'articles.
F.A.Q. et Support
Pour les clients ayant un site actif, vous pouvez contacter l'équipe de support sur le support HeroThemes.
Comment réinitialiser les votes d'un article ?
Les votes pour un article individuel peuvent être réinitialisés en modifiant un article et en cochant la case « Supprimer tous les votes », située dans la section « Votes et commentaires ». Mettez ensuite simplement à jour l'article et tous les votes seront supprimés.
Comment protéger les articles par mot de passe ?
Les articles individuels peuvent être protégés par mot de passe de la même manière que les autres articles et pages WordPress. Consultez Utiliser la protection par mot de passe sur le Codex WordPress pour plus de détails.
Comment intégrer le plugin de base de connaissances à mon thème ?
Veuillez consulter notre guide séparé Intégrer Heroic Knowledge Base à votre thème pour des instructions détaillées sur l'intégration de Heroic Knowledge Base avec les thèmes (achat de Heroic Knowledge Base autonome uniquement).
J'obtiens une erreur 404 en accédant aux pages de la base de connaissances ?
La cause la plus fréquente est que les permaliens n'ont pas été actualisés. Pour forcer cela, visitez simplement la page des paramètres des Permaliens dans Paramètres > Permaliens et cliquez sur enregistrer dans votre tableau de bord WordPress, puis réessayez. Il est recommandé pour la plupart des thèmes que les Permaliens ne soient pas définis sur la valeur par défaut. Pour plus de détails, consultez cet article pour obtenir des conseils sur l'utilisation des Permaliens.