www/ecrire/inc/filtres.php

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