Guide d’utilisation

Modules externes

Comment installer et gérer les modules externes (plugins) qui ajoutent des fonctions à l’éditeur, et la page développeur pour créer et publier vos propres modules. Pour utiliser les modules externes dans l’éditeur, consultez l’article « Modules externes de l’éditeur ».

Onglet des modules externes

L’onglet Plug-ins du tableau de bord sert à gérer les modules installés ; les nouveaux se trouvent dans la galerie :

Mes plugins — les modules externes que vous avez installés. Leur nom, leur version, leur développeur et les autorisations qu’ils utilisent s’affichent ; à droite se trouvent un interrupteur d’activation et le bouton Supprimer (corbeille).
Galerie › Extensions — les cartes des modules externes publiés après vérification. On y accède par le lien Parcourir les extensions en haut à droite de l’onglet ou par Galerie dans l’en-tête (consultation sans connexion). Les modules sont tous gratuits pour l’instant, mais leur installation demande une offre payante (Starter ou Pro). Avec l’offre gratuite, le bouton Installer de la fenêtre de détails est grisé et un message sur l’offre s’affiche. Lorsque votre offre prend fin, les modules installés ne sont plus chargés dans l’éditeur ; ils restent dans votre liste et reviennent dès que vous passez à une offre payante. Les cartes déjà installées portent la mention Installé.

Installer un module ne télécharge pas de fichier : le module est associé à votre compte. Les modules installés et activés sont chargés à chaque ouverture de l’éditeur, si bien que vous les retrouvez sur n’importe quel ordinateur où vous vous connectez. Ils n’apparaissent pas aussitôt dans un éditeur déjà ouvert : actualisez l’onglet ou rouvrez la mise en page.

Questions associées

Où installer un plugin ?
Peut-on ajouter des extensions à l’éditeur ?
Les modules externes sont-ils payants ?

Installer un module externe

Dans Galerie › Extensions, cliquez sur une carte. La fenêtre de détails s’ouvre.
Vérifiez Développeur, Version, Éditeur requis, Prix et la liste Ce que ce plugin peut faire.
Cliquez sur Installer. Si le module se connecte à un serveur externe, le bouton s’appelle Accepter et installer (voir « Modules externes qui se connectent à un serveur externe » ci-dessous).
Le module apparaît dans Mes plugins : c’est terminé. Il sera présent la prochaine fois que vous ouvrirez l’éditeur.

Un module qui indique Éditeur requis n’est chargé que par cette version de l’éditeur ou une version plus récente. Si la version d’éditeur choisie pour votre compte est plus ancienne, choisissez-en une plus récente dans Paramètres de la mise en page (section « Version de l’éditeur » de l’article « Tableau de bord »).

Questions associées

J’ai installé un plugin mais il n’est pas dans l’éditeur
Comment installer un module externe ?
Que signifie la version d’éditeur requise ?

Autorisations

Un module externe ne peut faire que ce que permettent les autorisations indiquées dans la fenêtre de détails. Les voici :

Lire la mise en page — lit les pages, les objets et le texte de la mise en page ouverte.
Modifier la mise en page — crée, modifie ou supprime des objets, du texte, des images et des pages. Toutes les modifications peuvent être annulées et sont enregistrées normalement.
Sélection — connaît les objets sélectionnés et modifie la sélection.
Interface — ajoute à l’éditeur des boutons d’outil, des menus, des panneaux et des boîtes de dialogue.
Enregistrer des réglages — enregistre les réglages du module dans votre compte (jusqu’à 64 Ko).
Connexion à un serveur externe — l’adresse du serveur suit le nom de l’autorisation. Le module peut échanger des données avec ce serveur.

Les modules externes s’exécutent dans un espace isolé de l’éditeur (bac à sable). Ils n’ont accès ni à vos identifiants de connexion, ni à vos autres mises en page, ni à l’interface de l’éditeur, et un module sans autorisation de connexion à un serveur externe ne peut pas du tout accéder à Internet. Les panneaux et fenêtres qu’affiche un module sont eux aussi dessinés uniquement dans une fenêtre isolée.

Questions associées

Un plugin peut-il lire mes mises en page comme il veut ?
Que veulent dire les autorisations d’un module ?
Un plugin peut-il récupérer les informations de mon compte ?

Modules externes qui se connectent à un serveur externe

Pour un module disposant d’une autorisation de connexion à un serveur externe (par exemple un module qui remplit la mise en page avec des données d’un service de fiches produits), la fenêtre de détails affiche aussi un avertissement. Sous « Ce plugin peut envoyer le contenu de la mise en page aux serveurs suivants : » figurent l’adresse du serveur et le lien Politique de confidentialité du développeur.

Le module ne peut se connecter qu’aux serveurs indiqués et ne peut rien envoyer à une autre adresse.
Une fois connecté, le contenu de la mise en page peut partir vers ce serveur : lisez l’adresse et la politique de confidentialité, et ne cliquez sur Accepter et installer que si vous leur faites confiance.

Questions associées

L’autorisation de connexion à un serveur externe est-elle dangereuse ?
Le plugin utilise-t-il Internet ?
Que fait le bouton pour accepter et installer ?

Activer, désactiver et supprimer

Si vous désactivez l’interrupteur, le module n’est plus chargé à partir de la prochaine ouverture de l’éditeur. Réactivez-le pour qu’il soit de nouveau chargé.
Cliquez sur Supprimer et confirmez : le module disparaît de Mes plugins. Les objets créés avec ce module restent dans la mise en page et s’affichent et s’impriment tels qu’ils ont été enregistrés (section « Objets de module externe » de l’article « Modules externes de l’éditeur »).
Un module marqué Bloqué par l’administrateur a été bloqué par un administrateur : il ne peut pas être activé et n’est pas chargé dans l’éditeur. Aucune version utilisable signifie qu’aucune version n’est publiée actuellement.

Questions associées

Je veux désactiver un plugin un moment
Que deviennent mes objets si je supprime le module ?
Le module est indiqué comme bloqué par l’administrateur

Mettre à niveau un module externe

Un module installé continue d’utiliser la version que vous avez installée. Quand le développeur publie une nouvelle version et qu’elle passe la vérification, votre module ne change pas tout seul : la nouvelle version n’est utilisée qu’après une mise à niveau.

Quand une nouvelle version sort, un avis avec son numéro apparaît sous ce module dans Mes plugins. Si la nouvelle version utilise plus d’autorisations que l’actuelle, l’avis l’indique. Le menu Modules externes de l’éditeur affiche aussi un élément indiquant qu’une mise à niveau est possible.
Cliquez sur Mettre à niveau : la fenêtre Mettre à niveau le plugin montre la version actuelle, la nouvelle et les nouvelles autorisations.
Cliquez sur Mettre à niveau. La nouvelle version est chargée à partir de la prochaine ouverture de l’éditeur.

Sans mise à niveau, l’éditeur continue de charger la version actuelle. Si cette version est retirée, la version antérieure la plus haute est utilisée ; seulement s’il n’y en a aucune, la nouvelle version la plus proche prend le relais.

Questions associées

Les modules se mettent-ils à jour automatiquement ?
Comment obtenir la nouvelle version d’un module ?
Le module cesse-t-il de fonctionner si je ne fais pas la mise à niveau ?

Page développeur des modules externes

Pour créer et publier vos propres modules externes, allez dans Mon compte, puis sur Développeur en bas du menu de gauche.

Le formulaire Devenir développeur s’affiche d’abord. Saisissez Nom affiché (le nom affiché comme développeur dans la boutique) et Contact (adresse e-mail ou site web), acceptez les conditions développeur, puis cliquez sur Envoyer la demande.
Un administrateur examine la demande et le résultat vous arrive par notification. En cas de refus, vous pouvez corriger et refaire une demande.
Une fois approuvé, la section Premiers pas apparaît sur cette page. Téléchargez le SDK (zip) avec Télécharger le SDK. Il contient les outils, les définitions de types, des exemples et le guide du développeur (README.md) ; Node 18 ou plus récent est requis.
Créez le module sur votre ordinateur et lancez le serveur de développement du SDK, puis ouvrez l’éditeur en ajoutant pluginDev à la fin de son adresse pour tester le module aussitôt (uniquement avec un compte développeur approuvé et sur cet ordinateur (localhost)). Si vous lancez le serveur de développement avec --open, l’éditeur s’ouvre sans connexion sur une nouvelle mise en page de test qui n’enregistre rien sur le serveur (l’éditeur « bac à sable »). Les agents d’IA peuvent y exécuter des commandes et récupérer des images de pages depuis le terminal. Les commandes détaillées figurent dans les étapes de Premiers pas et dans le README.md du SDK.
Une fois terminé, créez le zip avec le SDK et envoyez-le avec Envoyer le zip dans Envoyer une version (5 Mo et 200 fichiers au maximum). La version envoyée reste à l’état Brouillon.
Cliquez sur Demander la vérification dans la liste des versions : un administrateur la vérifie. Pendant la vérification, la version ne peut être ni modifiée ni supprimée. L’approbation ou le refus et la note de vérification arrivent par notification et s’affichent aussi dans la liste des versions.
Une fois approuvé, le module est publié dans Galerie › Extensions. L’interrupteur Afficher dans la boutique détermine s’il apparaît dans la boutique.

Pour corriger un module, augmentez le numéro de version, envoyez-la comme nouvelle version et faites-la vérifier à nouveau. L’API des modules externes, l’autorisation de connexion à un serveur externe et les critères de vérification sont décrits dans le README.md du SDK.

Questions associées

Puis-je créer mon propre plugin ?
Où faire une demande de compte développeur ?
Où télécharger le SDK ?
Comment publier mon module dans la boutique ?