Voici une petite page pour les dev malheureux qui apprendront que leurs plugins développés pendant la phase bêta de la 1.8 ne seront pas compatibles avec la version officielle de la 1.8.
Et c’est peut être aussi bien comme cela ;)
On pourrait imaginer que dans mes_fonctions.php3 on ait
foreach (glob('ecrire/plugins/plug_*.php') as $plug)
include($plug);ceci, toutefois, n’est pas sufffisant. En effet, tous les plugins ne doivent pas être inclus dans mes_fonctions puisque ceux qui implémentent un PointsEntreeIncTexte doivent être placés dans mes_options pour être aussi appliqués dans l’espace privé. De plus, une erreur se produirait pour ces derniers puisque la fonction completer_fonction introduite avec l’idée des plugins a été supprimée.
Règles
Voici donc 2 règles très simples pour savoir où recycler un plugin :
- si le plugin contenait un appel à completer_fonction, ou avait un impact quelconque sur l’espace privé, il doit être recyclé dans mes_options,
- sinon (il contenait de nouveaux filtres, balises, critères, etc...), il suffit de le recycler dans mes_fonctions.
Cas de mes_options
Les plugins apportaient surtout un attrait avec la fonction completer_fonction. Celle ci n’étant pas déclarée par la version officielle de SPIP, il faut donc enlever la ligne appelant cette fonction du fichier plugin en notant bien si on complète avant ou après :
- completer_fonction("propre","quelquechose",""); complète avant,
- completer_fonction("propre","","quelquechose"); complète après,
- completer_fonction("propre","quelquechose","autrechose"); complète avant et après
Il faut ensuite importer (« include ») le fichier plugin en question dans mes_options. Supposons que l’on laisse les fichiers plugins dans le répertoire ecrire/plugins. Voici le code à placer dans mes_options pour récupérer ses anciens plugins :
include( _DIR_RESTREINT .'plugins/plug_ancre.php');Il faut aussi compléter à la main la fonction propre(). Pour cela, il faut trouver les fonctions avant_propre($texte) et apres_propre($texte) dans le fichier mes_options. Si ces fonctions n’existent pas, il faut les ajouter :
function avant_propre($texte) {
return $texte;
}
function apres_propre($texte) {
return $texte;
}- si on complète avant, il faut ajouter une ligne du genre :
$texte = quelquechose($texte);
au début de avant_propre
- si on complète après, il faut ajouter une ligne du genre :
$texte = quelquechose($texte);
au début de apres_propre
Cas de mes_fonctions
Le cas de mes_fonctions est bien plus simple.
Il suffit d’importer directement tous les plugins qui n’ont pas déjà été inclus dans mes_options.
Par exemple :
include('./ecrire/plugins/plug_exif.php')
ou encore
foreach (glob('./ecrire/plugins/plug_*.php') as $plug) {include $plug;}
Mais attention, on ne peut faire cela que si aucun plugins n’a été importé dans mes_options
Répondre à cet article