Extended Description

Date de la documentation : 21 Avril 2011

Un article de plg sur le blog de Piwigo

Descriptions multilingues

Les descriptions multilingues se font entre les balises [lang=xx] et [/lang], ou xx est le code de la langue (par exemple fr, en, es, it, etc….) Il existe également 2 balises spéciales: [lang=default] et [lang=all]

  • Exemple d'utilisation:
[lang=default] description par défaut [/lang]
[lang=fr] description en francais [/lang]
[lang=it] description en italien [/lang]

La description par défaut sera utilisée si la description dans la langue de l'utilisateur n'est pas définie. Si [lang=default] n'existe pas, tout ce qui est situé en dehors des balises de langues sera considéré comme description par défaut.

Balise all: tout ce qui est situé entre les balises [lang=all] et [/lang] sera inclus dans la description, quelle que soit la langue de l'utilisateur. Ceci est particulièrement pratique pour inclure du code html ou javascript dans une description.

Descriptions étendues

Les balises de description étendue permettent d'avoir une description réduite pour la présentation d'une catégorie, une description étendue pour la description qui s'affiche sur la page de la catégorie, ou deux descriptions différentes sur la page de la catégorie.

La balise <!–more–> permet de rajouter du texte à la description réduite.
La balise <!–complete–> permet d'avoir 2 descriptions distinctes.
La balise <!–up-down–> permet d'avoir une description haute et une descrition basse.

  • Balise <!–more–>
description réduite <!--more--> description détaillée

Seule la description réduite sera affichée pour la présentation de la catégorie. Sur la catégorie elle-même, la description sera la description réduite + la description détaillée.

  • Balise <!–complete–>
description réduite <!--complete--> description détaillée

Seule la description réduite sera affichée pour la présentation de la catégorie. Par contre, sur la catégorie elle-même, la description sera uniquement la description détaillée, soit 2 descriptions différentes.

  • Balise <!–up-down–>
description haute <!--up-down--> description basse

Seule la description haute sera affichée pour la présentation de la catégorie. Sur la catégorie elle-même, la description haute sera affichée au-dessus des miniatures, alors que la description basse sera affichée au-dessous (à l'emplacement normal de la description).

Insérer une catégorie

[cat=xx]

Cette balise permet d'insérer une catégorie dans la description, avec xx le numéro de la catégorie

Insérer une photo (à partie de la version 2.4.a)

[photo id=xx album=yy size=M html=yes link=yes]

Cette balise permet d'insérer une photo dans la description, avec :
- id le numéro de l'image
- album (facultatif) le numéro de l'album parent
- size (facultatif) la taille à afficher, à choisir parmi SQ, TH, XXS, XS, S, M, L, XL, XXL
- html (facultatif) si no la fonction renvoie seulement l'adresse de l'image
- link (facultatif) si yes l'image sera cliquable, vers sa page

[random album=xx size=M html=yes link=yes]

Permet d'insérer une photo aléatoire, avec :
- album le numéro de de la album dans lequel prendre la photo, si vous ne spécifiez pas album le plugin cherchera une photos parmi toutes celles de la galerie

Insérer un diaporama (à partir de la version 2.4.d)

[slider album=xx nb_images=10 random=no list=aa,bb,cc size=M speed=3 title=no effect=fade arrows=yes control=yes elastic=no thumbs_size=80]

Permet d'insérer un diaporama (NivoSlider), vous devez renseigner album OU list:
- album (facultatif) album source
- nb_images (facultatif) nombre maximal de photos dans le diaporama
- random (facultatif) choisir les photos aléatoirement dans l'album {yes, no}
- list (facultatif) une liste de photos séparées par une virgule
- size (facultatif) la taille des photos, parmi {SQ, TH, XXS, S, M, L, XL, XXL}
- speed (facultatif) la vitesse du diaporama (en secondes)
- title (facultatif) afficher le nom de la photo {yes, no}
- effect (facultatif) effet de transition (voir la doc NivoSlider)
- arrows (facultatif) afficher les flèches de navigations {yes, no}
- control (facultatif) afficher la barre de navigation {yes, no, thumb}
- elastic (facultatif) adapter la taille du diaporama à chaque photo {yes, no}
- thumbs_size (facultatif) taille en pixel des miniatures sir control=thumb

Masquer une catégorie

<!--hidden-->

Mettre la balise dans le nom de la catégorie:
- celle-ci ne sera plus affichée sur la page de la catégorie parente
- elle reste visible dans le menu des catégories

Masquer une catégorie dans le menu

<!--mb-hidden-->

Mettre la balise dans le nom de la catégorie:
- celle-ci ne sera plus affichée dans le menu des catégories
- elle reste visible sur la page de la catégorie parente

Masquer une image

<!--hidden-->

Mettre la balise dans le nom de l'image :
- celle-ci ne sera plus affichée sur la page des vignettes
- elle reste néanmoins visible au sein de la catégorie

Catégorie redirigée

[redirect http://piwigo.org]

Insérez cette balise dans la description d'une catégorie afin de la rediriger vers l'URL de votre choix.

[redirect img=xx]

Redirige vers une image de votre galerie où xx est l'identifiant de l'image; vous pouvez également préciser l'identifiant de la catégorie après le numéro de l'image: xx.ccc.

[redirect cat=xx]

Redirige vers une catégorie de votre galerie où xx est l'identifiant de la catégorie.

[redirect search=xx]

Redirige vers une page de recherche de votre galerie où xx est l'identifiant de la page de recherche.

 
Haut de page
plugins/ext_desc.txt · Dernière modification: 2013/12/23 14:09 par mistic100
 
 
github twitter facebook google+ newsletter Faire un don Piwigo.org © 2002-2017 · Contact