Les balises #LOGO_XXX

Syntaxe de la balise

Pour afficher le logo

#LOGO_ARTICLE

produit le code HTML suivant :

<img
	src="IMG/logo/coucher-de-soleil.jpg?1661940083"
	class="spip_logo"	
	width="600" 
	height="400"
        alt=""
>

Pour afficher le logo avec un lien vers l’objet

#LOGO_ARTICLE*

produit le code HTML suivant :

<a href="mon-super-article"><img src="IMG/logo/coucher-de-soleil.jpg?1661940083" class="spip_logo" width="600" height="400" alt=""></a>

Retourner le nom du fichier logo

#LOGO_ARTICLE**

produit le code HTML suivant :
coucher-de-soleil.jpg

Retourner le chemin du fichier logo

[(#LOGO_ARTICLE|extraire_attribut{src})]

produit le code HTML suivant :
IMG/logo/coucher-de-soleil.jpg?1661940083

Un timestamp est automatiquement ajouté à l’adresse. Il correspond à la dernière modification du logo. Pour ne pas l’afficher, on peut écrire :

[(#LOGO_ARTICLE|extraire_attribut{src}|supprimer_timestamp)]

Manipuler graphiquement les logos
Pour manipuler les logos, on pourra utiliser les filtres images.

Exemple : afficher un logo en le réduisant en largeur à 220 pixels

[(#LOGO_ARTICLE|image_reduire{220,*})]

Utiliser #ID_LOGO_ pour afficher les champs titre, crédits et descriptif d’un logo

Depuis SPIP 4.2, les logos sont des images comme les autres. On peut donc leur renseigner un titre, descriptif, crédits, alt, ....

Pour accéder à ces informations on pourra utiliser la balise #ID_LOGO_ (par exemple #ID_LOGO_ARTICLE) qui retourne l’identifiant du document utilisé pour le logo d’un objet

Par exemple : afficher le titre et le crédit d’un logo.

<BOUCLE_logometas(DOCUMENTS){id_document=#ID_LOGO_ARTICLE}{tout}>
[<div class="logo-titre">(#TITRE)</div>]
[<div class="logo-credits">(#CREDITS)</div>]
</BOUCLE_logometas>

A noter : on doit utiliser le critère {tout} pour récupérer l’image

Logo de survol

Historiquement, si l’option "logo de survol" est activée dans la configuration du site, SPIP permet d’ajouter un deuxième logo pour avoir un effet de survol sur le logo (effet "rollover").

Dans ce cas,
-  #LOGO_ARTICLE affiche le logo avec l’effet de survol

Par ailleurs deux balises permettent de récupérer un seul des deux logos :
-  #LOGO_ARTICLE_NORMAL affiche le logo sans survol ;
-  #LOGO_ARTICLE_SURVOL affiche le logo de survol.

L’argument {lien}

On peut ajouter un argument à la balise pour spécifier un lien.

Exemple :

[(#LOGO_ARTICLE{#URL_RUBRIQUE})]

produit le HTML suivant :
<a href="actualites"><img src="IMG/logo/coucher-de-soleil.jpg?1661940083" class="spip_logo" width="600" height="400" alt=""></a>

L’argument {alignement} (déprécié)

Au lieu d’un lien, vous pouvez aussi indiquer un alignement sur le logo. Les valeurs possibles sont left, center ou right

Exemple :

[(#LOGO_ARTICLE{right})]

produit le HTML suivant :
<a href="mon-super-article"><img src="IMG/logo/coucher-de-soleil.jpg?1661940083" class="spip_logo spip_logo_right" width="600" height="400" alt=""></a>

Il est fortement recommandé d’utiliser #INSERT_HEAD_CSS pour fournir la feuille de style gérant les classes CSS d’alignement .spip_logo_left et .spip_logo_right

Le critère {logo}

Au niveau des boucles, le critère {logo} permet de ne sélectionner que les articles (ou rubriques, etc) qui disposent d’un logo. Il fonctionne aussi dans la boucle (HIERARCHIE). Le critère inverse {!logo} liste les objets qui n’ont pas de logo.

<BOUCLE_rub_logo(RUBRIQUES){racine}{logo}{par num_titre}>
#LOGO_RUBRIQUE
</BOUCLE_rub_logo>

Retourne les logos des rubriques à la racine qui possèdent un logo.

Héritage des logos rubriques

-  #LOGO_ARTICLE_RUBRIQUE affiche le logo de l’article, éventuellement remplacé par le logo de la rubrique s’il n’existe pas de logo spécifique à l’article.

Par défaut, la balise #LOGO_RUBRIQUE affiche le logo de la rubrique en cours et s’il n’est pas défini, va automatiquement chercher s’il existe un logo pour la rubrique parente de manière récursive.

Pour désactiver cette fonction d’héritage, on peut définir la constante _LOGO_RUBRIQUE_DESACTIVER_HERITAGE.

Pour définir le logo des rubrique par défaut, on pourra se rendre dans le menu "Édition > Rubriques" (http://monsite.org/ecrire?exec=rubriques).

Convention de nommage

A partir de SPIP 4.0, les logos sont traités comme des documents. Ils sont stockés dans le répertoire IMG/logo/ en conservant leur nom d’origine légèrement corrigé s’il contient les caractères interdits de type accents, espace blanc,.. ou s’il existe déjà un fichier du même nom.

Par exemple : /IMG/logo/coucher-de-soleil.jpg

Jusqu’à SPIP 3.2, les logos étaient renommés par SPIP au moment de l’upload avec la convention suivante : IMG/type-etatX.ext où :

• type est le type d’objet éditorial rattaché au logo : art (article), rub (rubrique) ...
• etat on, off est l’état du logo normal ou survol
• X est l’id de l’objet éditorial
• ext est l’extension du fichier(jpg, png ou gif)

Par exemple :

• /IMG/arton4.jpg est le logo de l’article n°4
• /IMG/artoff4.jpg est le logo de survol de l’article n°4

Types de logos acceptables

Il est possible d’indiquer les types d’images utilisables comme logo au moyen de la variable de personnalisation $GLOBALS['formats_logos'].

Par exemple, pour n’accepter que les fichiers SVG :
$GLOBALS['formats_logos'] = array('svg');

Voir aussi

• #BALISE* et #BALISE**

Pour le développement en PHP

• API des logos