Flexweg CMS

Activer et configurer les plugins

Cette page parcourt les opérations quotidiennes sur les plugins : activer, désactiver, configurer, et gérer les effets de bord.

Cette page parcourt les opérations quotidiennes sur les plugins : activer, désactiver, configurer, et gérer les effets de bord.

La page Plugins

Ouvrez Plugins dans la sidebar. La page a deux onglets :

Onglet Plugins — toggleables

Liste chaque plugin régulier (intégré et externe). Chaque carte affiche :

  • Nom + version + auteur

  • Description — ce que fait le plugin

  • Badge de statut — Activé (bleu) ou Désactivé (gris)

  • Boutons d'action :

    • Toggle Activer / Désactiver
    • Configurer (uniquement quand le plugin a une page de réglages)
    • Uninstall (uniquement pour les externes)

Onglet Must-use — pas de toggle

Liste les plugins must-use (flexweg-blocks, flexweg-embeds, flexweg-custom-code, flexweg-favicon, flexweg-metrics, flexweg-import). Pas de toggle, mais le bouton Configurer est disponible quand le plugin a une page de réglages.

Activer / désactiver

Cliquer Activer sur un plugin désactivé :

  1. Patch settings.enabledPlugins.push("<id>") en base
  2. applyPluginRegistration se ré-exécute → reset les registries → re-enregistre depuis les plugins activés
  3. Le plugin commence à s'appliquer immédiatement (filtres, actions, blocs, cartes)

L'inverse pour Désactiver. Pas de reload nécessaire.

Attention : désactiver un plugin qui a uploadé des fichiers (sitemaps, RSS, archives, etc.) ne supprime PAS ces fichiers automatiquement. Ils restent sur le site public. Si vous voulez les supprimer aussi, désactivez le plugin PUIS allez dans sa page de réglages et utilisez la fonction de cleanup (typique : un bouton de désactivation ou de cleanup au save).

Configurer

Cliquez Configurer sur un plugin avec page de réglages → ouvre /settings/plugin/<id>. Voir Réglages des plugins pour le pattern UX.

Le bouton Configurer est aussi accessible depuis la sidebar Settings → onglets des plugins.

Le pattern "config survit à la désactivation"

Quand vous désactivez un plugin, son pluginConfigs[<id>] reste en base. Si vous le réactivez plus tard, ses réglages sont restaurés. Donc :

  • Désactivation rapide : safe, juste un toggle ON/OFF, les fichiers générés restent, les réglages restent
  • Désinstallation : juste pour les externes, supprime aussi les fichiers bundle ET le dossier /admin/plugins/<id>/ sur Flexweg. Le config persiste pour une réinstallation future.

Pour purger le config explicitement : éditez settings/site en base, supprimez la clé pluginConfigs.<id>.

Les plugins doivent être notifiés des changements

L'avantage du modèle filter/action : le pipeline notifie le plugin via les hooks lifecycle (publish.complete, post.unpublished, etc.) — donc le plugin peut réagir automatiquement.

Désavantage : si vous changez quelque chose qui n'est PAS notifié par un hook (par exemple, vous changez la baseUrl du site), les fichiers générés par les plugins (sitemaps, RSS, etc.) ne sont pas auto-régénérés. Vous devez cliquer manuellement sur Regenerate site → pour qu'ils soient à jour.

Cas particulier : flexweg-multilang

Activer le plugin multilang fait apparaître :

  • Une page de réglages où vous choisissez les langues activées + la langue primaire
  • Des onglets de langue au-dessus de l'éditeur de post / page
  • Une section de traductions sur chaque ligne de la page Catégories / Tags
  • Une option de SEO par langue dans la modale SEO de chaque terme
  • Des sentinels [data-cms-langswitch] que les thèmes peuvent surface comme switcher

Une fois activé, toutes les pages existantes ne sont pas auto-régénérées — vous devez cliquer Regenerate site → All HTML pour que les hreflang apparaissent sur les pages anciennes.

Cas particulier : flexweg-sitemaps, flexweg-rss, flexweg-archives, flexweg-search

Tous ces plugins ont une cible Force regenerate dans leur page de réglages ET dans le menu Thèmes → Regenerate site. Après chaque changement majeur (toggle d'activation, changement de config significatif), cliquez Force regenerate pour synchroniser les fichiers publics avec la nouvelle config.

Logs et debug

Quand un plugin émet des erreurs, elles apparaissent :

  • Dans la console du navigateur (avec un préfixe [<plugin-id>])
  • Comme toast en cas d'erreur d'upload (via le funnel flexwegApi.ts)
  • Dans le panneau de logs pendant un Force regenerate

Pour débugger plus profondément, ouvrez les Dev Tools → Console → cherchez le nom du plugin.

Ordre des plugins

Les filtres et actions tournent dans l'ordre des priorités (lower first). L'ordre dans lequel les plugins sont activés dans enabledPlugins n'a pas d'impact sur l'ordre des hooks.

Si vous avez besoin qu'un de vos handlers tourne après un autre, donnez-lui une priorité plus haute (numérique) que celle du handler concurrent. Voir Hooks → Priorité.