SPIP - Contrib

[ar] [en] [es] [fr] [it]



Accueil du site > Images, Galeries > Galeries, Diaporamas > Thumbsites

Thumbsites - documentation developpeur

lundi 25 février 2008, par cam.lafit. Dernier ajout jeudi 28 février 2008


Comment ajouter un nouveau serveur de vignettes


Préambule

Cet article a pour but d’expliquer comment intervenir sur le code afin d’ajouter un nouveau serveur d’aperçu

Organisation du code

Le plugin est entiérement éditable sur la zone. L’ajout d’un nouveau seveur se fait en 2 partie :

  • l’ajout des options de configuration
  • la surcharge du filtre

Tout le code PHP est à commenter selon la norme de documentation doxygen.

Le fond

Pour ajouter un nouveau serveur, il vous faut éditer le fond cfg_thumbsites.html

L’ajout de l’option

La premiére partie est d’ajouter le nom du serveur dans la liste de selection
serveur </serveur>.

<code>
<option value="nomserveur"[(#ENV{serveur}|=={'nomserveur'}|?{' selected="selected"'})]>nomserveur</option>

Il est important de bien définir nomserveur c’est grâce à ce nom que sera chargé la surcharge du filtre thumbsite

La zone de configuration

Ensuite il vous faut ajouter la zone de configuration, juste avant la partie javascript.

<fieldset id="nomserveur" class="conf_serveur [(#ENV{serveur}|=={'nomgirafa'}|?{'actif'})]"><legend>nomserveurGirafa</legend>
   <p>
       Explication du serveur et de sa configuration
   </p>
   <p>
       Précisision  sur la taille des vignettes
   </p>

   <p>
       <label for="nomserveur_parametre1"> texte : </label>
       <input type="text" name="nomserveur_parametre1" id="nomserveur_parametre1" [value="(#ENV{nomserveur_parametre1})"]>
   </p>
   <p>
        [...] On ajouter les autres paramètres [...]
   </p>
</fieldset>

Il est important de conserver l’écriture pour l’id et la classe du fieldset, c’est ce qui permet de rendre dynamique le gestion du fond.

Les paramètres sont à déclarer sous la forme nomserveur_parametre1

La surcharge PHP

La surcharge se fait simplement par la création d’un nouveau fichier dans le repertoire thumbsites/. Ce fichier sera à nommer nomserveur.php

Le code à mettre sera de la forme :

   function thumbsite_serveur($url) {
       //obtient les paramétres de connexion
       $param1 = lire_config('thumbsites/monserveur_parametre1');

       //les traitements

       //retourne l'url de la vignette
       return "url de l'image générée";
   }

Répondre à cet article



Suivre la vie du site RSS 2.0 | Plan du site | Espace privé | Charte et vie SPIP-Contrib | SPIP | L'autre.net