[plugin] modules - plugin permettant de charger d'autres modules, texte ou php

gcyrillus-nomade

Voici un autre plugin très léger, inspiré d'un morceau d'un autre plugin.

Ce plugin vous permet au travers d'un hook d'injecter dans vos pages du simple texte au script s’intégrant à PluXml comme un plugin. https://ressources.pluxopolis.net/banque-plugins/plugins/modules.zip

---

Une version 2 avec une architecture HTML revue pour les modules ainsi qu'un exemple de boite de configuration pour un modules est sorti: https://ressources.pluxopolis.net/banque-plugins/plugins/modules.2.0.zip

Pour aller un peu plus loin, voici une version 2.0 qui permet en plus d'afficher une boite de configuration pour le module.(c'est optionnel)
Cette boite est accessible uniquement si vous êtes déjà connecter en tant qu'administrateur. Visuellement cela ajoute une icône en bas de votre module à cliquer.
L'exemple avec mermaid est toujours pris en exemple avec la possibilité de switcher sur l'un des thèmes fournis par le script.
j'ai opté pour un fichier json relié au module plutôt que d'aller squatter le fichier de paramètre du plugin.
L'architecture est aussi revue pour éviter que l'ajout de modules et leurs fichiers deviennent ingérable à tous les niveaux.

Maintenant, ce qu'il va manquer, ce sont des modules, alors si vous trouvez une utilité à ce plugin et avez quelques modules utiles ou juste sympas que vous avez fait, faites en profitez la communauté

---

Son mode de fonctionnement:
1. un seul hook
2. un paramètre à passer
3. option d'un second paramètre séparé par une virgule

Placé dans votre thème, le hook va injecter un fichier php portant le nom du paramètre. si il y a un second paramètre, ce fichier pourra s'en servir : $param

Un exemple est fourni pour mieux comprendre le chargement et l'interaction d'un module .

J'ai pris par hasard le script https://mermaid.js.org/ et mis comme premier graph en démo un camembert des stats de de votre site .Nombre de : articles,categories,tags,commentaires,pages statiques et plugins .

Cet exemple aide aussi à voir comment passer ou pas un paramètre au plugin.

En installant ce plugin et un ajoutant dans votre thème le hook :
<?php eval($plxShow->callHook('moduleswidget','mermaid')); ?>

Le module mermaid.php sera chargé, ce module demande un paramètre supplémentaire pour charger tel ou tel script(fichier) .
Si ce paramètre est absent, le plugin duplique le premier paramètre, mermaid ira donc chercher dans son sous dossier un autre fichier nommé lui aussi mermaid.
Avec le second paramètre passé au module:
cela donne:
<?php eval($plxShow->callHook('moduleswidget','mermaid, mermaid')); ?>

Vous pouvez , par exemple seulement chargé le cdn de mermaid depuis le module et codé vos graphique dans vos articles.

(une évolution possible du module mermaid est un short code à placé dans un article ou une page statique pour afficher un le script d'un graph stocké dans son répertoire et l'ajout d'une fonction d'upload en page d'administration)

En gros, ce plugin peut simplement afficher un message texte, charger une feuille de style, un fichier et pluguer d'autres fonctions. Son usage n'a de limite que votre imagination.

Francis

Merci beaucoup pour ce plugin qui a l'air vraiment très intéressant !
Je crois qu'on va découvrir petit à petit beaucoup d'applications possibles.

Et c'est une bonne idée d'avoir donné comme exemple le script https://mermaid.js.org/
Je ne le connaissais pas, il offre beaucoup de possibilité de diagrammes, et il est simple à utiliser !

gcyrillus-nomade

@Francis merci de ton retour et de ton enthousiasme C'est encourageant

Pour aller un peu plus loin, voici une version 2.0 : https://ressources.pluxopolis.net/banque-plugins/plugins/modules.2.0.zip , qui permet en plus d'afficher une boite de configuration pour le module.(c'est optionnel)
Cette boite est accessible uniquement si vous êtes déjà connecter en tant qu'administrateur. Visuellement cela ajoute une icône en bas de votre module à cliquer.
L'exemple avec mermaid est toujours pris en exemple avec la possibilité de switcher sur l'un des thèmes fournis par le script.
j'ai opté pour un fichier json relié au module plutôt que d'aller squatter le fichier de paramètre du plugin.
L'architecture est aussi revue pour éviter que l'ajout de modules et leurs fichiers deviennent ingérable à tous les niveaux.

Maintenant, ce qu'il va manquer, ce sont des modules, alors si vous trouvez une utilité à ce plugin et avez quelques modules utiles ou juste sympas que vous avez fait, faites en profitez la communauté

gcyrillus-nomade

version 2.1 https://ressources.pluxopolis.net/banque-plugins/plugins/modules.2.1.zip
ajout d'un module embarquant 95 citations de Socrates à afficher aléatoirement ... et correction du code exemple pour la page de configuration d'un module.

Pour afficher ce module, placer dans votre thème à l'endroit que vous voulez, le code suivant :

<?php eval($plxShow->callHook('moduleswidget','socrate')); ?> classique pour un pied de page.

Vous pouvez ajouté des citations si vous êtes connecté en administrateur, il suffit de cliquer sur l'icône qui apparait (voir image ci-dessus) et un formulaire s'affiche. Les citations sont stockées au format json: { "citation": "la citation" , "auteur" : "l'auteur" }.