source: extensions/ExtendedDescription/language/fr_FR/help.html @ 17010

<div style="text-align:left;">
<h2>Extended Description</h2>

<h3>Descriptions multilingues</h3>

<p>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]</p>

<ul>
  <li><b>Exemple d'utilisation</b>:<br>
<code>[lang=default] description par défaut [/lang]<br>
[lang=fr] description en francais [/lang]<br>
[lang=it] description en italien [/lang]</code>
</li>
</ul>

<p>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.</p>

<p><u>Balise <i>all</i></u>: 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.</p>


<h3>Descriptions étendues</h3>

<p>Les balises de description étendue permettent d'avoir une description réduite pour la présentation d'un album,
une description étendue pour la description qui s'affiche sur la page de l'album,
ou deux descriptions différentes sur la page de l'album.</p>

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

<ul>
  <li><b>&lt;!--more--&gt;</b></li>
</ul>
<code>description réduite &lt;!--more--&gt; description détaillée</code>
<p>Seule la description réduite sera affichée pour la présentation de l'album.
Sur l'album lui-même, la description sera la description réduite + la description détaillée.</p>

<ul>
  <li><b>&lt;!--complete--&gt;</b></li>
</ul>
<code>description réduite &lt;!--complete--&gt; description détaillée</code>
<p>Seule la description réduite sera affichée pour la présentation de l'album.
Par contre, sur l'album lui-même, la description sera uniquement la description détaillée, soit 2 descriptions différentes.</p>

<ul>
  <li><b>&lt;!--up-down--&gt;</b></li>
</ul>
<code>description haute &lt;!--up-down--&gt; description basse</code>
<p>Seule la description haute sera affichée pour la présentation de l'album.
Sur l'album lui-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).</p>


<h3>Insérer un album ou une photo</h3>

<ul>
  <li><b>[cat=xx]</b></li>
</ul>
<p>Cette balise permet d'insérer un album dans la description, avec xx le numéro de l'album</p>

<ul>
  <li><b>[img=xx1 xx2 xx3 xxN;yyyy;name]</b></li>
</ul>
<p>Cette balise permet d'insérer une ou plusieurs vignettes dans la description, avec :<br><br>
- xx le numéro de la photo ; il est possible de préciser le numéro de l'album parent après le numéro : <code>xx.ccc</code>.<br/>
- yyyy (facultatif) prend soit la valeur <i>left</i>, soit la valeur <i>right</i> et permet de positionner la vignette de l'image sur la droite ou la gauche.<br/>
- name (facultatif) prend soit la valeur <i>name</i>, soit la valeur <i>titleName</i> ; avec <i>name</i> le nom de la photo sera affiché sous la vignette, avec <i>titleName</i> le nom de la photo est renseigné dans la balise <i>&lt;title&gt;</i> de celle-ci.</p>

<ul>
  <li><b>[photo id=xx album=yy size=M html=yes link=yes]</b></li>
</ul>
<p>Cette balise permet d'insérer une photo de n'importe quelle taille, avec:<br><br>
- <code>id</code> le numéro de la photo<br>
- <code>album</code> (facultatif) le numéro de l'album parent<br>
- <code>size</code> (facultatif) la taille de la photo, parmi <i>{SQ, TH, XXS, S, M, L, XL, XXL}</i><br>
- <code>html</code> (facultatif) si <i>no</i>, la balise ne retourne que l'URL de la photo, sans HTML<br>
- <code>link</code> (facultatif) si <i>yes</i>, la photo est cliquable, vers sa page</p>

<ul>
  <li><b>[random album=yy size=M html=yes link=yes]</b></li>
</ul>
<p>Même chose, sauf que la photo est prise aléatoirement dans <code>album</code></p>

<ul>
  <li><b>[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]</b></li>
</ul>
<p>Permet d'insérer un diaporama (NivoSlider), avec (vous devez renseigner <code>album</code> OU <code>list</code>):<br><br>
- <code>album</code> (facultatif) album source<br>
- <code>nb_images</code> (facultatif) nombre maximal de photos dans le diaporama<br>
- <code>random</code> (facultatif) choisir les photos aléatoirement dans l'album<br>
- <code>list</code> (facultatif) une liste de photos séparées par une virgule<br>
- <code>size</code> (facultatif) la taille des photos, parmi <i>{SQ, TH, XXS, S, M, L, XL, XXL}</i><br>
- <code>speed</code> (facultatif) la vitesse du diaporama (en secondes)<br>
- <code>title</code> (facultatif) afficher le nom de la photo<br>
- <code>effect</code> (facultatif) effet de transition (voir <a href="http://nivo.dev7studios.com/support/jquery-plugin-usage/">la doc de NivoSlider</a>)<br>
- <code>arrows</code> (facultatif) afficher les flèches de navigations<br>
- <code>control</code> (facultatif) afficher la barre de navigation<br>
- <code>elastic</code> (facultatif) adapter la taille du diaporama à chaque photo</p>


<h3>Masquer un album</h3>

<p>Balise <b>&lt;!--hidden--&gt;</b> dans le nom de l'album :<br>
<br>
- celui-ci ne sera plus affichée sur la page de l'album parent<br>
- il reste visible dans le menu des albums</p>

<h3>Masquer un album dans le menu</h3>

<p>Balise <b>&lt;!--mb-hidden--&gt;</b> dans le nom de l'album :<br>
<br>
- celui-ci ne sera plus affichée dans le menu des albums<br>
- il reste visible sur la page de l'album parent</p>

<h3>Masquer une photo</h3>

<p>Balise <b>&lt;!--hidden--&gt;</b> dans le nom de la photo :<br>
<br>
- celle-ci ne sera plus affichée sur la page des vignettes<br>
- elle reste néanmoins visible au sein de l'album</p>

<h3>Album redirigé</h3>

<ul>
  <li><b>[redirect http://piwigo.org]</b></li>
</ul>
<p>Insérez cette balise dans la description d'un album afin de le rediriger vers l'URL de votre choix.</p>

<ul>
  <li><b>[redirect img=xx]</b></li>
</ul>
<p>Redirige vers une photo de votre galerie où xx est l'identifiant de celle-ci; vous pouvez également préciser l'identifiant de l'album après le numéro de la photo : <code>xx.ccc</code>.</p>

<ul>
  <li><b>[redirect cat=xx]</b></li>
</ul>
<p>Redirige vers un album de votre galerie où xx est l'identifiant de celui-ci.</p>

<ul>
  <li><b>[redirect search=xx]</b></li>
</ul>
<p>Redirige vers une page de recherche de votre galerie où xx est l'identifiant de la page de recherche.</p>
</div>