2 /***************************************************************************
3 * Copyright (C) 2003-2009 Polytechnique.org *
4 * http://opensource.polytechnique.org/ *
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. *
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. *
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 *
19 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
20 ***************************************************************************/
22 // {{{ Global variables used for the search Queries
24 @$globals->search
->result_fields
= '
25 u.user_id, u.promo, u.matricule, u.matricule_ax,
26 if(u.nom_usage=\'\', u.nom, u.nom_usage) AS NomSortKey,
28 u.deces!=0 AS dcd,u.deces,
29 u.perms IN (\'admin\',\'user\', \'disabled\') AS inscrit,
30 u.perms != \'pending\' AS wasinscrit,
31 FIND_IN_SET(\'femme\', u.flags) AS sexe,
32 ede0.name AS eduname0, ede0.url AS eduurl0, edd0.degree AS edudegree0,
33 edu0.grad_year AS edugrad_year0, f0.field AS edufield0, edu0.program AS eduprogram0,
34 ede1.name AS eduname1, ede1.url AS eduurl1, edd1.degree AS edudegree1,
35 edu1.grad_year AS edugrad_year1, f1.field AS edufield1, edu1.program AS eduprogram1,
36 ede2.name AS eduname2, ede2.url AS eduurl2, edd2.degree AS edudegree2,
37 edu2.grad_year AS edugrad_year2, f2.field AS edufield2, edu2.program AS eduprogram2,
38 ede3.name AS eduname3, ede3.url AS eduurl3, edd3.degree AS edudegree3,
39 edu3.grad_year AS edugrad_year3, f3.field AS edufield3, edu3.program AS eduprogram3,
40 es.name AS secteur, ef.fonction_fr AS fonction,
41 IF(n1.nat=\'\',n1.pays,n1.nat) AS nat1, n1.a2 AS iso3166_1,
42 IF(n2.nat=\'\',n2.pays,n2.nat) AS nat2, n2.a2 AS iso3166_2,
43 IF(n3.nat=\'\',n3.pays,n3.nat) AS nat3, n3.a2 AS iso3166_3,
44 (COUNT(em.email) > 0 OR FIND_IN_SET("googleapps", u.mail_storage) > 0) AS actif,';
45 // hide private information if not logged
47 $globals->search
->result_fields
.='
48 q.profile_freetext AS freetext,
49 adr.city, gp.pays AS countrytxt, gr.name AS region,
51 nw.address AS networking_address,
52 nwe.name AS networking_name,';
54 $globals->search
->result_fields
.="
55 IF(q.profile_freetext_pub='public', q.profile_freetext, '') AS freetext,
56 IF(adr.pub='public', adr.city, '') AS city,
57 IF(adr.pub='public', gp.pays, '') AS countrytxt,
58 IF(adr.pub='public', gr.name, '') AS region,
59 IF(e.pub='public', je.name, '') AS entreprise,
60 IF(nw.pub='public', nw.address, '') AS networking_address,
61 IF(nw.pub='public', nwe.name, '') AS networking_name,";
62 @$globals->search
->result_where_statement
= "
63 LEFT JOIN profile_education AS edu0 ON (u.user_id = edu0.uid AND edu0.id = 0)
64 LEFT JOIN profile_education_enum AS ede0 ON (ede0.id = edu0.eduid)
65 LEFT JOIN profile_education_degree_enum AS edd0 ON (edd0.id = edu0.degreeid)
66 LEFT JOIN profile_education_field_enum AS f0 ON (f0.id = edu0.fieldid)
67 LEFT JOIN profile_education AS edu1 ON (u.user_id = edu1.uid AND edu1.id = 1)
68 LEFT JOIN profile_education_enum AS ede1 ON (ede1.id = edu1.eduid)
69 LEFT JOIN profile_education_degree_enum AS edd1 ON (edd1.id = edu1.degreeid)
70 LEFT JOIN profile_education_field_enum AS f1 ON (f1.id = edu1.fieldid)
71 LEFT JOIN profile_education AS edu2 ON (u.user_id = edu2.uid AND edu2.id = 2)
72 LEFT JOIN profile_education_enum AS ede2 ON (ede2.id = edu2.eduid)
73 LEFT JOIN profile_education_degree_enum AS edd2 ON (edd2.id = edu2.degreeid)
74 LEFT JOIN profile_education_field_enum AS f2 ON (f2.id = edu2.fieldid)
75 LEFT JOIN profile_education AS edu3 ON (u.user_id = edu3.uid AND edu3.id = 3)
76 LEFT JOIN profile_education_enum AS ede3 ON (ede3.id = edu3.eduid)
77 LEFT JOIN profile_education_degree_enum AS edd3 ON (edd3.id = edu3.degreeid)
78 LEFT JOIN profile_education_field_enum AS f3 ON (f3.id = edu3.fieldid)
79 LEFT JOIN profile_job AS e ON (e.uid = u.user_id)
80 LEFT JOIN profile_job_enum AS ee ON (e.jobid = ee.id)
81 LEFT JOIN profile_job_sector_enum AS es ON (es.id = e.sectorid)
82 LEFT JOIN fonctions_def AS ef ON (e.fonction = ef.id)
83 LEFT JOIN geoloc_countries AS n1 ON (u.nationalite = n1.iso_3166_1_a2)
84 LEFT JOIN geoloc_countries AS n2 ON (u.nationalite2 = n2.iso_3166_1_a2)
85 LEFT JOIN geoloc_countries AS n3 ON (u.nationalite3 = n3.iso_3166_1_a2)
86 LEFT JOIN profile_addresses AS adr ON (u.user_id = adr.pid
87 AND FIND_IN_SET('current', adr.flags))
88 LEFT JOIN geoloc_countries AS gp ON (adr.countryId = gp.iso_3166_1_a2)
89 LEFT JOIN geoloc_administrativeareas AS gr ON (adr.countryId = gr.country
90 AND adr.administrativeAreaId = gr.id)
91 LEFT JOIN emails AS em ON (em.uid = u.user_id AND em.flags = 'active')
92 LEFT JOIN profile_networking AS nw ON (nw.uid = u.user_id)
93 LEFT JOIN profile_networking_enum AS nwe ON (nwe.network_type = nw.network_type)";
96 // {{{ class ThrowError
98 /** handle errors for end-users queries
99 * assign the error message and runs the templates
101 * @author Jean-Sebastien Bedo
105 public static $throwHook = array('ThrowError', 'defaultHandler');
108 * @param $explain string the error (in natural language)
110 public function __construct($explain)
112 call_user_func(ThrowError
::$throwHook, $explain);
115 /** defaut error handler
117 private static function defaultHandler($explain)
120 $page =& Platal
::page();
121 $page->changeTpl('search/index.tpl');
122 $page->setTitle('Polytechnique.org - Annuaire');
123 $page->assign('baseurl', $globals->baseurl
);
124 $page->trigError($explain);
130 // {{{ class SField [Base class]
132 /** classe de base représentant un champ de recherche
133 * (correspond à un champ du formulaire mais peut être à plusieurs champs de la bdd)
134 * interface étendue pour chaque type de champ particulier
140 /** le nom du champ dans le formulaire HTML */
142 /** champs de la bdd correspondant à ce champ sous forme d'un tableau */
144 /** champ résultat dans la requête MySQL correspondant à ce champ
145 * (alias utilisé pour la clause ORDER BY) */
146 var $fieldResultName;
147 /** valeur du champ instanciée par l'utilisateur */
154 * (récupère la requête de l'utilisateur pour ce champ) */
155 function SField($_fieldFormName, $_fieldDbName='', $_fieldResultName='')
157 $this->fieldFormName
= $_fieldFormName;
158 $this->fieldDbName
= $_fieldDbName;
159 $this->fieldResultName
= $_fieldResultName;
160 $this->get_request();
164 // {{{ function get_request()
166 /** récupérer la requête de l'utilisateur
167 * on met une chaîne vide si le champ n'a pas été complété */
168 function get_request()
170 $this->value
= trim(Env
::v($this->fieldFormName
));
174 // {{{ function get_where_statement()
176 /** récupérer la clause correspondant au champ dans la clause WHERE de la requête
177 * on parcourt l'ensemble des champs de la bdd de $fieldDbName et on associe
178 * à chacun d'entre eux une clause spécifique
179 * la clause totale et la disjonction de ces clauses spécifiques */
180 function get_where_statement()
182 if ($this->value
=='') {
185 $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_where_statement'), $this->fieldDbName
)));
186 return empty($res) ?
'' : "($res)";
190 // {{{ function get_order_statement()
192 /** récupérer la clause correspondant au champ dans la clause ORDER BY de la requête
193 * utilisé par exemple pour placer d'abord le nom égal à la requête avant les approximations */
194 function get_order_statement()
200 // {{{ function get_select_statement()
202 function get_select_statement()
208 // {{{ function get_url()
210 /** récupérer le bout d'URL correspondant aux paramètres permettant d'imiter une requête d'un
211 * utilisateur assignant la valeur $this->value à ce champ */
214 if (empty($this->value
)) {
217 return $this->fieldFormName
.'='.urlencode($this->value
);
225 // {{{ class QuickSearch [Google Like]
227 class QuickSearch
extends SField
233 /** stores numerical ranges */
235 /** stores admin searches */
238 /** stores phone number */
244 function QuickSearch($_fieldFormName)
246 $this->fieldFormName
= $_fieldFormName;
247 $this->get_request();
248 if (preg_match(":[\]\[{}~/§_`|%$^=+]|\*\*:u", $this->value
)) {
249 new ThrowError('Un champ contient un caractère interdit rendant la recherche impossible.');
254 // {{{ function isempty()
258 return empty($this->strings
) && empty($this->ranges
) && empty($this->email
) && empty($this->ip
) && empty($this->phone
);
262 // {{{ function get_request()
264 function get_request()
266 parent
::get_request();
267 $s = replace_accent(trim($this->value
));
268 $r = $s = str_replace('*','%',$s);
270 if (S
::admin() && strpos($s, '@') !== false
) {
272 } else if (S
::admin() && preg_match('/[0-9]+\.([0-9]+|%)\.([0-9]+|%)\.([0-9]+|%)/', $s)) {
275 if ($this->email ||
$this->ip
) {
276 $this->strings
= $this->ranges
= array();
280 $s = preg_replace('!\d+!', ' ', $s);
281 $this->strings
= preg_split("![^a-zA-Z%]+!",$s, -1, PREG_SPLIT_NO_EMPTY
);
282 if (count($this->strings
) > 5) {
283 Platal
::page()->trigWarning("Tu as indiqué trop d'éléments dans ta recherche, seuls les 5 premiers seront pris en compte");
284 $this->strings
= array_slice($this->strings
, 0, 5);
287 $s = preg_replace('! *- *!', '-', $r);
288 $s = preg_replace('!([<>]) *!', ' \1', $s);
289 $s = preg_replace('![^0-9\-><]!', ' ', $s);
290 $s = preg_replace('![<>\-] !', '', $s);
291 $ranges = preg_split('! +!', $s, -1, PREG_SPLIT_NO_EMPTY
);
292 $this->ranges
=Array();
293 foreach ($ranges as $r) {
294 if (preg_match('!^([<>]\d{4}|\d{4}(-\d{4})?)$!', $r)) $this->ranges
[] = $r;
297 $t = preg_replace('!(\d{4}-\d{4}|>\d{4}|<\d{4})!', '', $s);
298 $t = preg_replace('![<>\- ]!', '', $t);
299 if (strlen($t) > 4) {
305 // {{{ function get_where_statement()
307 function get_where_statement()
310 foreach ($this->strings
as $i => $s) {
311 if (Env
::i('with_soundex') && strlen($s) > 1) {
313 $where[] = "sn$i.soundex = '$t'";
314 } elseif (Env
::i('exact')) {
315 $where[] = "sn$i.token = '$s'";
317 $t = str_replace('*', '%', $s).'%';
318 $t = str_replace('%%', '%', $t);
319 $where[] = "sn$i.token LIKE '$t'";
324 foreach ($this->ranges
as $r) {
325 if (preg_match('!^\d{4}$!', $r)) {
326 $wherep[] = "u.promo=$r";
327 } elseif (preg_match('!^(\d{4})-(\d{4})$!', $r, $matches)) {
328 $p1=min(intval($matches[1]), intval($matches[2]));
329 $p2=max(intval($matches[1]), intval($matches[2]));
330 $wherep[] = "(u.promo>=$p1 AND u.promo<=$p2)";
331 } elseif (preg_match('!^<(\d{4})!', $r, $matches)) {
332 $wherep[] = "u.promo<={$matches[1]}";
333 } elseif (preg_match('!^>(\d{4})!', $r, $matches)) {
334 $wherep[] = "u.promo>={$matches[1]}";
337 if (!empty($wherep)) {
338 $where[] = '('.join(' OR ',$wherep).')';
340 if (!empty($this->email
)) {
341 $where[] = 'ems.email = ' . XDB
::escape($this->email
);
343 if (!empty($this->ip
)) {
344 $ip = ip_to_uint($this->ip
);
346 // If the IP address requested for the search cannot be translated,
347 // the predicate should always be valued to false.
349 $where[] = "( ls.ip = $ip OR ls.forward_ip = $ip ) AND ls.suid = 0";
354 if (!empty($this->phone
)){
355 require_once("profil.func.inc.php");
356 $phone = format_phone_number($this->phone
) . "%";
357 $where[] = 't.search_tel LIKE ' . XDB
::escape($phone);
360 return join(" AND ", $where);
364 // {{{ get_select_statement
365 function get_select_statement()
370 foreach ($this->strings
as $i => $s) {
372 $and = "AND FIND_IN_SET('public', sn$i.flags)";
374 $myu = str_replace('snv', "sn$i", $uniq);
375 $join .= "INNER JOIN search_name AS sn$i ON (u.user_id = sn$i.uid $and$myu)\n";
376 $uniq .= " AND sn$i.token != snv.token";
378 if (!empty($this->email
)) {
379 $join .= "LEFT JOIN emails AS ems ON (ems.uid = u.user_id)";
381 if (!empty($this->ip
)) {
382 $join .= "INNER JOIN logger.sessions AS ls ON (ls.uid = u.user_id)\n";
384 if (!empty($this->phone
)) {
386 $join .= "INNER JOIN profile_phones AS t ON (t.uid = u.user_id AND t.pub = 'public')";
388 $join .= "INNER JOIN profile_phones AS t ON (t.uid = u.user_id)";
394 // {{{ function get_order_statement()
396 function get_order_statement()
402 // {{{ function get_score_statement
404 function get_score_statement()
407 foreach ($this->strings
as $i => $s) {
408 $sum[] .= "SUM(sn$i.score + IF('$s'=sn$i.token,5,0))";
410 return join('+', $sum).' AS score';
417 // {{{ class NumericSField [Integer fields]
419 /** classe de champ numérique entier (offset par exemple)
421 class NumericSField
extends SField
426 * (récupère la requête de l'utilisateur pour ce champ) */
427 function NumericSField($_fieldFormName)
429 $this->fieldFormName
= $_fieldFormName;
430 $this->get_request();
434 // {{{ function get_request()
436 /** récupère la requête de l'utilisateur et échoue s'il ne s'agit pas d'un entier */
437 function get_request()
439 parent
::get_request();
440 if (empty($this->value
)) {
443 if (!preg_match("/^[0-9]+$/", $this->value
)) {
444 new ThrowError('Un champ numérique contient des caractères alphanumériques.');
452 // {{{ class RefSField [ ??? ]
454 class RefSField
extends SField
466 function RefSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition, $_exact=true
)
468 $this->fieldFormName
= $_fieldFormName;
469 $this->fieldDbName
= $_fieldDbName;
470 $this->refTable
= $_refTable;
471 $this->refAlias
= $_refAlias;
472 $this->refCondition
= $_refCondition;
473 $this->exact
= $_exact;
474 $this->get_request();
478 // {{{ function get_request()
480 function get_request() {
481 parent
::get_request();
482 if ($this->value
=='00' ||
$this->value
=='0') {
488 // {{{ function too_large()
492 return ($this->value
=='');
496 // {{{ function compare()
500 $val = addslashes($this->value
);
501 if (Env
::i('exact')) return "='$val'";
502 return $this->exact ?
"='$val'" : " LIKE '%$val%'";
506 // {{{ function get_single_match_statement()
508 function get_single_match_statement($field)
510 return $field.$this->compare();
514 // {{{ function get_single_where_statement()
516 function get_single_where_statement($field)
518 return $this->refTable
=='' ?
$this->get_single_match_statement($field) : false
;
522 // {{{ function get_select_statement()
524 function get_select_statement()
526 if ($this->value
=='' ||
$this->refTable
=='') {
529 $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_match_statement'), $this->fieldDbName
)));
530 if (is_array($this->refTable
)) {
531 foreach ($this->refTable
as $i => $refT)
534 foreach ($this->refTable
as $i => $refT)
535 $inner .= " INNER JOIN {$refT} AS {$this->refAlias[$i]} ON ({$this->refCondition[$i]} ".(($i == $last)?
"AND ($res) ":"").")\n";
538 return "INNER JOIN {$this->refTable} AS {$this->refAlias} ON ({$this->refCondition} AND ($res) )";
547 // {{{ class RefSFieldMultipleTable
548 class PhoneSField
extends RefSField
550 function PhoneSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition)
552 $this->RefSField($_fieldFormName, $_fieldDbName, $_refTable, $_refAlias, $_refCondition, true
);
555 function get_request()
557 require_once("profil.func.inc.php");
558 $this->value
= trim(Env
::v($this->fieldFormName
));
559 $this->value
= format_phone_number($this->value
);
564 return " LIKE '" . addslashes($this->value
) . "%'";
568 class IndexSField
extends RefSField
570 function IndexSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition)
572 $this->RefSField($_fieldFormName, $_fieldDbName, $_refTable, $_refAlias, $_refCondition, true
);
575 function get_request()
577 $this->value
= trim(Env
::v($this->fieldFormName
));
581 class MapSField
extends RefSField
585 function MapSField($_fieldFormName, $_fieldDbName='', $_refTable, $_refAlias, $_refCondition, $_mapId=false
)
587 if ($_mapId === false
)
588 $this->mapId
= Env
::v($_fieldFormName, '');
590 $this->mapId
= $_mapId;
591 $this->value
= $this->mapId
;
592 $this->RefSField($_fieldFormName, $_fieldDbName, $_refTable, $_refAlias, $_refCondition, true
, false
);
595 function get_select_statement()
597 if ($this->mapId
=== '') return false
;
598 $res = implode(' OR ', array_filter(array_map(array($this, 'get_single_match_statement'), $this->fieldDbName
)));
599 foreach ($this->refTable
as $i => $refT)
602 foreach ($this->refTable
as $i => $refT)
603 $inner .= " INNER JOIN {$refT} AS {$this->refAlias[$i]} ON ({$this->refCondition[$i]} ".(($i == $last)?
"AND ($res) ":"").")";
606 function get_request()
608 $this->value
= $this->mapId
;
612 // {{{ class RefWithSoundexSField [ ??? ]
614 class RefWithSoundexSField
extends RefSField
616 // {{{ function compare()
620 return "='".soundex_fr($this->value
)."'";
627 // {{{ class StringSField [String fields]
629 /** classe de champ texte (nom par exemple)
631 class StringSField
extends SField
633 // {{{ function get_request()
635 /** récupère la requête de l'utilisateur et échoue si la chaîne contient des caractères
637 function get_request()
639 parent
::get_request();
640 if (preg_match(":[\]\[<>{}~/§_`|%$^=+]|\*\*:u", $this->value
)) {
641 new ThrowError('Un champ contient un caractère interdit rendant la recherche impossible.');
646 // {{{ function length()
648 /** donne la longueur de la requête de l'utilisateur
649 * (au sens strict i.e. pas d'* ni d'espace ou de trait d'union -> les contraintes réellement
650 * imposées par l'utilisateur) */
653 $cleaned = replace_accent(strtolower($this->value
));
654 $length = strlen(ereg_replace('[a-z0-9]', '', $cleaned));
655 return strlen($this->value
) - $length;
659 // {{{ function too_large()
663 return ($this->length()<2);
667 // {{{ function get_single_where_statement()
669 /** clause WHERE correspondant à un champ de la bdd et à ce champ de formulaire
670 * @param field nom de champ de la bdd concerné par la clause */
671 function get_single_where_statement($field)
673 $val = addslashes($this->value
);
674 if (Env
::i('exact')) return "$field = '$val'";
675 $regexp = strtr($val, '-*', '_%');
676 return "$field LIKE '$regexp%'";
680 // {{{ function get_order_statement()
682 /** clause ORDER BY correspondant à ce champ de formulaire */
683 function get_order_statement()
685 if ($this->value
!='' && $this->fieldResultName
!='') {
686 return "{$this->fieldResultName}!='".addslashes($this->value
)."'";
696 // {{{ class NameSField [Names : serach 'n%' + '% b']
698 /** classe pour les noms : on cherche en plus du like 'foo%' le like '% foo' (particules)
700 class NameSField
extends StringSField
702 // {{{ function get_single_where_statement()
704 function get_single_where_statement($field)
706 $val = addslashes($this->value
);
707 if (Env
::i('exact')) return "$field = '$val'";
708 $regexp = strtr($val, '-*', '_%');
709 return "$field LIKE '$regexp%' OR $field LIKE '% $regexp%' OR $field LIKE '%-$regexp%'";
713 // {{{ function get_order_statement()
715 function get_order_statement()
717 if ($this->value
!='' && $this->fieldResultName
!='') {
718 return "{$this->fieldResultName} NOT LIKE '".addslashes($this->value
)."'";
728 // {{{ class StringWithSoundexSField [Strings + soundex]
730 /** classe de champ texte avec soundex (nom par exemple)
732 class StringWithSoundexSField
extends StringSField
734 // {{{ function get_single_where_statement()
736 /** clause WHERE correspondant à un champ de la bdd et à ce champ de formulaire
737 * @param field nom de champ de la bdd concerné par la clause */
738 function get_single_where_statement($field) {
739 return $field.'="'.soundex_fr($this->value
).'"';
746 // {{{ class PromoSField [Prom field]
748 /** classe de champ de promotion */
749 class PromoSField
extends SField
753 /** opérateur de comparaison (<,>,=) de la promo utilisé pour ce champ de formulaire */
760 * compareField est un champ de formulaire très simple qui ne sert qu'à la construction de la
761 * clause WHERE de la promo */
762 function PromoSField($_fieldFormName, $_compareFieldFormName, $_fieldDbName, $_fieldResultName)
764 parent
::SField($_fieldFormName, $_fieldDbName, $_fieldResultName);
765 $this->compareField
= new SField($_compareFieldFormName);
769 // {{{ function get_request()
771 /** récupère la requête utilisateur et échoue si le champ du formulaire ne représente pas une
772 * promotion (nombre à 4 chiffres) */
773 function get_request()
775 parent
::get_request();
776 if (preg_match('/^[0-9]{2}$/', $this->value
)){
777 $this->value
= intval($this->value
) +
1900;
779 if (!(empty($this->value
) or preg_match('/^[0-9]{4}$/', $this->value
))) {
780 new ThrowError('La promotion est une année à quatre chiffres.');
785 // {{{ function is_a_single_promo()
787 /** teste si la requête est de la forme =promotion -> contrainte forte imposée -> elle suffit
788 * pour autoriser un affichage des résultats alors que <promotion est insuffisant */
789 function is_a_single_promo()
791 return ($this->compareField
->value
=='=' && $this->value
!='');
795 // {{{ function too_large()
799 return !$this->is_a_single_promo();
803 // {{{ function get_single_where_statement()
805 /** clause WHERE correspondant à ce champ */
806 function get_single_where_statement($field)
808 return $field.$this->compareField
->value
.$this->value
;
812 // {{{ function get_url()
814 /** récupérer le bout d'URL correspondant aux paramètres permettant d'imiter une requête
815 * d'un utilisateur assignant la valeur $this->value à ce champ et assignant l'opérateur de
816 * comparaison adéquat */
819 if (!($u=parent
::get_url())) {
822 return $u.'&'.$this->compareField
->get_url();
829 // {{{ class SFieldGroup [Group fields]
831 /** classe groupant des champs de formulaire de recherche */
836 /** tableau des classes correspondant aux champs groupés */
838 /** type de groupe : ET ou OU */
845 function SFieldGroup($_and, $_fields)
847 $this->fields
= $_fields;
849 foreach ($this->fields
as $key=>&$field) {
850 if (is_null($field)) {
851 unset($this->fields
[$key]);
857 // {{{ function too_large()
862 for ($i=0 ; $b && $i<count($this->fields
) ; $i++
) {
863 if (!is_null($this->fields
[$i])) {
864 $b = $b && $this->fields
[$i]->too_large();
871 // {{{ function field_get_select()
873 function field_get_select($f)
875 return $f->get_select_statement();
879 // {{{ function field_get_where()
881 /** récupérer la clause WHERE d'un objet champ de recherche */
882 function field_get_where($f)
884 return $f->get_where_statement();
888 // {{{ function field_get_order()
890 /** récupérer la clause ORDER BY d'un objet champ de recherche */
891 function field_get_order($f)
893 return $f->get_order_statement();
897 // {{{ function field_get_url()
899 /** récupérer le bout d'URL correspondant à un objet champ de recherche */
900 function field_get_url($f)
902 return $f->get_url();
906 // {{{ function get_select_statement()
908 function get_select_statement()
910 return implode(' ', array_filter(array_map(array($this, 'field_get_select'), $this->fields
)));
914 // {{{ function get_where_statement()
916 /** récupérer la clause WHERE du groupe de champs = conjonction (ET) ou disjonction (OU) de
917 * clauses des champs élémentaires */
918 function get_where_statement()
920 $joinText = $this->and ?
' AND ' : ' OR ';
921 $res = implode($joinText, array_filter(array_map(array($this, 'field_get_where'), $this->fields
)));
922 return $res == '' ?
'' : "($res)";
926 // {{{ function get_order_statement()
928 /** récupérer la clause ORDER BY du groupe de champs = conjonction (ET) ou disjonction (OU) de
929 * clauses des champs élémentaires */
930 function get_order_statement()
932 $order = array_filter(array_map(array($this, 'field_get_order'), $this->fields
));
933 return count($order)>0 ?
implode(',', $order) : false
;
937 // {{{ function get_url()
939 /** récupérer le bout d'URL correspondant à ce groupe de champs = concaténation des bouts d'URL
940 * des champs élémentaires */
941 function get_url($others=Array())
943 $url = array_filter(array_map(array($this, 'field_get_url'), $this->fields
));
944 foreach ($url as $key=>$val) {
949 foreach ($others as $key=>$val) {
951 $url[] = "$key=$val";
954 return count($url)>0 ?
implode('&', $url) : false
;
962 // vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8: