PUBLIE : Les balises #LOGO_XXX

**SPIP**

# Article validé

L’article "**Les balises #LOGO_XXX**
(https://www.spip.net/fr_article6461.html)" vient d’être publié par
b_b.

* * *

## Les balises #LOGO_XXX

mardi 9 octobre 2018 , par [erational](.././?page=auteur&id_auteur=705&)

Les balises #LOGO_ affichent les logos des objets éditoriaux.

* **`#LOGO_SITE_SPIP`** : logo du site
* **`#LOGO_ARTICLE`** : logo d’un article
* **`#LOGO_RUBRIQUE`** : logo d’une rubrique
* **`#LOGO_AUTEUR`** logo de l’auteur
* **`#LOGO_BREVE`** : logo d’une brève
* .... et plus généralement **`#LOGO_NOM_OBJET_EDITORIAL`**

## Syntaxe de la balise

**Pour afficher le logo**

    #LOGO_ARTICLE

produit le code HTML suivant :
`<img class="spip_logo spip_logos" alt="" src="IMG/arton4.jpg?1538235375"
width="600" height="400">`

**Pour afficher le logo avec un lien vers l’objet**

    #LOGO_ARTICLE

    *

produit le code HTML suivant :
`<a href="mon-super-article"><img class="spip_logo spip_logos" alt=""
src="IMG/arton4.jpg?1538235375" width="600" height="400"></a>`

**Retourner le nom du fichier logo**

    #LOGO_ARTICLE

    **

produit le code HTML suivant :
`arton4.jpg`

**Retourner le chemin du fichier logo**

    [

    (

    #LOGO_ARTICLE

    |extraire_attribut

    {src}

    )

    ]

produit le code HTML suivant :
`IMG/arton4.jpg?1538235375 `

Un timestamp (https://www.spip.net/ecrire/?exec=article&id_article=6187)
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
(https://www.spip.net/ecrire/?exec=article&id_article=3327).

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

    [

    (

    #LOGO_ARTICLE

    |image_reduire

    {220,*}

    )

    ]

## 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.

## Filtre `|adresse` (déprécié)

Le filtre `|adresse` permet d’ajouter un lien sur le logo.

    [

    (

    #LOGO_ARTICLE

    |adresse

    )

    ]

**Exemple :**

    [(
    
    #LOGO_ARTICLE
    
    |
    
    #URL_ARTICLE
    
    })]

produit le HTML suivant :
`<a href="spip.php?article4"><img class="spip_logo spip_logos" alt=""
src="IMG/arton4.jpg?1538235375" width="600" height="400" /></a> `

**Nouvelle écriture** : ce filtre est à présent à écrire comme
*argument* de la balise, ainsi `[(#LOGO_xxx|#URL_yyy)]` est remplacé par
`#LOGO_xxx{#URL_yyy}`.

## Filtre `|alignement` (déprécié)

Le filtre `|alignement` permet d’ajouter un alignement sur le logo.

    [

    (

    #LOGO_ARTICLE

    |alignement

    )

    ]

Permet d’indiquer une valeur d’alignement : *left* ou *right*

**Exemple :**

    [

    (

    #LOGO_ARTICLE

    |right

    )

    ]

produit le HTML suivant :
`<img class="spip_logo spip_logo_right spip_logos" alt=""
style="float:right" src="IMG/arton4.jpg?1538235375" width="600"
height="400">`

**Nouvelle écriture** : ce filtre est à présent à écrire comme
*argument* de la balise, ainsi `[(#LOGO_xxx|left)]` est remplacée par
`#LOGO_xxx{left}`.

Il est fortement recommandé d’utiliser `#INSERT_HEAD_CSS` pour fournir
la feuille de style gérant les alignements.

## 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
(https://www.spip.net/ecrire/?exec=article&id_article=5691).

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

Les logos sont 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

## Historique

La syntaxe de balise `#LOGO_` a beaucoup évolué depuis les premières
versions de SPIP. Pour connaitre l’évolution de la syntaxe, on pourra
consulter la page de présentation de SPIP 2.1
(https://www.spip.net/ecrire/?exec=article&id_article=4728#logos).

— Envoyé par SPIP (https://www.spip.net/)

rubon143-b1fe1.jpg

puce.gif