MagixTextBlock est un plugin hybride open source pour Magix CMS 4 qui révolutionne la gestion des contenus libres. Oubliez les contraintes des balises {hook} traditionnelles et des modules en boucle : ce plugin introduit un système de balisage Smarty natif permettant d'injecter des blocs de texte riche multilingues au pixel près, n'importe où dans votre thème.
- Gerits Aurelien (gtraxx) - aurelien@magix-cms.com
- Communauté Magix CMS
Si vous souhaitez soutenir le développement de ce plugin, vous pouvez faire un don via PayPal :
Contrairement aux modules classiques qui affichent des listes ou nécessitent des positions figées, ce plugin a été pensé pour offrir une liberté architecturale totale aux intégrateurs et webmasters.
- Placement Chirurgical (Zéro Hook) : N'utilise aucun hook de positionnement. Vous appelez vos textes directement via une fonction Smarty personnalisée :
{textblock alias="..."}. - Haute Performance (Mise en cache) : Toutes les variables de texte d'une page sont chargées via une seule requête SQL, même si vous affichez 20 blocs différents.
- Multilingue Natif : Gestion transparente des traductions en fonction de la langue active du visiteur.
- Édition Riche : Intégration complète avec TinyMCE (et ses plugins comme MagixMedia) pour un formatage HTML parfait.
- Chargement Contextuel : Les textes sont liés à des contextes (home, news, footer...) pour ne charger en mémoire que ce qui est strictement nécessaire à la page affichée.
- Téléchargez et décompressez l'archive du plugin.
- Placez le dossier
MagixTextBlockdans le répertoireplugins/de votre installation Magix CMS. - Connectez-vous à l'administration de votre site.
- Rendez-vous dans Extensions > Gestionnaire.
- Cliquez sur le bouton d'installation pour MagixTextBlock.
- Accédez à la configuration du plugin via le bouton "Gérer" pour créer votre premier bloc.
L'utilisation se fait en deux étapes très simples :
- Dans le Back-office : Créez un nouveau bloc de texte, assignez-lui un contexte (ex: home) et un alias unique (ex: test_block).
- Dans votre thème (Fichiers
.tpl) : Appelez simplement votre alias avec la balise dédiée. Aucun attributnofiltern'est requis, l'injection HTML est gérée nativement par le cœur de Smarty 5.
Exemple d'intégration :
<section class="hero-section">
<div class="container text-center">
{* On appelle la nouvelle balise magique ! *}
{textblock alias="test_block"}
</div>
</section>- Magix CMS 4.x
- PHP 8.2 ou supérieur
- Smarty 5 (Intégré nativement dans Magix CMS 4)
| Problème | Cause possible | Solution |
|---|---|---|
| Le texte ne s'affiche pas | Mauvais contexte ou alias erroné | Vérifiez que l'alias écrit dans votre .tpl correspond exactement à celui du back-office, sans espaces. |
| Erreur de contexte | La page courante n'est pas ciblée | Assurez-vous que le bloc est assigné au bon module (ex: home pour l'accueil, ou footer pour du global). |
| Code HTML apparent | Balise mal formattée | Utilisez la syntaxe stricte {textblock alias="votre_alias"}. N'ajoutez pas de $, ni de nofilter. |
| Erreur Fatale Smarty | Conflit de version Smarty | Ce plugin utilise le namespace Smarty\Template requis par Smarty 5. Vérifiez la version de votre moteur de template. |
Ce projet est open source. Nous encourageons les développeurs à l'améliorer :
- Forker le projet.
- Créer une branche pour une nouvelle fonctionnalité (
git checkout -b feature/NouvelleIdee). - Commiter les changements (
git commit -m 'Ajout de NouvelleIdee'). - Push sur la branche (
git push origin feature/NouvelleIdee). - Ouvrir une Pull Request.
Ce projet est sous licence GPLv3. Voir le fichier LICENSE pour plus de détails.
Copyright (C) 2008 - 2026 Gerits Aurelien (Magix CMS).
Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Générale GNU telle que publiée par la Free Software Foundation ; soit la version 3 de la Licence, ou (à votre discrétion) toute version ultérieure.