From f836414c9c3a0b8e330d3501a6c6f0e0a9003ba3 Mon Sep 17 00:00:00 2001
From: Cerdic <cedric@yterium.com>
Date: Thu, 21 Oct 2021 10:20:42 +0200
Subject: [PATCH] PHPDoc de medias_trouver_modele_emb() Fix #4847
---
medias_fonctions.php | 24 +++++++++++++++++-------
1 file changed, 17 insertions(+), 7 deletions(-)
diff --git a/medias_fonctions.php b/medias_fonctions.php
index 923049fe..34dbe126 100644
--- a/medias_fonctions.php
+++ b/medias_fonctions.php
@@ -371,14 +371,24 @@ function duree_en_secondes($duree, $precis = false) {
* - avec une extension
* - avec un mime_type donne
*
- * => modeles/{modele_base}_emb_html.html si il existe
- * => modeles/{modele_base}_text_html.html si il existe,
- * => modeles/{modele_base}_text.html si il existe,
- * => modeles/{modele_base}.html sinon
+ * En priorité :
+ * - modeles/{modele_base}_emb_{extension}.html si il existe
+ * - modeles/{modele_base}_emb_{mimetype}.html si il existe,
+ * dans {mimetype}, les caractères non alphanumériques (typiquement '/') ont été remplacés par '_'.
+ * Par exemple "text/css" devient "text_css"
+ * - modeles/{modele_base}_emb_{mimetypeprincipal}.html si il existe
+ * {mimetypeprincipal} est la partie du mimetype avant le '/'. C'est par exemple 'text' pour 'text/css'
+ * - modeles/{modele_base} sinon
*
- * @param $extension
- * @param $mime_type
- * @return mixed
+ * Pour une image jpg cela donne par priorité :
+ * modeles/image_emb_jpg.html
+ * modeles/image_emb_image_jpeg.html
+ * modeles/image_emb_image.html
+ * modeles/image.html
+ *
+ * @param string $extension
+ * @param string $mime_type
+ * @return string
*/
function medias_trouver_modele_emb($extension, $mime_type, $modele_base='file') {
if ($extension and trouve_modele($fond = $modele_base . '_emb_' . $extension)) {
--
GitLab