157 lines
9.2 KiB
HTML
157 lines
9.2 KiB
HTML
|
[(#REM)
|
||
|
|
|
||
|
|
Modèle «album» par défaut : vue sous forme de vignettes.
|
||
|
|
|
||
|
|
Cf. http://tinytypo.tetue.net/tinytypo.html#album
|
||
|
|
Ce modèle est plutôt destiné aux albums contenant des images.
|
||
|
|
Par défaut, l'affichage est volontairement minimaliste et les vignettes sont retaillées en hauteur.
|
||
|
|
Les paramètres permettent d'afficher des éléments supplémentaires (titre, descriptif, labels), de retailler et recadrer les vignettes,
|
||
|
|
de changer la position et le contenu de la légende, de changer la pagination, le tri, etc.
|
||
|
|
Des constantes de personnalisation permettent de définir des paramètres par défaut,
|
||
|
|
consulter le fichier `albums_options.php` pour la liste complète.
|
||
|
|
|
||
|
|
Utilisation :
|
||
|
|
- Dans un squelette : #MODELE{album, id_album=x} docs de l'album n°x
|
||
|
|
#MODELE{album, id_article=x} docs de l'article n°x
|
||
|
|
#MODELE{album, id=x-y-z-N} docs identifiés
|
||
|
|
- Dans un texte : <albumX>
|
||
|
|
<album|id_article=x>
|
||
|
|
<album|id=x,y,z,N>
|
||
|
|
|
||
|
|
Notes techniques diverses :
|
||
|
|
- Le squelette a l'air bien chevelu, mais à la base, le markup d'un album est hyper simple (cf. lien plus haut).
|
||
|
|
Comme il faut prendre en compte tous les paramètres possibles, assurer la rétrocompatibilité,
|
||
|
|
et gérer les petites incohérences des modèles, ça donne un truc bien dense.
|
||
|
|
- Attention, `id` et `id_article` sont utilisés comme paramètres dans la v1
|
||
|
|
mais en SPIP 3, ils peuvent se retrouver automatiquement dans l'environnement.
|
||
|
|
- Les vieux documents (issus d'avant SPIP 1.9) peuvent avoir un champ `media` vide.
|
||
|
|
|
||
|
|
|
||
|
|
][(#REM)
|
||
|
|
|
||
|
|
Paramètres :
|
||
|
|
id_album Identifiant d'un album.
|
||
|
|
titre Pour afficher le titre de l'album ou un titre personnalisé
|
||
|
|
valeurs : «oui» ou «true» pour le "vrai" titre de l'album.
|
||
|
|
n'importe quelle autre chaîne pour un titre personnalisé.
|
||
|
|
défaut : ''
|
||
|
|
balise_titre Balise dans laquelle encapsuler le titre, sans les chevrons.
|
||
|
|
ex. : «h3», «strong»...
|
||
|
|
défaut : _ALBUMS_BALISE_TITRE_VIGNETTES > _ALBUMS_BALISE_TITRE > strong
|
||
|
|
descriptif Pour afficher le descriptif de l'album
|
||
|
|
valeurs : «oui» ou «true»
|
||
|
|
défaut : ''
|
||
|
|
label Pour afficher le label de chaque document
|
||
|
|
valeurs : n'importe quelle chaîne (oui, true...)
|
||
|
|
défaut : ''
|
||
|
|
Attention, les noms de fichiers longs peuvent perturber l'agencement, prévoir des styles CSS supplémentaires.
|
||
|
|
largeur Largeur maximale des images (filtre image_reduire).
|
||
|
|
défaut : _ALBUMS_TAILLE_PREVIEW > taille des miniatures dans les options avancées > 0
|
||
|
|
hauteur Hauteur maximale des images (filtre image_reduire).
|
||
|
|
défaut : _ALBUMS_TAILLE_PREVIEW > taille des miniatures dans les options avancées > 150
|
||
|
|
recadrer Pour recadrer les images (filtre image_passe_partout + image_recadre).
|
||
|
|
valeurs : n'importe quelle chaîne (oui, true...)
|
||
|
|
défaut : _ALBUMS_RECADRER > ''
|
||
|
|
ratio Ratio utilisé pour recadrer
|
||
|
|
valeurs : 16/9, 2.21:1, 4-3 etc.
|
||
|
|
défaut : 1
|
||
|
|
par Tri des documents.
|
||
|
|
valeurs : id_document | titre | fichier | media | mode | extension | taille
|
||
|
|
défaut : media, fichier, titre
|
||
|
|
align Alignement du bloc conteneur (.album)
|
||
|
|
valeurs : left | right | center
|
||
|
|
défaut : ''
|
||
|
|
classe Classe(s) CSS supplémentaire(s) du bloc conteneur (.album)
|
||
|
|
pagination Pagination pour le nombre de documents affichés.
|
||
|
|
défaut : _ALBUMS_PAGINATION_VIGNETTES > _ALBUMS_PAGINATION > 20
|
||
|
|
pagination_type Type de pagination
|
||
|
|
valeurs : page | precedent_suivant | page_precedent_suivant
|
||
|
|
défaut : page
|
||
|
|
position_legende Emplacement de la légende (titre & descriptif) : en haut ou en bas de la liste.
|
||
|
|
valeurs : top | bottom
|
||
|
|
défaut : bottom
|
||
|
|
|
||
|
|
Dépréciés, pour rétro compatibilité avec les versions antérieures :
|
||
|
|
id sélection prédéfinie de documents, séparés par un caractère non alphanumérique.
|
||
|
|
id_article identifiant d'un article pour sélectionner ses documents.
|
||
|
|
balise_titraille = balise_titre
|
||
|
|
media pour restreindre à un type de document
|
||
|
|
|
||
|
|
][(#SET{has_titre, #EVAL{_ALBUMS_AFFICHER_TITRE}|ou{#ENV{titre}|oui}|et{#ENV{titre,oui}|=={non}|non}})][
|
||
|
|
(#SET{titre, #GET{has_titre}|?{#ENV{titre}|replace{'^(oui|non|true)$',''}|sinon{#INFO_TITRE{album,#ENV{id_album}}}}|trim})][
|
||
|
|
(#SET{has_descriptif, #EVAL{_ALBUMS_AFFICHER_DESCRIPTIF}|ou{#ENV{descriptif}|oui}|et{#ENV{descriptif}|=={non}|non}})][
|
||
|
|
(#SET{descriptif, #GET{has_descriptif}|?{#ENV{descriptif}|replace{'^(oui|non|true)$',''}|sinon{#INFO_DESCRIPTIF{album,#ENV{id_album}}}}|trim})][
|
||
|
|
(#SET{pagination, #ENV{pagination}|intval|sinon{#EVAL{_ALBUMS_PAGINATION_VIGNETTES}|intval}|sinon{#EVAL{_ALBUMS_PAGINATION}|intval}|sinon{20}})][
|
||
|
|
(#SET{balise_titre, #ENV*{balise_titre,#ENV*{balise_titraille,h2}}})][
|
||
|
|
(#SET{position_legende, #ENV{position_legende,top}|sinon{#EVAL{_ALBUMS_POSITION_LEGENDE_VIGNETTES}}|sinon{#EVAL{_ALBUMS_POSITION_LEGENDE}}|trim})][
|
||
|
|
(#SET{position_legende, #GET{position_legende}|in_array{#LISTE{top,bottom}}|?{#GET{position_legende},top}})][
|
||
|
|
(#SET{caption, #GET{has_titre}|ou{#GET{has_descriptif}}|?{
|
||
|
|
#GET{has_titre}|?{#GET{titre}|wrap{#VAL{'<'}|concat{#GET{balise_titre},' class="album-titre">'}}}
|
||
|
|
|concat{#GET{has_descriptif}|?{#GET{descriptif}|wrap{<div class="album-descriptif">}}}
|
||
|
|
|wrap{#VAL{'<div class="album-caption p '}|concat{#GET{position_legende},'">'}}}
|
||
|
|
|trim})][
|
||
|
|
(#SET{taille_preview, #CONFIG{taille_preview}|intval|sinon{#EVAL{_ALBUMS_TAILLE_PREVIEW}|intval}|sinon{150}})][
|
||
|
|
(#SET{recadrer, #ENV{recadrer,oui}|et{#ENV{recadrer,oui}|=={non}|non}?{' ',#EVAL{_ALBUMS_RECADRER}}})][
|
||
|
|
(#SET{ids_documents, #ARRAY})][
|
||
|
|
(#SET{source_docs, #ENV{id_album}|intval|?{album,
|
||
|
|
#VAL{/\W/}|preg_split{#ENV*{id}}|array_filter|count|>{1}?{id,
|
||
|
|
#ENV{id_article}|intval|?{article}}}})][
|
||
|
|
|
||
|
|
|
||
|
|
(#REM) 1. ID DOCUMENTS
|
||
|
|
|
||
|
|
|
||
|
|
][
|
||
|
|
(#REM) «id_album»
|
||
|
|
]<BOUCLE_album(ALBUMS){id_album}><BOUCLE_docs(DOCUMENTS){id_album}{par #ENV{par,media},titre}{tout}{media?}{si #GET{source_docs}|=={album}}
|
||
|
|
>#SET{ids_documents,#GET{ids_documents}|push{#ID_DOCUMENT}}</BOUCLE_docs></BOUCLE_album>[
|
||
|
|
(#REM) sinon «id_article»
|
||
|
|
]<BOUCLE_article(DOCUMENTS){id_article}{par #ENV{par,media},titre}{tout}{media?}{si #GET{source_docs}|=={article}}
|
||
|
|
>#SET{ids_documents,#GET{ids_documents}|push{#ID_DOCUMENT}}</BOUCLE_article>[
|
||
|
|
(#REM) sinon «id»
|
||
|
|
]<BOUCLE_id(CONDITION){si #GET{source_docs}|=={id}}
|
||
|
|
>#SET{ids_documents,#VAL{/\W/}|preg_split{#ENV*{id}}}</BOUCLE_id>[
|
||
|
|
|
||
|
|
|
||
|
|
(#REM) 2. ALBUM
|
||
|
|
|
||
|
|
|
||
|
|
]<B_documents_album>
|
||
|
|
<div class="album vignettes vue_icones clearfix figure p[ (#ENV{align})][ (#ENV{class})][ (#ENV{classe})]">
|
||
|
|
#ANCRE_PAGINATION[
|
||
|
|
(#GET{position_legende}|=={top}|oui)[(#GET{caption})]]
|
||
|
|
<ul class='thumbnails'>
|
||
|
|
<BOUCLE_documents_album(DOCUMENTS){id_document IN #GET{ids_documents}}{tout}{pagination #GET{pagination} #VAL{album}|concat{#ENV{id_album,x}}}>[
|
||
|
|
(#SET{titre_doc, #TITRE|sinon{#FICHIER|basename}})][
|
||
|
|
(#SET{titre_doc_long, #EVAL{_ALBUMS_TITRE_COURT}|?{#GET{titre_doc},#GET{titre_doc}|concat{' - ',#TYPE_DOCUMENT,' - ',#VAL{#TAILLE|taille_en_octets},#MEDIA|=={image}|?{#VAL{' - '}|concat{#LARGEUR,'×',#HAUTEUR,' px'}}}}})][
|
||
|
|
(#SET{ratio, #GET{recadrer}|?{#VAL{/\[-:\/\]/}|preg_split{#ENV*{ratio,1}}}})][
|
||
|
|
(#SET{ratio, #GET{ratio}|count|>{1}|?{#GET{ratio/1}|div{#GET{ratio/0}},#GET{ratio/0}}|floatval})][
|
||
|
|
(#SET{ratio, #GET{ratio}|sinon{#LARGEUR|div{#HAUTEUR}}|floatval})][
|
||
|
|
(#SET{largeur, #ENV{largeur}|sinon{#ENV{hauteur}|div{#GET{ratio}}}|sinon{#GET{taille_preview}}|intval})][
|
||
|
|
(#SET{hauteur, #ENV{hauteur,#GET{largeur}|mult{#GET{ratio}}}|intval})][
|
||
|
|
(#SET{extension, #EXTENSION|sinon{#FICHIER|pathinfo|table_valeur{extension}}})][
|
||
|
|
(#SET{logo, #MEDIA|=={image}|?{
|
||
|
|
#GET{recadrer}|?{
|
||
|
|
#FICHIER|image_passe_partout{#GET{largeur},#GET{hauteur}}|image_recadre{#GET{largeur},#GET{hauteur},center,transparent},
|
||
|
|
#FICHIER|image_reduire{#GET{largeur},#GET{hauteur}}},
|
||
|
|
#LOGO_DOCUMENT}})]
|
||
|
|
<li class="list-unstyled">
|
||
|
|
<figure class="thumbnail">
|
||
|
|
<a href="#URL_DOCUMENT" type="#MIME_TYPE" rel="album#ID_ALBUM" class="[(#EXPOSER) ][(#EXTENSION) ]"[ title="(#TITRE|attribut_html|couper{80})"]>
|
||
|
|
[(#GET{logo}
|
||
|
|
|inserer_attribut{class,spip_logo spip_logos vignette}
|
||
|
|
|inserer_attribut{alt,[(#TITRE|attribut_html|couper{60})]})]
|
||
|
|
[(#ENV{label,oui}|=={non}|non)
|
||
|
|
<figcaption class='caption'>[(#TITRE)]</figcaption>
|
||
|
|
]
|
||
|
|
</a>
|
||
|
|
</figure>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
</BOUCLE_documents_album>
|
||
|
|
</ul>[
|
||
|
|
<div class='pagination'>(#PAGINATION{#ENV{pagination_type,page}})</div>][
|
||
|
|
(#GET{position_legende}|=={bottom}|oui)[(#GET{caption})]]
|
||
|
|
</div><!-- .album.vignettes -->
|
||
|
|
</B_documents_album>
|