un exemple de squelette SPIP3 expliqué

La gestion privée de la médiathèque SPIP 3

  une page privée performante construite sur UNE boucle

Avant la refonte complémentaire de la médiathèque, concomitante à l’intégration des Logos en Documents, examinons cette unique et simple Boucle !

Article publié le 31 décembre 2021, et actualisé en décembre 2021

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

La médiathèque regroupe dans une interface unifiée la gestion annexe de tous les fichiers informatiques joints aux objets éditoriaux de SPIP ; mais noter qu’actuellement un "DOCUMENT" n’est pas vraiment un objet éditorial, car il n’est pas nativement publiable indépendamment de son/ses objet(s) de rattachement !

 La boucle de la Galerie médiathèque

Cette gestion longtemps parcellaire est intégrée depuis SPIP 3 dans une page centrale unique :
Considérez celle-ci dans l’espace privé, et toutes les possibilités présentées dans la navigation du milieu de page :

Medias3 gestion_documents

Toute la puissance de SPIP s’y résume,car cette gestion est construite autour d’une simple unique boucle (DOCUMENTS) !
On peut facilement analyser son source en rajoutant le fameux &var_mode=inclure à l’URL utilisée dans la barre d’adresse : la copie d’ecran ci-dessous nous indique les deux noisettes
mediatheque-galerie.html et mediatheque-navigation.html.

Medias3 {les} inclure

Pour consulter le code, reportons-nous à https://git.spip.net/spip/medias/src/branch/master/prive/squelettes/inclure/mediatheque-galerie.html#L18 [1] .

Medias3 navigation

Mode d’emploi de la boucle :
<BOUCLE_galerie(DOCUMENTS) {id_rubrique ?}{id_article ?}{id_breve ?}{id_document ?}{recherche ?} {tri id_document,inverse}{media?}{extension?}{distant?}{brise?}{statut==#ENV{statut,.*}}{orphelins?}{titre==(#ENV{sanstitre}|?{'^$','.*'})}{id_vignette==(#ENV{sansvignette}|?{'^0','.*'})}{pagination #ENV{pagination,10}}>

- On remarque d’abord la liste de clés optionnelles,
{id_rubrique ?}{id_article ?}{id_breve ?}{id_document ?} (manque id_mot [2]
qui permettrait de ré-utiliser cet afficheur avec des liens plus précis (non actuellement prévus dans l’interface) passés par l’URL : ainsi rajouter un &id_rubrique=33 limitera l’affichage aux documents de cette rubrique.

- La boucle de page propose une variété de types de filtres logiques :
{media?}{extension?}{distant?}{brise?}

- les tris (par défaut {tri id_document,inverse} ) sont accessibles par la suite de lignes ci-dessous correspondant au bandeau :

Medias3 tris et pagination
[(#TRI{'>',#CHEMIN_IMAGE{tri-asc-16.png}
|balise_img{<:par_tri_croissant:>}}) |]
[(#TRI{'<',#CHEMIN_IMAGE{tri-desc-16.png}|
balise_img{<:par_tri_decroissant:>}}) |]
[(#TRI{id_document,<:medias:par_id:>}) |]
[(#TRI{date,<:medias:par_date:>}) |]
[(#TRI{taille,<:medias:par_taille:>}) |]
[(#TRI{largeur,<:medias:par_largeur:>}) |]
[(#TRI{hauteur,<:medias:par_hauteur:>}) |]
[(#TRI{titre,<:medias:par_titre:>}) |]

- d’autres critères de sélection sont accessibles : il faut juste en fournir une valeur dans l’URL ... :
{statut==#ENV{statut,.*}}{orphelins?}{titre==(#ENV{sanstitre}|?{'^$','.*'})}{id_vignette==(#ENV{sansvignette}|?{'^0','.*'})}
Le pilotage de ces paramètres est passé par le chapeau de navigation...voir git.spip.net/spip/medias/.../prive/squelettes/inclure/mediatheque-navigation.html

 Quelques constats /SPIP 3.2.12

- il n’est (actuellement) pas prévu de rattacher un Logo ou une vignette depuis la médiathèque,ni depuis Internet.
=> on s’attend à voir des boites de téléchargement (Logo / Document / Vignette) homogènes, avec les 4 sources proposées : Ordinateur, Serveur, Mediathèque, Internet.
- une vignette personnalisée de document n’est pas accessible dans la médiathèque
- "changer" le fichier (aussi pour une vignette), meme en gardant le meme nom de fichier introduit un changement au nom du fichier réellement enregistré dans /IMG/../ en ajoutant un suffixe -2 ou -r90 en cas de rotation..
- un raccourci <docXX> introduit manuellement dans le texte d’un article provoque le rattachement automatique du document aussi à cet article (?)
- rattacher par ce moyen une vignette (utilisée comme illustration) ne déclenche, ni rattachement, ni apparition de l’image (’vignette’ promue ’image’) dans la médiathèque.

Comme précisé,la rédaction de cet article correspond à une volonté d’épuration, demandée [3] à un Webmestre débutant reprenant un vieux site (15 ans ; 900 articles ; 2500 documents dont approximativement un millier d’images en double ou plus.... rechargées avec des définitions différentes...
Cette démarche a justifié l’ajout d’un tri par #FICHIER pour regrouper et mieux mutualiser les images ...
Car il existe déjà une sélection par extension plus précise (.PDF,.ePUB..), qui apparait lors d’un clic sur l’onglet Autres ; à préciser comment compléter ce second filtre si besoins...
Reste à intégrer une restriction et/ou par mots-clés [4]


Merci de nous signaler les coquilles, imprécisions ou erreurs qui figureraient dans cette page.

[1(+) l’amélioration souhaitée se borne à rajouter +18.1 [(#TRI{fichier,<:medias:par_nom_du_fichier:>}) |] et vous verrez ici la modification obtenue

Medias3 améliorée
Une seule petite ligne ajoutée [(#TRI{fichier,<:medias:par_nom_du_fichier:>}) |]
Puissance de SPIP !

[2Mais l’évolution SPIP 4 autorisant un id_ générique... va simplifier tout !

[3avant la bascule SPIP4 des LOGOS en Documents

[4Un usage serait de présélectionner des images d’illustration souvent utilisées comme séparateurs dans les articles..


Liens A2A visibles seulement pour les inscrits.
Liens visibles seulement pour les inscrits.

Article publié le 31 décembre 2021, et actualisé en décembre 2021 .

Répondre à cet article