Filtre vignette pour trouver la vignette d'un type de fichier, avec [(#EXTENSION|vignette)]

inc/vignette.php

@@ -9,18 +9,32 @@
  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
 \***************************************************************************/
 
+/**
+ * Gestion des vignettes de types de fichier
+ *
+ * @package SPIP\Medias\Vignette
+**/
+
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
 /**
- * Vignette pour les documents lies
- * rechercher les fichiers d'icone au format png pour l'extension demandee
- *
- * on cherche prive/vignettes/ext.png dans le path
+ * Vignette pour une extension de document
+ * 
+ * Recherche les fichiers d'icones au format png pour l'extension demandée.
+ * On cherche prive/vignettes/ext.png dans le path.
  *
  * @param string $ext
+ *     Extension du fichier. Exemple : png
  * @param bool $size
+ *     true pour retourner un tableau avec les tailles de la vignette
+ *     false pour retourner uniquement le chemin du fichier
  * @param bool $loop
- * @return array|bool|int|string
+ *     Autoriser la fonction à s'appeler sur elle-même
+ *     (paramètre interne).
+ * @return array|bool|string
+ *     False si l'image n'est pas trouvée
+ *     Chaîne (chemin vers l'image) si on ne demande pas de taille
+ *     Tableau (chemin, largeur, hauteur) si on demande avec la taille.
  */
 function inc_vignette_dist($ext, $size=true, $loop = true) {
 

medias_fonctions.php

@@ -10,11 +10,14 @@
  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
 \***************************************************************************/
 
+/**
+ * Fonctions utiles pour les squelettes et déclarations de boucle
+ * pour le compilateur
+ *
+ * @package SPIP\Medias\Fonctions
+**/
 
-//
-// Ce fichier definit les boucles standard de SPIP
-//
-
+// sécurité
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
 
@@ -160,4 +163,43 @@ function critere_DOCUMENTS_carre_dist($idb, &$boucles, $crit) {
 	$not = ($crit->not?"NOT ":"");
 	$boucle->where[] = "'$not($table.largeur>0 AND $table.largeur = $table.hauteur)'";
 }
+
+
+/**
+ * Calcule la vignette d'une extension (l'image du type de fichier)
+ *
+ * Utile dans une boucle DOCUMENTS pour afficher une vignette du type
+ * du document (#EXTENSION) alors que ce document a déjà une vignette
+ * personnalisée (affichable par #LOGO_DOCUMENT).
+ * 
+ * @example
+ *     [(#EXTENSION|vignette)] produit une balise <img ... />
+ *     [(#EXTENSION|vignette{true})] retourne le chemin de l'image
+ *
+ * @param string $extension
+ *     L'extension du fichier, exemple : png ou pdf
+ * @param bool $get_chemin
+ *     false pour obtenir une balise img de l'image,
+ *     true pour obtenir seulement le chemin du fichier
+ * @return string
+ *     Balise HTML <img...> ou chemin du fichier
+**/
+function filtre_vignette_dist($extension='defaut', $get_chemin = false) {
+	static $vignette = false;
+	static $balise_img = false;
+
+	if (!$vignette) {
+		$vignette = charger_fonction('vignette', 'inc');
+		$balise_img = charger_filtre('balise_img');
+	}
+
+	$fichier = $vignette($extension, false);
+	// retourne simplement le chemin du fichier
+	if ($get_chemin) {
+		return $fichier;
+	}
+	// retourne une balise <img ... />
+	return $balise_img($fichier);
+}
+
 ?>

paquet.xml

 <paquet
 	prefix="medias"
 	categorie="multimedia"
-	version="2.7.33"
+	version="2.7.34"
 	etat="stable"
 	compatibilite="[3.0.0;3.1.*]"
 	logo="prive/themes/spip/images/portfolio-32.png"