Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Vous pouvez personnaliser l'apparence du portail des services pour les développeurs afin qu'il corresponde au thème de votre entreprise, ajouter de nouvelles zones de contenu au portail ou modifier la mise en page de n'importe quelle page du portail. Une grande partie de cette configuration nécessite des connaissances pratiques de Drupal. Toutefois, cette page décrit certaines tâches de base que vous pouvez effectuer pour personnaliser votre portail.
Personnaliser le titre et le slogan du site
Vous pouvez définir le titre du site, ainsi que son slogan. Sur la page d'accueil, le titre et le slogan apparaissent comme suit:
"Titre | Slogan"
Le titre est obligatoire et est défini sur "Nouveau site Apigee" par défaut. Le slogan n'est pas obligatoire et est vide par défaut.
Pour définir le titre et le slogan:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Configuration > Système > Informations sur le site dans le menu d'administration de Drupal.
- Sur la page "Informations sur le site", définissez le nom du site et éventuellement le slogan.
- Enregistrez la configuration.
Notez qu'en raison de la mise en cache, les modifications apportées à la carte et au slogan peuvent ne pas apparaître immédiatement. Vous pouvez éventuellement vider le cache pour que ces modifications s'affichent. Pour vider le cache, sélectionnez l'icône Drupal tout à gauche du menu d'administration Drupal, puis sélectionnez "Vider tous les caches".
Personnaliser la mise en page de la page d'accueil
La figure suivante montre la mise en page de la page d'accueil:
Drupal fournit un mécanisme étendu pour contrôler l'affichage de cette page. Cette section décrit les éléments de mise en page de la page principale par défaut et comment les modifier. Pour effectuer une refonte complète de la page, consultez la documentation Drupal.
La page d'accueil est divisée en sections:
- Menu principal: contient le logo Apigee, ainsi que les entrées de menu "Blog" et "Forum". La section ci-dessous explique comment configurer le menu principal.
- Message de bienvenue: chaîne située sous le menu principal et commençant par le texte "Bienvenue dans ...". Personnaliser le thème explique comment configurer le message de bienvenue.
- Partie supérieure: zone située sous le menu principal, qui comprend le message de bienvenue, les deux zones avec des liens vers la documentation et le bâtiment avec une clé d'accès, ainsi que la grande icône. Cette zone est définie par un bloc Drupal. Les blocs sont des zones de contenu rectangulaires sur les pages Drupal. Pour configurer la zone supérieure, modifiez le bloc Drupal qui définit le contenu de cette zone, comme décrit ci-dessous.
- Partie inférieure: zone comprenant les sections "Articles de blog récents", "Discussions sur le forum" et "Thèmes d'actualité". Ces trois zones sont implémentées en tant que vues Drupal. Ajouter des articles de blog et de forum explique comment modifier ces vues.
- Pied de page: contient les liens vers les règles de confidentialité, les conditions d'utilisation et les coordonnées. Consultez Modifier les pages de pied de page.
Personnaliser le bloc qui définit la partie supérieure de la page d'accueil
- Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
- Sélectionnez Structure > Blocs dans le menu d'administration de Drupal.
- Sur la page "Blocs", sélectionnez le lien Configurer pour le bloc nommé "En-tête de la page d'accueil".
Le corps du bloc d'en-tête de la page d'accueil est un code HTML qui définit l'apparence de ce bloc. - Modifiez le bloc si nécessaire.
- Sélectionnez Enregistrer le bloc.
- Accédez à votre page d'accueil pour voir les modifications.
Personnaliser le menu principal
Le menu principal s'affiche en haut de chaque page du portail pour les développeurs. Par défaut, il affiche le logo Apigee et deux entrées de menu : "Blog" et "Forum". Vous pouvez modifier le menu principal pour changer de logo et définir vos propres entrées de menu.
Pour modifier le logo:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
-
Si votre thème par défaut est le thème Apigee Responsive:
- Sélectionnez Apparence > Paramètres.
-
Si votre thème par défaut est le thème Apigee DevConnect:
- Sélectionnez Appearance > Settings > Apigee DevConnect Theme (Apparence > Paramètres > Thème Apigee DevConnect).
- Désélectionnez Utiliser le logo par défaut sous "Paramètres de l'image du logo".
La page change pour vous permettre d'accéder à un fichier image et de l'importer. - Sous "Importer une image du logo", sélectionnez le bouton Sélectionner un fichier, puis accédez à votre fichier image.
- Sélectionnez Ouvrir pour importer le fichier.
- Cliquez sur Enregistrer la configuration.
Pour modifier les entrées de menu:
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Structure > Menus > Menu principal dans le menu d'administration de Drupal.
Cette page vous permet d'ajouter, de supprimer et de réorganiser les entrées de menu. - Cliquez sur Ajouter un lien pour ajouter une entrée de menu.
- Ajoutez les informations requises, puis sélectionnez Enregistrer.
- Cliquez sur Enregistrer la configuration sur la page du menu principal.
Renommer la page "Mes applications" en "Mes API"
Par défaut, chaque développeur de portail dispose d'une page intitulée "Mes applications", qu'il utilise pour ajouter, modifier et supprimer des applications et les clés API associées à ces applications. Par exemple, les développeurs peuvent avoir plusieurs applications, modifier des applications pour ajouter ou supprimer des produits d'API, et afficher des informations analytiques sur l'utilisation des applications, le tout depuis la page "Mes applications".
Toutefois, certains fournisseurs d'API souhaitent simplifier l'affichage des informations sur le portail et les interactions des développeurs avec celui-ci. Par exemple, vous pouvez configurer le portail pour qu'il crée une application et une clé API par défaut lorsqu'un développeur s'y inscrit. Cette application peut même être la seule à laquelle le développeur aura accès, et le site ne permet pas à l'utilisateur de la modifier. Pour savoir comment créer une application par défaut, consultez Ajouter et gérer des comptes utilisateur.
Certains sites ne souhaitent pas utiliser le terme "application" du tout. Ces sites font plutôt référence aux API et aux clés API. Dans ce cas, vous configurez le portail pour remplacer le terme "application" par "API", de sorte que les développeurs disposent désormais d'une page intitulée "Mes API". Toutefois, les informations affichées sur la page sont les mêmes que lorsque la page s'appelait "Mes applications", comme illustré ci-dessous:
Ce changement affecte non seulement le titre de la page "Mes API", mais aussi d'autres éléments. Par exemple, dans l'image ci-dessus, notez que le bouton de droite indique désormais "Ajouter une API" et que le texte en dessous fait référence aux API plutôt qu'aux applications.
Pour configurer le portail afin qu'il affiche "Mes API" :
- Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
- Sélectionnez Configuration > Portail de développement > Paramètres de l'application dans le menu d'administration de Drupal.
- Développez la section Application UI Settings (Paramètres de l'interface utilisateur de l'application).
- Cochez la case d'option correspondant au texte que vous souhaitez faire valoir.
- Cliquez sur Enregistrer les modifications.
- Sélectionnez Structure > Menus > Menu principal dans le menu d'administration de Drupal.
- Cliquez sur le lien Modifier de l'entrée Mes applications.
- Modifiez le titre du lien du menu pour qu'il indique Mes API.
- Cliquez sur Enregistrer.
- Cliquez sur Enregistrer la configuration sur la page du menu principal.
Activer le menu d'administration Drupal pour les appareils mobiles
Le menu d'administration Drupal par défaut n'est pas compatible avec les petits écrans des appareils mobiles. Si vous souhaitez administrer votre portail sur un appareil mobile, vous pouvez activer le nouveau menu d'administration compatible avec les appareils mobiles dont la largeur d'écran est d'au moins 767 pixels.
Pour activer le menu d'administration compatible avec les mobiles:
- 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 d'administration de Drupal. La liste de tous les modules Drupal installés s'affiche.
- Téléchargez et installez le module de barre de navigation.
- Si elle est activée, désactivez le module Style de la barre d'outils du menu Administration.
- Cliquez sur Enregistrer la configuration.
- Désactivez le module Menu Administration.
- Activez le module Barre de navigation.
- Cliquez sur Enregistrer la configuration.
Le menu d'administration Drupal compatible avec les appareils mobiles s'affiche.