Balise #IMAGE_PAR_DEFAUT

Cette balise génère à la volée des images dont on peut préciser la taille et la couleur. Elle s’utilise par exemple lors du développement d’un site, lorsqu’il manque des images. On la place alors dans la partie alternative de boucles requérant ces images, et elle sera appelée chaque fois qu’une image requise n’a pas été trouvée par la boucle.

Cas d’utilisation

Imaginons le cas d’un site où l’on ait absolument besoin d’une série d’images d’une certaine taille par exemple pour alimenter un slider. Imaginons que ces images ne soient pas encore présentes sur le site.

Créons un squelette de slider qui tente dans un premier temps de récupérer les images requises (de largeur 960px par exemple) depuis la bibliothèque dans une boucle [1] :

<BOUCLE_a_la_une_image(DOCUMENTS){id_article}{extension IN png,jpg,gif}{0,1}{largeur >= 960}>
  [(#FICHIER
    |image_passe_partout{960,260}|image_recadre{960,260}
    |inserer_attribut{alt,""})]
</BOUCLE_a_la_une_image>
...

Ajoutons une partie alternative à la boucle afin de traiter les cas où les images requises ne sont pas encore en bae. La balise #IMAGE_PAR_DEFAUT sera appelée en lieu et place du fichier manquant :

...
  [(#IMAGE_PAR_DEFAUT{960,260}
    |image_passe_partout{960,260}|image_recadre{960,260}
    |inserer_attribut{alt,""})]
<//B_a_la_une_image>

Paramètres

Outre les dimensions de l’image à fabriquer, on peut passer à la balise #IMAGE_PAR_DEFAUT d’autres paramères :
-  un texte (court...)
-  une couleur pour le fond (par défaut gris #cccccc...)
-  une couleur pour le texte (par défaut #444444...)

Exemples d’appel

Voici quelques exemples d’appel avec les résultats produits :

#IMAGE_PAR_DEFAUT{300,200,'',#009AFE,#717286}

#IMAGE_PAR_DEFAUT{300,200,'Pouet'}

Pour de petites images :

#IMAGE_PAR_DEFAUT{108,108,'Silhouette',#e6d39b,#4682C8}

Et pour des images plus grandes [2] :

#IMAGE_PAR_DEFAUT{960,260,'Un texte vraiment très très long, voire trop long',#e6d39b,#4682C8}

Footnotes

[1Les filtres sur la boucle document et sur la balise #FICHIER sont donnés à titre d’exemple et n’influent pas sur le comportement de la balise

[2Dans le cas présent sur Contrib les images sont réduites pour ne pas nuire à la mise en forme

Afin d’éviter que des images alternatives issues de la balise #IMAGE_PAR_DEFAUT n’apparaissent par mégarde aux yeux des visiteurs, il est recommandé de désactiver ce plugin sur les sites en production.

Discussion

One discussion

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom