Blogspx

Projet spx pour booster pluxml

Vous êtes ici : accueil

Edito

Le projet spx a pour but de créer un ensemble de plugins homogènes afin de pousser pluxml hors de ses limites.

Il existe pour le moment 8 plugins "spx". L'un des plus important se nomme "spxdatas", il est le moteur du projet :

Quelques liens utiles :

Ce blog a pour vocation d'éclaircir le projet et donner des exemples concrets pour adapter spx a ses besoins.

spxplugindownloader : comment rejoindre la liste des dépôts de plugins

Rédigé par je-evrard / 10 mars 2015 / aucun commentaire

Le plugin spxplugindownloader permet de centraliser des dépôts de plugins.

Vous avez créé des plugins et vous voulez les faire partager dans un dépot via ce plugin.

Comment faire ?

Les différents dépôts doivent produire deux url qui permettent au plugin de connaitre le numéro de version du repository ainsi que la liste exacte des plugins de ce dépot.

Deux fichiers doivent être fournit appelé par une url:

Ces deux fichiers peuvent par exemple être mis dan un dossier de votre dépôt git ou ailleurs (/repository par exemple).

  • https://github.com/mongit/repository/repository.version --> retourne le numero de version de ton repository
  • https://github.com/mongit/repository/repository.xml --> liste le detail de tes différents plugins (voir formattage ci-joint)

le repository.xml se présente sous cette forme :


<?xml version="1.0" encoding="UTF-8"?>
<document>    <plugin>       <title><![CDATA[Titre du plugin]]></title>       <author><![CDATA[Mon nom]]></author>       <version>1.6</version>       <date>01/10/2013</date>       <site>http://www.monsite.net/</site>       <description><![CDATA[Plugin x detail]]></description>       <name>pluginname</name>       <file>https://github.com/mongit/gutuma/pluginname.1.6.zip</file>       <icon>https://github.com/mongit/gutuma/pluginname.png</icon>    </plugin>    <plugin>       ...    </plugin> </document>

A noter :

  • l'icône peut etre générée en base 64 et non appelée via une url
  • le "file" représente l'url du zip
  • le "name" correspond au nom du dossier du plugin dans le repertoire plugin de pluxml

Comme on le voit ci dessus, le détail des plugins permet la comparaison entre le plugin installé sur site et la version du repository. Un champs file permet de récupérer l'url du zip du plugin, un champs icon permet d'afficher l'icône du plugin.

Vouloir créer sont dépot reste finallement assez simple.

Il vous faudra donc fournir les informations liés au depôt. Construire vos deux fichiers (version + liste des plugins au format xml), les zip et les logos devront correspondre à l'intégrité du fichier xml de description des plugins.

En changeant votre numéro de version de repository le plugin mettra a jour votre dépôt de plugins mis en cache.

Avis aux amateurs ! Ne pas hésiter à me contacter pour que je vous rajoute dans la liste des dépôts.