modules/search/classes.inc.php

   1 <?php
   2 /***************************************************************************
   3  *  Copyright (C) 2003-2007 Polytechnique.org                              *
   4  *  http://opensource.polytechnique.org/                                   *
   5  *                                                                         *
   6  *  This program is free software; you can redistribute it and/or modify   *
   7  *  it under the terms of the GNU General Public License as published by   *
   8  *  the Free Software Foundation; either version 2 of the License, or      *
   9  *  (at your option) any later version.                                    *
  10  *                                                                         *
  11  *  This program is distributed in the hope that it will be useful,        *
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of         *
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          *
  14  *  GNU General Public License for more details.                           *
  15  *                                                                         *
  16  *  You should have received a copy of the GNU General Public License      *
  17  *  along with this program; if not, write to the Free Software            *
  18  *  Foundation, Inc.,                                                      *
  19  *  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                *
  20  ***************************************************************************/
  21
  22 require_once("xorg.misc.inc.php");
  23
  24 // {{{ Global variables used for the search Queries
  25
  26 $globals->search->result_fields = '
  27     u.user_id, u.promo, u.matricule, u.matricule_ax,
  28     if(u.nom_usage=\'\', u.nom, u.nom_usage) AS NomSortKey,
  29     u.nom_usage,u.date,
  30     u.deces!=0 AS dcd,u.deces,
  31     u.perms IN (\'admin\',\'user\', \'disabled\') AS inscrit,
  32     u.perms != \'pending\' AS wasinscrit,
  33     FIND_IN_SET(\'femme\', u.flags) AS sexe,
  34     a.alias AS forlife,
  35     ad0.text AS app0text, ad0.url AS app0url, ai0.type AS app0type,
  36     ad1.text AS app1text, ad1.url AS app1url, ai1.type AS app1type,
  37     es.label AS secteur, ef.fonction_fr AS fonction,
  38     IF(n.nat=\'\',n.pays,n.nat) AS nat, n.a2 AS iso3166,
  39     COUNT(em.email) > 0 AS actif,';
  40 // hide private information if not logged
  41 if (S::logged())
  42     $globals->search->result_fields .='
  43         q.profile_web AS web,
  44         q.profile_mobile AS mobile,
  45         q.profile_freetext AS freetext,
  46         adr.city, gp.pays AS countrytxt, gr.name AS region,
  47         e.entreprise,';
  48 else
  49     $globals->search->result_fields .="
  50     IF(q.profile_web_pub='public', q.profile_web, '') AS web,
  51         IF(q.profile_mobile_pub='public', q.profile_mobile, '') AS mobile,
  52         IF(q.profile_freetext_pub='public', q.profile_freetext, '') AS freetext,
  53         IF(adr.pub='public', adr.city, '') AS city,
  54         IF(adr.pub='public', gp.pays, '') AS countrytxt,
  55         IF(adr.pub='public', gr.name, '') AS region,
  56         IF(e.pub='public', e.entreprise, '') AS entreprise,";
  57 $globals->search->result_where_statement = '
  58     LEFT JOIN  applis_ins     AS ai0 ON (u.user_id = ai0.uid AND ai0.ordre = 0)
  59     LEFT JOIN  applis_def     AS ad0 ON (ad0.id = ai0.aid)
  60     LEFT JOIN  applis_ins     AS ai1 ON (u.user_id = ai1.uid AND ai1.ordre = 1)
  61     LEFT JOIN  applis_def     AS ad1 ON (ad1.id = ai1.aid)
  62     LEFT JOIN  entreprises    AS e   ON (e.entrid = 0 AND e.uid = u.user_id)
  63     LEFT JOIN  emploi_secteur AS es  ON (e.secteur = es.id)
  64     LEFT JOIN  fonctions_def  AS ef  ON (e.fonction = ef.id)
  65     LEFT JOIN  geoloc_pays    AS n   ON (u.nationalite = n.a2)
  66     LEFT JOIN  adresses       AS adr ON (u.user_id = adr.uid AND FIND_IN_SET(\'active\',adr.statut))
  67     LEFT JOIN  geoloc_pays    AS gp  ON (adr.country = gp.a2)
  68     LEFT JOIN  geoloc_region  AS gr  ON (adr.country = gr.a2 AND adr.region = gr.region)
  69     LEFT JOIN  emails         AS em  ON (em.uid = u.user_id AND em.flags = \'active\')';
  70
  71 // }}}
  72 // {{{ function display_lines()
  73
  74 /**
  75  * This function is a heuristic that approximatively tells
  76  * how many lines of output the contact list will use.
  77  */
  78 function display_lines($text)
  79 {
  80     $n = 0;
  81     $tokens = Array('<tr>', '<div class="nom">');
  82     foreach ($tokens as $t) {
  83         $i = -1;
  84         while ( ($i = strpos($text,$t,$i+1))!==false) { $n++; }
  85     }
  86     return $n;
  87 }
  88
  89 // }}}
  90 // {{{ class ThrowError
  91
  92 /** handle errors for end-users queries
  93  * assign the error message and runs the templates
  94  *
  95  * @author Jean-Sebastien Bedo
  96  */
  97 class ThrowError
  98 {
  99     /** constuctor
 100      * @param  $explain string  the error (in natural language)
 101      */
 102     function ThrowError($explain)
 103     {
 104         global $page;
 105         $page->trig('Erreur : '.$explain);
 106         $page->run();
 107     }
 108 }
 109
 110 // }}}
 111 // {{{ class SField                                     [Base class]
 112
 113 /** classe de base représentant un champ de recherche
 114  * (correspond à un champ du formulaire mais peut être à plusieurs champs de la bdd)
 115  * interface étendue pour chaque type de champ particulier
 116  */
 117 class SField
 118 {
 119     // {{{ properties
 120
 121     /** le nom du champ dans le formulaire HTML */
 122     var $fieldFormName;
 123     /** champs de la bdd correspondant à ce champ sous forme d'un tableau */
 124     var $fieldDbName;
 125     /** champ résultat dans la requête MySQL correspondant à ce champ
 126      * (alias utilisé pour la clause ORDER BY) */
 127     var $fieldResultName;
 128     /** valeur du champ instanciée par l'utilisateur */
 129     var $value;
 130
 131     // }}}
 132     // {{{ constructor
 133
 134     /** constructeur
 135      * (récupère la requête de l'utilisateur pour ce champ) */
 136     function SField($_fieldFormName, $_fieldDbName='', $_fieldResultName='')
 137     {
 138         $this->fieldFormName   = $_fieldFormName;
 139         $this->fieldDbName     = $_fieldDbName;
 140         $this->fieldResultName = $_fieldResultName;
 141         $this->get_request();
 142     }
 143
 144     // }}}
 145     // {{{ function get_request()
 146
 147     /** récupérer la requête de l'utilisateur
 148      * on met une chaîne vide si le champ n'a pas été complété */
 149     function get_request()
 150     {
 151         $this->value = trim(Env::v($this->fieldFormName));
 152     }
 153
 154     // }}}
 155     // {{{ function get_where_statement()
 156
 157     /** récupérer la clause correspondant au champ dans la clause WHERE de la requête
 158      * on parcourt l'ensemble des champs de la bdd de $fieldDbName et on associe
 159      * à chacun d'entre eux une clause spécifique
 160      * la clause totale et la disjonction de ces clauses spécifiques */
 161     function get_where_statement()
 162     {
 163         if ($this->value=='') {
 164             return false;
 165         }
 166         $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_where_statement'), $this->fieldDbName)));
 167         return empty($res) ? '' : "($res)";
 168     }
 169
 170     // }}}
 171     // {{{ function get_order_statement()
 172
 173     /** récupérer la clause correspondant au champ dans la clause ORDER BY de la requête
 174      * utilisé par exemple pour placer d'abord le nom égal à la requête avant les approximations */
 175     function get_order_statement()
 176     {
 177         return false;
 178     }
 179
 180     // }}}
 181     // {{{ function get_select_statement()
 182
 183     function get_select_statement()
 184     {
 185         return false;
 186     }
 187
 188     // }}}
 189     // {{{ function get_url()
 190
 191     /** récupérer le bout d'URL correspondant aux paramètres permettant d'imiter une requête d'un
 192      * utilisateur assignant la valeur $this->value à ce champ */
 193     function get_url()
 194     {
 195         if (empty($this->value)) {
 196             return false;
 197         } else {
 198             return $this->fieldFormName.'='.urlencode($this->value);
 199         }
 200     }
 201
 202     // }}}
 203 }
 204
 205 // }}}
 206 // {{{ class QuickSearch                                [Google Like]
 207
 208 class QuickSearch extends SField
 209 {
 210     // {{{ properties
 211
 212     /** stores tokens */
 213     var $strings;
 214     /** stores numerical ranges */
 215     var $ranges;
 216
 217     // }}}
 218     // {{{ constructor
 219
 220     function QuickSearch($_fieldFormName)
 221     {
 222         $this->fieldFormName = $_fieldFormName;
 223         $this->get_request();
 224         if (preg_match(":[\]\[{}~/§_`|%$^=+]|\*\*:u", $this->value)) {
 225             new ThrowError('Un champ contient un caractère interdit rendant la recherche impossible.');
 226         }
 227     }
 228
 229     // }}}
 230     // {{{ function isempty()
 231
 232     function isempty()
 233     {
 234         return empty($this->strings) && empty($this->ranges);
 235     }
 236
 237     // }}}
 238     // {{{ function get_request()
 239
 240     function get_request()
 241     {
 242         parent::get_request();
 243         $s = replace_accent(trim($this->value));
 244         $s = preg_replace('!\d+!', ' ', $s);
 245         $s = str_replace('*','%',$s);
 246         $this->strings = preg_split("![^a-zA-Z%]+!",$s, -1, PREG_SPLIT_NO_EMPTY);
 247
 248         $s = trim($this->value);
 249         $s = preg_replace('! *- *!', '-', $s);
 250         $s = preg_replace('!([<>]) *!', ' \1', $s);
 251         $s = preg_replace('![^0-9\-><]!', ' ', $s);
 252         $s = preg_replace('![<>\-] !', '', $s);
 253         $ranges = preg_split('! +!', $s, -1, PREG_SPLIT_NO_EMPTY);
 254         $this->ranges=Array();
 255         foreach ($ranges as $r) {
 256             if (preg_match('!^([<>]\d{4}|\d{4}(-\d{4})?)$!', $r)) $this->ranges[] = $r;
 257         }
 258     }
 259
 260     // }}}
 261     // {{{ function get_where_statement()
 262
 263     function get_where_statement()
 264     {
 265         $where = Array();
 266         foreach ($this->strings as $i => $s) {
 267             if (Env::i('with_soundex')) {
 268                 $t = soundex_fr($s);
 269                 $where[] = "sn$i.soundex = '$t'";
 270             } else {
 271                 $t = str_replace('*', '%', $s).'%';
 272                 $t = str_replace('%%', '%', $t);
 273                 $where[] = "sn$i.token LIKE '$t'";
 274             }
 275         }
 276
 277         $wherep = Array();
 278         foreach ($this->ranges as $r) {
 279             if (preg_match('!^\d{4}$!', $r)) {
 280                 $wherep[] = "u.promo=$r";
 281             } elseif (preg_match('!^(\d{4})-(\d{4})$!', $r, $matches)) {
 282                 $p1=min(intval($matches[1]), intval($matches[2]));
 283                 $p2=max(intval($matches[1]), intval($matches[2]));
 284                 $wherep[] = "(u.promo>=$p1 AND u.promo<=$p2)";
 285             } elseif (preg_match('!^<(\d{4})!', $r, $matches)) {
 286                 $wherep[] = "u.promo<={$matches[1]}";
 287             } elseif (preg_match('!^>(\d{4})!', $r, $matches)) {
 288                 $wherep[] = "u.promo>={$matches[1]}";
 289             }
 290         }
 291         if (!empty($wherep)) {
 292             $where[] = '('.join(' OR ',$wherep).')';
 293         }
 294         return join(" AND ", $where);
 295     }
 296
 297     // }}}
 298     // {{{ get_select_statement
 299     function get_select_statement()
 300     {
 301         $join = "";
 302         foreach ($this->strings as $i => $s) {
 303             $join .= "INNER JOIN search_name AS sn$i ON (u.user_id = sn$i.uid)\n";
 304         }
 305         return $join;
 306     }
 307     // }}}
 308     // {{{ function get_order_statement()
 309
 310     function get_order_statement()
 311     {
 312         return false;
 313     }
 314
 315     // }}}
 316     // {{{ function get_score_statement
 317
 318     function get_score_statement()
 319     {
 320         $sum = array('0');
 321         foreach ($this->strings as $i => $s) {
 322             $sum[] .= "SUM(sn$i.score + IF('$s'=sn$i.token,5,0))";
 323         }
 324         return join('+', $sum).' AS score';
 325     }
 326
 327     // }}}
 328 }
 329
 330 // }}}
 331 // {{{ class NumericSField                              [Integer fields]
 332
 333 /** classe de champ numérique entier (offset par exemple)
 334  */
 335 class NumericSField extends SField
 336 {
 337     // {{{ constructor
 338
 339     /** constructeur
 340      * (récupère la requête de l'utilisateur pour ce champ) */
 341     function NumericSField($_fieldFormName)
 342     {
 343         $this->fieldFormName = $_fieldFormName;
 344         $this->get_request();
 345     }
 346
 347     // }}}
 348     // {{{ function get_request()
 349
 350     /** récupère la requête de l'utilisateur et échoue s'il ne s'agit pas d'un entier */
 351     function get_request()
 352     {
 353         parent::get_request();
 354         if (empty($this->value)) {
 355             $this->value = 0;
 356         }
 357         if (!preg_match("/^[0-9]+$/", $this->value)) {
 358             new ThrowError('Un champ numérique contient des caractères alphanumériques.');
 359         }
 360     }
 361
 362     // }}}
 363 }
 364
 365 // }}}
 366 // {{{ class RefSField                                  [ ??? ]
 367
 368 class RefSField extends SField
 369 {
 370     // {{{ properties
 371
 372     var $refTable;
 373     var $refAlias;
 374     var $refCondition;
 375     var $exact = true;
 376
 377     // }}}
 378     // {{{ constructor
 379
 380     function RefSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition, $_exact=true)
 381     {
 382         $this->fieldFormName = $_fieldFormName;
 383         $this->fieldDbName   = $_fieldDbName;
 384         $this->refTable      = $_refTable;
 385         $this->refAlias      = $_refAlias;
 386         $this->refCondition  = $_refCondition;
 387         $this->exact         = $_exact;
 388         $this->get_request();
 389     }
 390
 391     // }}}
 392     // {{{ function get_request()
 393
 394     function get_request() {
 395         parent::get_request();
 396         if ($this->value=='00' || $this->value=='0') {
 397             $this->value='';
 398         }
 399     }
 400
 401     // }}}
 402     // {{{ function too_large()
 403
 404     function too_large()
 405     {
 406         return ($this->value=='');
 407     }
 408
 409     // }}}
 410     // {{{ function compare()
 411
 412     function compare()
 413     {
 414         $val = addslashes($this->value);
 415         return $this->exact ? "='$val'" : " LIKE '%$val%'";
 416     }
 417
 418     // }}}
 419     // {{{ function get_single_match_statement()
 420
 421     function get_single_match_statement($field)
 422     {
 423         return $field.$this->compare();
 424     }
 425
 426     // }}}
 427     // {{{ function get_single_where_statement()
 428
 429     function get_single_where_statement($field)
 430     {
 431         return $this->refTable=='' ? $this->get_single_match_statement($field) : false;
 432     }
 433
 434     // }}}
 435     // {{{ function get_select_statement()
 436
 437     function get_select_statement()
 438     {
 439         if ($this->value=='' || $this->refTable=='') {
 440             return false;
 441         }
 442         $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_match_statement'), $this->fieldDbName)));
 443         return "INNER JOIN {$this->refTable} AS {$this->refAlias} ON ({$this->refCondition} AND ($res) )";
 444     }
 445
 446     // }}}
 447 }
 448
 449 // }}}
 450
 451 // {{{ class RefSFieldMultipleTable
 452 class MapSField extends RefSField
 453 {
 454     var $mapId;
 455
 456     function MapSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition, $_mapId=false)
 457     {
 458         if ($_mapId === false)
 459             $this->mapId = Env::v($_fieldFormName, '');
 460         else
 461             $this->mapId = $_mapId;
 462         $this->RefSField($_fieldFormName, $_fieldDbName, $_refTable, $_refAlias, $_refCondition, true, false);
 463     }
 464     function get_select_statement()
 465     {
 466         if ($this->mapId === '') return false;
 467         $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_match_statement'), $this->fieldDbName)));
 468         foreach ($this->refTable as $i => $refT)
 469             $last = $i;
 470         $inner = "";
 471         foreach ($this->refTable as $i => $refT)
 472             $inner .= " INNER JOIN {$refT} AS {$this->refAlias[$i]} ON ({$this->refCondition[$i]} ".(($i == $last)?"AND ($res) ":"").")";
 473         return $inner;
 474     }
 475     function get_request()
 476     {
 477         $this->value = $this->mapId;
 478     }
 479 }
 480
 481 // {{{ class RefWithSoundexSField                       [ ??? ]
 482
 483 class RefWithSoundexSField extends RefSField
 484 {
 485     // {{{ function compare()
 486
 487     function compare()
 488     {
 489         return "='".soundex_fr($this->value)."'";
 490     }
 491
 492     // }}}
 493 }
 494
 495 // }}}
 496 // {{{ class StringSField                               [String fields]
 497
 498 /** classe de champ texte (nom par exemple)
 499  */
 500 class StringSField extends SField
 501 {
 502     // {{{ function get_request()
 503
 504     /** récupère la requête de l'utilisateur et échoue si la chaîne contient des caractères
 505      * interdits */
 506     function get_request()
 507     {
 508         parent::get_request();
 509         if (preg_match(":[\]\[<>{}~/§_`|%$^=+]|\*\*:u", $this->value)) {
 510             new ThrowError('Un champ contient un caractère interdit rendant la recherche impossible.');
 511         }
 512     }
 513
 514     // }}}
 515     // {{{ function length()
 516
 517     /** donne la longueur de la requête de l'utilisateur
 518      * (au sens strict i.e. pas d'* ni d'espace ou de trait d'union -> les contraintes réellement
 519      * imposées par l'utilisateur) */
 520     function length()
 521     {
 522         $cleaned = replace_accent(strtolower($this->value));
 523         $length  = strlen(ereg_replace('[a-z0-9]', '', $cleaned));
 524         return strlen($this->value) - $length;
 525     }
 526
 527     // }}}
 528     // {{{ function too_large()
 529
 530     function too_large()
 531     {
 532         return ($this->length()<2);
 533     }
 534
 535     // }}}
 536     // {{{ function get_single_where_statement()
 537
 538     /** clause WHERE correspondant à un champ de la bdd et à ce champ de formulaire
 539      * @param field nom de champ de la bdd concerné par la clause */
 540     function get_single_where_statement($field)
 541     {
 542         $regexp = strtr(addslashes($this->value), '-*', '_%');
 543         return "$field LIKE '$regexp%'";
 544     }
 545
 546     // }}}
 547     // {{{ function get_order_statement()
 548
 549     /** clause ORDER BY correspondant à ce champ de formulaire */
 550     function get_order_statement()
 551     {
 552         if ($this->value!='' && $this->fieldResultName!='') {
 553             return "{$this->fieldResultName}!='".addslashes($this->value)."'";
 554         } else {
 555             return false;
 556         }
 557     }
 558
 559     // }}}
 560 }
 561
 562 // }}}
 563 // {{{ class NameSField                                 [Names : serach 'n%' + '% b']
 564
 565 /** classe pour les noms : on cherche en plus du like 'foo%' le like '% foo' (particules)
 566 +*/
 567 class NameSField extends StringSField
 568 {
 569     // {{{ function get_single_where_statement()
 570
 571     function get_single_where_statement($field)
 572     {
 573         $regexp = strtr(addslashes($this->value), '-*', '_%');
 574         return "$field LIKE '$regexp%' OR $field LIKE '% $regexp%' OR $field LIKE '%-$regexp%'";
 575     }
 576
 577     // }}}
 578     // {{{ function get_order_statement()
 579
 580     function get_order_statement()
 581     {
 582         if ($this->value!='' && $this->fieldResultName!='') {
 583             return "{$this->fieldResultName} NOT LIKE '".addslashes($this->value)."'";
 584         } else {
 585             return false;
 586         }
 587     }
 588
 589     // }}}
 590 }
 591
 592 // }}}
 593 // {{{ class StringWithSoundexSField                    [Strings + soundex]
 594
 595 /** classe de champ texte avec soundex (nom par exemple)
 596  */
 597 class StringWithSoundexSField extends StringSField
 598 {
 599     // {{{ function get_single_where_statement()
 600
 601     /** clause WHERE correspondant à un champ de la bdd et à ce champ de formulaire
 602      * @param field nom de champ de la bdd concerné par la clause */
 603     function get_single_where_statement($field) {
 604         return $field.'="'.soundex_fr($this->value).'"';
 605     }
 606
 607     // }}}
 608 }
 609
 610 // }}}
 611 // {{{ class PromoSField                                [Prom field]
 612
 613 /** classe de champ de promotion */
 614 class PromoSField extends SField
 615 {
 616     // {{{ properties
 617
 618     /** opérateur de comparaison (<,>,=) de la promo utilisé pour ce champ de formulaire */
 619     var $compareField;
 620
 621     // }}}
 622     // {{{ constructor
 623
 624     /** constructeur
 625      * compareField est un champ de formulaire très simple qui ne sert qu'à la construction de la
 626      * clause WHERE de la promo */
 627     function PromoSField($_fieldFormName, $_compareFieldFormName, $_fieldDbName, $_fieldResultName)
 628     {
 629         parent::SField($_fieldFormName, $_fieldDbName, $_fieldResultName);
 630         $this->compareField = new SField($_compareFieldFormName);
 631     }
 632
 633     // }}}
 634     // {{{ function get_request()
 635
 636     /** récupère la requête utilisateur et échoue si le champ du formulaire ne représente pas une
 637      * promotion (nombre à 4 chiffres) */
 638     function get_request()
 639     {
 640         parent::get_request();
 641         if (preg_match('/^[0-9]{2}$/', $this->value)){
 642             $this->value = intval($this->value) + 1900;
 643         }
 644         if (!(empty($this->value) or preg_match('/^[0-9]{4}$/', $this->value))) {
 645             new ThrowError('La promotion est une année à quatre chiffres.');
 646         }
 647     }
 648
 649     // }}}
 650     // {{{ function is_a_single_promo()
 651
 652     /** teste si la requête est de la forme =promotion -> contrainte forte imposée -> elle suffit
 653      * pour autoriser un affichage des résultats alors que <promotion est insuffisant */
 654     function is_a_single_promo()
 655     {
 656         return ($this->compareField->value=='=' && $this->value!='');
 657     }
 658
 659     // }}}
 660     // {{{ function too_large()
 661
 662     function too_large()
 663     {
 664         return !$this->is_a_single_promo();
 665     }
 666
 667     // }}}
 668     // {{{ function get_single_where_statement()
 669
 670     /** clause WHERE correspondant à ce champ */
 671     function get_single_where_statement($field)
 672     {
 673         return $field.$this->compareField->value.$this->value;
 674     }
 675
 676     // }}}
 677     // {{{ function get_url()
 678
 679     /** récupérer le bout d'URL correspondant aux paramètres permettant d'imiter une requête
 680      * d'un utilisateur assignant la valeur $this->value à ce champ et assignant l'opérateur de
 681      * comparaison adéquat */
 682     function get_url()
 683     {
 684         if (!($u=parent::get_url())) {
 685             return false;
 686         }
 687         return $u.'&amp;'.$this->compareField->get_url();
 688     }
 689
 690     // }}}
 691 }
 692
 693 // }}}
 694 // {{{ class SFieldGroup                                [Group fields]
 695
 696 /** classe groupant des champs de formulaire de recherche */
 697 class SFieldGroup
 698 {
 699     // {{{ properties
 700
 701     /** tableau des classes correspondant aux champs groupés */
 702     var $fields;
 703     /** type de groupe : ET ou OU */
 704     var $and;
 705
 706     // }}}
 707     // {{{ constuctor
 708
 709     /** constructeur */
 710     function SFieldGroup($_and, $_fields)
 711     {
 712         $this->fields = $_fields;
 713         $this->and    = $_and;
 714     }
 715
 716     // }}}
 717     // {{{ function too_large()
 718
 719     function too_large()
 720     {
 721         $b = true;
 722         for ($i=0; $b && $i<count($this->fields); $i++) {
 723             $b &= $this->fields[$i]->too_large();
 724         }
 725         return $b;
 726     }
 727
 728     // }}}
 729     // {{{ function field_get_select()
 730
 731     function field_get_select($f)
 732     {
 733         return $f->get_select_statement();
 734     }
 735
 736     // }}}
 737     // {{{ function field_get_where()
 738
 739     /** récupérer la clause WHERE d'un objet champ de recherche */
 740     function field_get_where($f)
 741     {
 742         return $f->get_where_statement();
 743     }
 744
 745     // }}}
 746     // {{{ function field_get_order()
 747
 748     /** récupérer la clause ORDER BY d'un objet champ de recherche */
 749     function field_get_order($f)
 750     {
 751         return $f->get_order_statement();
 752     }
 753
 754     // }}}
 755     // {{{ function field_get_url()
 756
 757     /** récupérer le bout d'URL correspondant à un objet champ de recherche */
 758     function field_get_url($f)
 759     {
 760         return $f->get_url();
 761     }
 762
 763     // }}}
 764     // {{{ function get_select_statement()
 765
 766     function get_select_statement()
 767     {
 768         return implode(' ', array_filter(array_map(array($this, 'field_get_select'), $this->fields)));
 769     }
 770
 771     // }}}
 772     // {{{ function get_where_statement()
 773
 774     /** récupérer la clause WHERE du groupe de champs = conjonction (ET) ou disjonction (OU) de
 775      * clauses des champs élémentaires */
 776     function get_where_statement()
 777     {
 778         $joinText = $this->and ? ' AND ' : ' OR ';
 779         $res = implode($joinText, array_filter(array_map(array($this, 'field_get_where'), $this->fields)));
 780         return $res == '' ? '' : "($res)";
 781     }
 782
 783     // }}}
 784     // {{{ function get_order_statement()
 785
 786     /** récupérer la clause ORDER BY du groupe de champs = conjonction (ET) ou disjonction (OU) de
 787      * clauses des champs élémentaires */
 788     function get_order_statement()
 789     {
 790         $order = array_filter(array_map(array($this, 'field_get_order'), $this->fields));
 791         return count($order)>0 ? implode(',', $order) : false;
 792     }
 793
 794     // }}}
 795     // {{{ function get_url()
 796
 797     /** récupérer le bout d'URL correspondant à ce groupe de champs = concaténation des bouts d'URL
 798      * des champs élémentaires */
 799     function get_url($others=Array())
 800     {
 801         $url = array_filter(array_map(array($this, 'field_get_url'), $this->fields));
 802         foreach ($url as $key=>$val) {
 803             if (empty($val)) {
 804                 unset($url[$key]);
 805             }
 806         }
 807         foreach ($others as $key=>$val) {
 808             if (!empty($val)) {
 809                 $url[] = "$key=$val";
 810             }
 811         }
 812         return count($url)>0 ? implode('&amp;', $url) : false;
 813     }
 814
 815     // }}}
 816 }
 817
 818 // }}}
 819
 820 // vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8:
 821 ?>