Extensions & Plugins

Personnalisez et étendez les fonctionnalités de Magix CMS

Un plugin (ou extension) est un module logiciel modulaire qui enrichit le noyau de Magix CMS en lui apportant de nouvelles fonctionnalités adaptées à vos besoins métiers, tout en préservant l’intégrité du code source de base.

Compétences requises pour créer un plugin

Développer et intégrer un plugin dans Magix CMS 4 s'appuie sur des standards modernes du web :

• PHP (8.2+) & POO : architecture MVC, namespaces PSR-4, manipulation de contrôleurs et services.

• SQL & QueryBuilder : conception de schémas de données relationnels et requêtes optimisées.

• Moteur de template Smarty : intégration des vues front/back, exploitation des filtres et dictionnaires de traduction (.conf).

• JavaScript & Composants Web : interactions dynamiques, gestion AJAX (MagixForms, API Fetch) et animations.

• Architecture événementielle (Hooks & Filtres) : connexion aux points d'ancrage du CMS via HookManager.

Les types de plugins dans Magix CMS 4

Dans Magix CMS 4, la nature et le comportement d'un plugin sont définis dans son descripteur manifest.json via la propriété "type". Le système distingue quatre architectures complémentaires :

1. Backend ("type": "backend")

Une extension exclusivement dédiée à l’espace d’administration (Back-Office).

• Rôle : Fournir des outils de gestion, d'analyse, d'automatisation ou de configuration technique sans exposer d'interface publique directe aux visiteurs.

• Comportement : Accessible depuis le panneau d'administration via son propre contrôleur et sécurisé par le système de rôles et permissions RBAC.

• Exemples :

  • Outils de maintenance, de purge du cache ou d'optimisation de base de données.

  • Outil de génération ou d'import/export de données (CSV/Excel).

  • Gestionnaire de configuration système ou de sécurité.

2. Widget ("type": "widget")

Un composant d’interface léger conçu pour s’accrocher dans le flux de vos pages.

• Rôle : Injecter un bloc d'affichage dynamique dans une zone spécifique du site sans disposer de page publique dédiée.

• Comportement : Se greffe automatiquement ou manuellement aux emplacements réservés du thème grâce aux Hooks (displayHomeTop, displaySidebar, etc.) et est administrable depuis le gestionnaire de disposition (Layout).

• Exemples :

  • Carrousel de bannières promotionnelles.

  • Bloc des dernières actualités publiées (MagixLastNews).

  • Widget météo, flux de réseaux sociaux ou bouton flottant d’appel à l'action.

3. Hybride ("type": "hybrid")

Une extension complète et autonome associant interface publique et fonctionnalités transversales.

• Rôle : Déployer une application complète dotée de ses propres routes publiques (URL dédiées), tout en ayant la capacité d'enrichir les modules natifs du CMS (pages, catalogue, actualités).

• Comportement : Déclare des contrôleurs frontend et backend, dispose de ses propres tables et peut injecter des onglets ou des champs dans les formulaires d'édition du Core via les cibles déclarées (core_targets).

• Exemples :

  • Gestionnaire multimédia et de documents privés (MagixFiles).

  • Module d'actualités et d'articles de blog avec pagination et commentaires.

  • Système d'espace membre et d'authentification (Magixaccount).

4. Addon ("type": "addon")

Une extension spécialisée conçue pour se greffer sur un autre plugin parent.

• Rôle : Étendre les fonctionnalités d'un module hôte sans jamais en modifier le code source, garantissant ainsi une indépendance totale et des mises à jour sans rupture.

• Comportement : Cible un plugin spécifique via la clé plugin_targets du manifest.json. Sa liaison et son activation sont gérées dynamiquement dans la table de liaison mc_plugins_module.

• Exemples :

  • Passerelles de paiement externes pour la boutique en ligne (ex: Magixstripe ou PayPal pour Magixcartpay).

  • Modules de transporteurs et de calcul de frais de port (Bpost, Mondial Relay) connectés au panier d'achat.

  • Extensions de règles de tarification ou de facturation automatique.

Pourquoi utiliser des extensions ?

1. Modularité & Propreté : Vous activez uniquement les fonctionnalités nécessaires à votre projet, sans alourdir le noyau de base.

2. Évolutivité sans régression : Grâce au système de hooks, de filtres et d'addons, vos développements personnalisés restent protégés lors des futures mises à jour du CMS.

3. Réutilisabilité : Développez un plugin une seule fois et déployez-le facilement sur plusieurs projets web grâce au système de paquets et d'installation automatisée (manifest.json, scripts SQL d'installation et de désinstallation).