iGalerie

Documentation d'iGalerie 3

HTML dans les champs textes

Ajouter du code HTML à vos textes

Il est possible de mettre du code HTML dans les champs textes suivants :

  • Description de la galerie
  • Descriptions des catégories, albums et fichiers
  • Messages de pied de page et de fermeture de la galerie
  • Pages personnalisées
  • Page contact

Les champs textes qui autorisent du code HTML sont reconnaissables par l'étiquette HTML qui se trouve au dessus et à droite du champ. En cliquant dessus, vous obtenez la liste des balises HTML et des attributs de balises autorisés.

Champ texte disposant d'une étiquette 'HTML'
Champ texte disposant d'une étiquette "HTML".

Notez que le code HTML est filtré pour des raisons de sécurité. De manière générale, seules les balises de mise en forme du texte sont autorisées. S'il est possible d'ajouter des liens et des images, en revanche le code Javascript se sera pas autorisé.

Si vous souhaitez ajouter du code HTML non autorisés ou du Javascript, vous devrez modifier les fichiers de template du thème, situés dans le répertoire template.

Exemple

Pour styler du texte, vous pouvez utiliser la balise <span> avec l'attribut style :

<span style="color:#1F4B9D;font-size:110%">Exemple de texte</span>

Balise <img>

Le code pour l'ajout d'image est filtré. Il est impossible de placer une image provenant d'un autre site dans votre galerie. Ceci afin d'éviter l'ajout de pixel espion, mais aussi pour éviter de se servir de votre galerie pour mener une attaque de type CSRF.

C'est pourquoi toutes les images que vous souhaitez ajouter dans vos descriptions doivent se trouver dans le répertoire images d'iGalerie. Le code HTML à insérer devra donc ressembler à ça :

<img src="/igalerie/images/mon_image.jpg">

ou bien encore à ça :

<img width="300" height="50" alt="Texte alternatif" src="http://mon-site/ma-galerie/images/mon_image.jpg">

Limitations de l'attribut "style"

Comme nous l'avons vu plus haut, vous pouvez utiliser la balise <span> avec du code CSS. Cependant, toujours pour des raisons de sécurité, certains caractères ne sont pas autorisés avec l'attribut style, notamment le slash (/), ce qui a pour conséquence d'interdire l'utilisation de certaines propriétés CSS comme la propriété background-image (risques identiques à la balise <img>). Pour contourner cette limitation, il suffit d'utiliser un identifiant (ou une classe) sur une balise, puis d'appliquer les propriétés souhaitées sur cet identifiant en ajoutant du code CSS dans les options du thème.

Dernière modification : 20/03/2020