[plugin] theCrock - Utilitaire. génère le squelette d'un plugin

gcyrillus-nomade · décembre 2023

theCrock est un plugin pour faire des plugins

disponible ici https://github.com/gcyrillus/theCrock

A voir aussi comme un complément possible à la documentation : https://wiki.pluxml.org/docs/develop/plugins/index.html

et utilisable en ligne ici https://pluxopolis.net/thecrock si vous ne souhaitez pas l'installer chez vous.

Cela se présente dans un formulaire à plusieurs pages, avec des cases à cocher et quelque textes optionnels

les options sont :

incluses systématiquement :
- compatibilité avec le plugin multilingue ,
- un fichier lang, ( a compléter par vos soins)
- un fichier d'aide ( a compléter par vos soins)
Aux choix
- Page de configuration
- Page admin
- wizard
- widget
- selection de hooks natifs
- Ajout de vos hook ou fonction (noms)
- Paramètres d'exemples
- Vos paramètres (noms) par type : string,cdata ou numérique
- envoi de votre icône (fichier image renommé et convertit en icon.png )

Le plugin se charge d’insérer les fonctionnalités choisies, les fichiers nécessaires (php,js,css) habituels dans un fichier au format zip.
Le plugin installable en l'état, n'attendra plus que vos script. Il vous fait gagner du temps en générant les fichiers nécessaires.

Ce n'est pas le premier outil qui veut vous aider dans les premiers pas du dev d'un plugin.
Il existe ce script : http://outils.warriordudimanche.net/outils/pluxml_plugin_starter.php
il existe aussi ces deux bases : https://ressources.pluxopolis.net/banque-plugins/plugins/Plugin.zip et https://ressources.pluxopolis.net/banque-plugins/plugins/test.zip

Entre Outils , vous avez aussi, https://ressources.pluxopolis.net/banque-plugins/plugins/kzTranslate-1_1_0.zip pour traduire votre fichier langue en une ou plusieurs autre langues.

Bon Dev

cpalo · décembre 2023

Bonsoir
Une fois de plus merci pour ce travail.
Je vais tester ça ( j'avais testé les autres que tu cites, et ça m'avait bien aidé à comprendre comment faire un plugin)
Cordialement

jack31 · décembre 2023

C'est sympa, c'est joli, c'est utile, c'est un truc à faire revenir des utilisateurs vers Pluxml, mais, bien qu'il s'adresse aux apprentis codeurs, il n'y en a quand même pas assez pour que l'ignare qui voudrait se mettre à construire un plugin y arrive tout seul. je pense à ma pomme bien évidemment. 🙂

Alors, un petit tuto de derrière les fagots qui explique comment fonctionne un plugin deniaiserait les incultes et aurait toute sa place car l'utilisateur lambda aimerait encore plus notre CMS favori.

Avec espoir... 😉

Jack31

gcyrillus-nomade · décembre 2023

@cpalo Merki , j’espère qu'il te sera utile

@jack31 bien vu,
j'ai oublié de mettre le lien le plus important et indissociable en fait : https://wiki.pluxml.org/docs/develop/plugins/index.html

Sans être totalement un tuto, on y trouve toutes les informations du fonctionnement d'un plugin. On peut voir ce plugin (et autres sources partagées) comme un complément à la documentation. La seule chose qui n'est pas évoqué dans la doc c'est l'ajout d'un Wizard à l'activation.

Je pense régulièrement à l'écriture d'un tutoriel sur la créations d'un plugin et je n'ai toujours pas trouvé d'accroche simple car il y a deux pré-requis sur lesquels il est difficile de faire l'impasse et de les évaluer.

être capable d’écrire une fonction et une class en PHP
comprendre le fonctionnement de PluXml et ou se trouvent les hooks dans le code.

Ensuite, quels exemples prendre pour ouvrir les possibles ? C'est très vaste et dépend totalement des compétences et besoins de chacun .
On peut montrer comment et où injecter une feuille de style ou script, ajouter une fonctionnalité ou remplacer un pan de code de PluXml, traiter et initialiser les paramètres d'un plugin ... en fait le plugin embarque déjà ces exemples sur lesquelles on peut ensuite broder et compléter.

Il y a aussi le fait que je ne suis pas développeur, je n'ai que des idées et connaissances partielles ou empiriques, je ne suis pas certains d'en savoir assez pour faire un tuto de ce genre qui tienne la route, je n'ai pas non plus le vocabulaire.
Je n'arrive pas à faire la part entre ce que l’apprentie plugueur-codeur doit déjà savoir et ce qu'il y a savoir en plus qui n'est pas dans la documentation. Pour l'instant, mes quelques tentatives ont toutes échouées, d'où la raison de ce plugin que l'on peut raccourcir en ...-"Attends c'est compliqué , je vais te faire un dessin"- _{aussi en echo à https://forum.pluxml.org/discussion/7526/resolu-nouvelle-option-de-redimensionnement-dimage}

cdt

jack31 · décembre 2023

Yes, en fait tu as répondu à ma question. C'est compliqué :-D

Je n'avais pas vu tout cela et mais tout de même, je reste persuadé qu'en bossant un peu le truc pour comprendre ce qui nous intéresse, arriver petit à petit à obtenir ce que l'on cherche à faire ce qui est déjà un début et je crois que les "simples" utilisateurs y trouveraient leur compte pour adapter à Pluxml un de leur programme perso sous forme de plugin qu'ils pourraient mettre à la disposition de la communauté.

En effet, combien de néo-pluxistes abandonnent le CMS parce qu'il ne fait pas ce qu'ils souhaitent en se disant que s'ils pouvaient lui intégrer un script qu'ils veulent utiliser, cela serait le bonheur ?

Pour l'exemple, tu sais que j'ai fais trois ou quatre machins appelés pompeusement Plugin mais ce n'était que du bricolage.

Tu vois, si à l'époque j'avais pris le temps de vraiment m'y mettre avec un plugin dans le genre du tien (et ses prédécesseurs), bien qu'un peu compliqué quand-même pour les bricoleurs de mon style, j'aurai "codé" des tas de trucs et serais resté plus investi dans Pluxml.

Sans pour autant devenir un crack du PHP. C'est trop tard.

Une idée qui me vient en écrivant ces lignes.

Et si on organisais un genre de tutoriel pratique sur ces forums où, à l'aide de theCrock, tu guiderais les bonhommes à fabriquer leur premier plugin (un très simple bien sûr) et tu pourrais ainsi répondre aux questions qu'ils se posent en les aidant à avancer là où ils bloquent ?

Peut-être que ça ferait venir des gens sur ces forums et contribuerait à la future pérennité de Pluxml.

petitpouyo · décembre 2023

Salut @gcyrillus-nomade bravo pour ce taff je suis très admiratif de tes plugins. Je vais me remettre tout doucement à PluXml.

jack31 · décembre 2023

@gcyrillus-nomade Tu vois, quand je te le disais. Les brebis rentrent au bercail.

gcyrillus-nomade · décembre 2023

@jack31

Et si on organisais un genre de tutoriel pratique sur ces forums où, à l'aide de theCrock, tu guiderais les bonhommes à fabriquer leur premier plugin (un très simple bien sûr) et tu pourrais ainsi répondre aux questions qu'ils se posent en les aidant à avancer là où ils bloquent ?

C'est ce que j’espère du forum (lien vers ce sujet mis depuis le plugin sur pluxopolis)
J’espère aussi ne pas être le seul à répondre, je connais pas trop mal PluXml mais je ne suis pas l'expert de la bête.

cdt

@petitpouyo Merci

jack31 · décembre 2023

Allez, arrête avec ta timidité.

On vois bien avec tes productions que tu en sais bien plus que tu ne veut le dire (à moi tu m'a bluffé) et le but n'est pas d'écrire une encyclopédie mais à aider les mecs qui veulent mettre les mains dans le cambouis.

Mon idée est qu'ils sont beau ces tutoriels (je suis en train de lire pour la dixième fois le lien que tu as donné "Créer un plugin") mais quand il manque les bases, on est vite bloqué évidement.

C'est là que le tuteur entre en jeu.

Un truc te préoccupe ?

Au lieu de passer des heures et des jours à aller consulter les sites spécialisés, forums et autres tutoriels vite indigestes pour le newbie qui s'y colle, la réponse concernant le sujet est là toute prête sans besoin d'apprendre le PHP parce-que que là on n'est pas arrivé.

Et le débutant apprend par l'exemple. (Méthode pédagogique inventée par Webjack).

De l'amusement quoi.

erxyz · décembre 2023

@jack31 : je crois que tu n'imagines pas le temps et la diplomatie nécessaire à une telle entreprise (guider individuellement les apprentis plugueurs).

Je ne doute pas que notre ami @gcyrillus-nomade regorge de diplomatie (il est le plus actif sur ce forum pour aider) mais je crois qu'il a aussi une vie à côté.

L'idée est évidemment intéressante mais elle nécessiterait que d'autres développeurs s'y investissent. Surtout, si comme tu l'espères, cette initiative augmente le nombre d'utilisateurs (donc de demandeurs).

Et, oui, PHP c'est chiant et long à apprendre mais c'est indispensable d'en avoir au moins les bases (boucles, tableaux, formulaires, objets, tests basiques, etc).

jack31 · décembre 2023

Oui erxyz , j'en suis [parfaitement] conscient mais reste persuadé que comprendre (en général) le fonctionnement d'un plugin permettrait aux petits bidouilleurs dans mon genre d'adapter au sein Pluxml des scripts qu'ils aimeraient lui intégrer.

Ok, Ok, c'est pas gagné d'avance mais un petit peu de connaissance ne peut faire de mal et surtout nous inciterait à nous engager davantage dans la communauté.

Oui, je sais, je rêve, mais ne sommes-nous pas là pour rêver et faire rêver les visiteurs de nos sites ?

kroc · décembre 2023

Merci @gcyrillus-nomade pour ce joli cadeau de Noël !

gcyrillus-nomade · 1 janv.

petite mise à jours du plugin (le wizard , si pris en option, n’était pas lancé dans le squelette du plugin ) en vérifiant son fonctionnement dans la 5.9.0-rc1 . tout va bien.

Bonne Année À tous

[plugin] theCrock - Utilitaire. génère le squelette d'un plugin

Réponses