Créer les fichiers associés à un plugin

Références

• paquet.xml (02/05/2019)
• Plugin.xml et pipelines (26/02/2013)
• Rédaction du plugin.xml (non daté !)
• Plugins, paquets et dépôts (non daté !)
• Rédaction du paquet.xml (non daté)
• PlugOnet => Plugin de migration de la DTD plugin à celle de paquet

Préambule

Plugin.xml (spip SPIP Système de Publication Pour l’Internet (CMS utilisé pour le présent site). Voir Wiipedia SPIP 2.0) devrait être remplacé par paquet.xml (spip SPIP Système de Publication Pour l’Internet (CMS utilisé pour le présent site). Voir Wiipedia SPIP 3.0) même si plugin.xml fonctionne toujours avec spip SPIP Système de Publication Pour l’Internet (CMS utilisé pour le présent site). Voir Wiipedia SPIP 3.0

Rédaction

• balise englobante unique : <paquet></paquet>
• sous-balises en 5 groupes avec ordre impératif : nom, crédits et copyright, traduction, techniques, spip SPIP Système de Publication Pour l’Internet (CMS utilisé pour le présent site). Voir Wiipedia SPIP
• la balise <paquet> possède 4 attributs obligatoires : prefix, categorie, version et état
• la balise <paquet> peut posséder 7 attributs facultatifs : logo, schema, meta, documentation, demonstration, developpement, compatibilite.

Mise en œuvre

<paquet
	prefix="qcm"
	categorie="divers"
	version="1.0"
	etat="dev"
	compatibilite="[3.2.*]"
	documentation="https://www.lorand.org/spip.php?rubrique116"
>
	<nom>QCM</nom>
	<auteur>Roland Bouat, 2020-</auteur>
	<licence lien="http://www.gnu.org/licenses/gpl-3.0.html">GNU/GPL</licence>
 
	<description>Qcm permet de réaliser un qcm par tirage au sort des questions, questions extraites d'un fichier dédié en affichant dans un ordre aléatoire des propositions issues du même fichier.</description>
</paquet>

L’écriture de paquet.xml tentée produit une erreur (non due à la cohabitation de plugin.xml et paquet.xml). Probablement une erreur de rédaction de paquet.xml qui est beaucoup plus formel que plugin.xml.

Si plugin.xml est désactivée, la première erreur disparaît (semble disparaître) mais la deuxième subsiste !

La balise qui pose probablement problème est la balise "description". Que se passe-t-il si elle est supprimée ? Nouvelle erreur.

Le fichier plugin.xml n’est pas désactivé. Après désactivation, il n’y a plus de message d’erreurs mais... le plugin n’apparaît plus dans les plugins à installer !

Désactivation de paquet.xml et suppression de la balise version dans plugin.xml => plantage : "Impossible de lire certaines descriptions XML - Version du plugin manquante".

... ???

La mise en oeuvre de paquet.xml étant en échec, la nouvelle tentative va utiliser le plugin PlugOnet pour construire le fichier paquet.xml à partir du fichier plugin.xml.

Résultat

• le slogan et la description ne sont pas dans paquet.xml mais dans un fichier de langue ! (je n’avais pas du tout compris ça !) La mention "array" venait donc de là !
• l’attribut "compatibilité" est plutôt mystérieux...?
• Et voici le nouveau fichier paquet.xml qui fonctionne !

<paquet
	prefix="qcm"
	categorie="divers"
	version="1.0"
	etat="dev"
	compatibilite="];["
>	
 
	<nom>QCM</nom>
	<!-- Un questionnaire à choix multiple totalement aléatoire. -->
 
	<auteur mail="roland.bouat@lorand.org">Roland Bouat</auteur>
 
	<licence lien="http://www.gnu.org/licenses/gpl-3.0.html">GPL 3</licence>
</paquet>

Il y a donc un fichier de langue associé (fichier rangé dans le sous-dossier "lang" évidemment). Le fichier se nomme "paquet-qcm_fr.php PHP Hypertext Preprocessor Voir Wikipedia PHP ".

<?php
 
// Ceci est un fichier langue de SPIP -- This is a SPIP language file
 
// Fichier produit par PlugOnet
// Module: paquet-qcm
// Langue: fr
// Date: 05-06-2020 09:56:26
// Items: 2
 
if (!defined('_ECRIRE_INC_VERSION')) return;
 
$GLOBALS[$GLOBALS['idx_lang']] = array(
 
	// Q
	'qcm_description' => 'Les questions du QCM sont affichées dans un ordre aléatoire ainsi que les propositions. Cette version de QCM permet de définir le nombre de questions du QCM ainsi que le nombre de propositions.',
	'qcm_slogan' => 'Un questionnaire à choix multiple totalement aléatoire.',
);
?>