SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

289 Plugins, 197 contribs sur SPIP-Zone, 66 visiteurs en ce moment

Accueil > Affichage multimédia > Galeries et diaporamas > Thumbsites > Thumbsites - documentation developpeur

Thumbsites - documentation developpeur

30 juillet 2009 – par cam.lafit, _Eric_

12 votes

Ajouter un nouveau serveur de vignettes avec sa configuration

Préambule

Cet article a pour but d’expliquer comment intervenir sur le code afin d’ajouter un nouveau serveur de vignettes ainsi que sa configuration.

Organisation du code

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

  • ajout des options de configuration
  • la surcharge du filtre de création de la requête serveur

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

La page de configuration

Pour ajouter un nouveau serveur, il vous faut éditer :

  • soit le fichier fonds/cfg_thumbsites.html pour la branche v0 compatible SPIP 2. La configuration utilise encore CFG.
  • soit le fichier formulaires/configurer_thumbsites.html pour la branche v1 compatible SPIP 3. la configuration n’utilise plus CFG.

-  Ajout de l’option dans la liste des serveurs

La première étape consiste à ajouter le serveur comme une option supplémentaire du select. Il est important de bien définir nom_du_serveur car c’est grâce à ce nom que le bon filtre de création de la requête serveur sera chargé.

-  Ajout de la zone spécifique de configuration du serveur

La deuxième étape consiste à rajouter le fieldset qui contient la configuration spécifique du serveur (explications, taille des vignettes, identifiant de connexion, conditions d’utilisation...).

Il est essentiel de positionner le nom nom_du_serveur en id de la balise fieldset ainsi que la classe de façon à assurer le fonctionnement du script jQuery. En outre, le nom des paramètres doivent être de la forme nom_du_serveur_parametre. Enfin, tous les textes doivent être sous forme d’items de langue (voir les serveurs existant).

Le script jQuery ne doit jamais être modifié.

La surcharge du filtre de création de la requête serveur

La surcharge consiste à créer un nouveau fichier dans le répertoire serveurs/. En considérant que notre nouveau serveur a pour nom nom_du_serveur, ce fichier sera nommé nom_du_serveur.php.

Le code PHP qu’il contiendra sera de la forme :

  1. function url_thumbsite_serveur ($url_site) {
  2.         // on lit les paramètres si besoin
  3.         $param1 = lire_config('thumbsites/serveur_x_parametre1');
  4.         // .../... les autres paramètres
  5.  
  6.         // on construit l'url
  7.         // .../...
  8.  
  9.         // on retourne l'url de la requête serveur
  10.         return "url de l'image générée";
  11. }

Télécharger

Dernière modification de cette page le 16 mars 2013

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Envoyer des fichiers avec un formulaire Formidable

    2 janvier 2017 – 56 commentaires

    La version 3.0.0 du plugin Formidable permet de créer des formulaires comprenant des envois de fichiers. Cet article regroupe la documentation relative à cette fonctionnalité. Pour une présentation générale de Formidable, voir « Formidable, le (...)

  • Grappes 1.0

    23 novembre 2012 – 33 commentaires

    Présentation et nouveautés Cette version 1.0 du plugin Grappes est un portage pour SPIP 3.x. Le plugin permet de grouper des objets de SPIP dans des grappes. Les objets du core (articles, rubriques, auteurs, etc.) sont pris en charge, ainsi que (...)

  • Cycle2

    7 août 2014 – 117 commentaires

    La seconde version de la librairie Javascript « jQuery Cycle », qui permet de produire des diaporamas, se nomme « Cycle2 » : http://jquery.malsup.com/cycle2/. Voici cette nouvelle librairie mise en plugin pour SPIP. Si vous utilisez déjà « jQuery (...)

  • LinkCheck : vérificateur de liens

    13 février 2015 – 128 commentaires

    Ce plugin permet de chercher et tester l’ensemble des liens présents dans les objets. Vous pourrez donc en quelques clics connaître les liens brisés ou défectueux qui se sont immiscés dans le contenu de votre site SPIP. La vérification s’effectue en (...)

  • Mon site affiche une page blanche ou je ne peux plus accèder à l’espace privé

    7 février 2008 – 34 commentaires

    Au secours ! « Tout à coup » votre site devient inutilisable ou inaccessible ! Comment faire ? Pourquoi ? Par où commencer ? Sans pouvoir couvrir tous les cas, cet article va essayer de vous guider rapidement vers la (...)