www/ecrire/inc/filtres.php

   1 <?php
   2
   3 /***************************************************************************\
   4  *  SPIP, Systeme de publication pour l'internet                           *
   5  *                                                                         *
   6  *  Copyright (c) 2001-2012                                                *
   7  *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
   8  *                                                                         *
   9  *  Ce programme est un logiciel libre distribue sous licence GNU/GPL.     *
  10  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
  11 \***************************************************************************/
  12
  13 if (!defined('_ECRIRE_INC_VERSION')) return;
  14
  15 include_spip('inc/charsets');
  16 include_spip('inc/filtres_mini');
  17 include_spip('base/objets');
  18 include_spip('public/parametrer'); // charger les fichiers fonctions
  19
  20 /**
  21  * Charger un filtre depuis le php :
  22  * - on inclue tous les fichiers fonctions des plugins et du skel
  23  * - on appelle chercher_filtre
  24  *
  25  * @param string $fonc
  26  * @param string $default
  27  * @return string
  28  */
  29 function charger_filtre($fonc, $default='filtre_identite_dist') {
  30         include_spip('public/parametrer'); // inclure les fichiers fonctions
  31         return chercher_filtre($fonc, $default);
  32 }
  33
  34 function filtre_identite_dist($texte){return $texte;}
  35
  36 /**
  37  * http://doc.spip.org/@chercher_filtre
  38  *
  39  * @param string $fonc
  40  * @param null $default
  41  * @return string
  42  */
  43 function chercher_filtre($fonc, $default=NULL) {
  44         if (!$fonc) return $default;
  45         // Cas des types mime, sans confondre avec les appels de fonction de classe
  46         // Foo::Bar
  47         // qui peuvent etre avec un namespace : space\Foo::Bar
  48         if (preg_match(',^[\w]+/,',$fonc)){
  49                 $nom = preg_replace(',\W,','_', $fonc);
  50                 $f = chercher_filtre($nom);
  51                 // cas du sous-type MIME sans filtre associe, passer au type:
  52                 // si filtre_text_plain pas defini, passe a filtre_text
  53                 if (!$f AND $nom!==$fonc)
  54                         $f = chercher_filtre(preg_replace(',\W.*$,','', $fonc));
  55                 return $f;
  56         }
  57         foreach (
  58         array('filtre_'.$fonc, 'filtre_'.$fonc.'_dist', $fonc) as $f){
  59                 if (isset( $GLOBALS['spip_matrice'][$f]) AND is_string($g = $GLOBALS['spip_matrice'][$f]))
  60                         find_in_path($g,'', true);
  61                 if (function_exists($f)
  62                 OR (preg_match("/^(\w*)::(\w*)$/", $f, $regs)
  63                         AND is_callable(array($regs[1], $regs[2]))
  64                 )) {
  65                         return $f;
  66                 }
  67         }
  68         return $default;
  69 }
  70
  71 /**
  72  * Applique un filtre
  73  *
  74  * Fonction générique qui prend en argument l’objet (texte, etc) à modifier
  75  * et le nom du filtre. Retrouve les arguments du filtre demandé dans les arguments
  76  * transmis à cette fonction, via func_get_args().
  77  *
  78  * @see filtrer() Assez proche
  79  *
  80  * @param string $arg
  81  *     Texte sur lequel appliquer le filtre
  82  * @param string $filtre
  83  *     Nom du filtre a appliquer
  84  * @param string $force
  85  *     La fonction doit-elle retourner le texte ou rien ?
  86  * @return string
  87  *     Texte avec le filtre appliqué s'il a été trouvé,
  88  *     Texte sans le filtre appliqué s'il n'a pas été trouvé et que $force n'a
  89  *       pas été fourni,
  90  *     Chaîne vide si le filtre n'a pas été trouvé et que $force a été fourni.
  91 **/
  92 function appliquer_filtre($arg, $filtre, $force=NULL) {
  93         $f = chercher_filtre($filtre);
  94         if (!$f) {
  95                 if (!$force) return '';
  96                 else return $arg;
  97         }
  98
  99         $args = func_get_args();
 100         array_shift($args); // enlever $arg
 101         array_shift($args); // enlever $filtre
 102         array_unshift($args, $arg); // remettre $arg
 103         return call_user_func_array($f,$args);
 104 }
 105
 106 // http://doc.spip.org/@spip_version
 107 function spip_version() {
 108         $version = $GLOBALS['spip_version_affichee'];
 109         if ($svn_revision = version_svn_courante(_DIR_RACINE))
 110                 $version .= ($svn_revision<0 ? ' SVN':'').' ['.abs($svn_revision).']';
 111         return $version;
 112 }
 113
 114
 115 //
 116 // Mention de la revision SVN courante de l'espace restreint standard
 117 // (numero non garanti pour l'espace public et en cas de mutualisation)
 118 // on est negatif si on est sur .svn, et positif si on utilise svn.revision
 119 // http://doc.spip.org/@version_svn_courante
 120 function version_svn_courante($dir) {
 121         if (!$dir) $dir = '.';
 122
 123         // version installee par paquet ZIP
 124         if (lire_fichier($dir.'/svn.revision', $c)
 125         AND preg_match(',Revision: (\d+),', $c, $d))
 126                 return intval($d[1]);
 127
 128         // version installee par SVN
 129         if (lire_fichier($dir . '/.svn/entries', $c)
 130         AND (
 131         (preg_match_all(
 132         ',committed-rev="([0-9]+)",', $c, $r1, PREG_PATTERN_ORDER)
 133         AND $v = max($r1[1])
 134         )
 135         OR
 136         (preg_match(',^\d.*dir[\r\n]+(\d+),ms', $c, $r1) # svn >= 1.4
 137         AND $v = $r1[1]
 138         )))
 139                 return -$v;
 140
 141         // Bug ou paquet fait main
 142         return 0;
 143 }
 144
 145 // La matrice est necessaire pour ne filtrer _que_ des fonctions definies dans filtres_images
 146 // et laisser passer les fonctions personnelles baptisees image_...
 147 $GLOBALS['spip_matrice']['image_graver'] = true;//'inc/filtres_images_mini.php';
 148 $GLOBALS['spip_matrice']['image_select'] = true;//'inc/filtres_images_mini.php';
 149 $GLOBALS['spip_matrice']['image_reduire'] = true;//'inc/filtres_images_mini.php';
 150 $GLOBALS['spip_matrice']['image_reduire_par'] = true;//'inc/filtres_images_mini.php';
 151 $GLOBALS['spip_matrice']['image_passe_partout'] = true;//'inc/filtres_images_mini.php';
 152
 153 $GLOBALS['spip_matrice']['couleur_html_to_hex'] = 'inc/filtres_images_mini.php';
 154 $GLOBALS['spip_matrice']['couleur_foncer'] = 'inc/filtres_images_mini.php';
 155 $GLOBALS['spip_matrice']['couleur_eclaircir'] = 'inc/filtres_images_mini.php';
 156
 157 // ou pour inclure un script au moment ou l'on cherche le filtre
 158 $GLOBALS['spip_matrice']['filtre_image_dist'] = 'inc/filtres_mime.php';
 159 $GLOBALS['spip_matrice']['filtre_audio_dist'] = 'inc/filtres_mime.php';
 160 $GLOBALS['spip_matrice']['filtre_video_dist'] = 'inc/filtres_mime.php';
 161 $GLOBALS['spip_matrice']['filtre_application_dist'] = 'inc/filtres_mime.php';
 162 $GLOBALS['spip_matrice']['filtre_message_dist'] = 'inc/filtres_mime.php';
 163 $GLOBALS['spip_matrice']['filtre_multipart_dist'] = 'inc/filtres_mime.php';
 164 $GLOBALS['spip_matrice']['filtre_text_dist'] = 'inc/filtres_mime.php';
 165 $GLOBALS['spip_matrice']['filtre_text_csv_dist'] = 'inc/filtres_mime.php';
 166 $GLOBALS['spip_matrice']['filtre_text_html_dist'] = 'inc/filtres_mime.php';
 167 $GLOBALS['spip_matrice']['filtre_audio_x_pn_realaudio'] = 'inc/filtres_mime.php';
 168
 169
 170 // charge les fonctions graphiques et applique celle demandee
 171 // http://doc.spip.org/@filtrer
 172 function filtrer($filtre) {
 173         if (isset($GLOBALS['spip_matrice'][$filtre]) and is_string($f = $GLOBALS['spip_matrice'][$filtre])){
 174                 find_in_path($f,'', true);
 175                 $GLOBALS['spip_matrice'][$filtre] = true;
 176         }
 177         $tous = func_get_args();
 178         if (substr($filtre,0,6)=='image_' && $GLOBALS['spip_matrice'][$filtre])
 179                 return image_filtrer($tous);
 180         elseif($f = chercher_filtre($filtre)) {
 181                 array_shift($tous);
 182                 return call_user_func_array($f, $tous);
 183         }
 184         else {
 185                 // le filtre n'existe pas, on provoque une erreur
 186                 $msg = array('zbug_erreur_filtre', array('filtre'=>texte_script($filtre)));
 187                 erreur_squelette($msg);
 188                 return '';
 189         }
 190 }
 191
 192 // fonction generique d'entree des filtres images
 193 // accepte en entree un texte complet, un img-log (produit par #LOGO_XX),
 194 // un tag <img ...> complet, ou encore un nom de fichier *local* (passer
 195 // le filtre |copie_locale si on veut l'appliquer a un document)
 196 // applique le filtre demande a chacune des occurrences
 197
 198 // http://doc.spip.org/@image_filtrer
 199 function image_filtrer($args){
 200         $filtre = array_shift($args); # enlever $filtre
 201         $texte = array_shift($args);
 202         if (!strlen($texte)) return;
 203         find_in_path('filtres_images_mini.php','inc/', true);
 204         statut_effacer_images_temporaires(true); // activer la suppression des images temporaires car le compilo finit la chaine par un image_graver
 205         // Cas du nom de fichier local
 206         if ( strpos(substr($texte,strlen(_DIR_RACINE)),'..')===FALSE
 207         AND !preg_match(',^/|[<>]|\s,S', $texte)
 208         AND (
 209                 file_exists(preg_replace(',[?].*$,','',$texte))
 210                 OR preg_match(';^(\w{3,7}://);', $texte)
 211                 )) {
 212                 array_unshift($args,"<img src='$texte' />");
 213                 $res = call_user_func_array($filtre, $args);
 214                 statut_effacer_images_temporaires(false); // desactiver pour les appels hors compilo
 215                 return $res;
 216         }
 217
 218         // Cas general : trier toutes les images, avec eventuellement leur <span>
 219         if (preg_match_all(
 220                 ',(<([a-z]+) [^<>]*spip_documents[^<>]*>)?\s*(<img\s.*>),UimsS',
 221                 $texte, $tags, PREG_SET_ORDER)) {
 222                 foreach ($tags as $tag) {
 223                         $class = extraire_attribut($tag[3],'class');
 224                         if (!$class || (strpos($class,'no_image_filtrer')===FALSE)){
 225                                 array_unshift($args,$tag[3]);
 226                                 if ($reduit = call_user_func_array($filtre, $args)) {
 227                                         // En cas de span spip_documents, modifier le style=...width:
 228                                         if($tag[1]){
 229                                                 $w = extraire_attribut($reduit, 'width');
 230                                                 if (!$w AND preg_match(",width:\s*(\d+)px,S",extraire_attribut($reduit,'style'),$regs))
 231                                                         $w = $regs[1];
 232                                                 if ($w AND ($style = extraire_attribut($tag[1], 'style'))){
 233                                                         $style = preg_replace(",width:\s*\d+px,S", "width:${w}px", $style);
 234                                                         $replace = inserer_attribut($tag[1], 'style', $style);
 235                                                         $texte = str_replace($tag[1], $replace, $texte);
 236                                                 }
 237                                         }
 238                                         // traiter aussi un eventuel mouseover
 239                                         if ($mouseover = extraire_attribut($reduit,'onmouseover')){
 240                                                 if (preg_match(",this[.]src=['\"]([^'\"]+)['\"],ims", $mouseover, $match)){
 241                                                         $srcover = $match[1];
 242                                                         array_shift($args);
 243                                                         array_unshift($args,"<img src='".$match[1]."' />");
 244                                                         $srcover_filter = call_user_func_array($filtre, $args);
 245                                                         $srcover_filter = extraire_attribut($srcover_filter,'src');
 246                                                         $reduit = str_replace($srcover,$srcover_filter,$reduit);
 247                                                 }
 248                                         }
 249                                         $texte = str_replace($tag[3], $reduit, $texte);
 250                                 }
 251                                 array_shift($args);
 252                         }
 253                 }
 254         }
 255         statut_effacer_images_temporaires(false); // desactiver pour les appels hors compilo
 256         return $texte;
 257 }
 258
 259 //
 260 // Retourner taille d'une image
 261 // pour les filtres |largeur et |hauteur
 262 //
 263 // http://doc.spip.org/@taille_image
 264 function taille_image($img) {
 265
 266         static $largeur_img =array(), $hauteur_img= array();
 267         $srcWidth = 0;
 268         $srcHeight = 0;
 269
 270         $logo = extraire_attribut($img,'src');
 271
 272         if (!$logo) $logo = $img;
 273         else {
 274                 $srcWidth = extraire_attribut($img,'width');
 275                 $srcHeight = extraire_attribut($img,'height');
 276         }
 277
 278         // ne jamais operer directement sur une image distante pour des raisons de perfo
 279         // la copie locale a toutes les chances d'etre la ou de resservir
 280         if (preg_match(';^(\w{3,7}://);', $logo)){
 281                 include_spip('inc/distant');
 282                 $fichier = copie_locale($logo);
 283                 $logo = $fichier ? _DIR_RACINE . $fichier : $logo;
 284         }
 285         if (($p=strpos($logo,'?'))!==FALSE)
 286                 $logo=substr($logo,0,$p);
 287
 288         $srcsize = false;
 289         if (isset($largeur_img[$logo]))
 290                 $srcWidth = $largeur_img[$logo];
 291         if (isset($hauteur_img[$logo]))
 292                 $srcHeight = $hauteur_img[$logo];
 293         if (!$srcWidth OR !$srcHeight){
 294                 if (file_exists($logo)
 295                         AND $srcsize = @getimagesize($logo)){
 296                         if (!$srcWidth) $largeur_img[$logo] = $srcWidth = $srcsize[0];
 297                         if (!$srcHeight)        $hauteur_img[$logo] = $srcHeight = $srcsize[1];
 298                 }
 299                 // $logo peut etre une reference a une image temporaire dont a n'a que le log .src
 300                 // on s'y refere, l'image sera reconstruite en temps utile si necessaire
 301                 elseif(@file_exists($f = "$logo.src")
 302                   AND lire_fichier($f,$valeurs)
 303                   AND $valeurs=unserialize($valeurs)) {
 304                         if (!$srcWidth) $largeur_img[$logo] = $srcWidth = $valeurs["largeur_dest"];
 305                         if (!$srcHeight)        $hauteur_img[$logo] = $srcHeight = $valeurs["hauteur_dest"];
 306           }
 307         }
 308         return array($srcHeight, $srcWidth);
 309 }
 310 // http://doc.spip.org/@largeur
 311 function largeur($img) {
 312         if (!$img) return;
 313         list ($h,$l) = taille_image($img);
 314         return $l;
 315 }
 316 // http://doc.spip.org/@hauteur
 317 function hauteur($img) {
 318         if (!$img) return;
 319         list ($h,$l) = taille_image($img);
 320         return $h;
 321 }
 322
 323
 324 // Echappement des entites HTML avec correction des entites "brutes"
 325 // (generees par les butineurs lorsqu'on rentre des caracteres n'appartenant
 326 // pas au charset de la page [iso-8859-1 par defaut])
 327 //
 328 // Attention on limite cette correction aux caracteres "hauts" (en fait > 99
 329 // pour aller plus vite que le > 127 qui serait logique), de maniere a
 330 // preserver des echappements de caracteres "bas" (par exemple [ ou ")
 331 // et au cas particulier de &amp; qui devient &amp;amp; dans les url
 332 // http://doc.spip.org/@corriger_entites_html
 333 function corriger_entites_html($texte) {
 334         if (strpos($texte,'&amp;') === false) return $texte;
 335         return preg_replace(',&amp;(#[0-9][0-9][0-9]+;|amp;),iS', '&\1', $texte);
 336 }
 337 // idem mais corriger aussi les &amp;eacute; en &eacute;
 338 // http://doc.spip.org/@corriger_toutes_entites_html
 339 function corriger_toutes_entites_html($texte) {
 340         if (strpos($texte,'&amp;') === false) return $texte;
 341         return preg_replace(',&amp;(#?[a-z0-9]+;),iS', '&\1', $texte);
 342 }
 343
 344 // http://doc.spip.org/@proteger_amp
 345 function proteger_amp($texte){
 346         return str_replace('&','&amp;',$texte);
 347 }
 348
 349 //
 350 /**
 351  * http://doc.spip.org/@entites_html
 352  *
 353  * @param string $texte
 354  *   chaine a echapper
 355  * @param bool $tout
 356  *   corriger toutes les &amp;xx; en &xx;
 357  * @param bool $quote
 358  *   echapper aussi les simples quotes en &#039;
 359  * @return mixed|string
 360  */
 361 function entites_html($texte, $tout=false, $quote=true) {
 362         if (!is_string($texte) OR !$texte
 363         OR strpbrk($texte, "&\"'<>")==false
 364         ) return $texte;
 365         include_spip('inc/texte');
 366         $texte = htmlspecialchars(echappe_retour(echappe_html($texte,'',true),'','proteger_amp'),$quote?ENT_QUOTES:(ENT_COMPAT|ENT_HTML401));
 367         if ($tout)
 368                 return corriger_toutes_entites_html($texte);
 369         else
 370                 return corriger_entites_html($texte);
 371 }
 372
 373 // Transformer les &eacute; dans le charset local
 374 // http://doc.spip.org/@filtrer_entites
 375 function filtrer_entites($texte) {
 376         if (strpos($texte,'&') === false) return $texte;
 377         // filtrer
 378         $texte = html2unicode($texte);
 379         // remettre le tout dans le charset cible
 380         return unicode2charset($texte);
 381 }
 382
 383 // caracteres de controle - http://www.w3.org/TR/REC-xml/#charsets
 384 // http://doc.spip.org/@supprimer_caracteres_illegaux
 385 function supprimer_caracteres_illegaux($texte) {
 386         static $from = "\x0\x1\x2\x3\x4\x5\x6\x7\x8\xB\xC\xE\xF\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F";
 387         static $to = null;
 388
 389         if (is_array($texte)) {
 390                 return array_map('corriger_caracteres_windows', $texte);
 391         }
 392
 393         if (!$to) $to = str_repeat('-', strlen($from));
 394         return strtr($texte, $from, $to);
 395 }
 396
 397 // Supprimer caracteres windows et les caracteres de controle ILLEGAUX
 398 // http://doc.spip.org/@corriger_caracteres
 399 function corriger_caracteres ($texte) {
 400         $texte = corriger_caracteres_windows($texte);
 401         $texte = supprimer_caracteres_illegaux($texte);
 402         return $texte;
 403 }
 404
 405 /**
 406  * Encode du HTML pour transmission XML
 407  * notamment dans les flux RSS
 408  *
 409  * http://doc.spip.org/@texte_backend
 410  *
 411  * @param $texte
 412  * @return mixed
 413  */
 414 function texte_backend($texte) {
 415
 416         static $apostrophe = array("&#8217;", "'"); # n'allouer qu'une fois
 417
 418         // si on a des liens ou des images, les passer en absolu
 419         $texte = liens_absolus($texte);
 420
 421         // echapper les tags &gt; &lt;
 422         $texte = preg_replace(',&(gt|lt);,S', '&amp;\1;', $texte);
 423
 424         // importer les &eacute;
 425         $texte = filtrer_entites($texte);
 426
 427         // " -> &quot; et tout ce genre de choses
 428         $u = $GLOBALS['meta']['pcre_u'];
 429         $texte = str_replace("&nbsp;", " ", $texte);
 430         $texte = preg_replace('/\s{2,}/S'.$u, " ", $texte);
 431         // ne pas echapper les sinqle quotes car certains outils de syndication gerent mal
 432         $texte = entites_html($texte, false, false);
 433
 434         // verifier le charset
 435         $texte = charset2unicode($texte);
 436
 437         // Caracteres problematiques en iso-latin 1
 438         if ($GLOBALS['meta']['charset'] == 'iso-8859-1') {
 439                 $texte = str_replace(chr(156), '&#156;', $texte);
 440                 $texte = str_replace(chr(140), '&#140;', $texte);
 441                 $texte = str_replace(chr(159), '&#159;', $texte);
 442         }
 443
 444         // l'apostrophe curly pose probleme a certains lecteure de RSS
 445         // et le caractere apostrophe alourdit les squelettes avec PHP
 446         // ==> on les remplace par l'entite HTML
 447         return str_replace($apostrophe, "'", $texte);
 448 }
 449
 450 // Comme ci-dessus, mais avec addslashes final pour squelettes avec PHP (rss)
 451
 452 function texte_backendq($texte) {
 453         return addslashes(texte_backend($texte));
 454 }
 455
 456 // Enleve le numero des titres numerotes ("1. Titre" -> "Titre")
 457 // http://doc.spip.org/@supprimer_numero
 458 function supprimer_numero($texte) {
 459         return preg_replace(
 460         ",^[[:space:]]*([0-9]+)([.)]|".chr(194).'?'.chr(176).")[[:space:]]+,S",
 461         "", $texte);
 462 }
 463
 464 // et la fonction inverse
 465 // http://doc.spip.org/@recuperer_numero
 466 function recuperer_numero($texte) {
 467         if (preg_match(
 468         ",^[[:space:]]*([0-9]+)([.)]|".chr(194).'?'.chr(176).")[[:space:]]+,S",
 469         $texte, $regs))
 470                 return intval($regs[1]);
 471         else
 472                 return '';
 473 }
 474
 475 // Suppression basique et brutale de tous les <...>
 476 // http://doc.spip.org/@supprimer_tags
 477 function supprimer_tags($texte, $rempl = "") {
 478         $texte = preg_replace(",<[^>]*>,US", $rempl, $texte);
 479         // ne pas oublier un < final non ferme
 480         // mais qui peut aussi etre un simple signe plus petit que
 481         $texte = str_replace('<', ' ', $texte);
 482         return $texte;
 483 }
 484
 485 // Convertit les <...> en la version lisible en HTML
 486 // http://doc.spip.org/@echapper_tags
 487 function echapper_tags($texte, $rempl = "") {
 488         $texte = preg_replace("/<([^>]*)>/", "&lt;\\1&gt;", $texte);
 489         return $texte;
 490 }
 491
 492 // Convertit un texte HTML en texte brut
 493 // http://doc.spip.org/@textebrut
 494 function textebrut($texte) {
 495         $u = $GLOBALS['meta']['pcre_u'];
 496         $texte = preg_replace('/\s+/S'.$u, " ", $texte);
 497         $texte = preg_replace("/<(p|br)( [^>]*)?".">/iS", "\n\n", $texte);
 498         $texte = preg_replace("/^\n+/", "", $texte);
 499         $texte = preg_replace("/\n+$/", "", $texte);
 500         $texte = preg_replace("/\n +/", "\n", $texte);
 501         $texte = supprimer_tags($texte);
 502         $texte = preg_replace("/(&nbsp;| )+/S", " ", $texte);
 503         // nettoyer l'apostrophe curly qui pose probleme a certains rss-readers, lecteurs de mail...
 504         $texte = str_replace("&#8217;","'",$texte);
 505         return $texte;
 506 }
 507
 508 // Remplace les liens SPIP en liens ouvrant dans une nouvelle fenetre (target=blank)
 509 // http://doc.spip.org/@liens_ouvrants
 510 function liens_ouvrants ($texte) {
 511         return preg_replace(",<a\s+([^>]*https?://[^>]*class=[\"']spip_(out|url)\b[^>]+)>,",
 512                 "<a \\1 target=\"_blank\">", $texte);
 513 }
 514
 515 // Transformer les sauts de paragraphe en simples passages a la ligne
 516 // http://doc.spip.org/@PtoBR
 517 function PtoBR($texte){
 518         $u = $GLOBALS['meta']['pcre_u'];
 519         $texte = preg_replace("@</p>@iS", "\n", $texte);
 520         $texte = preg_replace("@<p\b.*>@UiS", "<br />", $texte);
 521         $texte = preg_replace("@^\s*<br />@S".$u, "", $texte);
 522         return $texte;
 523 }
 524
 525
 526 /**
 527  * lignes_longues assure qu'un texte ne vas pas deborder d'un bloc
 528  * par la faute d'un mot trop long (souvent des URLs)
 529  * Ne devrait plus etre utilise et fait directement en CSS par un style
 530  * word-wrap:break-word;
 531  * cf http://www.alsacreations.com/tuto/lire/1038-gerer-debordement-contenu-css.html
 532  *
 533  * Pour assurer la compatibilite du filtre, on encapsule le contenu par
 534  * un div ou span portant ce style inline.
 535  *
 536  * http://doc.spip.org/@lignes_longues
 537  *
 538  * @param string $texte
 539  * @return string
 540  */
 541 function lignes_longues($texte) {
 542         if (!strlen(trim($texte))) return $texte;
 543         include_spip('inc/texte');
 544         $tag = preg_match(',</?('._BALISES_BLOCS.')[>[:space:]],iS', $texte) ?
 545                 'div' : 'span';
 546
 547         return "<$tag style='word-wrap:break-word;'>$texte</$tag>";
 548 }
 549
 550 // Majuscules y compris accents, en HTML
 551 // http://doc.spip.org/@majuscules
 552 function majuscules($texte) {
 553         if (!strlen($texte)) return '';
 554
 555         // Cas du turc
 556         if ($GLOBALS['spip_lang'] == 'tr') {
 557                 # remplacer hors des tags et des entites
 558                 if (preg_match_all(',<[^<>]+>|&[^;]+;,S', $texte, $regs, PREG_SET_ORDER))
 559                         foreach ($regs as $n => $match)
 560                                 $texte = str_replace($match[0], "@@SPIP_TURC$n@@", $texte);
 561
 562                 $texte = str_replace('i', '&#304;', $texte);
 563
 564                 if ($regs)
 565                         foreach ($regs as $n => $match)
 566                                 $texte = str_replace("@@SPIP_TURC$n@@", $match[0], $texte);
 567         }
 568
 569         // Cas general
 570         return "<span style='text-transform: uppercase;'>$texte</span>";
 571 }
 572
 573 // "127.4 ko" ou "3.1 Mo"
 574 // http://doc.spip.org/@taille_en_octets
 575 function taille_en_octets ($taille) {
 576         if ($taille < 1) return '';
 577         if ($taille < 1024) {$taille = _T('taille_octets', array('taille' => $taille));}
 578         else if ($taille < 1024*1024) {
 579                 $taille = _T('taille_ko', array('taille' => round($taille/1024, 1)));
 580         } else if ($taille < 1024*1024*1024) {
 581                 $taille = _T('taille_mo', array('taille' => round($taille/1024/1024, 1)));
 582         } else {
 583                 $taille = _T('taille_go', array('taille' => round($taille/1024/1024/1024, 2)));
 584         }
 585         return $taille;
 586 }
 587
 588
 589 // Rend une chaine utilisable sans dommage comme attribut HTML
 590 // http://doc.spip.org/@attribut_html
 591 function attribut_html($texte,$textebrut = true) {
 592         $u = $GLOBALS['meta']['pcre_u'];
 593         if ($textebrut)
 594                 $texte = preg_replace(array(",\n,",",\s(?=\s),msS".$u),array(" ",""),textebrut($texte));
 595         $texte = texte_backend($texte);
 596         $texte = str_replace(array("'",'"'),array('&#039;', '&#034;'), $texte);
 597
 598         return preg_replace(array("/&(amp;|#38;)/","/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,5};)/"),array("&","&#38;") , $texte);
 599 }
 600
 601 // Vider les url nulles comme 'http://' ou 'mailto:'
 602 // et leur appliquer un htmlspecialchars() + gerer les &amp;
 603 // http://doc.spip.org/@vider_url
 604 function vider_url($url, $entites = true) {
 605         # un message pour abs_url
 606         $GLOBALS['mode_abs_url'] = 'url';
 607
 608         $url = trim($url);
 609         if (preg_match(",^(http:?/?/?|mailto:?)$,iS", $url))
 610                 return '';
 611
 612         if ($entites) $url = entites_html($url);
 613
 614         return $url;
 615 }
 616
 617 // Extraire une date de n'importe quel champ (a completer...)
 618 // http://doc.spip.org/@extraire_date
 619 function extraire_date($texte) {
 620         // format = 2001-08
 621         if (preg_match(",([1-2][0-9]{3})[^0-9]*(1[0-2]|0?[1-9]),",$texte,$regs))
 622                 return $regs[1]."-".sprintf("%02d", $regs[2])."-01";
 623 }
 624
 625 // Maquiller une adresse e-mail
 626 // http://doc.spip.org/@antispam
 627 function antispam($texte) {
 628         include_spip('inc/acces');
 629         $masque = creer_pass_aleatoire(3);
 630         return preg_replace("/@/", " $masque ", $texte);
 631 }
 632
 633 // http://doc.spip.org/@securiser_acces
 634 function securiser_acces($id_auteur, $cle, $dir, $op='', $args='')
 635 {
 636         include_spip('inc/acces');
 637         if ($op) $dir .= " $op $args";
 638         return verifier_low_sec($id_auteur, $cle, $dir);
 639 }
 640
 641 /**
 642  * La fonction sinon retourne le second parametre lorsque
 643  * le premier est considere vide, sinon retourne le premier parametre.
 644  *
 645  * En php sinon($a, 'rien') retourne $a ou 'rien' si $a est vide.
 646  * En filtre spip |sinon{#TEXTE, rien} : affiche #TEXTE ou "rien" si #TEXTE est vide,
 647  *
 648  * Note : l'utilisation de |sinon en tant que filtre de squelette
 649  * est directement compile dans public/references par la fonction filtre_logique()
 650  *
 651  * @param mixed $texte
 652  *              Contenu de reference a tester
 653  * @param mixed $sinon
 654  *              Contenu a retourner si le contenu de reference est vide
 655  * @return mixed
 656  *              Retourne $texte, sinon $sinon.
 657 **/
 658 function sinon ($texte, $sinon='') {
 659         if ($texte OR (!is_array($texte) AND strlen($texte)))
 660                 return $texte;
 661         else
 662                 return $sinon;
 663 }
 664
 665 // |choixsivide{vide,pasvide} affiche pasvide si la chaine n'est pas vide...
 666 // http://doc.spip.org/@choixsivide
 667 function choixsivide($a, $vide, $pasvide) {
 668         return $a ? $pasvide : $vide;
 669 }
 670
 671 // |choixsiegal{aquoi,oui,non} affiche oui si la chaine est egal a aquoi ...
 672 // http://doc.spip.org/@choixsiegal
 673 function choixsiegal($a1,$a2,$v,$f) {
 674         return ($a1 == $a2) ? $v : $f;
 675 }
 676
 677
 678 //
 679 // Date, heure, saisons
 680 //
 681
 682 // on normalise la date, si elle vient du contexte (public/parametrer.php), on force le jour
 683 // http://doc.spip.org/@normaliser_date
 684 function normaliser_date($date, $forcer_jour = false) {
 685         $date = vider_date($date);
 686         if ($date) {
 687                 if (preg_match("/^[0-9]{8,10}$/", $date))
 688                         $date = date("Y-m-d H:i:s", $date);
 689                 if (preg_match("#^([12][0-9]{3})([-/]00)?( [-0-9:]+)?$#", $date, $regs))
 690                         $date = $regs[1]."-00-00".$regs[3];
 691                 else if (preg_match("#^([12][0-9]{3}[-/][01]?[0-9])([-/]00)?( [-0-9:]+)?$#", $date, $regs))
 692                         $date = preg_replace("@/@","-",$regs[1])."-00".$regs[3];
 693                 else
 694                         $date = date("Y-m-d H:i:s", strtotime($date));
 695
 696                 if ($forcer_jour)
 697                         $date = str_replace('-00', '-01', $date);
 698         }
 699         return $date;
 700 }
 701
 702 // http://doc.spip.org/@vider_date
 703 function vider_date($letexte) {
 704         if (strncmp("0000-00-00", $letexte,10)==0) return '';
 705         if (strncmp("0001-01-01", $letexte,10)==0) return '';
 706         if (strncmp("1970-01-01", $letexte,10)==0) return '';   // eviter le bug GMT-1
 707         return $letexte;
 708 }
 709
 710 // http://doc.spip.org/@recup_heure
 711 function recup_heure($date){
 712
 713         static $d = array(0,0,0);
 714         if (!preg_match('#([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2})#', $date, $r))
 715                 return $d;
 716
 717         array_shift($r);
 718         return $r;
 719 }
 720
 721 // http://doc.spip.org/@heures
 722 function heures($numdate) {
 723         $date_array = recup_heure($numdate);
 724         if ($date_array)
 725                 list($heures, $minutes, $secondes) = $date_array;
 726         return $heures;
 727 }
 728
 729 // http://doc.spip.org/@minutes
 730 function minutes($numdate) {
 731         $date_array = recup_heure($numdate);
 732         if ($date_array)
 733                 list($heures, $minutes, $secondes) = $date_array;
 734         return $minutes;
 735 }
 736
 737 // http://doc.spip.org/@secondes
 738 function secondes($numdate) {
 739         $date_array = recup_heure($numdate);
 740         if ($date_array)
 741                 list($heures,$minutes,$secondes) = $date_array;
 742         return $secondes;
 743 }
 744
 745 // http://doc.spip.org/@heures_minutes
 746 function heures_minutes($numdate) {
 747         return _T('date_fmt_heures_minutes', array('h'=> heures($numdate), 'm'=> minutes($numdate)));
 748 }
 749
 750 // http://doc.spip.org/@recup_date
 751 function recup_date($numdate, $forcer_jour = true){
 752         if (!$numdate) return '';
 753         $heures = $minutes = $secondes = 0;
 754         if (preg_match('#([0-9]{1,2})/([0-9]{1,2})/([0-9]{4}|[0-9]{1,2})#', $numdate, $regs)) {
 755                 $jour = $regs[1];
 756                 $mois = $regs[2];
 757                 $annee = $regs[3];
 758                 if ($annee < 90){
 759                         $annee = 2000 + $annee;
 760                 } elseif ($annee<100) {
 761                         $annee = 1900 + $annee ;
 762                 }
 763                 list($heures, $minutes, $secondes) = recup_heure($numdate);
 764
 765         }
 766         elseif (preg_match('#([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})#',$numdate, $regs)) {
 767                 $annee = $regs[1];
 768                 $mois = $regs[2];
 769                 $jour = $regs[3];
 770                 list($heures, $minutes, $secondes) = recup_heure($numdate);
 771         }
 772         elseif (preg_match('#([0-9]{4})-([0-9]{2})#', $numdate, $regs)){
 773                 $annee = $regs[1];
 774                 $mois = $regs[2];
 775                 $jour ='';
 776                 list($heures, $minutes, $secondes) = recup_heure($numdate);
 777         }
 778         elseif (preg_match('#^([0-9]{4})([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{2})$#', $numdate, $regs)){
 779                 $annee = $regs[1];
 780                 $mois = $regs[2];
 781                 $jour = $regs[3];
 782                 $heures = $regs[4];
 783                 $minutes = $regs[5];
 784                 $secondes = $regs[6];
 785         } else $annee = $mois =  $jour ='';
 786         if ($annee > 4000) $annee -= 9000;
 787         if (substr($jour, 0, 1) == '0') $jour = substr($jour, 1);
 788
 789         if ($forcer_jour AND $jour == '0') $jour = '1';
 790         if ($forcer_jour AND $mois == '0') $mois = '1';
 791         if ($annee OR $mois OR $jour OR $heures OR $minutes OR $secondes)
 792                 return array($annee, $mois, $jour, $heures, $minutes, $secondes);
 793 }
 794
 795 // une date pour l'interface : utilise date_relative si le decalage
 796 // avec time() est de moins de douze heures, sinon la date complete
 797 // http://doc.spip.org/@date_interface
 798 function date_interface($date, $decalage_maxi = 43200/* 12*3600 */) {
 799         return sinon(
 800                 date_relative($date, $decalage_maxi),
 801                 affdate_heure($date)
 802         );
 803 }
 804
 805 // http://doc.spip.org/@date_relative
 806 function date_relative($date, $decalage_maxi=0,$ref_date=null) {
 807
 808         if (is_null($ref_date))
 809                 $ref_time = time();
 810         else
 811                 $ref_time = strtotime($ref_date);
 812
 813         if (!$date) return;
 814         $decal = date("U",$ref_time) - date("U", strtotime($date));
 815
 816         if ($decalage_maxi AND ($decal > $decalage_maxi OR $decal < 0))
 817                 return '';
 818
 819         if ($decal < 0) {
 820                 $il_y_a = "date_dans";
 821                 $decal = -1 * $decal;
 822         } else {
 823                 $il_y_a = "date_il_y_a";
 824         }
 825
 826         if ($decal > 3600 * 24 * 30 * 6)
 827                 return affdate_court($date);
 828
 829         if ($decal > 3600 * 24 * 30) {
 830                 $mois = floor ($decal / (3600 * 24 * 30));
 831                 if ($mois < 2)
 832                         $delai = "$mois "._T("date_un_mois");
 833                 else
 834                         $delai = "$mois "._T("date_mois");
 835         }
 836         else if ($decal > 3600 * 24 * 7) {
 837                 $semaines = floor ($decal / (3600 * 24 * 7));
 838                 if ($semaines < 2)
 839                         $delai = "$semaines "._T("date_une_semaine");
 840                 else
 841                         $delai = "$semaines "._T("date_semaines");
 842         }
 843         else if ($decal > 3600 * 24) {
 844                 $jours = floor ($decal / (3600 * 24));
 845                 if ($jours < 2)
 846                         return $il_y_a=="date_dans"?_T("date_demain"):_T("date_hier");
 847                 else
 848                         $delai = "$jours "._T("date_jours");
 849         }
 850         else if ($decal >= 3600) {
 851                 $heures = floor ($decal / 3600);
 852                 if ($heures < 2)
 853                         $delai = "$heures "._T("date_une_heure");
 854                 else
 855                         $delai = "$heures "._T("date_heures");
 856         }
 857         else if ($decal >= 60) {
 858                 $minutes = floor($decal / 60);
 859                 if ($minutes < 2)
 860                         $delai = "$minutes "._T("date_une_minute");
 861                 else
 862                         $delai = "$minutes "._T("date_minutes");
 863         } else {
 864                 $secondes = ceil($decal);
 865                 if ($secondes < 2)
 866                         $delai = "$secondes "._T("date_une_seconde");
 867                 else
 868                         $delai = "$secondes "._T("date_secondes");
 869         }
 870
 871         return _T($il_y_a, array("delai"=> $delai));
 872 }
 873
 874
 875 // http://doc.spip.org/@date_relativecourt
 876 function date_relativecourt($date, $decalage_maxi=0) {
 877
 878         if (!$date) return;
 879         $decal = date("U",strtotime(date('Y-m-d'))-strtotime(date('Y-m-d',strtotime($date))));
 880
 881         if ($decalage_maxi AND ($decal > $decalage_maxi OR $decal < 0))
 882                 return '';
 883
 884         if ($decal < -24*3600) {
 885                 $retour = date_relative($date, $decalage_maxi);
 886         }
 887         elseif ($decal < 0) {
 888                 $retour = _T("date_demain");
 889         }
 890         else if ($decal < (3600 * 24) ) {
 891                 $retour = _T("date_aujourdhui");
 892         }
 893         else if ($decal < (3600 * 24 *2) ) {
 894                 $retour = _T("date_hier");
 895         }
 896         else {
 897                 $retour = date_relative($date, $decalage_maxi);
 898         }
 899
 900
 901
 902         return $retour;
 903 }
 904
 905 /**
 906  * Formatage humain de la date $numdate selon le format $vue
 907  * http://doc.spip.org/@affdate_base
 908  *
 909  * @param $numdate
 910  * @param $vue
 911  * @param array $options
 912  *   param : 'abbr' ou 'initiale' permet d'afficher les jours au format court ou initiale
 913  *   annee_courante : permet de definir l'annee de reference pour l'affichage des dates courtes
 914  * @return mixed|string
 915  */
 916 function affdate_base($numdate, $vue, $options = array()) {
 917         if (is_string($options))
 918                 $options = array('param'=>$options);
 919         $date_array = recup_date($numdate, false);
 920         if (!$date_array) return;
 921         list($annee, $mois, $jour, $heures, $minutes, $secondes)= $date_array;
 922
 923         // 1er, 21st, etc.
 924         $journum = $jour;
 925
 926         if ($jour == 0) {
 927                 $jour = '';
 928         } else {
 929                 $njour = intval($jour);
 930                 if ($jourth = _T('date_jnum'.$jour))
 931                         $jour = $jourth;
 932         }
 933
 934         $mois = intval($mois);
 935         if ($mois > 0 AND $mois < 13) {
 936                 $nommois = _T('date_mois_'.$mois);
 937                 if ($jour)
 938                         $jourmois = _T('date_de_mois_'.$mois, array('j'=>$jour, 'nommois'=>$nommois));
 939                 else
 940                         $jourmois = $nommois;
 941         } else $nommois = '';
 942
 943         if ($annee < 0) {
 944                 $annee = -$annee." "._T('date_avant_jc');
 945                 $avjc = true;
 946         }
 947         else $avjc = false;
 948
 949         switch ($vue) {
 950         case 'saison':
 951                 $saison = '';
 952                 if ($mois > 0){
 953                         $saison = 1;
 954                         if (($mois == 3 AND $jour >= 21) OR $mois > 3) $saison = 2;
 955                         if (($mois == 6 AND $jour >= 21) OR $mois > 6) $saison = 3;
 956                         if (($mois == 9 AND $jour >= 21) OR $mois > 9) $saison = 4;
 957                         if (($mois == 12 AND $jour >= 21) OR $mois > 12) $saison = 1;
 958                 }
 959                 return $saison?_T('date_saison_'.$saison):'';
 960
 961         case 'court':
 962                 if ($avjc) return $annee;
 963                 $a = ((isset($options['annee_courante']) AND $options['annee_courante'])?$options['annee_courante']:date('Y'));
 964                 if ($annee < ($a - 100) OR $annee > ($a + 100)) return $annee;
 965                 if ($annee != $a) return _T('date_fmt_mois_annee', array ('mois'=>$mois, 'nommois'=>spip_ucfirst($nommois), 'annee'=>$annee));
 966                 return _T('date_fmt_jour_mois', array ('jourmois'=>$jourmois, 'jour'=>$jour, 'mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee));
 967
 968         case 'jourcourt':
 969                 if ($avjc) return $annee;
 970                 $a = ((isset($options['annee_courante']) AND $options['annee_courante'])?$options['annee_courante']:date('Y'));
 971                 if ($annee < ($a - 100) OR $annee > ($a + 100)) return $annee;
 972                 if ($annee != $a) return _T('date_fmt_jour_mois_annee', array ('jourmois'=>$jourmois, 'jour'=>$jour, 'mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee));
 973                 return _T('date_fmt_jour_mois', array ('jourmois'=>$jourmois, 'jour'=>$jour, 'mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee));
 974
 975         case 'entier':
 976                 if ($avjc) return $annee;
 977                 if ($jour)
 978                         return _T('date_fmt_jour_mois_annee', array ('jourmois'=>$jourmois, 'jour'=>$jour, 'mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee));
 979                 elseif ($mois)
 980                         return trim(_T('date_fmt_mois_annee', array ('mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee)));
 981                 else
 982                         return $annee;
 983
 984         case 'nom_mois':
 985                 $param = ((isset($options['param']) AND $options['param']) ? '_'.$options['param'] : '');
 986                 if ($param and $mois) {
 987                         return _T('date_mois_'.$mois.$param);
 988                 }
 989                 return $nommois;
 990
 991         case 'mois':
 992                 return sprintf("%02s",$mois);
 993
 994         case 'jour':
 995                 return $jour;
 996
 997         case 'journum':
 998                 return $journum;
 999
1000         case 'nom_jour':
1001                 if (!$mois OR !$njour)
1002                         return '';
1003                 $nom = mktime(1,1,1,$mois,$njour,$annee);
1004                 $nom = 1+date('w',$nom);
1005                 $param = ((isset($options['param']) AND $options['param']) ? '_'.$options['param'] : '');
1006                 return _T('date_jour_'.$nom.$param);
1007
1008         case 'mois_annee':
1009                 if ($avjc) return $annee;
1010                 return trim(_T('date_fmt_mois_annee', array('mois'=>$mois, 'nommois'=>$nommois, 'annee'=>$annee)));
1011
1012         case 'annee':
1013                 return $annee;
1014
1015         // Cas d'une vue non definie : retomber sur le format
1016         // de date propose par http://www.php.net/date
1017         default:
1018                 return date($vue, strtotime($numdate));
1019         }
1020 }
1021
1022 // http://doc.spip.org/@nom_jour
1023 function nom_jour($numdate, $forme = '') {
1024         if(!($forme == 'abbr' OR $forme == 'initiale')) $forme = '';
1025         return affdate_base($numdate, 'nom_jour', $forme);
1026 }
1027
1028 // http://doc.spip.org/@jour
1029 function jour($numdate) {
1030         return affdate_base($numdate, 'jour');
1031 }
1032
1033 // http://doc.spip.org/@journum
1034 function journum($numdate) {
1035         return affdate_base($numdate, 'journum');
1036 }
1037
1038 // http://doc.spip.org/@mois
1039 function mois($numdate) {
1040         return affdate_base($numdate, 'mois');
1041 }
1042
1043 // http://doc.spip.org/@nom_mois
1044 function nom_mois($numdate, $forme='') {
1045         if(!($forme == 'abbr')) $forme = '';
1046         return affdate_base($numdate, 'nom_mois', $forme);
1047 }
1048
1049 // http://doc.spip.org/@annee
1050 function annee($numdate) {
1051         return affdate_base($numdate, 'annee');
1052 }
1053
1054 // http://doc.spip.org/@saison
1055 function saison($numdate) {
1056         return affdate_base($numdate, 'saison');
1057 }
1058
1059 // http://doc.spip.org/@affdate
1060 function affdate($numdate, $format='entier') {
1061         return affdate_base($numdate, $format);
1062 }
1063
1064 // http://doc.spip.org/@affdate_court
1065 function affdate_court($numdate, $annee_courante=null) {
1066         return affdate_base($numdate, 'court', array('annee_courante'=>$annee_courante));
1067 }
1068
1069 // http://doc.spip.org/@affdate_jourcourt
1070 function affdate_jourcourt($numdate, $annee_courante=null) {
1071         return affdate_base($numdate, 'jourcourt', array('annee_courante'=>$annee_courante));
1072 }
1073
1074 // http://doc.spip.org/@affdate_mois_annee
1075 function affdate_mois_annee($numdate) {
1076         return affdate_base($numdate, 'mois_annee');
1077 }
1078
1079 // http://doc.spip.org/@affdate_heure
1080 function affdate_heure($numdate) {
1081         $date_array = recup_date($numdate);
1082         if (!$date_array) return;
1083         list($annee, $mois, $jour, $heures, $minutes, $sec)= $date_array;
1084         return _T('date_fmt_jour_heure', array('jour' => affdate($numdate), 'heure' =>  _T('date_fmt_heures_minutes', array('h'=> $heures, 'm'=> $minutes))));
1085 }
1086
1087 /**
1088  * Afficher de facon textuelle les dates de debut et fin en fonction des cas
1089  * - Lundi 20 fevrier a 18h
1090  * - Le 20 fevrier de 18h a 20h
1091  * - Du 20 au 23 fevrier
1092  * - Du 20 fevrier au 30 mars
1093  * - Du 20 fevrier 2007 au 30 mars 2008
1094  * $horaire='oui' ou true permet d'afficher l'horaire, toute autre valeur n'indique que le jour
1095  * $forme peut contenir une ou plusieurs valeurs parmi
1096  *  - abbr (afficher le nom des jours en abbrege)
1097  *  - hcal (generer une date au format hcal)
1098  *  - jour (forcer l'affichage des jours)
1099  *  - annee (forcer l'affichage de l'annee)
1100  *
1101  * @param string $date_debut
1102  * @param string $date_fin
1103  * @param string $horaire
1104  * @param string $forme
1105  * @return string
1106  */
1107 function affdate_debut_fin($date_debut, $date_fin, $horaire = 'oui', $forme=''){
1108         $abbr = $jour = '';
1109         $affdate = "affdate_jourcourt";
1110         if (strpos($forme,'abbr') !==false) $abbr = 'abbr';
1111         if (strpos($forme,'annee')!==false) $affdate = 'affdate';
1112         if (strpos($forme,'jour') !==false) $jour = 'jour';
1113
1114         $dtstart = $dtend = $dtabbr = "";
1115         if (strpos($forme,'hcal')!==false) {
1116                 $dtstart = "<abbr class='dtstart' title='".date_iso($date_debut)."'>";
1117                 $dtend = "<abbr class='dtend' title='".date_iso($date_fin)."'>";
1118                 $dtabbr = "</abbr>";
1119         }
1120
1121         $date_debut = strtotime($date_debut);
1122         $date_fin = strtotime($date_fin);
1123         $d = date("Y-m-d", $date_debut);
1124         $f = date("Y-m-d", $date_fin);
1125         $h = ($horaire==='oui' OR $horaire===true);
1126         $hd = _T('date_fmt_heures_minutes_court', array('h'=> date("H",$date_debut), 'm'=> date("i",$date_debut)));
1127         $hf = _T('date_fmt_heures_minutes_court', array('h'=> date("H",$date_fin), 'm'=> date("i",$date_fin)));
1128
1129         if ($d==$f)
1130         { // meme jour
1131                 $nomjour = nom_jour($d,$abbr);
1132                 $s = $affdate($d);
1133                 $s = _T('date_fmt_jour',array('nomjour'=>$nomjour,'jour' => $s));
1134                 if ($h){
1135                         if ($hd==$hf){
1136                                 // Lundi 20 fevrier a 18h25
1137                                 $s = spip_ucfirst(_T('date_fmt_jour_heure',array('jour'=>$s,'heure'=>$hd)));
1138                                 $s = "$dtstart$s$dtabbr";
1139                         }else{
1140                                 // Le <abbr...>lundi 20 fevrier de 18h00</abbr> a <abbr...>20h00</abbr>
1141                                 if($dtabbr && $dtstart && $dtend)
1142                                         $s = spip_ucfirst(_T('date_fmt_jour_heure_debut_fin_abbr',array('jour'=>$s,'heure_debut'=>$hd,'heure_fin'=>$hf,'dtstart'=>$dtstart,'dtend'=>$dtend,'dtabbr'=>$dtabbr)));
1143                                 // Le lundi 20 fevrier de 18h00 a 20h00
1144                                 else
1145                                         $s = spip_ucfirst(_T('date_fmt_jour_heure_debut_fin',array('jour'=>$s,'heure_debut'=>$hd,'heure_fin'=>$hf)));
1146                         }
1147                 }else{
1148                         if($dtabbr && $dtstart)
1149                                 $s = $dtstart.spip_ucfirst($s).$dabbr;
1150                         else
1151                                 $s = spip_ucfirst($s);
1152                 }
1153         }
1154         else if ((date("Y-m",$date_debut))==date("Y-m",$date_fin))
1155         { // meme annee et mois, jours differents
1156                 if(!$h)
1157                         $date_debut = jour($d);
1158                 else
1159                         $date_debut = $affdate($d);
1160                 $date_fin = $affdate($f);
1161                 if($jour){
1162                         $nomjour_debut = nom_jour($d,$abbr);
1163                         $date_debut = _T('date_fmt_jour',array('nomjour'=>$nomjour_debut,'jour' => $date_debut));
1164                         $nomjour_fin = nom_jour($f,$abbr);
1165                         $date_fin = _T('date_fmt_jour',array('nomjour'=>$nomjour_fin,'jour' => $date_fin));
1166                 }
1167                 if ($h){
1168                         $date_debut = _T('date_fmt_jour_heure',array('jour'=>$date_debut,'heure'=>$hd));
1169                         $date_fin = _T('date_fmt_jour_heure',array('jour'=>$date_fin,'heure'=>$hf));
1170                 }
1171                 $date_debut = $dtstart.$date_debut.$dtabbr;
1172                 $date_fin = $dtend.$date_fin.$dtabbr;
1173
1174                 $s = _T('date_fmt_periode',array('date_debut' => $date_debut,'date_fin'=>$date_fin));
1175         }
1176         else {
1177                 $date_debut = affdate($d);
1178                 $date_fin = affdate($f);
1179                 if($jour){
1180                         $nomjour_debut = nom_jour($d,$abbr);
1181                         $date_debut = _T('date_fmt_jour_periode',array('nomjour'=>$nomjour_debut,'jour' => $date_debut));
1182                         $nomjour_fin = nom_jour($f,$abbr);
1183                         $date_fin = _T('date_fmt_jour_periode',array('nomjour'=>$nomjour_fin,'jour' => $date_fin));
1184                 }
1185                 if ($h){
1186                         $date_debut = _T('date_fmt_jour_heure',array('jour'=>$date_debut,'heure'=>$hd));
1187                         $date_fin = _T('date_fmt_jour_heure',array('jour'=>$date_fin,'heure'=>$hf));
1188                 }
1189
1190                 $date_debut = $dtstart.$date_debut.$dtabbr;
1191                 $date_fin=$dtend.$date_fin.$dtabbr;
1192                 $s = _T('date_fmt_periode',array('date_debut' => $date_debut,'date_fin'=>$date_fin));
1193
1194         }
1195         return $s;
1196 }
1197
1198 /**
1199  * Alignements en HTML (Old-style, preferer CSS)
1200  * Cette fonction ne cree pas de paragraphe
1201  *
1202  * http://doc.spip.org/@aligner
1203  *
1204  * @param  $letexte
1205  * @param string $justif
1206  * @return string
1207  */
1208 function aligner($letexte, $justif='') {
1209         $letexte = trim($letexte);
1210         if (!strlen($letexte)) return '';
1211
1212         // Paragrapher rapidement
1213         $letexte = "<div style='text-align:$justif'>"
1214                 . $letexte
1215           ."</div>";
1216
1217         return $letexte;
1218 }
1219 // http://doc.spip.org/@justifier
1220 function justifier($letexte) { return aligner($letexte,'justify');}
1221 // http://doc.spip.org/@aligner_droite
1222 function aligner_droite($letexte) { return aligner($letexte,'right');}
1223 // http://doc.spip.org/@aligner_gauche
1224 function aligner_gauche($letexte) {return aligner($letexte,'left');}
1225 // http://doc.spip.org/@centrer
1226 function centrer($letexte) {return aligner($letexte,'center');}
1227
1228 // http://doc.spip.org/@style_align
1229 function style_align($bof) {
1230         global $spip_lang_left;
1231         return "text-align: $spip_lang_left";
1232 }
1233
1234 //
1235 // Export iCal
1236 //
1237
1238 // http://doc.spip.org/@filtrer_ical
1239 function filtrer_ical($texte) {
1240         #include_spip('inc/charsets');
1241         $texte = html2unicode($texte);
1242         $texte = unicode2charset(charset2unicode($texte, $GLOBALS['meta']['charset'], 1), 'utf-8');
1243         $texte = preg_replace("/\n/", " ", $texte);
1244         $texte = preg_replace("/,/", "\,", $texte);
1245
1246         return $texte;
1247 }
1248
1249 // http://doc.spip.org/@date_ical
1250 function date_ical($date, $addminutes = 0) {
1251         list($heures, $minutes, $secondes) = recup_heure($date);
1252         list($annee, $mois, $jour) = recup_date($date);
1253         return date("Ymd\THis",
1254                     mktime($heures, $minutes+$addminutes,$secondes,$mois,$jour,$annee));
1255 }
1256
1257 // date_iso retourne la date au format "RFC 3339" / "ISO 8601"
1258 // voir http://www.php.net/manual/fr/ref.datetime.php#datetime.constants
1259 // http://doc.spip.org/@date_iso
1260 function date_iso($date_heure) {
1261         list($annee, $mois, $jour) = recup_date($date_heure);
1262         list($heures, $minutes, $secondes) = recup_heure($date_heure);
1263         $time = @mktime($heures, $minutes, $secondes, $mois, $jour, $annee);
1264         return gmdate('Y-m-d\TH:i:s\Z', $time);
1265 }
1266
1267 // date_822 retourne la date au format "RFC 822"
1268 // utilise pour <pubdate> dans certains feeds RSS
1269 // http://doc.spip.org/@date_822
1270 function date_822($date_heure) {
1271         list($annee, $mois, $jour) = recup_date($date_heure);
1272         list($heures, $minutes, $secondes) = recup_heure($date_heure);
1273         $time = mktime($heures, $minutes, $secondes, $mois, $jour, $annee);
1274         return date('r', $time);
1275 }
1276
1277 // http://doc.spip.org/@date_anneemoisjour
1278 function date_anneemoisjour($d)  {
1279         if (!$d) $d = date("Y-m-d");
1280         return  substr($d, 0, 4) . substr($d, 5, 2) .substr($d, 8, 2);
1281 }
1282
1283 // http://doc.spip.org/@date_anneemois
1284 function date_anneemois($d)  {
1285         if (!$d) $d = date("Y-m-d");
1286         return  substr($d, 0, 4) . substr($d, 5, 2);
1287 }
1288
1289 // http://doc.spip.org/@date_debut_semaine
1290 function date_debut_semaine($annee, $mois, $jour) {
1291   $w_day = date("w", mktime(0,0,0,$mois, $jour, $annee));
1292   if ($w_day == 0) $w_day = 7; // Gaffe: le dimanche est zero
1293   $debut = $jour-$w_day+1;
1294   return date("Ymd", mktime(0,0,0,$mois,$debut,$annee));
1295 }
1296
1297 // http://doc.spip.org/@date_fin_semaine
1298 function date_fin_semaine($annee, $mois, $jour) {
1299   $w_day = date("w", mktime(0,0,0,$mois, $jour, $annee));
1300   if ($w_day == 0) $w_day = 7; // Gaffe: le dimanche est zero
1301   $debut = $jour-$w_day+1;
1302   return date("Ymd", mktime(0,0,0,$mois,$debut+6,$annee));
1303 }
1304
1305
1306 //
1307 // Recuperation de donnees dans le champ extra
1308 // Ce filtre n'a de sens qu'avec la balise #EXTRA
1309 //
1310 // http://doc.spip.org/@extra
1311 function extra($letexte, $champ) {
1312         $champs = unserialize($letexte);
1313         return $champs[$champ];
1314 }
1315
1316 // postautobr : transforme les sauts de ligne en _
1317 // http://doc.spip.org/@post_autobr
1318 function post_autobr($texte, $delim="\n_ ") {
1319         if (!function_exists('echappe_html'))
1320                 include_spip('inc/texte_mini');
1321         $texte = str_replace("\r\n", "\r", $texte);
1322         $texte = str_replace("\r", "\n", $texte);
1323
1324         if (preg_match(",\n+$,", $texte, $fin))
1325                 $texte = substr($texte, 0, -strlen($fin = $fin[0]));
1326         else
1327                 $fin = '';
1328
1329         $texte = echappe_html($texte, '', true);
1330
1331         // echapper les modeles
1332         if (strpos($texte,"<")!==false){
1333                 include_spip('inc/lien');
1334                 if (defined('_PREG_MODELE')){
1335                         $preg_modeles = "@"._PREG_MODELE."@imsS";
1336                         $texte = echappe_html($texte, '', true, $preg_modeles);
1337                 }
1338         }
1339
1340         $debut = '';
1341         $suite = $texte;
1342         while ($t = strpos('-'.$suite, "\n", 1)) {
1343                 $debut .= substr($suite, 0, $t-1);
1344                 $suite = substr($suite, $t);
1345                 $car = substr($suite, 0, 1);
1346                 if (($car<>'-') AND ($car<>'_') AND ($car<>"\n") AND ($car<>"|") AND ($car<>"}")
1347                 AND !preg_match(',^\s*(\n|</?(quote|div|dl|dt|dd)|$),S',($suite))
1348                 AND !preg_match(',</?(quote|div|dl|dt|dd)> *$,iS', $debut)) {
1349                         $debut .= $delim;
1350                 } else
1351                         $debut .= "\n";
1352                 if (preg_match(",^\n+,", $suite, $regs)) {
1353                         $debut.=$regs[0];
1354                         $suite = substr($suite, strlen($regs[0]));
1355                 }
1356         }
1357         $texte = $debut.$suite;
1358
1359         $texte = echappe_retour($texte);
1360         return $texte.$fin;
1361 }
1362
1363
1364 define('_EXTRAIRE_MULTI', "@<multi>(.*?)</multi>@sS");
1365
1366 // Extraire et transformer les blocs multi ; on indique la langue courante
1367 // pour ne pas mettre de span@lang=fr si on est deja en fr
1368 // http://doc.spip.org/@extraire_multi
1369 function extraire_multi($letexte, $lang=null, $echappe_span=false) {
1370         if (preg_match_all(_EXTRAIRE_MULTI, $letexte, $regs, PREG_SET_ORDER)) {
1371                 if (!$lang) $lang = $GLOBALS['spip_lang'];
1372
1373                 foreach ($regs as $reg) {
1374                         // chercher la version de la langue courante
1375                         $trads = extraire_trads($reg[1]);
1376                         if ($l = approcher_langue($trads, $lang)) {
1377                                 $trad = $trads[$l];
1378                         } else {
1379                                 include_spip('inc/texte');
1380                                 // langue absente, prendre la premiere dispo
1381                                 // mais typographier le texte selon les regles de celle-ci
1382                                 // Attention aux blocs multi sur plusieurs lignes
1383                                 $l = key($trads);
1384                                 $trad = $trads[$l];
1385                                 $typographie = charger_fonction(lang_typo($l), 'typographie');
1386                                 $trad = $typographie($trad);
1387                                 include_spip('inc/texte');
1388                                 // Tester si on echappe en span ou en div
1389                                 // il ne faut pas echapper en div si propre produit un seul paragraphe
1390                                 $trad_propre = preg_replace(",(^<p[^>]*>|</p>$),Uims","",propre($trad));
1391                                 $mode = preg_match(',</?('._BALISES_BLOCS.')[>[:space:]],iS', $trad_propre) ? 'div' : 'span';
1392                                 $trad = code_echappement($trad, 'multi', false, $mode);
1393                                 $trad = str_replace("'", '"', inserer_attribut($trad, 'lang', $l));
1394                                 if (lang_dir($l) !== lang_dir($lang))
1395                                         $trad = str_replace("'", '"', inserer_attribut($trad, 'dir', lang_dir($l)));
1396                                 if (!$echappe_span)
1397                                         $trad = echappe_retour($trad, 'multi');
1398                         }
1399                         $letexte = str_replace($reg[0], $trad, $letexte);
1400                 }
1401         }
1402
1403         return $letexte;
1404 }
1405
1406 // convertit le contenu d'une balise multi en un tableau
1407 // http://doc.spip.org/@extraire_trad
1408 function extraire_trads($bloc) {
1409         $lang = '';
1410 // ce reg fait planter l'analyse multi s'il y a de l'{italique} dans le champ
1411 //      while (preg_match("/^(.*?)[{\[]([a-z_]+)[}\]]/siS", $bloc, $regs)) {
1412         while (preg_match("/^(.*?)[\[]([a-z_]+)[\]]/siS", $bloc, $regs)) {
1413                 $texte = trim($regs[1]);
1414                 if ($texte OR $lang)
1415                         $trads[$lang] = $texte;
1416                 $bloc = substr($bloc, strlen($regs[0]));
1417                 $lang = $regs[2];
1418         }
1419         $trads[$lang] = $bloc;
1420
1421         return $trads;
1422 }
1423
1424 //
1425 // Ce filtre retourne la donnee si c'est la premiere fois qu'il la voit ;
1426 // possibilite de gerer differentes "familles" de donnees |unique{famille}
1427 # |unique{famille,1} affiche le nombre d'elements affiches (preferer toutefois #TOTAL_UNIQUE)
1428 # ameliorations possibles :
1429 # 1) si la donnee est grosse, mettre son md5 comme cle
1430 # 2) purger $mem quand on change de squelette (sinon bug inclusions)
1431 //
1432 // http://www.spip.net/@unique
1433 // http://doc.spip.org/@unique
1434 function unique($donnee, $famille='', $cpt = false) {
1435         static $mem = array();
1436         // permettre de vider la pile et de la restaurer
1437         // pour le calcul de introduction...
1438         if ($famille=='_spip_raz_'){
1439                 $tmp = $mem;
1440                 $mem = array();
1441                 return $tmp;
1442         } elseif ($famille=='_spip_set_'){
1443                 $mem = $donnee;
1444                 return;
1445         }
1446         // eviter une notice
1447         if (!isset($mem[$famille])) {
1448                 $mem[$famille] = array();
1449         }
1450         if ($cpt) {
1451                 return count($mem[$famille]);
1452         }
1453         // eviter une notice
1454         if (!isset($mem[$famille][$donnee])) {
1455                 $mem[$famille][$donnee] = 0;
1456         }
1457         if (!($mem[$famille][$donnee]++)) {
1458                 return $donnee;
1459         }
1460 }
1461
1462 //
1463 // Filtre |alterner
1464 //
1465 // Exemple [(#COMPTEUR_BOUCLE|alterner{'bleu','vert','rouge'})]
1466 //
1467 // http://doc.spip.org/@alterner
1468 function alterner($i) {
1469         // recuperer les arguments (attention fonctions un peu space)
1470         $num = func_num_args();
1471         $args = func_get_args();
1472
1473         if($num == 2 && is_array($args[1])) {
1474     $args = $args[1];
1475     array_unshift($args,'');
1476     $num = count($args);
1477   }
1478
1479         // renvoyer le i-ieme argument, modulo le nombre d'arguments
1480         return $args[(intval($i)-1)%($num-1)+1];
1481 }
1482
1483 // recuperer un attribut d'une balise html
1484 // ($complet demande de retourner $r)
1485 // la regexp est mortelle : cf. tests/filtres/extraire_attribut.php
1486 // Si on a passe un tableau de balises, renvoyer un tableau de resultats
1487 // (dans ce cas l'option $complet n'est pas disponible)
1488 // http://doc.spip.org/@extraire_attribut
1489 function extraire_attribut($balise, $attribut, $complet = false) {
1490         if (is_array($balise)) {
1491                 array_walk($balise,
1492                         create_function('&$a,$key,$t',
1493                                 '$a = extraire_attribut($a,$t);'
1494                         ),
1495                         $attribut);
1496                 return $balise;
1497         }
1498         if (preg_match(
1499         ',(^.*?<(?:(?>\s*)(?>[\w:.-]+)(?>(?:=(?:"[^"]*"|\'[^\']*\'|[^\'"]\S*))?))*?)(\s+'
1500         .$attribut
1501         .'(?:=\s*("[^"]*"|\'[^\']*\'|[^\'"]\S*))?)()([^>]*>.*),isS',
1502
1503         $balise, $r)) {
1504                 if ($r[3][0] == '"' || $r[3][0] == "'") {
1505                         $r[4] = substr($r[3], 1, -1);
1506                         $r[3] = $r[3][0];
1507                 } elseif ($r[3]!=='') {
1508                         $r[4] = $r[3];
1509                         $r[3] = '';
1510                 } else {
1511                         $r[4] = trim($r[2]);
1512                 }
1513                 $att = filtrer_entites(str_replace("&#39;", "'", $r[4]));
1514         }
1515         else
1516                 $att = NULL;
1517
1518         if ($complet)
1519                 return array($att, $r);
1520         else
1521                 return $att;
1522 }
1523
1524 /**
1525  * modifier (ou inserer) un attribut html dans une balise
1526  *
1527  * http://doc.spip.org/@inserer_attribut
1528  *
1529  * @param string $balise
1530  * @param string $attribut
1531  * @param string $val
1532  * @param bool $proteger
1533  * @param bool $vider
1534  * @return string
1535  */
1536 function inserer_attribut($balise, $attribut, $val, $proteger=true, $vider=false) {
1537         // preparer l'attribut
1538         // supprimer les &nbsp; etc mais pas les balises html
1539         // qui ont un sens dans un attribut value d'un input
1540         if ($proteger) $val = attribut_html($val,false);
1541
1542         // echapper les ' pour eviter tout bug
1543         $val = str_replace("'", "&#039;", $val);
1544         if ($vider AND strlen($val)==0)
1545                 $insert = '';
1546         else
1547                 $insert = " $attribut='$val'";
1548
1549         list($old, $r) = extraire_attribut($balise, $attribut, true);
1550
1551         if ($old !== NULL) {
1552                 // Remplacer l'ancien attribut du meme nom
1553                 $balise = $r[1].$insert.$r[5];
1554         }
1555         else {
1556                 // preferer une balise " />" (comme <img />)
1557                 if (preg_match(',/>,', $balise))
1558                         $balise = preg_replace(",\s?/>,S", $insert." />", $balise, 1);
1559                 // sinon une balise <a ...> ... </a>
1560                 else
1561                         $balise = preg_replace(",\s?>,S", $insert.">", $balise, 1);
1562         }
1563
1564         return $balise;
1565 }
1566
1567 // http://doc.spip.org/@vider_attribut
1568 function vider_attribut ($balise, $attribut) {
1569         return inserer_attribut($balise, $attribut, '', false, true);
1570 }
1571
1572
1573 /**
1574  * Un filtre pour determiner le nom du satut des inscrits
1575  *
1576  * @deprecated a virer en 3.1
1577  *
1578  * @param void|int $id
1579  * @param string $mode
1580  * @return string
1581  */
1582 function tester_config($id, $mode='') {
1583         include_spip('inc/autoriser');
1584         return autoriser('inscrireauteur', $mode, $id) ? $mode : '';
1585 }
1586
1587 //
1588 // Quelques fonctions de calcul arithmetique
1589 //
1590 // http://doc.spip.org/@plus
1591 function plus($a,$b) {
1592         return $a+$b;
1593 }
1594 // http://doc.spip.org/@moins
1595 function moins($a,$b) {
1596         return $a-$b;
1597 }
1598 // http://doc.spip.org/@mult
1599 function mult($a,$b) {
1600         return $a*$b;
1601 }
1602 // http://doc.spip.org/@div
1603 function div($a,$b) {
1604         return $b?$a/$b:0;
1605 }
1606 // http://doc.spip.org/@modulo
1607 function modulo($nb, $mod, $add=0) {
1608         return ($mod?$nb%$mod:0)+$add;
1609 }
1610
1611
1612 // Verifier la conformite d'une ou plusieurs adresses email
1613 //  retourne false ou la  normalisation de la derniere adresse donnee
1614 // http://doc.spip.org/@email_valide
1615 function email_valide($adresses) {
1616         // eviter d'injecter n'importe quoi dans preg_match
1617         if (!is_string($adresses))
1618                 return false;
1619
1620         // Si c'est un spammeur autant arreter tout de suite
1621         if (preg_match(",[\n\r].*(MIME|multipart|Content-),i", $adresses)) {
1622                 spip_log("Tentative d'injection de mail : $adresses");
1623                 return false;
1624         }
1625
1626         foreach (explode(',', $adresses) as $v) {
1627                 // nettoyer certains formats
1628                 // "Marie Toto <Marie@toto.com>"
1629                 $adresse = trim(preg_replace(",^[^<>\"]*<([^<>\"]+)>$,i", "\\1", $v));
1630                 // RFC 822
1631                 if (!preg_match('#^[^()<>@,;:\\"/[:space:]]+(@([-_0-9a-z]+\.)*[-_0-9a-z]+)$#i', $adresse))
1632                         return false;
1633         }
1634         return $adresse;
1635 }
1636
1637 // http://doc.spip.org/@afficher_enclosures
1638 function afficher_enclosures($tags) {
1639         $s = array();
1640         foreach (extraire_balises($tags, 'a') as $tag) {
1641                 if (extraire_attribut($tag, 'rel') == 'enclosure'
1642                 AND $t = extraire_attribut($tag, 'href')) {
1643                         $s[] = preg_replace(',>[^<]+</a>,S',
1644                                 '>'
1645                                 .http_img_pack('attachment-16.png', $t,
1646                                         'title="'.attribut_html($t).'"')
1647                                 .'</a>', $tag);
1648                 }
1649         }
1650         return join('&nbsp;', $s);
1651 }
1652 // http://doc.spip.org/@afficher_tags
1653 function afficher_tags($tags, $rels='tag,directory') {
1654         $s = array();
1655         foreach (extraire_balises($tags, 'a') as $tag) {
1656                 $rel = extraire_attribut($tag, 'rel');
1657                 if (strstr(",$rels,", ",$rel,"))
1658                         $s[] = $tag;
1659         }
1660         return join(', ', $s);
1661 }
1662
1663 // Passe un <enclosure url="fichier" length="5588242" type="audio/mpeg"/>
1664 // au format microformat <a rel="enclosure" href="fichier" ...>fichier</a>
1665 // attention length="zz" devient title="zz", pour rester conforme
1666 // http://doc.spip.org/@enclosure2microformat
1667 function enclosure2microformat($e) {
1668         if (!$url = filtrer_entites(extraire_attribut($e, 'url')))
1669                 $url = filtrer_entites(extraire_attribut($e, 'href'));
1670         $type = extraire_attribut($e, 'type');
1671         if (!$length = extraire_attribut($e, 'length')) {
1672                 # <media:content : longeur dans fileSize. On tente.
1673                 $length = extraire_attribut($e, 'fileSize');
1674         }
1675         $fichier = basename($url);
1676         return '<a rel="enclosure"'
1677                 . ($url? ' href="'.htmlspecialchars($url).'"' : '')
1678                 . ($type? ' type="'.htmlspecialchars($type).'"' : '')
1679                 . ($length? ' title="'.htmlspecialchars($length).'"' : '')
1680                 . '>'.$fichier.'</a>';
1681 }
1682 // La fonction inverse
1683 // http://doc.spip.org/@microformat2enclosure
1684 function microformat2enclosure($tags) {
1685         $enclosures = array();
1686         foreach (extraire_balises($tags, 'a') as $e)
1687         if (extraire_attribut($e, 'rel') == 'enclosure') {
1688                 $url = filtrer_entites(extraire_attribut($e, 'href'));
1689                 $type = extraire_attribut($e, 'type');
1690                 if (!$length = intval(extraire_attribut($e, 'title')))
1691                         $length = intval(extraire_attribut($e, 'length')); # vieux data
1692                 $fichier = basename($url);
1693                 $enclosures[] = '<enclosure'
1694                         . ($url? ' url="'.htmlspecialchars($url).'"' : '')
1695                         . ($type? ' type="'.htmlspecialchars($type).'"' : '')
1696                         . ($length? ' length="'.$length.'"' : '')
1697                         . ' />';
1698         }
1699         return join("\n", $enclosures);
1700 }
1701 // Creer les elements ATOM <dc:subject> a partir des tags
1702 // http://doc.spip.org/@tags2dcsubject
1703 function tags2dcsubject($tags) {
1704         $subjects = '';
1705         foreach (extraire_balises($tags, 'a') as $e) {
1706                 if (extraire_attribut($e, rel) == 'tag') {
1707                         $subjects .= '<dc:subject>'
1708                                 . texte_backend(textebrut($e))
1709                                 . '</dc:subject>'."\n";
1710                 }
1711         }
1712         return $subjects;
1713 }
1714
1715 // retourne la premiere balise du type demande
1716 // ex: [(#DESCRIPTIF|extraire_balise{img})]
1717 // Si on a passe un tableau de textes, renvoyer un tableau de resultats
1718 // http://doc.spip.org/@extraire_balise
1719 function extraire_balise($texte, $tag='a') {
1720         if (is_array($texte)) {
1721                 array_walk($texte,
1722                         create_function('&$a,$key,$t', '$a = extraire_balise($a,$t);'),
1723                         $tag);
1724                 return $texte;
1725         }
1726
1727         if (preg_match(
1728         ",<$tag\b[^>]*(/>|>.*</$tag\b[^>]*>|>),UimsS",
1729         $texte, $regs))
1730                 return $regs[0];
1731 }
1732
1733 // extraire toutes les balises du type demande, sous forme de tableau
1734 // Si on a passe un tableau de textes, renvoyer un tableau de resultats
1735 // http://doc.spip.org/@extraire_balises
1736 function extraire_balises($texte, $tag='a') {
1737         if (is_array($texte)) {
1738                 array_walk($texte,
1739                         create_function('&$a,$key,$t', '$a = extraire_balises($a,$t);'),
1740                         $tag);
1741                 return $texte;
1742         }
1743
1744         if (preg_match_all(
1745         ",<${tag}\b[^>]*(/>|>.*</${tag}\b[^>]*>|>),UimsS",
1746         $texte, $regs, PREG_PATTERN_ORDER))
1747                 return $regs[0];
1748         else
1749                 return array();
1750 }
1751
1752 // comme in_array mais renvoie son 3e arg si le 2er arg n'est pas un tableau
1753 // prend ' ' comme representant de vrai et '' de faux
1754
1755 // http://doc.spip.org/@in_any
1756 function in_any($val, $vals, $def='') {
1757         if (!is_array($vals) AND $v=unserialize($vals)) $vals = $v;
1758   return (!is_array($vals) ? $def : (in_array($val, $vals) ? ' ' : ''));
1759 }
1760
1761 // valeur_numerique("3*2") => 6
1762 // n'accepte que les *, + et - (a ameliorer si on l'utilise vraiment)
1763 // http://doc.spip.org/@valeur_numerique
1764 function valeur_numerique($expr) {
1765         $a = 0;
1766         if (preg_match(',^[0-9]+(\s*[+*-]\s*[0-9]+)*$,S', trim($expr)))
1767                 eval("\$a = $expr;");
1768         return intval($a);
1769 }
1770
1771 // http://doc.spip.org/@regledetrois
1772 function regledetrois($a,$b,$c)
1773 {
1774   return round($a*$b/$c);
1775 }
1776
1777 // Fournit la suite de Input-Hidden correspondant aux parametres de
1778 // l'URL donnee en argument, compatible avec les types_urls depuis [14447].
1779 // cf. tests/filtres/form_hidden.html
1780 // http://doc.spip.org/@form_hidden
1781 function form_hidden($action) {
1782
1783         $contexte = array();
1784         include_spip('inc/urls');
1785         if ($p = urls_decoder_url($action, '')
1786                 AND reset($p)) {
1787                 $fond = array_shift($p);
1788                 if ($fond!='404'){
1789                         $contexte = array_shift($p);
1790                         $contexte['page'] = $fond;
1791                         $action = preg_replace('/([?]'.preg_quote($fond).'[^&=]*[0-9]+)(&|$)/', '?&', $action);
1792                 }
1793         }
1794         // defaire ce qu'a injecte urls_decoder_url : a revoir en modifiant la signature de urls_decoder_url
1795         if (defined('_DEFINIR_CONTEXTE_TYPE') AND _DEFINIR_CONTEXTE_TYPE)
1796                 unset($contexte['type']);
1797         if (defined('_DEFINIR_CONTEXTE_TYPE_PAGE') AND _DEFINIR_CONTEXTE_TYPE_PAGE)
1798                 unset($contexte['type-page']);
1799
1800         // on va remplir un tableau de valeurs en prenant bien soin de ne pas
1801         // ecraser les elements de la forme mots[]=1&mots[]=2
1802         $values = array();
1803
1804         // d'abord avec celles de l'url
1805         if (false !== ($p = strpos($action, '?'))) {
1806                 foreach(preg_split('/&(amp;)?/S',substr($action,$p+1)) as $c){
1807                         list($var,$val) = explode('=', $c, 2);
1808                         if ($var) {
1809                                 $val =  rawurldecode($val);
1810                                 $var =  rawurldecode($var); // decoder les [] eventuels
1811                                 if (preg_match(',\[\]$,S', $var))
1812                                         $values[] = array($var, $val);
1813                                 else if (!isset($values[$var]))
1814                                         $values[$var] = array($var, $val);
1815                         }
1816                 }
1817         }
1818
1819         // ensuite avec celles du contexte, sans doublonner !
1820         foreach($contexte as $var=>$val)
1821                 if (preg_match(',\[\]$,S', $var))
1822                         $values[] = array($var, $val);
1823                 else if (!isset($values[$var]))
1824                         $values[$var] = array($var, $val);
1825
1826         // puis on rassemble le tout
1827         $hidden = array();
1828         foreach($values as $value) {
1829                 list($var,$val) = $value;
1830                 $hidden[] = '<input name="'
1831                         . entites_html($var)
1832                         .'"'
1833                         . (is_null($val)
1834                                 ? ''
1835                                 : ' value="'.entites_html($val).'"'
1836                                 )
1837                         . ' type="hidden"'."\n/>";
1838         }
1839         return join("", $hidden);
1840 }
1841
1842 // http://doc.spip.org/@filtre_bornes_pagination_dist
1843 function filtre_bornes_pagination_dist($courante, $nombre, $max = 10) {
1844         if($max<=0 OR $max>=$nombre)
1845                 return array(1, $nombre);
1846
1847         $premiere = max(1, $courante-floor(($max-1)/2));
1848         $derniere = min($nombre, $premiere+$max-2);
1849         $premiere = $derniere == $nombre ? $derniere-$max+1 : $premiere;
1850         return array($premiere, $derniere);
1851 }
1852
1853
1854 // Ces trois fonctions permettent de simuler les filtres |reset et |end
1855 // pour extraire la premiere ou la derniere valeur d'un tableau ; utile
1856 // pour la pagination (mais peut-etre a refaire plus simplement)
1857 // http://doc.spip.org/@filtre_valeur_tableau
1858 function filtre_valeur_tableau($array, $index) {
1859         if (!is_array($array)
1860         OR !isset($array[$index]))
1861                 return null;
1862         return $array[$index];
1863 }
1864 // http://doc.spip.org/@filtre_reset
1865 function filtre_reset($array) {
1866         return !is_array($array) ? null : reset($array);
1867 }
1868 // http://doc.spip.org/@filtre_end
1869 function filtre_end($array) {
1870         return !is_array($array) ? null : end($array);
1871 }
1872
1873 // http://doc.spip.org/@filtre_push
1874 function filtre_push($array, $val) {
1875         if($array == '' OR !array_push($array, $val)) return '';
1876         return $array;
1877 }
1878
1879 // http://doc.spip.org/@filtre_find
1880 function filtre_find($array, $val) {
1881         return (is_array($array) AND in_array($val, $array));
1882 }
1883
1884
1885 //
1886 // fonction standard de calcul de la balise #PAGINATION
1887 // on peut la surcharger en definissant filtre_pagination dans mes_fonctions
1888 //
1889
1890 // http://doc.spip.org/@filtre_pagination_dist
1891 function filtre_pagination_dist($total, $nom, $position, $pas, $liste = true, $modele='', $connect='', $env=array()) {
1892         static $ancres = array();
1893         if ($pas<1) return '';
1894         $ancre = 'pagination'.$nom; // #pagination_articles
1895         $debut = 'debut'.$nom; // 'debut_articles'
1896
1897         // n'afficher l'ancre qu'une fois
1898         if (!isset($ancres[$ancre]))
1899                 $bloc_ancre = $ancres[$ancre] = "<a name='".$ancre."' id='".$ancre."'></a>";
1900         else $bloc_ancre = '';
1901         // liste = false : on ne veut que l'ancre
1902         if (!$liste)
1903                 return $ancres[$ancre];
1904
1905         $pagination = array(
1906                 'debut' => $debut,
1907                 'url' => parametre_url(self(),'fragment',''), // nettoyer l'id ahah eventuel
1908                 'total' => $total,
1909                 'position' => intval($position),
1910                 'pas' => $pas,
1911                 'nombre_pages' => floor(($total-1)/$pas)+1,
1912                 'page_courante' => floor(intval($position)/$pas)+1,
1913                 'ancre' => $ancre,
1914                 'bloc_ancre' => $bloc_ancre
1915         );
1916         if (is_array($env))
1917                 $pagination = array_merge($env,$pagination);
1918
1919         // Pas de pagination
1920         if ($pagination['nombre_pages']<=1)
1921                 return '';
1922
1923         if ($modele) $modele = '_'.$modele;
1924
1925         return recuperer_fond("modeles/pagination$modele", $pagination, array('trim'=>true), $connect);
1926 }
1927
1928 // passer les url relatives a la css d'origine en url absolues
1929 // http://doc.spip.org/@urls_absolues_css
1930 function urls_absolues_css($contenu, $source) {
1931         $path = suivre_lien(url_absolue($source),'./');
1932
1933         return preg_replace_callback(
1934                 ",url\s*\(\s*['\"]?([^'\"/][^:]*)['\"]?\s*\),Uims",
1935                 create_function('$x',
1936                         'return "url(\"".suivre_lien("'.$path.'",$x[1])."\")";'
1937                 ), $contenu);
1938 }
1939
1940 // recuperere le chemin d'une css existante et :
1941 // 1. regarde si une css inversee droite-gauche existe dans le meme repertoire
1942 // 2. sinon la cree (ou la recree) dans _DIR_VAR/cache_css/
1943 // SI on lui donne a manger une feuille nommee _rtl.css il va faire l'inverse
1944 // http://doc.spip.org/@direction_css
1945 function direction_css ($css, $voulue='') {
1946         if (!preg_match(',(_rtl)?\.css$,i', $css, $r)) return $css;
1947
1948         // si on a precise le sens voulu en argument, le prendre en compte
1949         if ($voulue = strtolower($voulue)) {
1950                 if ($voulue != 'rtl' AND $voulue != 'ltr')
1951                         $voulue = lang_dir($voulue);
1952         }
1953         else
1954                 $voulue =  lang_dir();
1955
1956         $r = count($r) > 1;
1957         $right = $r ? 'left' : 'right'; // 'right' de la css lue en entree
1958         $dir = $r ? 'rtl' : 'ltr';
1959         $ndir = $r ? 'ltr' : 'rtl';
1960
1961         if ($voulue == $dir)
1962                 return $css;
1963
1964         if (
1965                 // url absolue
1966                 preg_match(",^http:,i",$css)
1967                 // ou qui contient un ?
1968                 OR (($p=strpos($css,'?'))!==FALSE)) {
1969                 $distant = true;
1970                 $cssf = parse_url($css);
1971                 $cssf = $cssf['path'].($cssf['query']?"?".$cssf['query']:"");
1972                 $cssf = preg_replace(',[?:&=],', "_", $cssf);
1973         }
1974         else {
1975                 $distant = false;
1976                 $cssf = $css;
1977                 // 1. regarder d'abord si un fichier avec la bonne direction n'est pas aussi
1978                 //propose (rien a faire dans ce cas)
1979                 $f = preg_replace(',(_rtl)?\.css$,i', '_'.$ndir.'.css', $css);
1980                 if (@file_exists($f))
1981                         return $f;
1982         }
1983
1984         // 2.
1985         $dir_var = sous_repertoire (_DIR_VAR, 'cache-css');
1986         $f = $dir_var
1987                 . preg_replace(',.*/(.*?)(_rtl)?\.css,', '\1', $cssf)
1988                 . '.' . substr(md5($cssf), 0,4) . '_' . $ndir . '.css';
1989
1990         // la css peut etre distante (url absolue !)
1991         if ($distant){
1992                 include_spip('inc/distant');
1993                 $contenu = recuperer_page($css);
1994                 if (!$contenu) return $css;
1995         }
1996         else {
1997                 if ((@filemtime($f) > @filemtime($css))
1998                         AND (_VAR_MODE != 'recalcul'))
1999                         return $f;
2000                 if (!lire_fichier($css, $contenu))
2001                         return $css;
2002         }
2003
2004         $contenu = str_replace(
2005                 array('right', 'left', '@@@@L E F T@@@@'),
2006                 array('@@@@L E F T@@@@', 'right', 'left'),
2007                 $contenu);
2008
2009         // reperer les @import auxquels il faut propager le direction_css
2010         preg_match_all(",\@import\s*url\s*\(\s*['\"]?([^'\"/][^:]*)['\"]?\s*\),Uims",$contenu,$regs);
2011         $src = array();$src_direction_css = array();$src_faux_abs=array();
2012         $d = dirname($css);
2013         foreach($regs[1] as $k=>$import_css){
2014                 $css_direction = direction_css("$d/$import_css",$voulue);
2015                 // si la css_direction est dans le meme path que la css d'origine, on tronque le path, elle sera passee en absolue
2016                 if (substr($css_direction,0,strlen($d)+1)=="$d/") $css_direction = substr($css_direction,strlen($d)+1);
2017                 // si la css_direction commence par $dir_var on la fait passer pour une absolue
2018                 elseif (substr($css_direction,0,strlen($dir_var))==$dir_var) {
2019                         $css_direction = substr($css_direction,strlen($dir_var));
2020                         $src_faux_abs["/@@@@@@/".$css_direction] = $css_direction;
2021                         $css_direction = "/@@@@@@/".$css_direction;
2022                 }
2023                 $src[] = $regs[0][$k];
2024                 $src_direction_css[] = str_replace($import_css,$css_direction,$regs[0][$k]);
2025         }
2026         $contenu = str_replace($src,$src_direction_css,$contenu);
2027
2028         $contenu = urls_absolues_css($contenu, $css);
2029
2030         // virer les fausses url absolues que l'on a mis dans les import
2031         if (count($src_faux_abs))
2032                 $contenu = str_replace(array_keys($src_faux_abs),$src_faux_abs,$contenu);
2033
2034         if (!ecrire_fichier($f, $contenu))
2035                 return $css;
2036
2037         return $f;
2038 }
2039
2040 // recuperere le chemin d'une css existante et :
2041 // cree (ou recree) dans _DIR_VAR/cache_css/ une css dont les url relatives sont passees en url absolues
2042 // http://doc.spip.org/@url_absolue_css
2043 function url_absolue_css ($css) {
2044         if (!preg_match(',\.css$,i', $css, $r)) return $css;
2045
2046         $url_absolue_css = url_absolue($css);
2047
2048         $f = basename($css,'.css');
2049         $f = sous_repertoire (_DIR_VAR, 'cache-css')
2050                 . preg_replace(",(.*?)(_rtl|_ltr)?$,","\\1-urlabs-" . substr(md5("$css-urlabs"), 0,4) . "\\2",$f)
2051                 . '.css';
2052
2053         if ((@filemtime($f) > @filemtime($css))
2054         AND (_VAR_MODE != 'recalcul'))
2055                 return $f;
2056
2057         if ($url_absolue_css==$css){
2058                 if (strncmp($GLOBALS['meta']['adresse_site'],$css,$l=strlen($GLOBALS['meta']['adresse_site']))!=0
2059                  OR !lire_fichier(_DIR_RACINE . substr($css,$l), $contenu)){
2060                                 include_spip('inc/distant');
2061                                 if (!$contenu = recuperer_page($css))
2062                                         return $css;
2063                 }
2064         }
2065         elseif (!lire_fichier($css, $contenu))
2066                 return $css;
2067
2068         // passer les url relatives a la css d'origine en url absolues
2069         $contenu = urls_absolues_css($contenu, $css);
2070
2071         // ecrire la css
2072         if (!ecrire_fichier($f, $contenu))
2073                 return $css;
2074
2075         return $f;
2076 }
2077
2078
2079
2080 /**
2081  * Le filtre table_valeur
2082  * permet de recuperer la valeur d'une cle donnee
2083  * dans un tableau (ou un objet).
2084  *
2085  * @param mixed $table
2086  *              Tableau ou objet
2087  *              (ou chaine serialisee de tableau, ce qui permet d'enchainer le filtre)
2088  *
2089  * @param string $cle
2090  *              Cle du tableau (ou parametre public de l'objet)
2091  *              Cette cle peut contenir des caracteres / pour selectionner
2092  *              des sous elements dans le tableau, tel que "sous/element/ici"
2093  *              pour obtenir la valeur de $tableau['sous']['element']['ici']
2094  *
2095  * @param mixed $defaut
2096  *              Valeur par defaut retournee si la cle demandee n'existe pas
2097  *
2098  * @return mixed Valeur trouvee ou valeur par defaut.
2099 **/
2100 function table_valeur($table, $cle, $defaut='') {
2101         foreach (explode('/', $cle) as $k) {
2102
2103                 $table = is_string($table) ? @unserialize($table) : $table;
2104
2105                 if (is_object($table)) {
2106                         $table =  (($k !== "") and isset($table->$k)) ? $table->$k : $defaut;
2107                 } elseif (is_array($table)) {
2108                         $table = isset($table[$k]) ? $table[$k] : $defaut;
2109                 } else {
2110                         $table = $defaut;
2111                 }
2112         }
2113         return $table;
2114 }
2115
2116 // filtre match pour faire des tests avec expression reguliere
2117 // [(#TEXTE|match{^ceci$,Uims})]
2118 // retourne le fragment de chaine qui "matche"
2119 // il est possible de passer en 3eme argument optionnel le numero de parenthese capturante
2120 // accepte egalement la syntaxe #TRUC|match{truc(...)$,1} ou le modificateur n'est pas passe en second argument
2121 // http://doc.spip.org/@match
2122 function match($texte, $expression, $modif="UimsS",$capte=0) {
2123         if (intval($modif) AND $capte==0){
2124                 $capte = $modif;
2125                 $modif = "UimsS";
2126         }
2127         $expression=str_replace("\/","/",$expression);
2128         $expression=str_replace("/","\/",$expression);
2129
2130         if (preg_match('/' . $expression . '/' . $modif,$texte, $r)) {
2131                 if (isset($r[$capte]))
2132                         return $r[$capte];
2133                 else
2134                         return true;
2135         }
2136         return false;
2137 }
2138
2139 // filtre replace pour faire des operations avec expression reguliere
2140 // [(#TEXTE|replace{^ceci$,cela,UimsS})]
2141 // http://doc.spip.org/@replace
2142 function replace($texte, $expression, $replace='', $modif="UimsS") {
2143         $expression=str_replace("\/","/", $expression);
2144         $expression=str_replace("/","\/",$expression);
2145         return preg_replace('/' . $expression . '/' . $modif, $replace, $texte);
2146 }
2147
2148
2149 // cherche les documents numerotes dans un texte traite par propre()
2150 // et affecte les doublons['documents']
2151 // http://doc.spip.org/@traiter_doublons_documents
2152 // http://doc.spip.org/@traiter_doublons_documents
2153 function traiter_doublons_documents(&$doublons, $letexte) {
2154
2155         // Verifier dans le texte & les notes (pas beau, helas)
2156         $t = $letexte.$GLOBALS['les_notes'];
2157
2158         if (strstr($t, 'spip_document_') // evite le preg_match_all si inutile
2159         AND preg_match_all(
2160         ',<[^>]+\sclass=["\']spip_document_([0-9]+)[\s"\'],imsS',
2161         $t, $matches, PREG_PATTERN_ORDER))
2162                 $doublons['documents'] .= "," . join(',', $matches[1]);
2163
2164         return $letexte;
2165 }
2166
2167 // filtre vide qui ne renvoie rien
2168 // http://doc.spip.org/@vide
2169 function vide($texte){
2170         return "";
2171 }
2172
2173 //
2174 // Filtres pour le modele/emb (embed document)
2175 //
2176
2177 // A partir d'un #ENV, retourne des <param ...>
2178 // http://doc.spip.org/@env_to_params
2179 function env_to_params ($texte, $ignore_params=array()) {
2180         $ignore_params = array_merge (
2181                 array('id', 'lang', 'id_document', 'date', 'date_redac', 'align', 'fond', '', 'recurs', 'emb', 'dir_racine'),
2182         $ignore_params);
2183         $tableau = unserialize($texte);
2184         $texte = "";
2185         foreach ($tableau as $i => $j)
2186                 if (is_string($j) AND !in_array($i,$ignore_params))
2187                         $texte .= "<param name='".$i."'\n\tvalue='".$j."' />";
2188         return $texte;
2189 }
2190 // A partir d'un #ENV, retourne des attributs
2191 // http://doc.spip.org/@env_to_attributs
2192 function env_to_attributs ($texte, $ignore_params=array()) {
2193         $ignore_params = array_merge (
2194                 array('id', 'lang', 'id_document', 'date', 'date_redac', 'align', 'fond', '', 'recurs', 'emb', 'dir_racine'),
2195         $ignore_params);
2196         $tableau = unserialize($texte);
2197         $texte = "";
2198         foreach ($tableau as $i => $j)
2199                 if (is_string($j) AND !in_array($i,$ignore_params))
2200                         $texte .= $i."='".$j."' ";
2201         return $texte;
2202 }
2203
2204 // Concatener des chaines
2205 // #TEXTE|concat{texte1,texte2,...}
2206 // http://doc.spip.org/@concat
2207 function concat(){
2208         $args = func_get_args();
2209         return join('', $args);
2210 }
2211
2212
2213 // http://doc.spip.org/@charge_scripts
2214 function charge_scripts($scripts) {
2215   $flux = "";
2216   $args = is_array($scripts)?$scripts:explode("|",$scripts);
2217   foreach($args as $script) {
2218     if(preg_match(",^\w+$,",$script)) {
2219       $path = find_in_path("javascript/$script.js");
2220       if($path) $flux .= spip_file_get_contents($path);
2221     }
2222   }
2223   return $flux;
2224 }
2225
2226
2227
2228 /**
2229  * produit une balise img avec un champ alt d'office si vide
2230  * attention le htmlentities et la traduction doivent etre appliques avant.
2231  *
2232  * http://doc.spip.org/@http_img_pack
2233  *
2234  * @param $img
2235  * @param $alt
2236  * @param string $atts
2237  * @param string $title
2238  * @param array $options
2239  *   chemin_image : utiliser chemin_image sur $img fourni, ou non (oui par dafaut)
2240  *   utiliser_suffixe_size : utiliser ou non le suffixe de taille dans le nom de fichier de l'image
2241  *   sous forme -xx.png (pour les icones essentiellement) (oui par defaut)
2242  * @return string
2243  */
2244 function http_img_pack($img, $alt, $atts='', $title='', $options = array()) {
2245         if (!isset($options['chemin_image']) OR $options['chemin_image']==true)
2246                 $img = chemin_image($img);
2247         if (stripos($atts, 'width')===false){
2248                 // utiliser directement l'info de taille presente dans le nom
2249                 if ((!isset($options['utiliser_suffixe_size']) OR $options['utiliser_suffixe_size']==true)
2250                     AND preg_match(',-([0-9]+)[.](png|gif)$,',$img,$regs)){
2251                         $largeur = $hauteur = intval($regs[1]);
2252                 }
2253                 else{
2254                         $taille = taille_image($img);
2255                         list($hauteur,$largeur) = $taille;
2256                         if (!$hauteur OR !$largeur)
2257                                 return "";
2258                 }
2259                 $atts.=" width='".$largeur."' height='".$hauteur."'";
2260         }
2261         return  "<img src='$img' alt='" . attribut_html($alt ? $alt : $title) . "'"
2262           . ($title ? ' title="'.attribut_html($title).'"' : '')
2263           . " ".ltrim($atts)
2264           . " />";
2265 }
2266
2267 /**
2268  * generer une directive style='background:url()' a partir d'un fichier image
2269  *
2270  * http://doc.spip.org/@http_style_background
2271  *
2272  * @param string $img
2273  * @param string $att
2274  * @return string
2275  */
2276 function http_style_background($img, $att=''){
2277   return " style='background".($att?"":"-image").": url(\"".chemin_image($img)."\")" . ($att ? (' ' . $att) : '') . ";'";
2278 }
2279
2280 /**
2281  * une fonction pour generer une balise img a partir d'un nom de fichier
2282  *
2283  * @param string $img
2284  * @param string $alt
2285  * @param string $class
2286  * @return string
2287  */
2288 function filtre_balise_img_dist($img,$alt="",$class=""){
2289         return http_img_pack($img, $alt, $class?" class='".attribut_html($class)."'":'', '', array('chemin_image'=>false,'utiliser_suffixe_size'=>false));
2290 }
2291
2292
2293 //[(#ENV*|unserialize|foreach)]
2294 // http://doc.spip.org/@filtre_foreach_dist
2295 function filtre_foreach_dist($balise_deserializee, $modele = 'foreach') {
2296         $texte = '';
2297         if(is_array($balise_deserializee))
2298                 foreach($balise_deserializee as $k => $v) {
2299                         $res = recuperer_fond('modeles/'.$modele,
2300                                 array_merge(array('cle' => $k), (is_array($v) ? $v : array('valeur' => $v)))
2301                         );
2302                         $texte .= $res;
2303                 }
2304         return $texte;
2305 }
2306
2307 // renvoie la liste des plugins actifs du site
2308 // si le premier parametre est un prefix de cette liste, renvoie vrai, faux sinon
2309 // la valeur du second parametre si celui-ci renvoie a une information connue
2310 // cf liste_plugin_actifs() pour connaitre les informations affichables
2311 // appelee par la balise #PLUGIN
2312 // http://doc.spip.org/@filtre_info_plugin_dist
2313 function filtre_info_plugin_dist($plugin, $type_info) {
2314         include_spip('inc/plugin');
2315         $plugin = strtoupper($plugin);
2316         $plugins_actifs = liste_plugin_actifs();
2317
2318         if (!$plugin)
2319                 return serialize(array_keys($plugins_actifs));
2320         elseif (empty($plugins_actifs[$plugin]))
2321                 return '';
2322         elseif ($type_info == 'est_actif')
2323                 return $plugins_actifs[$plugin] ? 1 : 0;
2324         elseif (isset($plugins_actifs[$plugin][$type_info]))
2325                 return $plugins_actifs[$plugin][$type_info];
2326         else {
2327                 $get_infos = charger_fonction('get_infos','plugins');
2328                 // On prend en compte les extensions
2329                 if (!is_dir($plugins_actifs[$plugin]['dir_type']))
2330                         $dir_plugins = constant($plugins_actifs[$plugin]['dir_type']);
2331                 else
2332                         $dir_plugins = $plugins_actifs[$plugin]['dir_type'];
2333                 if (!$infos = $get_infos($plugins_actifs[$plugin]['dir'], false, $dir_plugins))
2334                         return '';
2335                 if ($type_info == 'tout')
2336                         return $infos;
2337                 else
2338                         return strval($infos[$type_info]);
2339         }
2340 }
2341
2342
2343 // http://doc.spip.org/@puce_changement_statut
2344 function puce_changement_statut($id_objet, $statut, $id_rubrique, $type, $ajax=false){
2345         $puce_statut = charger_fonction('puce_statut','inc');
2346         return $puce_statut($id_objet, $statut, $id_rubrique, $type, $ajax);
2347 }
2348
2349 /**
2350  * [(#STATUT|puce_statut{article})] affiche une puce passive
2351  * [(#STATUT|puce_statut{article,#ID_ARTICLE,#ID_RUBRIQUE})] affiche une puce avec changement rapide
2352  *
2353  * utilisable sur tout objet qui a declare
2354  * @param string $statut
2355  * @param string $objet
2356  * @param int $id_objet
2357  * @param int $id_parent
2358  * @return string
2359  */
2360 function filtre_puce_statut_dist($statut,$objet,$id_objet=0,$id_parent=0){
2361         static $puce_statut = null;
2362         if (!$puce_statut)
2363                 $puce_statut = charger_fonction('puce_statut','inc');
2364         return $puce_statut($id_objet, $statut, $id_parent, $objet, false, objet_info($objet,'editable')?_ACTIVER_PUCE_RAPIDE:false);
2365 }
2366
2367
2368 /**
2369  * Encoder un contexte pour l'ajax, le signer avec une cle, le crypter
2370  * avec le secret du site, le gziper si possible...
2371  * l'entree peut etre serialisee (le #ENV** des fonds ajax et ajax_stat)
2372  *
2373  * http://doc.spip.org/@encoder_contexte_ajax
2374  *
2375  * @param string|array $c
2376  *   contexte, peut etre un tableau serialize
2377  * @param string $form
2378  *   nom du formulaire eventuel
2379  * @param string $emboite
2380  *   contenu a emboiter dans le conteneur ajax
2381  * @param string $ajaxid
2382  *   ajaxid pour cibler le bloc et forcer sa mise a jour
2383  * @return string
2384  */
2385 function encoder_contexte_ajax($c,$form='', $emboite=NULL, $ajaxid='') {
2386         if (is_string($c)
2387         AND !is_null(@unserialize($c))) {
2388                 $c = unserialize($c);
2389         }
2390
2391         // supprimer les parametres debut_x
2392         // pour que la pagination ajax ne soit pas plantee
2393         // si on charge la page &debut_x=1 : car alors en cliquant sur l'item 0,
2394         // le debut_x=0 n'existe pas, et on resterait sur 1
2395         foreach ($c as $k => $v) {
2396                 if (strpos($k,'debut_') === 0) {
2397                         unset($c[$k]);
2398                 }
2399         }
2400
2401         if (!function_exists('calculer_cle_action'))
2402                 include_spip("inc/securiser_action");
2403         $cle = calculer_cle_action($form.(is_array($c)?serialize($c):$c));
2404         $c = serialize(array($c,$cle));
2405
2406         // on ne stocke pas les contextes dans des fichiers caches
2407         // par defaut, sauf si cette configuration a ete forcee
2408         // OU que la longueur de l''argument generee est plus long
2409         // que ce que telere Suhosin.
2410         $cache_contextes_ajax = (defined('_CACHE_CONTEXTES_AJAX') AND _CACHE_CONTEXTES_AJAX);
2411         if (!$cache_contextes_ajax) {
2412                 $env = $c;
2413                 if (function_exists('gzdeflate') && function_exists('gzinflate')) {
2414                         $env = gzdeflate($env);
2415                         // http://core.spip.org/issues/2667 | https://bugs.php.net/bug.php?id=61287
2416                         if (substr(phpversion(),0,5) == '5.4.0' AND !@gzinflate($env)) {
2417                                 $cache_contextes_ajax = true;
2418                                 spip_log("Contextes AJAX forces en fichiers ! Erreur PHP 5.4.0", _LOG_AVERTISSEMENT);
2419                         }
2420                 }
2421                 $env = _xor($env);
2422                 $env = base64_encode($env);
2423                 // tester Suhosin et la valeur maximale des variables en GET...
2424                 if ($max_len = @ini_get('suhosin.get.max_value_length')
2425                 and $max_len < ($len = strlen($env))) {
2426                         $cache_contextes_ajax = true;
2427                         spip_log("Contextes AJAX forces en fichiers !"
2428                                 . " Cela arrive lorsque la valeur du contexte"
2429                                 . " depasse la longueur maximale autorisee par Suhosin"
2430                                 . " ($max_len) dans 'suhosin.get.max_value_length'. Ici : $len."
2431                                 . " Vous devriez modifier les parametres de Suhosin"
2432                                 . " pour accepter au moins 1024 caracteres.", _LOG_AVERTISSEMENT);
2433                 }
2434         }
2435
2436         if ($cache_contextes_ajax) {
2437                 $dir = sous_repertoire(_DIR_CACHE, 'contextes');
2438                 // stocker les contextes sur disque et ne passer qu'un hash dans l'url
2439                 $md5 = md5($c);
2440                 ecrire_fichier("$dir/c$md5",$c);
2441                 $env = $md5;
2442         }
2443
2444         if ($emboite === NULL) return $env;
2445         if (!trim($emboite)) return "";
2446         // toujours encoder l'url source dans le bloc ajax
2447         $r = self();
2448         $r = ' data-origin="'.$r.'"';
2449         $class = 'ajaxbloc';
2450         if ($ajaxid AND is_string($ajaxid)){
2451                 $class .= ' ajax-id-'.$ajaxid;
2452         }
2453         $compl = "aria-live='polite' aria-atomic='true' ";
2454         return "<div class='$class' ".$compl."data-ajax-env='$env'$r>\n$emboite</div><!--ajaxbloc-->\n";
2455 }
2456
2457 // la procedure inverse de encoder_contexte_ajax()
2458 // http://doc.spip.org/@decoder_contexte_ajax
2459 function decoder_contexte_ajax($c,$form='') {
2460         if (!function_exists('calculer_cle_action'))
2461                 include_spip("inc/securiser_action");
2462         if (( (defined('_CACHE_CONTEXTES_AJAX') AND _CACHE_CONTEXTES_AJAX) OR strlen($c)==32)
2463                 AND $dir = sous_repertoire(_DIR_CACHE, 'contextes')
2464                 AND lire_fichier("$dir/c$c",$contexte)) {
2465                         $c = $contexte;
2466         } else {
2467                 $c = @base64_decode($c);
2468                 $c = _xor($c);
2469                 if (function_exists('gzdeflate') && function_exists('gzinflate'))
2470                         $c = @gzinflate($c);
2471         }
2472         list($env, $cle) = @unserialize($c);
2473
2474         if ($cle == calculer_cle_action($form.(is_array($env)?serialize($env):$env)))
2475                 return $env;
2476         return false;
2477 }
2478
2479 // encrypter/decrypter un message
2480 // http://www.php.net/manual/fr/language.operators.bitwise.php#81358
2481 // http://doc.spip.org/@_xor
2482 function _xor($message, $key=null){
2483         if (is_null($key)) {
2484                 if (!function_exists('calculer_cle_action'))
2485                         include_spip("inc/securiser_action");
2486                 $key = pack("H*", calculer_cle_action('_xor'));
2487         }
2488
2489         $keylen = strlen($key);
2490         $messagelen = strlen($message);
2491         for($i=0; $i<$messagelen; $i++)
2492                 $message[$i] = ~($message[$i]^$key[$i%$keylen]);
2493
2494         return $message;
2495 }
2496
2497 // Les vrai fonctions sont dans le plugin forum, mais on evite ici une erreur du compilateur
2498 // en absence du plugin
2499 function url_reponse_forum($texte){return $texte;}
2500 function url_rss_forum($texte){return $texte;}
2501
2502
2503 /**
2504  * une fonction pour generer des menus avec liens
2505  * ou un <strong class='on'> non clicable lorsque l'item est selectionne
2506  *
2507  * @param string $url
2508  * @param string $libelle
2509  *   le texte du lien
2510  * @param bool $on
2511  *   etat expose (genere un strong) ou non (genere un lien)
2512  * @param string $class
2513  * @param string $title
2514  * @param string $rel
2515  * @param string $evt
2516  *   complement a la balise a pour gerer un evenement javascript, de la forme " onclick='...'"
2517  * @return string
2518  */
2519 function lien_ou_expose($url,$libelle=NULL,$on=false,$class="",$title="",$rel="", $evt=''){
2520         if ($on) {
2521                 $bal = "strong";
2522                 $att = "class='on'";
2523         } else {
2524                 $bal = 'a';
2525                 $att = "href='$url'"
2526                 .($title?" title='".attribut_html($title)."'":'')
2527                 .($class?" class='".attribut_html($class)."'":'')
2528                 .($rel?" rel='".attribut_html($rel)."'":'')
2529                 .$evt;
2530         }
2531         if ($libelle === NULL)
2532                 $libelle = $url;
2533         return "<$bal $att>$libelle</$bal>";
2534 }
2535
2536
2537 /**
2538  * Afficher un message "un truc"/"N trucs"
2539  * Les items sont à indiquer comme pour la fonction _T() sous la forme :
2540  * "module:chaine"
2541  *
2542  * @param int $nb : le nombre
2543  * @param string $chaine_un : l'item de langue si $nb vaut un
2544  * @param string $chaine_plusieurs : l'item de lanque si $nb > 1
2545  * @param string $var : La variable à remplacer par $nb dans l'item de langue (facultatif, défaut "nb")
2546  * @param array $vars : Les autres variables nécessaires aux chaines de langues (facultatif)
2547  * @return string : la chaine de langue finale en utilisant la fonction _T()
2548  */
2549 function singulier_ou_pluriel($nb,$chaine_un,$chaine_plusieurs,$var='nb',$vars=array()){
2550         if (!$nb=intval($nb)) return "";
2551         if (!is_array($vars)) return "";
2552         $vars[$var] = $nb;
2553         if ($nb>1) return _T($chaine_plusieurs, $vars);
2554         else return _T($chaine_un,$vars);
2555 }
2556
2557
2558 /**
2559  * Fonction de base pour une icone dans un squelette
2560  * structure html : <span><a><img><b>texte</b></span>
2561  *
2562  * @param string $type
2563  *  'lien' ou 'bouton'
2564  * @param string $lien
2565  *  url
2566  * @param string $texte
2567  *  texte du lien / alt de l'image
2568  * @param string $fond
2569  *  objet avec ou sans son extension et sa taille (article, article-24, article-24.png)
2570  * @param string $fonction
2571  *  new/del/edit
2572  * @param string $class
2573  *  classe supplementaire (horizontale, verticale, ajax ...)
2574  * @param string $javascript
2575  *  "onclick='...'" par exemple
2576  * @return string
2577  */
2578 function prepare_icone_base($type, $lien, $texte, $fond, $fonction="", $class="",$javascript=""){
2579         if (in_array($fonction,array("del","supprimer.gif")))
2580                 $class .= ' danger';
2581         elseif ($fonction == "rien.gif")
2582                 $fonction = "";
2583         elseif ($fonction == "delsafe")
2584                 $fonction = "del";
2585
2586         // remappage des icone : article-24.png+new => article-new-24.png
2587         if ($icone_renommer = charger_fonction('icone_renommer','inc',true))
2588                 list($fond,$fonction) = $icone_renommer($fond,$fonction);
2589
2590         // ajouter le type d'objet dans la class de l'icone
2591         $class .= " " . substr(basename($fond),0,-4);
2592
2593         $alt = attribut_html($texte);
2594         $title = " title=\"$alt\""; // est-ce pertinent de doubler le alt par un title ?
2595
2596         $ajax = "";
2597         if (strpos($class,"ajax")!==false) {
2598                         $ajax="ajax";
2599                 if (strpos($class,"preload")!==false)
2600                         $ajax.=" preload";
2601                 if (strpos($class,"nocache")!==false)
2602                         $ajax.=" nocache";
2603                 $ajax=" class='$ajax'";
2604         }
2605
2606         $size = 24;
2607         if (preg_match("/-([0-9]{1,3})[.](gif|png)$/i",$fond,$match))
2608                 $size = $match[1];
2609
2610         if ($fonction){
2611                 // 2 images pour composer l'icone : le fond (article) en background,
2612                 // la fonction (new) en image
2613                 $icone = http_img_pack($fonction, $alt, "width='$size' height='$size'\n" .
2614                                         http_style_background($fond));
2615         }
2616         else {
2617                 $icone = http_img_pack($fond, $alt, "width='$size' height='$size'");
2618         }
2619
2620         if ($type=='lien')
2621                 return "<span class='icone s$size $class'>"
2622                 . "<a href='$lien'$title$ajax$javascript>"
2623                 . $icone
2624                 . "<b>$texte</b>"
2625                 . "</a></span>\n";
2626
2627         else
2628                 return bouton_action("$icone<b>$texte</b>",$lien,"icone s$size $class",$javascript,$alt);
2629 }
2630
2631 function icone_base($lien, $texte, $fond, $fonction="", $class="",$javascript=""){
2632         return prepare_icone_base('lien', $lien, $texte, $fond, $fonction, $class, $javascript);
2633 }
2634 function filtre_icone_verticale_dist($lien, $texte, $fond, $fonction="", $class="",$javascript=""){
2635         return icone_base($lien,$texte,$fond,$fonction,"verticale $class",$javascript);
2636 }
2637 function filtre_icone_horizontale_dist($lien, $texte, $fond, $fonction="", $class="",$javascript=""){
2638         return icone_base($lien,$texte,$fond,$fonction,"horizontale $class",$javascript);
2639 }
2640
2641 function filtre_bouton_action_horizontal_dist($lien, $texte, $fond, $fonction="", $class="",$confirm=""){
2642         return prepare_icone_base('bouton', $lien, $texte, $fond, $fonction, "horizontale $class", $confirm);
2643 }
2644 /*
2645  * Filtre icone pour compatibilite
2646  * mappe sur icone_base
2647  */
2648 function filtre_icone_dist($lien, $texte, $fond, $align="", $fonction="", $class="",$javascript=""){
2649         return icone_base($lien,$texte,$fond,$fonction,"verticale $align $class",$javascript);
2650 }
2651
2652
2653 /**
2654  * filtre explode pour les squelettes permettant d'ecrire
2655  * #GET{truc}|explode{-}
2656  *
2657  * @param strong $a
2658  * @param string $b
2659  * @return array
2660  */
2661 function filtre_explode_dist($a,$b){return explode($b,$a);}
2662
2663 /**
2664  * filtre implode pour les squelettes permettant d'ecrire
2665  * #GET{truc}|implode{-}
2666  *
2667  * @param array $a
2668  * @param string $b
2669  * @return string
2670  */
2671 function filtre_implode_dist($a,$b){return is_array($a)?implode($b,$a):$a;}
2672
2673 /**
2674  * Produire les styles prives qui associent item de menu avec icone en background
2675  * @return string
2676  */
2677 function bando_images_background(){
2678         include_spip('inc/bandeau');
2679         // recuperer tous les boutons et leurs images
2680         $boutons = definir_barre_boutons(definir_barre_contexte(),true,false);
2681
2682         $res = "";
2683         foreach($boutons as $page => $detail){
2684                 if ($detail->icone AND strlen(trim($detail->icone)))
2685                         $res .="\n.navigation_avec_icones #bando1_$page {background-image:url(".$detail->icone.");}";
2686                 $selecteur = (in_array($page,array('outils_rapides','outils_collaboratifs'))?"":".navigation_avec_icones ");
2687                 if (is_array($detail->sousmenu))
2688                         foreach($detail->sousmenu as $souspage=>$sousdetail)
2689                                 if ($sousdetail->icone AND strlen(trim($sousdetail->icone)))
2690                                         $res .="\n$selecteur.bando2_$souspage {background-image:url(".$sousdetail->icone.");}";
2691         }
2692         return $res;
2693 }
2694
2695 /**
2696  * Generer un bouton_action
2697  * utilise par #BOUTON_ACTION
2698  *
2699  * @param string $libelle
2700  * @param string $url
2701  * @param string $class
2702  * @param string $confirm
2703  *   message de confirmation oui/non avant l'action
2704  * @param string $title
2705  * @param string $callback
2706  *   callback js a appeler lors de l'evenement action (apres confirmation eventuelle si $confirm est non vide)
2707  *   et avant execution de l'action. Si la callback renvoie false, elle annule le declenchement de l'action
2708  * @return string
2709  */
2710 function bouton_action($libelle, $url, $class="", $confirm="", $title="", $callback=""){
2711         if ($confirm) {
2712                 $confirm = "confirm(\"" . attribut_html($confirm) . "\")";
2713           if ($callback)
2714                   $callback = "$confirm?($callback):false";
2715           else
2716                   $callback = $confirm;
2717         }
2718         $onclick = $callback?" onclick='return ".addcslashes($callback,"'")."'":"";
2719         $title = $title ? " title='$title'" : "";
2720         return "<form class='bouton_action_post $class' method='post' action='$url'><div>".form_hidden($url)
2721                 ."<button type='submit' class='submit'$title$onclick>$libelle</button></div></form>";
2722 }
2723
2724
2725 /**
2726  * Proteger les champs passes dans l'url et utiliser dans {tri ...}
2727  * preserver l'espace pour interpreter ensuite num xxx et multi xxx
2728  * @param string $t
2729  * @return string
2730  */
2731 function tri_protege_champ($t){
2732         return preg_replace(',[^\s\w.+],','',$t);
2733 }
2734
2735 /**
2736  * Interpreter les multi xxx et num xxx utilise comme tri
2737  * pour la clause order
2738  * 'multi xxx' devient simplement 'multi' qui est calcule dans le select
2739  * @param string $t
2740  * @param array $from
2741  * @return string
2742  */
2743 function tri_champ_order($t, $from=null){
2744         if(strncmp($t,'multi ',6)==0){
2745                 return "multi";
2746         }
2747
2748         $champ = $t;
2749
2750         if (strncmp($t,'num ',4)==0)
2751                 $champ = substr($t,4);
2752         // enlever les autres espaces non evacues par tri_protege_champ
2753         $champ = preg_replace(',\s,','',$champ);
2754
2755         if (is_array($from)){
2756                 $trouver_table = charger_fonction('trouver_table','base');
2757                 foreach($from as $idt=>$table_sql){
2758                         if ($desc = $trouver_table($table_sql)
2759                                 AND isset($desc['field'][$champ])){
2760                                 $champ = "$idt.$champ";
2761                                 break;
2762                         }
2763                 }
2764         }
2765         if (strncmp($t,'num ',4)==0)
2766                 return "0+$champ";
2767         else
2768                 return $champ;
2769 }
2770
2771 /**
2772  * Interpreter les multi xxx et num xxx utilise comme tri
2773  * pour la clause select
2774  * 'multi xxx' devient select "...." as multi
2775  * les autres cas ne produisent qu'une chaine vide '' en select
2776  * 'hasard' devient 'rand() AS hasard' dans le select
2777  *
2778  * @param string $t
2779  * @return string
2780  */
2781 function tri_champ_select($t){
2782         if(strncmp($t,'multi ',6)==0){
2783                 $t = substr($t,6);
2784                 $t = preg_replace(',\s,','',$t);
2785                 $t = sql_multi($t,$GLOBALS['spip_lang']);
2786                 return $t;
2787         }
2788         if(trim($t)=='hasard'){
2789                 return 'rand() AS hasard';
2790         }
2791         return "''";
2792 }
2793
2794
2795 /**
2796  * Donner n'importe quelle information sur un objet de maniere generique.
2797  *
2798  * La fonction va gerer en interne deux cas particuliers les plus utilises :
2799  * l'URL et le titre (qui n'est pas forcemment le champ SQL "titre").
2800  *
2801  * On peut ensuite personnaliser les autres infos en creant une fonction
2802  * generer_<nom_info>_entite($id_objet, $type_objet, $ligne).
2803  * $ligne correspond a la ligne SQL de tous les champs de l'objet, les fonctions
2804  * de personnalisation n'ont donc pas a refaire de requete.
2805  *
2806  * @param int $id_objet
2807  * @param string $type_objet
2808  * @param string $info
2809  * @param string $etoile
2810  * @return string
2811  */
2812 function generer_info_entite($id_objet, $type_objet, $info, $etoile=""){
2813         global $table_des_traitements;
2814         static $trouver_table=null;
2815         static $objets;
2816
2817         // On verifie qu'on a tout ce qu'il faut
2818         $id_objet = intval($id_objet);
2819         if (!($id_objet and $type_objet and $info))
2820                 return '';
2821
2822         // si on a deja note que l'objet n'existe pas, ne pas aller plus loin
2823         if (isset($objets[$type_objet]) AND $objets[$type_objet]===false)
2824                 return '';
2825
2826         // Si on demande l'url, on retourne direct la fonction
2827         if ($info == 'url')
2828                 return generer_url_entite($id_objet, $type_objet);
2829
2830         // Sinon on va tout chercher dans la table et on garde en memoire
2831         $demande_titre = ($info == 'titre');
2832
2833         // On ne fait la requete que si on a pas deja l'objet ou si on demande le titre mais qu'on ne l'a pas encore
2834         if (!isset($objets[$type_objet][$id_objet])
2835           OR
2836           ($demande_titre AND !isset($objets[$type_objet][$id_objet]['titre']))
2837           ){
2838                 if (!$trouver_table)
2839                         $trouver_table = charger_fonction('trouver_table','base');
2840                 $desc = $trouver_table(table_objet_sql($type_objet));
2841                 if (!$desc)
2842                         return $objets[$type_objet] = false;
2843
2844                 // Si on demande le titre, on le gere en interne
2845                 $champ_titre = "";
2846                 if ($demande_titre){
2847                         // si pas de titre declare mais champ titre, il sera peuple par le select *
2848                         $champ_titre = (!empty($desc['titre'])) ? ', ' . $desc['titre']:'';
2849                 }
2850                 include_spip('base/abstract_sql');
2851                 include_spip('base/connect_sql');
2852                 $objets[$type_objet][$id_objet] = sql_fetsel(
2853                         '*'.$champ_titre,
2854                         $desc['table_sql'],
2855                         id_table_objet($type_objet).' = '.intval($id_objet)
2856                 );
2857         }
2858
2859         // Si la fonction generer_TRUC_TYPE existe, on l'utilise pour formater $info_generee
2860         if ($generer = charger_fonction("generer_${info}_${type_objet}", '', true))
2861                 $info_generee = $generer($id_objet, $objets[$type_objet][$id_objet]);
2862         // Si la fonction generer_TRUC_entite existe, on l'utilise pour formater $info_generee
2863         else if ($generer = charger_fonction("generer_${info}_entite", '', true))
2864                 $info_generee = $generer($id_objet, $type_objet, $objets[$type_objet][$id_objet]);
2865         // Sinon on prend directement le champ SQL tel quel
2866         else
2867                 $info_generee = (isset($objets[$type_objet][$id_objet][$info])?$objets[$type_objet][$id_objet][$info]:'');
2868
2869         // On va ensuite chercher les traitements automatiques a faire
2870         $champ = strtoupper($info);
2871         $traitement = isset($table_des_traitements[$champ]) ? $table_des_traitements[$champ] : false;
2872         $table_sql = table_objet_sql($type_objet);
2873
2874         if (!$etoile
2875                 AND is_array($traitement)
2876           AND (isset($traitement[$table_sql]) OR isset($traitement[0]))){
2877                 $traitement = $traitement[isset($traitement[$table_sql]) ? $table_sql : 0];
2878                 $traitement = str_replace('%s', "'".texte_script($info_generee)."'", $traitement);
2879                 // FIXME: $connect et $Pile[0] font souvent partie des traitements.
2880                 // on les definit pour eviter des notices, mais ce fonctionnement est a ameliorer !
2881                 $connect = ""; $Pile = array(0 => array('id_objet'=>$id_objet,'objet'=>$type_objet));
2882                 eval("\$info_generee = $traitement;");
2883         }
2884
2885         return $info_generee;
2886 }
2887
2888 /**
2889  * Wrap un texte avec des balises
2890  * wrap('mot','<b>') => '<b>mot</b>'
2891  * @param string $texte
2892  * @param string $wrap
2893  * @return string
2894  */
2895 function wrap($texte,$wrap) {
2896         $balises = extraire_balises($wrap);
2897         if (preg_match_all(",<([a-z]\w*)\b[^>]*>,UimsS",$wrap, $regs, PREG_PATTERN_ORDER)) {
2898                 $texte = $wrap . $texte;
2899                 $regs = array_reverse($regs[1]);
2900                 $wrap = "</".implode("></",$regs).">";
2901                 $texte = $texte . $wrap;
2902         }
2903         return $texte;
2904 }
2905
2906
2907 // afficher proprement n'importe quoi
2908 // en cas de table profonde, l'option $join ne s'applique qu'au plus haut niveau
2909 // c'est VOULU !  Exemple : [(#VALEUR|print{<hr />})] va afficher de gros blocs
2910 // separes par des lignes, avec a l'interieur des trucs separes par des virgules
2911 function filtre_print_dist($u, $join=', ') {
2912         if (is_string($u))
2913                 return typo($u);
2914
2915         if (is_array($u))
2916                 return join($join, array_map('filtre_print_dist', $u));
2917
2918         if (is_object($u))
2919                 return join($join, array_map('filtre_print_dist', (array) $u));
2920
2921         return $u;
2922 }
2923
2924
2925 /**
2926  * Renvoyer l'info d'un objet
2927  * telles que definies dans declarer_tables_objets_sql
2928  *
2929  * @param string $objet
2930  * @param string $info
2931  * @return string
2932  */
2933 function objet_info($objet,$info){
2934         $table = table_objet_sql($objet);
2935         $infos = lister_tables_objets_sql($table);
2936         return (isset($infos[$info])?$infos[$info]:'');
2937 }
2938
2939 /**
2940  * Filtre pour afficher 'Aucun truc' ou '1 truc' ou 'N trucs'
2941  * avec la bonne chaine de langue en fonction de l'objet utilise
2942  * @param  $nb
2943  * @param  $objet
2944  * @return mixed|string
2945  */
2946 function objet_afficher_nb($nb, $objet){
2947         if (!$nb)
2948                 return _T(objet_info($objet,'info_aucun_objet'));
2949         else
2950                 return _T(objet_info($objet,$nb==1?'info_1_objet':'info_nb_objets'),array('nb'=>$nb));
2951 }
2952
2953 /**
2954  * Filtre pour afficher l'img icone d'un objet
2955  *
2956  * @param string $objet
2957  * @param int $taille
2958  * @return string
2959  */
2960 function objet_icone($objet,$taille=24){
2961         $icone = objet_info($objet,'icone_objet')."-".$taille.".png";
2962         $icone = chemin_image($icone);
2963         $balise_img = charger_filtre('balise_img');
2964         return $icone?$balise_img($icone,_T(objet_info($objet,'texte_objet'))):'';
2965 }
2966
2967 /**
2968  * Fonction de secours pour inserer le head_css de facon conditionnelle
2969  *
2970  * Appelée en filtre sur le squelette qui contient #INSERT_HEAD,
2971  * elle vérifie l'absence éventuelle de #INSERT_HEAD_CSS et y suplée si besoin
2972  * pour assurer la compat avec les squelettes qui n'utilisent pas.
2973  *
2974  * @param string $flux Code HTML
2975  * @return string      Code HTML
2976  */
2977 function insert_head_css_conditionnel($flux){
2978         if (strpos($flux,'<!-- insert_head_css -->')===false
2979                 AND $p=strpos($flux,'<!-- insert_head -->')){
2980                 // plutot avant le premier js externe (jquery) pour etre non bloquant
2981                 if ($p1 = stripos($flux,'<script src=') AND $p1<$p)
2982                         $p = $p1;
2983                 $flux = substr_replace($flux,pipeline('insert_head_css','<!-- insert_head_css -->'),$p,0);
2984         }
2985         return $flux;
2986 }
2987
2988 /**
2989  * Produire un fichier statique a partir d'un squelette dynamique
2990  * Permet ensuite a apache de le servir en statique sans repasser
2991  * par spip.php a chaque hit sur le fichier
2992  * si le format (css ou js) est passe dans contexte['format'], on l'utilise
2993  * sinon on regarde si le fond finit par .css ou .js
2994  * sinon on utilie "html"
2995  *
2996  * @param string $fond
2997  * @param array $contexte
2998  * @param array $options
2999  * @param string $connect
3000  * @return string
3001  */
3002 function produire_fond_statique($fond, $contexte=array(), $options = array(), $connect=''){
3003         if (isset($contexte['format'])){
3004                 $extension = $contexte['format'];
3005                 unset($contexte['format']);
3006         }
3007         else {
3008                 $extension = "html";
3009                 if (preg_match(',[.](css|js|json)$,',$fond,$m))
3010                         $extension = $m[1];
3011         }
3012         // recuperer le contenu produit par le squelette
3013         $options['raw'] = true;
3014         $cache = recuperer_fond($fond,$contexte,$options,$connect);
3015
3016         // calculer le nom de la css
3017         $dir_var = sous_repertoire (_DIR_VAR, 'cache-'.$extension);
3018         $nom_safe = preg_replace(",\W,",'_',str_replace('.','_',$fond));
3019         $filename = $dir_var . $extension."dyn-$nom_safe-".substr(md5($fond.serialize($contexte).$connect),0,8) .".$extension";
3020
3021         // mettre a jour le fichier si il n'existe pas
3022         // ou trop ancien
3023         // le dernier fichier produit est toujours suffixe par .last
3024         // et recopie sur le fichier cible uniquement si il change
3025         if (!file_exists($filename)
3026                 OR !file_exists($filename.".last")
3027                 OR (isset($cache['lastmodified']) AND $cache['lastmodified'] AND filemtime($filename.".last")<$cache['lastmodified'])
3028                 OR (defined('_VAR_MODE') AND _VAR_MODE=='recalcul')) {
3029                 $contenu = $cache['texte'];
3030                 // passer les urls en absolu si c'est une css
3031                 if ($extension=="css")
3032                         $contenu = urls_absolues_css($contenu, test_espace_prive()?generer_url_ecrire('accueil'):generer_url_public($fond));
3033
3034                 // ne pas insérer de commentaire si c'est du json
3035                 if ($extension!="json") {
3036                         $comment = "/* #PRODUIRE{fond=$fond";
3037                         foreach($contexte as $k=>$v)
3038                                 $comment .= ",$k=$v";
3039                         // pas de date dans le commentaire car sinon ca invalide le md5 et force la maj
3040                         // mais on peut mettre un md5 du contenu, ce qui donne un aperu rapide si la feuille a change ou non
3041                         $comment .="}\n   md5:".md5($contenu)." */\n";
3042                 }
3043                 // et ecrire le fichier
3044                 ecrire_fichier($filename.".last",$comment.$contenu);
3045                 // regarder si on recopie
3046                 if (!file_exists($filename)
3047                   OR md5_file($filename)!==md5_file($filename.".last")){
3048                         @copy($filename.".last",$filename);
3049                         spip_clearstatcache(true,$filename); // eviter que PHP ne reserve le vieux timestamp
3050                 }
3051         }
3052
3053         return $filename;
3054 }
3055
3056 /**
3057  * Ajouter un timestamp a une url de fichier
3058  * [(#CHEMIN{monfichier}|timestamp)]
3059  *
3060  * @param string $fichier
3061  * @return string
3062  */
3063 function timestamp($fichier){
3064         if (!$fichier) return $fichier;
3065         $m = filemtime($fichier);
3066         return "$fichier?$m";
3067 }
3068
3069 /**
3070  * Nettoyer le titre d'un email
3071  * eviter une erreur lorsqu'on utilise |nettoyer_titre_email dans un squelette de mail
3072  * @param  $titre
3073  * @return mixed
3074  */
3075 function filtre_nettoyer_titre_email_dist($titre){
3076         include_spip('inc/envoyer_mail');
3077         return nettoyer_titre_email($titre);
3078 }
3079
3080 /**
3081  * Afficher le sélecteur de rubrique
3082  *
3083  * Il permet de placer un objet dans la hiérarchie des rubriques de SPIP
3084  *
3085  * @param string $titre
3086  * @param int $id_objet
3087  * @param int $id_parent
3088  * @param string $objet
3089  * @param int $id_secteur
3090  * @param bool $restreint
3091  * @param bool $actionable
3092  *   true : fournit le selecteur dans un form directement postable
3093  * @param bool $retour_sans_cadre
3094  * @return string
3095  */
3096 function filtre_chercher_rubrique_dist($titre,$id_objet, $id_parent, $objet, $id_secteur, $restreint,$actionable = false, $retour_sans_cadre=false){
3097         include_spip('inc/filtres_ecrire');
3098         return chercher_rubrique($titre,$id_objet, $id_parent, $objet, $id_secteur, $restreint,$actionable, $retour_sans_cadre);
3099 }
3100
3101 /**
3102  * Rediriger une page suivant une autorisation,
3103  * et ce, n'importe où dans un squelette, même dans les inclusions.
3104  * Exemple :
3105  * [(#AUTORISER{non}|sinon_interdire_acces)]
3106  * [(#AUTORISER{non}|sinon_interdire_acces{#URL_PAGE{login}, 401})]
3107  *
3108  * @param bool $ok Indique si l'on doit rediriger ou pas
3109  * @param string $url Adresse vers laquelle rediriger
3110  * @param int $statut Statut HTML avec lequel on redirigera
3111  * @return string
3112  */
3113 function sinon_interdire_acces($ok=false, $url='', $statut=0){
3114         if ($ok) return '';
3115
3116         // Vider tous les tampons
3117         $level = @ob_get_level();
3118         while ($level--)
3119                 @ob_end_clean();
3120
3121         include_spip('inc/headers');
3122         $statut = intval($statut);
3123
3124         // Si aucun argument on essaye de deviner quoi faire par défaut
3125         if (!$url and !$statut){
3126                 // Si on est dans l'espace privé, on génère du 403 Forbidden
3127                 if (test_espace_prive()){
3128                         http_status(403);
3129                         $echec = charger_fonction('403','exec');
3130                         $echec();
3131                 }
3132                 // Sinon dans l'espace public on redirige vers une 404 par défaut, car elle toujours présente normalement
3133                 else{
3134                         $statut = 404;
3135                 }
3136         }
3137
3138         // On suit les directives indiquées dans les deux arguments
3139
3140         // S'il y a un statut
3141         if ($statut){
3142                 // Dans tous les cas on modifie l'entité avec ce qui est demandé
3143                 http_status($statut);
3144                 // Si le statut est une erreur et qu'il n'y a pas de redirection on va chercher le squelette du même nom
3145                 if ($statut >= 400 and !$url)
3146                         echo recuperer_fond("$statut");
3147         }
3148
3149         // S'il y a une URL, on redirige (si pas de statut, la fonction mettra 302 par défaut)
3150         if ($url) redirige_par_entete($url, '', $statut);
3151
3152         exit;
3153 }
3154
3155 /**
3156  * Assurer le fonctionnement de |compacte meme sans l'extension compresseur
3157  * @param string $source
3158  * @param null|string $format
3159  * @return string
3160  */
3161 function filtre_compacte_dist($source, $format = null){
3162         if (function_exists('compacte'))
3163                 return compacte($source, $format);
3164         return $source;
3165 }
3166
3167 ?>