Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Le portail de services pour les développeurs vous permet de créer des blogs et des forums organisés en fils de discussion:
- Les blogs permettent aux utilisateurs de créer, modifier et supprimer des articles de blog. En outre, les autorisations basées sur les rôles vous permettent de limiter les actions de blog à des types d'utilisateurs spécifiques.
- Les forums permettent aux utilisateurs de créer des fils de discussion avec modération basée sur les rôles. Vous pouvez ajouter des forums au portail, les regrouper dans une hiérarchie et configurer des rôles utilisateur pour contrôler l'accès aux forums.
Utilisation des blogs
Le portail permet aux utilisateurs disposant des droits nécessaires de créer, modifier et supprimer des articles de blog. Les blogs sont composés d'articles individuels, horodatés et consultés par date. Tous les utilisateurs, y compris les utilisateurs anonymes, peuvent consulter les articles de blog les plus récents à l'aide du lien de navigation fourni sur la page d'accueil du portail.
Tout utilisateur disposant des droits nécessaires peut ajouter un commentaire à un article de blog. Les commentaires peuvent s'afficher dès qu'ils sont saisis. Vous pouvez également configurer le portail des développeurs de sorte que les commentaires soient modérés avant d'apparaître. Par défaut, les utilisateurs anonymes ne peuvent pas publier de commentaires.
À propos des types de blogs
Le portail accepte deux types de blogs selon la version du portail que vous utilisez:
- Le blog standard tel qu'il est mis en œuvre par le module du blog Drupal est utilisé par défaut par les versions du portail antérieures à la version 14.02.156.1.
- Le blog personnalisé Apigee avec une vue personnalisée des articles, la prise en charge des types de contenus image, audio et vidéo, et une barre d'outils d'édition de type tumblr mise en œuvre par les modules Apigee Drupal personnalisés. Les versions 14.02.156.1 et ultérieures du portail utilisent le blog personnalisé Apigee par défaut. Les portails existants peuvent être mis à niveau pour utiliser le nouveau blog dans le cadre de la mise à niveau vers la version 14.02.156.1.
Le blog personnalisé est défini par trois modules Drupal personnalisés fournis par Apigee. Le tableau suivant décrit ces modules:
| Module | Définition |
|---|---|
| Blog DevConnect | Définit les fonctionnalités de base du blog. |
| Menu de création de contenu Devconnct | Définit le menu qui vous permet de créer différents types de contenus pour les blogs. |
| Types de contenu de blog devconnect | Définit les types de contenu Drupal spéciaux pour le blog: image, audio et vidéo. Sans ce module, vous ne pouvez créer que des entrées de blog de type article. |
Déterminer la version de portail et les types de blogs compatibles:
Vous pouvez découvrir la version du portail à l'aide de la commande cURL suivante:
$ curl <portal url>/buildInfo
Si vous voulez utiliser le blog personnalisé, assurez-vous que vous utilisez la version 14.02.156.1 ou une version ultérieure.
Mise à niveau d'un portail existant pour utiliser les modules de blogs personnalisés Apigee:
- Assurez-vous que votre portail a été mis à niveau vers la version 14.02.156.1 ou ultérieure.
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Modules dans le menu Drupal.
- Désactivez le module Blog.
- Activez les trois modules personnalisés Apigee suivants :
- Blog Devconnect
- Devconnct Menu de création de contenu
- types de contenu de blog Devconnect
- Enregistrez la configuration.
Consulter un blog
Le portail des développeurs affiche les derniers articles de blog sur la page "Blog". Les articles du blog sont affichés par ordre décroissant de date de création. Pour afficher la page "Blog", sélectionnez "Blog" dans le menu principal du portail pour les développeurs.
De plus, le portail des développeurs est initialement configuré pour afficher les articles de blog récents sur la page d'accueil. Les entrées sont également affichées dans l'ordre décroissant, en fonction de l'heure de création.
Définir des autorisations pour le blog
En tant qu'administrateur, vous contrôlez les autorisations requises pour effectuer des actions sur le blog, comme créer, modifier et supprimer des articles.
Vous allez également configurer les autorisations requises pour publier, modifier et supprimer des commentaires de blog, et déterminer si les commentaires d'un utilisateur doivent être modérés. Les commentaires qui n'ont pas besoin d'être modérés apparaissent immédiatement. Si un commentaire doit être modéré, un utilisateur du portail disposant de l'autorisation nécessaire pour le modérer doit l'approuver.
Pour définir les autorisations du blog:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Contacts dans le menu Drupal.
- Sélectionnez le lien Autorisations en haut de la page "Participants".
- Faites défiler la page jusqu'à la zone Commentaire.
- Dans la zone Comment (Commentaire), définissez les autorisations suivantes pour contrôler quels utilisateurs peuvent ajouter, afficher, modifier et approuver des commentaires :
- Administrer les commentaires et les paramètres des commentaires
- Afficher les commentaires
- Commentaires sur le post
- Ignorer l'approbation des commentaires
- Modifier ses propres commentaires
- Faites défiler la page jusqu'à la zone Nœud.
- Dans la zone Nœud, définissez cinq autorisations différentes qui déterminent quels utilisateurs peuvent ajouter, modifier et supprimer des articles de blog :
- Article du blog: Créer un contenu
- Article de blog: Modifier votre propre contenu
- Article du blog: modifier le contenu
- Article de blog: Supprimer son propre contenu
- Article de blog: Supprimer tout contenu
- Enregistrez votre configuration.
Ajouter un article de blog
Tous les utilisateurs disposant des autorisations nécessaires peuvent créer un article de blog. Vous pouvez toutefois configurer les rôles utilisateur de sorte qu'un utilisateur puisse ajouter et modifier son propre article de blog, mais pas le supprimer. Ils peuvent également ajouter, modifier ou supprimer leurs propres articles, mais pas modifier les articles publiés par les autres utilisateurs.
Si votre version du portail utilise le module de blog Drupal, le bouton suivant s'affiche pour vous permettre de créer une entrée de blog:
La page de modification du blog par défaut s'affiche:
Si vous utilisez le blog personnalisé Apigee et que vous avez activé la prise en charge de tous les types de contenu de blog, le menu suivant s'affiche pour vous permettre de créer des entrées de blog de différents types:
Sélectionnez le bouton correspondant au type de contenu pour créer l'entrée de blog. Selon le type de contenu sélectionné, l'éditeur suivant apparaît:
Les boutons en bas à droite vous permettent d'ajouter du contenu défini par le projet Bootstrap, y compris un carrousel, un carrousel, une fonctionnalité de sélection, un appareil de jumbotron et un triple pli.
La zone inférieure vous permet d'ajouter les contenus multimédias associés. Par exemple, dans la figure ci-dessus, pour le type de contenu vidéo, vous pouvez ajouter une vidéo à l'article de blog.
Pour ajouter un article de blog:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Blog dans le menu de navigation du portail des développeurs.
- Sélectionnez Créer un nouvel entrée de blog (module Blog Drupal) ou le type de contenu (blog personnalisé Apigee).
- Ajoutez du contenu dans les sections Titre et Corps.
- Le cas échéant, cliquez sur Modifier le résumé pour en ajouter un.
- Saisissez une liste de mots clés séparés par une virgule. Ces mots clés sont utilisés pour remplir la vue "Sujets d'actualité" sur la page du blog. Vous pouvez éventuellement ajouter la vue "Sujets d'actualité" à la page d'accueil ou à n'importe quelle autre page.
Selon le type d'article de blog, vous devrez peut-être développer la zone Balises Meta de la page pour saisir des mots clés. - Cliquez sur Enregistrer.
Le blog est publié sur sa page d'accueil et figure sur la page d'accueil de la section "Articles récents".
Lorsque vous créez un article de blog, le module de blog enregistre des informations de base sur son contenu, y compris l'ID de l'auteur, la date de création et le type de contenu.
Modération des commentaires sur le blog
Les utilisateurs du portail des développeurs peuvent publier des commentaires sur les articles du blog. Par défaut, l'utilisateur doit être connecté au portail pour pouvoir publier un commentaire. La capacité d'un utilisateur à afficher, publier, modifier et approuver des commentaires dépend de son rôle et de ses autorisations, comme décrit ci-dessus.
Pour modérer un commentaire:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou d'approbation des commentaires.
- Sélectionnez Contenu > Commentaires dans le menu d'administration de Drupal.
- Sélectionnez le lien Commentaires publiés ou Commentaires non approuvés.
- Utilisez cette page pour modérer les commentaires.
Configurer l'affichage de la page du blog
Le portail des développeurs utilise une vue Drupal, appelée Items tagués as blog content view (Éléments marqués comme vue de contenu de blog), pour contrôler l'affichage des entrées du blog sur la page du blog. Par défaut, les articles de blog sont classés par ordre décroissant de date de création.
Pour configurer l'affichage du blog :
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Vues dans le menu d'administration de Drupal.
- Sélectionnez le lien Modifier sur la ligne de la vue Éléments tagués comme vue de contenu du blog (Contenu). La page suivante s'affiche, que vous pouvez utiliser pour configurer la vue:
- Modifiez la vue.
- Enregistrez les modifications.
Configurer l'affichage du sujet sensible pour les entrées de blog
Le portail des développeurs utilise une vue Drupal, appelée Hot Topics, pour contrôler l'affichage des sujets d'actualité pour les entrées de blog sur la page du blog. Par défaut, les éléments du sujet d'actualité correspondent aux mots clés ajoutés aux articles du blog.
Pour configurer la vue "Sujets d'actualité":
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Vues dans le menu d'administration de Drupal.
- Sélectionnez le lien Edit (Modifier) sur la ligne de la vue Hot Topics (Content) (Sujets d'actualité (contenu). La page qui s'affiche vous permet de configurer la vue.
- Modifiez la vue.
- Enregistrez les modifications.
Utiliser des forums
Les forums permettent aux utilisateurs disposant des droits nécessaires de créer des fils de discussion avec des fonctionnalités semblables à celles des autres systèmes de forums de discussion. Un sujet est contenu dans un forum, et chaque forum peut contenir de nombreux sujets. Les thèmes peuvent également avoir leurs propres URL.
Les utilisateurs publient de nouveaux sujets sur un forum. Chaque sujet du forum est constitué d'un message initial, ainsi que des réponses ou des commentaires. Selon les droits dont dispose l'utilisateur, celui-ci peut modifier et supprimer ses propres posts, ainsi que modifier et supprimer ceux d'autres utilisateurs.
Par défaut, les utilisateurs anonymes peuvent consulter les messages, mais ne peuvent pas publier de réponses. Seuls les utilisateurs authentifiés disposant des droits nécessaires peuvent répondre à un post. Les réponses apparaissent dès qu'elles sont saisies, ce qui signifie qu'elles ne sont pas modérées.
Les administrateurs définissent les autorisations requises pour publier, modifier et supprimer des posts. Les administrateurs peuvent également promouvoir des posts de forum dans la zone "Discussions sur les forums" de la page d'accueil.
Déterminer le module Drupal utilisé par les forums
Le portail utilise deux modules Drupal pour implémenter des forums:
- Le module de forum Drupal est le module principal du forum. Il est utilisé par défaut dans les versions du portail antérieures à la version 14.02.156.1.
- Le module du forum avancé de Drupal améliore le module principal du forum en y ajoutant des fonctionnalités supplémentaires : style amélioré, recherche rapide des sujets actifs, sujets sans réponse, nouveaux sujets, etc. Les versions 14.02.156.1 et ultérieures du portail utilisent par défaut le module de forum Drupal Advance.
Pour déterminer quel module est actif:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Modules dans le menu Drupal.
- Saisissez "forum" dans la liste des filtres en haut de la page "Modules".
- Si le module Forum avancé est répertorié et activé, cela signifie que vous utilisez le module Forum avancé.
- Si le module Advanced Forum est manquant ou désactivé et que le module Forum est activé, vous utilisez le module principal Forum.
Vous pouvez également découvrir la version du portail à l'aide de la commande cURL suivante:
$ curl <portal url>/buildInfo
Configurer le module Advanced Forum
Le module "Forum avancé" comporte des paramètres de configuration qui contrôlent l'affichage des forums, les fils d'Ariane et d'autres caractéristiques visuelles des forums.
Pour configurer le module "Forums avancés" :
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Configuration > Créateur de contenu > Forum avancé dans le menu Drupal. La page Forums avancés s'affiche.
- Définissez les options d'affichage.
- Enregistrez la configuration.
Définir des autorisations pour les forums
En tant qu'administrateur, vous contrôlez les autorisations requises pour effectuer des actions sur les forums. Vous allez définir les autorisations utilisées par le module "Forums et forums avancés" et définir des autorisations spécifiques à chaque module.
Pour définir les autorisations sur un forum:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Contacts dans le menu Drupal.
- Sélectionnez le lien Autorisations en haut de la page "Participants".
- Si vous utilisez le module Forums avancés, faites défiler la page jusqu'à la section Forums avancés et définissez les autorisations associées.
- Si vous utilisez le module Forums, faites défiler la page jusqu'à la section Forums (Forums) et définissez les autorisations associées.
- Faites défiler la page jusqu'à la zone Nœud.
- Dans la zone Nœud, définissez cinq autorisations différentes qui déterminent quels utilisateurs peuvent ajouter, modifier et supprimer des posts sur le forum :
- Sujet du forum: Créer du contenu
- Sujet du forum: modifier vos propres contenus
- Sujet du forum: modifier tout contenu
- Sujet du forum: Supprimer son contenu
- Sujet du forum: Supprimer du contenu
- Enregistrez votre configuration.
Ajouter un forum
Par défaut, le portail des développeurs contient un seul forum appelé "Discussion générale". Vous pouvez ajouter des forums supplémentaires, imbriquer des forums et créer des conteneurs de forum qui sont des groupes de forums.
Un conteneur de forum vous permet de créer un ensemble de forums. Cependant, un conteneur n'est pas un forum en soi. Il définit simplement un ensemble de forums.
Pour ajouter un forum:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Forums (Structure > Forums) dans le menu Drupal pour afficher la liste des forums actuels.
Sur cette page, vous pouvez modifier les forums existants ou modifier leur ordre d'affichage sur la page "Forums". - Sélectionnez + Ajouter un forum.
- Ajoutez des informations sur le nouveau forum, y compris son parent si vous souhaitez l'imbriquer.
- Sélectionnez Enregistrer.
Pour réorganiser les forums:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Forums (Structure > Forums) dans le menu Drupal pour afficher la liste des forums actuels.
- Cliquez sur le signe plus (+) et faites-le glisser devant le nom d'un forum pour modifier son ordre ou son niveau d'imbrication.
- Enregistrez les modifications.
Pour ajouter un conteneur de forum:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Forums (Structure > Forums) dans le menu Drupal pour afficher la liste des forums actuels.
- Sélectionnez + Ajouter un conteneur.
- Ajoutez des informations sur le nouveau conteneur, y compris son parent si vous souhaitez l'imbriquer.
- Sélectionnez Enregistrer.
La page Forums s'ouvre. - Sur la page Forums, cliquez sur le signe plus (+) devant un nom de forum et faites-le glisser pour l'ajouter à votre nouveau conteneur.
- Enregistrez les modifications.
Promouvoir un sujet du forum sur la page d'accueil
La page d'accueil par défaut contient une vue Drupal qui contrôle le contenu de la zone "Discussions de forum" de la page d'accueil. Pour qu'un sujet de forum apparaisse dans la zone "Discussions sur les forums", un administrateur doit le promouvoir.
Pour promouvoir un sujet de forum:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou d'approbation des commentaires.
- Sélectionnez Content (Contenu) dans le menu d'administration de Drupal.
- Filtrez le contenu en sélectionnant Forum topic (Sujet du forum) dans la boîte déroulante Type, puis en sélectionnant Apply (Appliquer).
Seuls les sujets du forum apparaissent dans la liste de contenu. - Sélectionnez un ou plusieurs sujets de forum à promouvoir.
- Dans le menu déroulant Opérations, sélectionnez Promouvoir en première page.
- Sélectionnez Execute (Exécuter).
Tous les sujets sélectionnés apparaissent désormais dans la zone "Discussions du forum" de la page d'accueil.
Vous pouvez également modifier un post sur le forum et sélectionner Promouvoir en première page dans les options de publication du sujet.