projects / platal.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Hotfix for foreign keys in profile_address edition (Closes #1228)
[platal.git] / classes / userfilter.php
CommitLineData
a087cc8d
FB		 1<?php
2/***************************************************************************
d4c08d89 3 * Copyright (C) 2003-2010 Polytechnique.org *
a087cc8d
FB		 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
d865c296
FB		 22
23/******************
24 * CONDITIONS
25 ******************/
26
8363588b 27// {{{ interface UserFilterCondition
2d83cac9
RB		 28/** This interface describe objects which filter users based
29 * on various parameters.
30 * The parameters of the filter must be given to the constructor.
31 * The buildCondition function is called by UserFilter when
32 * actually building the query. That function must call
33 * $uf->addWheteverFilter so that the UserFilter makes
34 * adequate joins. It must return the 'WHERE' condition to use
35 * with the filter.
36 */
dcc63ed5 37interface UserFilterCondition extends PlFilterCondition
a087cc8d 38{
a087cc8d 39}
8363588b 40// }}}
a087cc8d 41
77902bed 42// {{{ class UFC_HasProfile
53eae167
RB		 43/** Filters users who have a profile
44 */
77902bed 45class UFC_HasProfile implements UserFilterCondition
eb1449b8 46{
dcc63ed5 47 public function buildCondition(PlFilter &$uf)
eb1449b8 48 {
aaf70eb8 49 $uf->requireProfiles();
93b0da52 50 return '$PID IS NOT NULL';
eb1449b8
FB		 51 }
52}
8363588b 53// }}}
eb1449b8 54
ddba9d4f
RB		 55// {{{ class UFC_Hruid
56/** Filters users based on their hruid
57 * @param $val Either an hruid, or a list of those
58 */
59class UFC_Hruid implements UserFilterCondition
60{
61 private $hruids;
62
61d1fd8b 63 public function __construct()
ddba9d4f 64 {
61d1fd8b 65 $this->hruids = pl_flatten(func_get_args());
ddba9d4f
RB		 66 }
67
68 public function buildCondition(PlFilter &$uf)
69 {
7752f73f 70 $uf->requireAccounts();
bde68f05 71 return XDB::format('a.hruid IN {?}', $this->hruids);
ddba9d4f
RB		 72 }
73}
74// }}}
75
3e993f7a
FB		 76// {{{ class UFC_Hrpid
77/** Filters users based on the hrpid of their profiles
78 * @param $val Either an hrpid, or a list of those
79 */
80class UFC_Hrpid implements UserFilterCondition
81{
82 private $hrpids;
83
61d1fd8b 84 public function __construct()
3e993f7a 85 {
61d1fd8b 86 $this->hrpids = pl_flatten(func_get_args());
3e993f7a
FB		 87 }
88
89 public function buildCondition(PlFilter &$uf)
90 {
91 $uf->requireProfiles();
bde68f05 92 return XDB::format('p.hrpid IN {?}', $this->hrpids);
3e993f7a
FB		 93 }
94}
95// }}}
96
f73a4f1b
RB		 97// {{{ class UFC_Ip
98/** Filters users based on one of their last IPs
99 * @param $ip IP from which connection are checked
100 */
101class UFC_Ip implements UserFilterCondition
102{
103 private $ip;
104
105 public function __construct($ip)
106 {
107 $this->ip = $ip;
108 }
109
110 public function buildCondition(PlFilter &$uf)
111 {
112 $sub = $uf->addLoggerFilter();
113 $ip = ip_to_uint($this->ip);
114 return XDB::format($sub . '.ip = {?} OR ' . $sub . '.forward_ip = {?}', $ip, $ip);
115 }
116}
117// }}}
118
d7ddf29b
RB		 119// {{{ class UFC_Comment
120class UFC_Comment implements UserFilterCondition
121{
122 private $text;
123
124 public function __construct($text)
125 {
126 $this->text = $text;
127 }
128
129 public function buildCondition(PlFilter &$uf)
130 {
131 $uf->requireProfiles();
7f26cd69 132 return $uf->getVisibilityCondition('p.freetext_pub') . ' AND p.freetext ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->text);
d7ddf29b
RB		 133 }
134}
135// }}}
136
8363588b 137// {{{ class UFC_Promo
5d2e55c7 138/** Filters users based on promotion
53eae167
RB		 139 * @param $comparison Comparison operator (>, =, ...)
140 * @param $grade Formation on which to restrict, UserFilter::DISPLAY for "any formation"
5d2e55c7 141 * @param $promo Promotion on which the filter is based
53eae167 142 */
a087cc8d
FB		 143class UFC_Promo implements UserFilterCondition
144{
a087cc8d
FB		 145
146 private $grade;
147 private $promo;
148 private $comparison;
149
150 public function __construct($comparison, $grade, $promo)
151 {
152 $this->grade = $grade;
153 $this->comparison = $comparison;
154 $this->promo = $promo;
38c6fe96
FB		 155 if ($this->grade != UserFilter::DISPLAY) {
156 UserFilter::assertGrade($this->grade);
157 }
6c1e97ae 158 if ($this->grade == UserFilter::DISPLAY && $this->comparison != '=') {
999db5aa
RB		 159 // XXX: we might try to guess the grade from the first char of the promo and forbid only '<= 2004', but allow '<= X2004'
160 Platal::page()->killError("Il n'est pas possible d'appliquer la comparaison '" . $this->comparison . "' aux promotions sans spécifier de formation (X/M/D)");
6c1e97ae 161 }
a087cc8d
FB		 162 }
163
dcc63ed5 164 public function buildCondition(PlFilter &$uf)
a087cc8d 165 {
38c6fe96
FB		 166 if ($this->grade == UserFilter::DISPLAY) {
167 $sub = $uf->addDisplayFilter();
1a23a02b 168 return XDB::format('pd' . $sub . '.promo ' . $this->comparison . ' {?}', $this->promo);
38c6fe96
FB		 169 } else {
170 $sub = $uf->addEducationFilter(true, $this->grade);
171 $field = 'pe' . $sub . '.' . UserFilter::promoYear($this->grade);
172 return $field . ' IS NOT NULL AND ' . $field . ' ' . $this->comparison . ' ' . XDB::format('{?}', $this->promo);
173 }
784745ce
FB		 174 }
175}
8363588b 176// }}}
784745ce 177
9e8bacfb
FB		 178// {{{ class UFC_SchoolId
179/** Filters users based on their shoold identifier
180 * @param type Parameter type (Xorg, AX, School)
181 * @param value School id value
182 */
57f8776b 183class UFC_SchoolId implements UserFilterCondition
9e8bacfb
FB		 184{
185 const AX = 'ax';
186 const Xorg = 'xorg';
187 const School = 'school';
188
189 private $type;
190 private $id;
191
192 static public function assertType($type)
193 {
194 if ($type != self::AX && $type != self::Xorg && $type != self::School) {
195 Platal::page()->killError("Type de matricule invalide: $type");
196 }
197 }
198
199 public function __construct($type, $id)
200 {
201 $this->type = $type;
202 $this->id = $id;
203 self::assertType($type);
204 }
205
206 public function buildCondition(PlFilter &$uf)
207 {
208 $uf->requireProfiles();
209 $id = $this->id;
210 $type = $this->type;
211 if ($type == self::School) {
212 $type = self::Xorg;
213 $id = Profile::getXorgId($id);
214 }
215 return XDB::format('p.' . $type . '_id = {?}', $id);
216 }
217}
218// }}}
219
fb3b6547 220// {{{ class UFC_EducationSchool
d7ddf29b
RB		 221/** Filters users by formation
222 * @param $val The formation to search (either ID or array of IDs)
223 */
fb3b6547 224class UFC_EducationSchool implements UserFilterCondition
a7f8e48a 225{
d7ddf29b 226 private $val;
a7f8e48a 227
61d1fd8b 228 public function __construct()
a7f8e48a 229 {
61d1fd8b 230 $this->val = pl_flatten(func_get_args());
a7f8e48a
RB		 231 }
232
233 public function buildCondition(PlFilter &$uf)
234 {
235 $sub = $uf->addEducationFilter();
bde68f05 236 return XDB::format('pe' . $sub . '.eduid IN {?}', $this->val);
a7f8e48a
RB		 237 }
238}
239// }}}
240
fb3b6547
RB		 241// {{{ class UFC_EducationDegree
242class UFC_EducationDegree implements UserFilterCondition
d7ddf29b
RB		 243{
244 private $diploma;
245
61d1fd8b 246 public function __construct()
d7ddf29b 247 {
61d1fd8b 248 $this->diploma = pl_flatten(func_get_args());
d7ddf29b
RB		 249 }
250
251 public function buildCondition(PlFilter &$uf)
252 {
253 $sub = $uf->addEducationFilter();
d115b6df 254 return XDB::format('pe' . $sub . '.degreeid IN {?}', $this->diploma);
d7ddf29b
RB		 255 }
256}
257// }}}
258
fb3b6547
RB		 259// {{{ class UFC_EducationField
260class UFC_EducationField implements UserFilterCondition
d7ddf29b
RB		 261{
262 private $val;
263
61d1fd8b 264 public function __construct()
d7ddf29b 265 {
61d1fd8b 266 $this->val = pl_flatten(func_get_args());
d7ddf29b
RB		 267 }
268
269 public function buildCondition(PlFilter &$uf)
270 {
271 $sub = $uf->addEducationFilter();
4290d54e 272 return XDB::format('pe' . $sub . '.fieldid IN {?}', $this->val);
d7ddf29b
RB		 273 }
274}
275// }}}
276
8363588b 277// {{{ class UFC_Name
53eae167 278/** Filters users based on name
5d2e55c7 279 * @param $type Type of name field on which filtering is done (firstname, lastname...)
53eae167 280 * @param $text Text on which to filter
5d2e55c7 281 * @param $mode Flag indicating search type (prefix, suffix, with particule...)
53eae167 282 */
784745ce
FB		 283class UFC_Name implements UserFilterCondition
284{
706f7a0f
RB		 285 const EXACT = XDB::WILDCARD_EXACT; // 0x000
286 const PREFIX = XDB::WILDCARD_PREFIX; // 0x001
287 const SUFFIX = XDB::WILDCARD_SUFFIX; // 0x002
658b4c83 288 const CONTAINS = XDB::WILDCARD_CONTAINS; // 0x003
5bb60f74 289 const PARTICLE = 0x004;
658b4c83 290 const VARIANTS = 0x008;
784745ce
FB		 291
292 private $type;
293 private $text;
294 private $mode;
295
296 public function __construct($type, $text, $mode)
297 {
298 $this->type = $type;
299 $this->text = $text;
300 $this->mode = $mode;
301 }
302
303 private function buildNameQuery($type, $variant, $where, UserFilter &$uf)
304 {
305 $sub = $uf->addNameFilter($type, $variant);
306 return str_replace('$ME', 'pn' . $sub, $where);
307 }
308
dcc63ed5 309 public function buildCondition(PlFilter &$uf)
784745ce
FB		 310 {
311 $left = '$ME.name';
784745ce
FB		 312 if (($this->mode & self::PARTICLE) == self::PARTICLE) {
313 $left = 'CONCAT($ME.particle, \' \', $ME.name)';
314 }
658b4c83
RB		 315 $right = XDB::formatWildcards($this->mode & self::CONTAINS, $this->text);
316
317 $cond = $left . $right;
784745ce 318 $conds = array($this->buildNameQuery($this->type, null, $cond, $uf));
913a4e90
RB		 319 if (($this->mode & self::VARIANTS) != 0 && isset(Profile::$name_variants[$this->type])) {
320 foreach (Profile::$name_variants[$this->type] as $var) {
784745ce
FB		 321 $conds[] = $this->buildNameQuery($this->type, $var, $cond, $uf);
322 }
323 }
324 return implode(' OR ', $conds);
a087cc8d
FB		 325 }
326}
8363588b 327// }}}
a087cc8d 328
40585144
RB		 329// {{{ class UFC_NameTokens
330/** Selects users based on tokens in their name (for quicksearch)
331 * @param $tokens An array of tokens to search
332 * @param $flags Flags the tokens must have (e.g 'public' for public search)
333 * @param $soundex (bool) Whether those tokens are fulltext or soundex
334 */
335class UFC_NameTokens implements UserFilterCondition
336{
337 /* Flags */
338 const FLAG_PUBLIC = 'public';
339
340 private $tokens;
341 private $flags;
342 private $soundex;
79a0b464 343 private $exact;
40585144 344
79a0b464 345 public function __construct($tokens, $flags = array(), $soundex = false, $exact = false)
40585144 346 {
a867dfba
RB		 347 if (is_array($tokens)) {
348 $this->tokens = $tokens;
349 } else {
350 $this->tokens = array($tokens);
351 }
40585144
RB		 352 if (is_array($flags)) {
353 $this->flags = $flags;
354 } else {
355 $this->flags = array($flags);
356 }
357 $this->soundex = $soundex;
79a0b464 358 $this->exact = $exact;
40585144
RB		 359 }
360
dcc63ed5 361 public function buildCondition(PlFilter &$uf)
40585144 362 {
40585144 363 $conds = array();
2a93b634
RB		 364 foreach ($this->tokens as $i => $token) {
365 $sub = $uf->addNameTokensFilter($token);
366 if ($this->soundex) {
367 $c = XDB::format($sub . '.soundex = {?}', $token);
368 } else if ($this->exact) {
369 $c = XDB::format($sub . '.token = {?}', $token);
370 } else {
371 $c = $sub . '.token ' . XDB::formatWildcards(XDB::WILDCARD_PREFIX, $token);
40585144 372 }
2a93b634
RB		 373 if ($this->flags != null) {
374 $c .= XDB::format(' AND ' . $sub . '.flags IN {?}', $this->flags);
375 }
376 $conds[] = $c;
40585144
RB		 377 }
378
379 return implode(' AND ', $conds);
380 }
381}
382// }}}
383
0fb3713c
RB		 384// {{{ class UFC_Nationality
385class UFC_Nationality implements UserFilterCondition
386{
d7ddf29b 387 private $val;
0fb3713c 388
61d1fd8b 389 public function __construct()
0fb3713c 390 {
61d1fd8b 391 $this->val = pl_flatten(func_get_args());
0fb3713c
RB		 392 }
393
394 public function buildCondition(PlFilter &$uf)
395 {
d7ddf29b
RB		 396 $uf->requireProfiles();
397 $nat = XDB::formatArray($this->val);
398 $conds = array(
399 'p.nationality1 IN ' . $nat,
400 'p.nationality2 IN ' . $nat,
401 'p.nationality3 IN ' . $nat,
402 );
403 return implode(' OR ', $conds);
0fb3713c
RB		 404 }
405}
406// }}}
407
8363588b 408// {{{ class UFC_Dead
53eae167
RB		 409/** Filters users based on death date
410 * @param $comparison Comparison operator
8fcb783a 411 * @param $date Date to which death date should be compared (DateTime object, string or timestamp)
53eae167 412 */
4927ee54
FB		 413class UFC_Dead implements UserFilterCondition
414{
38c6fe96
FB		 415 private $comparison;
416 private $date;
417
418 public function __construct($comparison = null, $date = null)
4927ee54 419 {
38c6fe96 420 $this->comparison = $comparison;
a0d47f5c 421 $this->date = make_datetime($date);
4927ee54
FB		 422 }
423
dcc63ed5 424 public function buildCondition(PlFilter &$uf)
4927ee54 425 {
d7ddf29b 426 $uf->requireProfiles();
38c6fe96
FB		 427 $str = 'p.deathdate IS NOT NULL';
428 if (!is_null($this->comparison)) {
8fcb783a 429 $str .= ' AND p.deathdate ' . $this->comparison . ' ' . XDB::format('{?}', $this->date->format('Y-m-d'));
4927ee54 430 }
38c6fe96 431 return $str;
4927ee54
FB		 432 }
433}
8363588b 434// }}}
4927ee54 435
8363588b 436// {{{ class UFC_Registered
53eae167
RB		 437/** Filters users based on registration state
438 * @param $active Whether we want to use only "active" users (i.e with a valid redirection)
439 * @param $comparison Comparison operator
440 * @param $date Date to which users registration date should be compared
441 */
4927ee54
FB		 442class UFC_Registered implements UserFilterCondition
443{
444 private $active;
38c6fe96
FB		 445 private $comparison;
446 private $date;
447
448 public function __construct($active = false, $comparison = null, $date = null)
4927ee54 449 {
b2e8fc54 450 $this->active = $active;
38c6fe96 451 $this->comparison = $comparison;
a0d47f5c 452 $this->date = make_datetime($date);
4927ee54
FB		 453 }
454
dcc63ed5 455 public function buildCondition(PlFilter &$uf)
4927ee54 456 {
d7ddf29b 457 $uf->requireAccounts();
4927ee54 458 if ($this->active) {
93b0da52 459 $date = '$UID IS NOT NULL AND a.state = \'active\'';
4927ee54 460 } else {
93b0da52 461 $date = '$UID IS NOT NULL AND a.state != \'pending\'';
38c6fe96
FB		 462 }
463 if (!is_null($this->comparison)) {
c9c74e4f 464 $date .= ' AND a.registration_date != \'0000-00-00 00:00:00\' AND a.registration_date ' . $this->comparison . ' ' . XDB::format('{?}', $this->date->format('Y-m-d'));
4927ee54 465 }
38c6fe96 466 return $date;
4927ee54
FB		 467 }
468}
8363588b 469// }}}
4927ee54 470
8363588b 471// {{{ class UFC_ProfileUpdated
53eae167
RB		 472/** Filters users based on profile update date
473 * @param $comparison Comparison operator
474 * @param $date Date to which profile update date must be compared
475 */
7e735012
FB		 476class UFC_ProfileUpdated implements UserFilterCondition
477{
478 private $comparison;
479 private $date;
480
481 public function __construct($comparison = null, $date = null)
482 {
483 $this->comparison = $comparison;
484 $this->date = $date;
485 }
486
dcc63ed5 487 public function buildCondition(PlFilter &$uf)
7e735012 488 {
d7ddf29b 489 $uf->requireProfiles();
7e735012
FB		 490 return 'p.last_change ' . $this->comparison . XDB::format(' {?}', date('Y-m-d H:i:s', $this->date));
491 }
492}
8363588b 493// }}}
7e735012 494
8363588b 495// {{{ class UFC_Birthday
53eae167
RB		 496/** Filters users based on next birthday date
497 * @param $comparison Comparison operator
498 * @param $date Date to which users next birthday date should be compared
499 */
7e735012
FB		 500class UFC_Birthday implements UserFilterCondition
501{
502 private $comparison;
503 private $date;
504
505 public function __construct($comparison = null, $date = null)
506 {
507 $this->comparison = $comparison;
508 $this->date = $date;
509 }
510
dcc63ed5 511 public function buildCondition(PlFilter &$uf)
7e735012 512 {
d7ddf29b 513 $uf->requireProfiles();
7e735012
FB		 514 return 'p.next_birthday ' . $this->comparison . XDB::format(' {?}', date('Y-m-d', $this->date));
515 }
516}
8363588b 517// }}}
7e735012 518
8363588b 519// {{{ class UFC_Sex
53eae167
RB		 520/** Filters users based on sex
521 * @parm $sex One of User::GENDER_MALE or User::GENDER_FEMALE, for selecting users
522 */
4927ee54
FB		 523class UFC_Sex implements UserFilterCondition
524{
525 private $sex;
526 public function __construct($sex)
527 {
528 $this->sex = $sex;
529 }
530
dcc63ed5 531 public function buildCondition(PlFilter &$uf)
4927ee54
FB		 532 {
533 if ($this->sex != User::GENDER_MALE && $this->sex != User::GENDER_FEMALE) {
534 return self::COND_FALSE;
535 } else {
d7ddf29b 536 $uf->requireProfiles();
24e08e33 537 return XDB::format('p.sex = {?}', $this->sex == User::GENDER_FEMALE ? 'female' : 'male');
4927ee54
FB		 538 }
539 }
540}
8363588b 541// }}}
4927ee54 542
8363588b 543// {{{ class UFC_Group
53eae167 544/** Filters users based on group membership
5d2e55c7
RB		 545 * @param $group Group whose members we are selecting
546 * @param $anim Whether to restrict selection to animators of that group
53eae167 547 */
4927ee54
FB		 548class UFC_Group implements UserFilterCondition
549{
550 private $group;
5d2e55c7
RB		 551 private $anim;
552 public function __construct($group, $anim = false)
4927ee54
FB		 553 {
554 $this->group = $group;
5d2e55c7 555 $this->anim = $anim;
4927ee54
FB		 556 }
557
dcc63ed5 558 public function buildCondition(PlFilter &$uf)
4927ee54 559 {
7f26cd69
RB		 560 // Groups have AX visibility.
561 if ($uf->getVisibilityLevel() == ProfileVisibility::VIS_PUBLIC) {
9f169a65 562 return PlFilter::COND_TRUE;
7f26cd69 563 }
4927ee54
FB		 564 $sub = $uf->addGroupFilter($this->group);
565 $where = 'gpm' . $sub . '.perms IS NOT NULL';
5d2e55c7 566 if ($this->anim) {
4927ee54
FB		 567 $where .= ' AND gpm' . $sub . '.perms = \'admin\'';
568 }
569 return $where;
570 }
571}
8363588b 572// }}}
4927ee54 573
0fb3713c 574// {{{ class UFC_Binet
d7ddf29b
RB		 575/** Selects users based on their belonging to a given (list of) binet
576 * @param $binet either a binet_id or an array of binet_ids
577 */
0fb3713c
RB		 578class UFC_Binet implements UserFilterCondition
579{
d7ddf29b 580 private $val;
0fb3713c 581
61d1fd8b 582 public function __construct()
0fb3713c 583 {
61d1fd8b 584 $this->val = pl_flatten(func_get_args());
0fb3713c
RB		 585 }
586
587 public function buildCondition(PlFilter &$uf)
588 {
7f26cd69
RB		 589 // Binets are private.
590 if ($uf->getVisibilityLevel() != ProfileVisibility::VIS_PRIVATE) {
9f169a65 591 return PlFilter::COND_TRUE;
7f26cd69 592 }
d7ddf29b 593 $sub = $uf->addBinetsFilter();
bde68f05 594 return XDB::format($sub . '.binet_id IN {?}', $this->val);
a7f8e48a
RB		 595 }
596}
597// }}}
598
599// {{{ class UFC_Section
46e88fe3
RB		 600/** Selects users based on section
601 * @param $section ID of the section
602 */
a7f8e48a
RB		 603class UFC_Section implements UserFilterCondition
604{
605 private $section;
606
61d1fd8b 607 public function __construct()
a7f8e48a 608 {
61d1fd8b 609 $this->section = pl_flatten(func_get_args());
a7f8e48a
RB		 610 }
611
612 public function buildCondition(PlFilter &$uf)
613 {
7f26cd69
RB		 614 // Sections are private.
615 if ($uf->getVisibilityLevel() != ProfileVisibility::VIS_PRIVATE) {
9f169a65 616 return PlFilter::COND_TRUE;
7f26cd69 617 }
a7f8e48a 618 $uf->requireProfiles();
61d1fd8b 619 return XDB::format('p.section IN {?}', $this->section);
0fb3713c
RB		 620 }
621}
622// }}}
623
8363588b 624// {{{ class UFC_Email
2d6329a2 625/** Filters users based on an email or a list of emails
53eae167
RB		 626 * @param $emails List of emails whose owner must be selected
627 */
2d6329a2 628class UFC_Email implements UserFilterCondition
21401768
FB		 629{
630 private $emails;
2d6329a2 631 public function __construct()
21401768 632 {
61d1fd8b 633 $this->emails = pl_flatten(func_get_args());
21401768
FB		 634 }
635
dcc63ed5 636 public function buildCondition(PlFilter &$uf)
21401768 637 {
2d6329a2
FB		 638 $foreign = array();
639 $virtual = array();
640 $aliases = array();
21401768
FB		 641 $cond = array();
642
643 if (count($this->emails) == 0) {
dcc63ed5 644 return PlFilterCondition::COND_TRUE;
21401768
FB		 645 }
646
647 foreach ($this->emails as $entry) {
648 if (User::isForeignEmailAddress($entry)) {
2d6329a2 649 $foreign[] = $entry;
21401768 650 } else if (User::isVirtualEmailAddress($entry)) {
2d6329a2 651 $virtual[] = $entry;
21401768 652 } else {
21401768 653 @list($user, $domain) = explode('@', $entry);
2d6329a2 654 $aliases[] = $user;
21401768
FB		 655 }
656 }
2d6329a2
FB		 657
658 if (count($foreign) > 0) {
659 $sub = $uf->addEmailRedirectFilter($foreign);
bde68f05 660 $cond[] = XDB::format('e' . $sub . '.email IS NOT NULL OR a.email IN {?}', $foreign);
2d6329a2
FB		 661 }
662 if (count($virtual) > 0) {
663 $sub = $uf->addVirtualEmailFilter($virtual);
664 $cond[] = 'vr' . $sub . '.redirect IS NOT NULL';
665 }
666 if (count($aliases) > 0) {
667 $sub = $uf->addAliasFilter($aliases);
668 $cond[] = 'al' . $sub . '.alias IS NOT NULL';
669 }
21401768
FB		 670 return '(' . implode(') OR (', $cond) . ')';
671 }
672}
8363588b 673// }}}
d865c296 674
8363588b 675// {{{ class UFC_Address
2b9ca54d 676abstract class UFC_Address implements UserFilterCondition
c4b24511 677{
2b9ca54d 678 /** Valid address type ('hq' is reserved for company addresses)
036d1637 679 */
2b9ca54d
RB		 680 const TYPE_HOME = 1;
681 const TYPE_PRO = 2;
682 const TYPE_ANY = 3;
c4b24511 683
2b9ca54d 684 /** Text for these types
036d1637 685 */
2b9ca54d
RB		 686 protected static $typetexts = array(
687 self::TYPE_HOME => 'home',
688 self::TYPE_PRO => 'pro',
689 );
690
691 protected $type;
c4b24511 692
036d1637
RB		 693 /** Flags for addresses
694 */
695 const FLAG_CURRENT = 0x0001;
696 const FLAG_TEMP = 0x0002;
697 const FLAG_SECOND = 0x0004;
698 const FLAG_MAIL = 0x0008;
699 const FLAG_CEDEX = 0x0010;
700
701 // Binary OR of those flags
702 const FLAG_ANY = 0x001F;
703
704 /** Text of these flags
705 */
2b9ca54d 706 protected static $flagtexts = array(
036d1637
RB		 707 self::FLAG_CURRENT => 'current',
708 self::FLAG_TEMP => 'temporary',
709 self::FLAG_SECOND => 'secondary',
710 self::FLAG_MAIL => 'mail',
711 self::FLAG_CEDEX => 'cedex',
712 );
713
2b9ca54d
RB		 714 protected $flags;
715
716 public function __construct($type = null, $flags = null)
717 {
718 $this->type = $type;
719 $this->flags = $flags;
720 }
721
7f26cd69 722 protected function initConds($sub, $vis_cond)
2b9ca54d 723 {
7f26cd69
RB		 724 $conds = array($vis_cond);
725
2b9ca54d
RB		 726 $types = array();
727 foreach (self::$typetexts as $flag => $type) {
728 if ($flag & $this->type) {
729 $types[] = $type;
730 }
731 }
732 if (count($types)) {
6b140032 733 $conds[] = XDB::format($sub . '.type IN {?}', $types);
2b9ca54d
RB		 734 }
735
736 if ($this->flags != self::FLAG_ANY) {
737 foreach(self::$flagtexts as $flag => $text) {
738 if ($flag & $this->flags) {
739 $conds[] = 'FIND_IN_SET(' . XDB::format('{?}', $text) . ', ' . $sub . '.flags)';
740 }
741 }
742 }
743 return $conds;
744 }
745
746}
747// }}}
748
749// {{{ class UFC_AddressText
750/** Select users based on their address, using full text search
751 * @param $text Text for filter in fulltext search
658b4c83 752 * @param $textSearchMode Mode for search (one of XDB::WILDCARD_*)
2b9ca54d
RB		 753 * @param $type Filter on address type
754 * @param $flags Filter on address flags
755 * @param $country Filter on address country
756 * @param $locality Filter on address locality
757 */
758class UFC_AddressText extends UFC_Address
759{
2b9ca54d 760
036d1637 761 private $text;
2b9ca54d
RB		 762 private $textSearchMode;
763
658b4c83 764 public function __construct($text = null, $textSearchMode = XDB::WILDCARD_CONTAINS,
2b9ca54d
RB		 765 $type = null, $flags = self::FLAG_ANY, $country = null, $locality = null)
766 {
767 parent::__construct($type, $flags);
768 $this->text = $text;
769 $this->textSearchMode = $textSearchMode;
770 $this->country = $country;
771 $this->locality = $locality;
772 }
773
774 private function mkMatch($txt)
775 {
658b4c83 776 return XDB::formatWildcards($this->textSearchMode, $txt);
2b9ca54d
RB		 777 }
778
779 public function buildCondition(PlFilter &$uf)
780 {
781 $sub = $uf->addAddressFilter();
7f26cd69 782 $conds = $this->initConds($sub, $uf->getVisibilityCondition($sub . '.pub'));
2b9ca54d
RB		 783 if ($this->text != null) {
784 $conds[] = $sub . '.text' . $this->mkMatch($this->text);
785 }
786
787 if ($this->country != null) {
788 $subc = $uf->addAddressCountryFilter();
789 $subconds = array();
790 $subconds[] = $subc . '.country' . $this->mkMatch($this->country);
791 $subconds[] = $subc . '.countryFR' . $this->mkMatch($this->country);
792 $conds[] = implode(' OR ', $subconds);
793 }
794
795 if ($this->locality != null) {
796 $subl = $uf->addAddressLocalityFilter();
797 $conds[] = $subl . '.name' . $this->mkMatch($this->locality);
798 }
799
800 return implode(' AND ', $conds);
801 }
802}
803// }}}
804
46e88fe3 805// {{{ class UFC_AddressField
2b9ca54d 806/** Filters users based on their address,
46e88fe3
RB		 807 * @param $val Either a code for one of the fields, or an array of such codes
808 * @param $fieldtype The type of field to look for
2b9ca54d
RB		 809 * @param $type Filter on address type
810 * @param $flags Filter on address flags
2b9ca54d 811 */
46e88fe3 812class UFC_AddressField extends UFC_Address
2b9ca54d 813{
46e88fe3
RB		 814 const FIELD_COUNTRY = 1;
815 const FIELD_ADMAREA = 2;
816 const FIELD_SUBADMAREA = 3;
817 const FIELD_LOCALITY = 4;
818 const FIELD_ZIPCODE = 5;
819
2b9ca54d
RB		 820 /** Data of the filter
821 */
46e88fe3
RB		 822 private $val;
823 private $fieldtype;
036d1637 824
46e88fe3 825 public function __construct($val, $fieldtype, $type = null, $flags = self::FLAG_ANY)
036d1637 826 {
2b9ca54d 827 parent::__construct($type, $flags);
46e88fe3
RB		 828
829 if (!is_array($val)) {
830 $val = array($val);
831 }
832 $this->val = $val;
833 $this->fieldtype = $fieldtype;
c4b24511
RB		 834 }
835
dcc63ed5 836 public function buildCondition(PlFilter &$uf)
c4b24511 837 {
036d1637 838 $sub = $uf->addAddressFilter();
7f26cd69 839 $conds = $this->initConds($sub, $uf->getVisibilityCondition($sub . '.pub'));
036d1637 840
46e88fe3
RB		 841 switch ($this->fieldtype) {
842 case self::FIELD_COUNTRY:
843 $field = 'countryId';
844 break;
845 case self::FIELD_ADMAREA:
846 $field = 'administrativeAreaId';
847 break;
848 case self::FIELD_SUBADMAREA:
849 $field = 'subAdministrativeAreaId';
850 break;
851 case self::FIELD_LOCALITY:
852 $field = 'localityId';
853 break;
854 case self::FIELD_ZIPCODE:
855 $field = 'postalCode';
856 break;
857 default:
61f61261 858 Platal::page()->killError('Invalid address field type: ' . $this->fieldtype);
46e88fe3 859 }
bde68f05 860 $conds[] = XDB::format($sub . '.' . $field . ' IN {?}', $this->val);
036d1637
RB		 861
862 return implode(' AND ', $conds);
c4b24511
RB		 863 }
864}
8363588b 865// }}}
c4b24511 866
8363588b 867// {{{ class UFC_Corps
4083b126
RB		 868/** Filters users based on the corps they belong to
869 * @param $corps Corps we are looking for (abbreviation)
870 * @param $type Whether we search for original or current corps
871 */
872class UFC_Corps implements UserFilterCondition
873{
5d2e55c7
RB		 874 const CURRENT = 1;
875 const ORIGIN = 2;
4083b126
RB		 876
877 private $corps;
878 private $type;
879
880 public function __construct($corps, $type = self::CURRENT)
881 {
882 $this->corps = $corps;
883 $this->type = $type;
884 }
885
dcc63ed5 886 public function buildCondition(PlFilter &$uf)
4083b126 887 {
5d2e55c7
RB		 888 /** Tables shortcuts:
889 * pc for profile_corps,
4083b126
RB		 890 * pceo for profile_corps_enum - orginal
891 * pcec for profile_corps_enum - current
892 */
893 $sub = $uf->addCorpsFilter($this->type);
894 $cond = $sub . '.abbreviation = ' . $corps;
7f26cd69 895 $cond .= ' AND ' . $uf->getVisibilityCondition($sub . '.corps_pub');
4083b126
RB		 896 return $cond;
897 }
898}
8363588b 899// }}}
4083b126 900
8363588b 901// {{{ class UFC_Corps_Rank
4083b126
RB		 902/** Filters users based on their rank in the corps
903 * @param $rank Rank we are looking for (abbreviation)
904 */
905class UFC_Corps_Rank implements UserFilterCondition
906{
907 private $rank;
908 public function __construct($rank)
909 {
910 $this->rank = $rank;
911 }
912
dcc63ed5 913 public function buildCondition(PlFilter &$uf)
4083b126 914 {
5d2e55c7 915 /** Tables shortcuts:
7f26cd69 916 * pc for profile_corps
4083b126
RB		 917 * pcr for profile_corps_rank
918 */
919 $sub = $uf->addCorpsRankFilter();
920 $cond = $sub . '.abbreviation = ' . $rank;
7f26cd69
RB		 921 // XXX(x2006barrois): find a way to get rid of that hardcoded
922 // reference to 'pc'.
923 $cond .= ' AND ' . $uf->getVisibilityCondition('pc.corps_pub');
4083b126
RB		 924 return $cond;
925 }
926}
8363588b 927// }}}
4083b126 928
6a99c3ac
RB		 929// {{{ class UFC_Job_Company
930/** Filters users based on the company they belong to
931 * @param $type The field being searched (self::JOBID, self::JOBNAME or self::JOBACRONYM)
932 * @param $value The searched value
933 */
4e2f2ad2 934class UFC_Job_Company implements UserFilterCondition
6a99c3ac
RB		 935{
936 const JOBID = 'id';
937 const JOBNAME = 'name';
938 const JOBACRONYM = 'acronym';
939
940 private $type;
941 private $value;
942
943 public function __construct($type, $value)
944 {
945 $this->assertType($type);
946 $this->type = $type;
947 $this->value = $value;
948 }
949
950 private function assertType($type)
951 {
952 if ($type != self::JOBID && $type != self::JOBNAME && $type != self::JOBACRONYM) {
5d2e55c7 953 Platal::page()->killError("Type de recherche non valide.");
6a99c3ac
RB		 954 }
955 }
956
dcc63ed5 957 public function buildCondition(PlFilter &$uf)
6a99c3ac
RB		 958 {
959 $sub = $uf->addJobCompanyFilter();
412e2e0f 960 $cond = $sub . '.' . $this->type . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->value);
7f26cd69
RB		 961 $jsub = $uf->addJobFilter();
962 $cond .= ' AND ' . $uf->getVisibilityCondition($jsub . '.pub');
6a99c3ac
RB		 963 return $cond;
964 }
965}
966// }}}
967
968// {{{ class UFC_Job_Sectorization
969/** Filters users based on the ((sub)sub)sector they work in
46e88fe3 970 * @param $val The ID of the sector, or an array of such IDs
d7ddf29b 971 * @param $type The kind of search (subsubsector/subsector/sector)
6a99c3ac 972 */
4e2f2ad2 973class UFC_Job_Sectorization implements UserFilterCondition
6a99c3ac 974{
d7ddf29b
RB		 975 private $val;
976 private $type;
6a99c3ac 977
d7ddf29b
RB		 978 public function __construct($val, $type = UserFilter::JOB_SECTOR)
979 {
980 self::assertType($type);
46e88fe3
RB		 981 if (!is_array($val)) {
982 $val = array($val);
983 }
d7ddf29b
RB		 984 $this->val = $val;
985 $this->type = $type;
986 }
6a99c3ac 987
d7ddf29b 988 private static function assertType($type)
6a99c3ac 989 {
d7ddf29b
RB		 990 if ($type != UserFilter::JOB_SECTOR && $type != UserFilter::JOB_SUBSECTOR && $type != UserFilter::JOB_SUBSUBSECTOR) {
991 Platal::page()->killError("Type de secteur non valide.");
992 }
6a99c3ac
RB		 993 }
994
dcc63ed5 995 public function buildCondition(PlFilter &$uf)
6a99c3ac 996 {
d7ddf29b 997 $sub = $uf->addJobSectorizationFilter($this->type);
7f26cd69
RB		 998 $cond = $sub . '.id = ' . XDB::format('{?}', $this->val);
999 $jsub = $uf->addJobFilter();
1000 $cond .= ' AND ' . $uf->getVisibilityCondition($jsub . '.pub');
1001 return $cond;
6a99c3ac
RB		 1002 }
1003}
1004// }}}
1005
3ac45f10
PC		 1006// {{{ class UFC_Job_Terms
1007/** Filters users based on the job terms they assigned to one of their
1008 * jobs.
1009 * @param $val The ID of the job term, or an array of such IDs
1010 */
1011class UFC_Job_Terms implements UserFilterCondition
1012{
1013 private $val;
1014
1015 public function __construct($val)
1016 {
1017 if (!is_array($val)) {
1018 $val = array($val);
1019 }
1020 $this->val = $val;
1021 }
1022
1023 public function buildCondition(PlFilter &$uf)
1024 {
1025 $sub = $uf->addJobTermsFilter(count($this->val));
1026 $conditions = array();
1027 foreach ($this->val as $i => $jtid) {
1028 $conditions[] = $sub[$i] . ' = ' . XDB::escape($jtid);
1029 }
7f26cd69
RB		 1030 $jsub = $uf->addJobFilter();
1031 $conditions[] = $uf->getVisibilityCondition($jsub . '.pub');
3ac45f10
PC		 1032 return implode(' AND ', $conditions);
1033 }
1034}
1035// }}}
1036
6a99c3ac
RB		 1037// {{{ class UFC_Job_Description
1038/** Filters users based on their job description
1039 * @param $description The text being searched for
1040 * @param $fields The fields to search for (user-defined, ((sub|)sub|)sector)
1041 */
4e2f2ad2 1042class UFC_Job_Description implements UserFilterCondition
6a99c3ac
RB		 1043{
1044
6a99c3ac
RB		 1045 private $description;
1046 private $fields;
1047
01cc5f9e 1048 public function __construct($description, $fields)
6a99c3ac
RB		 1049 {
1050 $this->fields = $fields;
1051 $this->description = $description;
1052 }
1053
dcc63ed5 1054 public function buildCondition(PlFilter &$uf)
6a99c3ac
RB		 1055 {
1056 $conds = array();
7f26cd69
RB		 1057
1058 $jsub = $uf->addJobFilter();
1059 // CV is private => if only CV requested, and not private,
1060 // don't do anything. Otherwise restrict to standard job visibility.
9f169a65
RB		 1061 if ($this->fields == UserFilter::JOB_CV) {
1062 if ($uf->getVisibilityLevel() != ProfileVisibility::VIS_PRIVATE) {
1063 return PlFilter::COND_TRUE;
1064 }
1065 } else {
7f26cd69
RB		 1066 $conds[] = $uf->getVisibilityCondition($jsub . '.pub');
1067 }
1068
6a99c3ac 1069 if ($this->fields & UserFilter::JOB_USERDEFINED) {
7f26cd69 1070 $conds[] = $jsub . '.description ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
6a99c3ac 1071 }
7f26cd69 1072 if ($this->fields & UserFilter::JOB_CV && $uf->getVisibilityLevel == ProfileVisibility::VIS_PRIVATE) {
01cc5f9e 1073 $uf->requireProfiles();
658b4c83 1074 $conds[] = 'p.cv ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
01cc5f9e 1075 }
6a99c3ac
RB		 1076 if ($this->fields & UserFilter::JOB_SECTOR) {
1077 $sub = $uf->addJobSectorizationFilter(UserFilter::JOB_SECTOR);
658b4c83 1078 $conds[] = $sub . '.name ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
6a99c3ac
RB		 1079 }
1080 if ($this->fields & UserFilter::JOB_SUBSECTOR) {
1081 $sub = $uf->addJobSectorizationFilter(UserFilter::JOB_SUBSECTOR);
658b4c83 1082 $conds[] = $sub . '.name ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
6a99c3ac
RB		 1083 }
1084 if ($this->fields & UserFilter::JOB_SUBSUBSECTOR) {
1085 $sub = $uf->addJobSectorizationFilter(UserFilter::JOB_SUBSUBSECTOR);
658b4c83 1086 $conds[] = $sub . '.name ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
6a99c3ac 1087 $sub = $uf->addJobSectorizationFilter(UserFilter::JOB_ALTERNATES);
658b4c83 1088 $conds[] = $sub . '.name ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->description);
6a99c3ac
RB		 1089 }
1090 return implode(' OR ', $conds);
1091 }
1092}
1093// }}}
1094
0a2e9c74
RB		 1095// {{{ class UFC_Networking
1096/** Filters users based on network identity (IRC, ...)
1097 * @param $type Type of network (-1 for any)
1098 * @param $value Value to search
1099 */
4e2f2ad2 1100class UFC_Networking implements UserFilterCondition
0a2e9c74
RB		 1101{
1102 private $type;
1103 private $value;
1104
1105 public function __construct($type, $value)
1106 {
1107 $this->type = $type;
1108 $this->value = $value;
1109 }
1110
dcc63ed5 1111 public function buildCondition(PlFilter &$uf)
0a2e9c74
RB		 1112 {
1113 $sub = $uf->addNetworkingFilter();
1114 $conds = array();
7f26cd69 1115 $conds[] = $uf->getVisibilityCondition($sub . '.pub');
658b4c83 1116 $conds[] = $sub . '.address ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->value);
0a2e9c74 1117 if ($this->type != -1) {
1f5cd004 1118 $conds[] = $sub . '.nwid = ' . XDB::format('{?}', $this->type);
0a2e9c74
RB		 1119 }
1120 return implode(' AND ', $conds);
1121 }
1122}
1123// }}}
1124
6d62969e
RB		 1125// {{{ class UFC_Phone
1126/** Filters users based on their phone number
1127 * @param $num_type Type of number (pro/user/home)
1128 * @param $phone_type Type of phone (fixed/mobile/fax)
1129 * @param $number Phone number
1130 */
4e2f2ad2 1131class UFC_Phone implements UserFilterCondition
6d62969e
RB		 1132{
1133 const NUM_PRO = 'pro';
1134 const NUM_USER = 'user';
1135 const NUM_HOME = 'address';
1136 const NUM_ANY = 'any';
1137
1138 const PHONE_FIXED = 'fixed';
1139 const PHONE_MOBILE = 'mobile';
1140 const PHONE_FAX = 'fax';
1141 const PHONE_ANY = 'any';
1142
1143 private $num_type;
1144 private $phone_type;
1145 private $number;
1146
1147 public function __construct($number, $num_type = self::NUM_ANY, $phone_type = self::PHONE_ANY)
1148 {
da0a9c5a 1149 $phone = new Phone(array('display' => $number));
0b6c8b36
SJ		 1150 $phone->format();
1151 $this->number = $phone->search();
6d62969e 1152 $this->num_type = $num_type;
0b6c8b36 1153 $this->phone_type = $phone_type;
6d62969e
RB		 1154 }
1155
dcc63ed5 1156 public function buildCondition(PlFilter &$uf)
6d62969e
RB		 1157 {
1158 $sub = $uf->addPhoneFilter();
1159 $conds = array();
7f26cd69
RB		 1160
1161 $conds[] = $uf->getVisibilityCondition($sub . '.pub');
1162
6d62969e
RB		 1163 $conds[] = $sub . '.search_tel = ' . XDB::format('{?}', $this->number);
1164 if ($this->num_type != self::NUM_ANY) {
1165 $conds[] = $sub . '.link_type = ' . XDB::format('{?}', $this->num_type);
1166 }
1167 if ($this->phone_type != self::PHONE_ANY) {
1168 $conds[] = $sub . '.tel_type = ' . XDB::format('{?}', $this->phone_type);
1169 }
1170 return implode(' AND ', $conds);
1171 }
1172}
1173// }}}
1174
ceb512d2
RB		 1175// {{{ class UFC_Medal
1176/** Filters users based on their medals
1177 * @param $medal ID of the medal
1178 * @param $grade Grade of the medal (null for 'any')
1179 */
4e2f2ad2 1180class UFC_Medal implements UserFilterCondition
ceb512d2
RB		 1181{
1182 private $medal;
1183 private $grade;
1184
1185 public function __construct($medal, $grade = null)
1186 {
1187 $this->medal = $medal;
1188 $this->grade = $grade;
1189 }
1190
dcc63ed5 1191 public function buildCondition(PlFilter &$uf)
ceb512d2
RB		 1192 {
1193 $conds = array();
7f26cd69
RB		 1194
1195 // This will require profiles => table 'p' will be available.
ceb512d2 1196 $sub = $uf->addMedalFilter();
7f26cd69
RB		 1197
1198 $conds[] = $uf->getVisibilityCondition('p.medals_pub');
1199
ceb512d2
RB		 1200 $conds[] = $sub . '.mid = ' . XDB::format('{?}', $this->medal);
1201 if ($this->grade != null) {
1202 $conds[] = $sub . '.gid = ' . XDB::format('{?}', $this->grade);
1203 }
1204 return implode(' AND ', $conds);
1205 }
1206}
1207// }}}
1208
470d14f6
FB		 1209// {{{ class UFC_Photo
1210/** Filters profiles with photo
1211 */
1212class UFC_Photo implements UserFilterCondition
1213{
1214 public function buildCondition(PlFilter &$uf)
1215 {
7f26cd69
RB		 1216 $sub = $uf->addPhotoFilter();
1217 return $sub . '.attach IS NOT NULL AND ' . $uf->getVisibilityCondition($sub . '.pub');
470d14f6
FB		 1218 }
1219}
1220// }}}
1221
671b7073
RB		 1222// {{{ class UFC_Mentor_Expertise
1223/** Filters users by mentoring expertise
1224 * @param $expertise Domain of expertise
1225 */
4e2f2ad2 1226class UFC_Mentor_Expertise implements UserFilterCondition
671b7073
RB		 1227{
1228 private $expertise;
1229
1230 public function __construct($expertise)
1231 {
1232 $this->expertise = $expertise;
1233 }
1234
dcc63ed5 1235 public function buildCondition(PlFilter &$uf)
671b7073
RB		 1236 {
1237 $sub = $uf->addMentorFilter(UserFilter::MENTOR_EXPERTISE);
658b4c83 1238 return $sub . '.expertise ' . XDB::formatWildcards(XDB::WILDCARD_CONTAINS, $this->expertise);
671b7073
RB		 1239 }
1240}
1241// }}}
1242
1243// {{{ class UFC_Mentor_Country
1244/** Filters users by mentoring country
1245 * @param $country Two-letters code of country being searched
1246 */
4e2f2ad2 1247class UFC_Mentor_Country implements UserFilterCondition
671b7073
RB		 1248{
1249 private $country;
1250
61d1fd8b 1251 public function __construct()
671b7073 1252 {
61d1fd8b 1253 $this->country = pl_flatten(func_get_args());
671b7073
RB		 1254 }
1255
dcc63ed5 1256 public function buildCondition(PlFilter &$uf)
671b7073
RB		 1257 {
1258 $sub = $uf->addMentorFilter(UserFilter::MENTOR_COUNTRY);
61d1fd8b 1259 return $sub . '.country IN ' . XDB::format('{?}', $this->country);
671b7073
RB		 1260 }
1261}
1262// }}}
1263
459e6f81
PC		 1264// {{{ class UFC_Mentor_Terms
1265/** Filters users based on the job terms they used in mentoring.
1266 * @param $val The ID of the job term, or an array of such IDs
1267 */
1268class UFC_Mentor_Terms implements UserFilterCondition
1269{
1270 private $val;
1271
1272 public function __construct($val)
1273 {
1274 $this->val = $val;
1275 }
1276
1277 public function buildCondition(PlFilter &$uf)
1278 {
1279 $sub = $uf->addMentorFilter(UserFilter::MENTOR_TERM);
1280 return $sub . '.jtid_1 = ' . XDB::escape($this->val);
1281 }
1282}
1283// }}}
1284
671b7073
RB		 1285// {{{ class UFC_Mentor_Sectorization
1286/** Filters users based on mentoring (sub|)sector
c5da8574
RB		 1287 * @param $sector ID of (sub)sector
1288 * @param $type Whether we are looking for a sector or a subsector
671b7073 1289 */
4e2f2ad2 1290class UFC_Mentor_Sectorization implements UserFilterCondition
671b7073 1291{
c5da8574
RB		 1292 const SECTOR = 1;
1293 const SUBSECTOR = 2;
671b7073 1294 private $sector;
c5da8574 1295 private $type;
671b7073 1296
c5da8574 1297 public function __construct($sector, $type = self::SECTOR)
671b7073
RB		 1298 {
1299 $this->sector = $sector;
c5da8574 1300 $this->type = $type;
671b7073
RB		 1301 }
1302
dcc63ed5 1303 public function buildCondition(PlFilter &$uf)
671b7073
RB		 1304 {
1305 $sub = $uf->addMentorFilter(UserFilter::MENTOR_SECTOR);
c5da8574
RB		 1306 if ($this->type == self::SECTOR) {
1307 $field = 'sectorid';
1308 } else {
1309 $field = 'subsectorid';
671b7073 1310 }
c5da8574 1311 return $sub . '.' . $field . ' = ' . XDB::format('{?}', $this->sector);
671b7073
RB		 1312 }
1313}
1314// }}}
1315
8363588b 1316// {{{ class UFC_UserRelated
5d2e55c7 1317/** Filters users based on a relation toward a user
53eae167
RB		 1318 * @param $user User to which searched users are related
1319 */
4e7bf1e0 1320abstract class UFC_UserRelated implements UserFilterCondition
3f42a6ad 1321{
009b8ab7
FB		 1322 protected $user;
1323 public function __construct(PlUser &$user)
1324 {
1325 $this->user =& $user;
3f42a6ad 1326 }
4e7bf1e0 1327}
8363588b 1328// }}}
3f42a6ad 1329
8363588b 1330// {{{ class UFC_Contact
5d2e55c7 1331/** Filters users who belong to selected user's contacts
53eae167 1332 */
4e7bf1e0
FB		 1333class UFC_Contact extends UFC_UserRelated
1334{
dcc63ed5 1335 public function buildCondition(PlFilter &$uf)
3f42a6ad 1336 {
009b8ab7 1337 $sub = $uf->addContactFilter($this->user->id());
3f42a6ad
FB		 1338 return 'c' . $sub . '.contact IS NOT NULL';
1339 }
1340}
8363588b 1341// }}}
3f42a6ad 1342
8363588b 1343// {{{ class UFC_WatchRegistration
53eae167
RB		 1344/** Filters users being watched by selected user
1345 */
4e7bf1e0
FB		 1346class UFC_WatchRegistration extends UFC_UserRelated
1347{
dcc63ed5 1348 public function buildCondition(PlFilter &$uf)
4e7bf1e0 1349 {
a87530ea 1350 if (!$this->user->watchType('registration')) {
dcc63ed5 1351 return PlFilterCondition::COND_FALSE;
009b8ab7
FB		 1352 }
1353 $uids = $this->user->watchUsers();
1354 if (count($uids) == 0) {
dcc63ed5 1355 return PlFilterCondition::COND_FALSE;
009b8ab7 1356 } else {
93b0da52 1357 return XDB::format('$UID IN {?}', $uids);
009b8ab7 1358 }
4e7bf1e0
FB		 1359 }
1360}
8363588b 1361// }}}
4e7bf1e0 1362
8363588b 1363// {{{ class UFC_WatchPromo
53eae167
RB		 1364/** Filters users belonging to a promo watched by selected user
1365 * @param $user Selected user (the one watching promo)
1366 * @param $grade Formation the user is watching
1367 */
4e7bf1e0
FB		 1368class UFC_WatchPromo extends UFC_UserRelated
1369{
1370 private $grade;
009b8ab7 1371 public function __construct(PlUser &$user, $grade = UserFilter::GRADE_ING)
4e7bf1e0 1372 {
009b8ab7 1373 parent::__construct($user);
4e7bf1e0
FB		 1374 $this->grade = $grade;
1375 }
1376
dcc63ed5 1377 public function buildCondition(PlFilter &$uf)
4e7bf1e0 1378 {
009b8ab7
FB		 1379 $promos = $this->user->watchPromos();
1380 if (count($promos) == 0) {
dcc63ed5 1381 return PlFilterCondition::COND_FALSE;
009b8ab7
FB		 1382 } else {
1383 $sube = $uf->addEducationFilter(true, $this->grade);
1384 $field = 'pe' . $sube . '.' . UserFilter::promoYear($this->grade);
bde68f05 1385 return XDB::format($field . ' IN {?}', $promos);
009b8ab7 1386 }
4e7bf1e0
FB		 1387 }
1388}
8363588b 1389// }}}
4e7bf1e0 1390
8363588b 1391// {{{ class UFC_WatchContact
53eae167
RB		 1392/** Filters users watched by selected user
1393 */
009b8ab7 1394class UFC_WatchContact extends UFC_Contact
4e7bf1e0 1395{
dcc63ed5 1396 public function buildCondition(PlFilter &$uf)
4e7bf1e0 1397 {
009b8ab7 1398 if (!$this->user->watchContacts()) {
dcc63ed5 1399 return PlFilterCondition::COND_FALSE;
009b8ab7
FB		 1400 }
1401 return parent::buildCondition($uf);
4e7bf1e0
FB		 1402 }
1403}
8363588b 1404// }}}
4e7bf1e0 1405
48885bbe
FB		 1406// {{{ class UFC_MarketingHash
1407/** Filters users using the hash generated
1408 * to send marketing emails to him.
1409 */
1410class UFC_MarketingHash implements UserFilterCondition
1411{
1412 private $hash;
1413
1414 public function __construct($hash)
1415 {
1416 $this->hash = $hash;
1417 }
1418
1419 public function buildCondition(PlFilter &$uf)
1420 {
1421 $table = $uf->addMarketingHash();
1422 return XDB::format('rm.hash = {?}', $this->hash);
1423 }
1424}
416d4244 1425// }}}
4e7bf1e0 1426
d865c296
FB		 1427/******************
1428 * ORDERS
1429 ******************/
1430
8363588b 1431// {{{ class UFO_Promo
5d2e55c7
RB		 1432/** Orders users by promotion
1433 * @param $grade Formation whose promotion users should be sorted by (restricts results to users of that formation)
53eae167
RB		 1434 * @param $desc Whether sort is descending
1435 */
ccc951d9 1436class UFO_Promo extends PlFilterGroupableOrder
d865c296
FB		 1437{
1438 private $grade;
1439
1440 public function __construct($grade = null, $desc = false)
1441 {
009b8ab7 1442 parent::__construct($desc);
d865c296 1443 $this->grade = $grade;
d865c296
FB		 1444 }
1445
61f61261 1446 protected function getSortTokens(PlFilter &$uf)
d865c296
FB		 1447 {
1448 if (UserFilter::isGrade($this->grade)) {
1449 $sub = $uf->addEducationFilter($this->grade);
1450 return 'pe' . $sub . '.' . UserFilter::promoYear($this->grade);
1451 } else {
1452 $sub = $uf->addDisplayFilter();
1453 return 'pd' . $sub . '.promo';
1454 }
1455 }
1456}
8363588b 1457// }}}
d865c296 1458
8363588b 1459// {{{ class UFO_Name
53eae167 1460/** Sorts users by name
5d2e55c7
RB		 1461 * @param $type Type of name on which to sort (firstname...)
1462 * @param $variant Variant of that name to use (marital, ordinary...)
53eae167
RB		 1463 * @param $particle Set to true if particles should be included in the sorting order
1464 * @param $desc If sort order should be descending
1465 */
ccc951d9 1466class UFO_Name extends PlFilterOrder
d865c296
FB		 1467{
1468 private $type;
1469 private $variant;
1470 private $particle;
1471
1472 public function __construct($type, $variant = null, $particle = false, $desc = false)
1473 {
009b8ab7 1474 parent::__construct($desc);
d865c296
FB		 1475 $this->type = $type;
1476 $this->variant = $variant;
1477 $this->particle = $particle;
d865c296
FB		 1478 }
1479
61f61261 1480 protected function getSortTokens(PlFilter &$uf)
d865c296 1481 {
913a4e90 1482 if (Profile::isDisplayName($this->type)) {
d865c296 1483 $sub = $uf->addDisplayFilter();
a9ef52c9
RB		 1484 $token = 'pd' . $sub . '.' . $this->type;
1485 if ($uf->accountsRequired()) {
1486 $account_token = Profile::getAccountEquivalentName($this->type);
1487 return 'IFNULL(' . $token . ', a.' . $account_token . ')';
1488 } else {
1489 return $token;
1490 }
d865c296
FB		 1491 } else {
1492 $sub = $uf->addNameFilter($this->type, $this->variant);
1493 if ($this->particle) {
1494 return 'CONCAT(pn' . $sub . '.particle, \' \', pn' . $sub . '.name)';
1495 } else {
1496 return 'pn' . $sub . '.name';
1497 }
1498 }
1499 }
1500}
8363588b 1501// }}}
d865c296 1502
40585144 1503// {{{ class UFO_Score
ccc951d9 1504class UFO_Score extends PlFilterOrder
40585144 1505{
61f61261 1506 protected function getSortTokens(PlFilter &$uf)
40585144 1507 {
2a93b634
RB		 1508 $toks = $uf->getNameTokens();
1509 $scores = array();
488765e3
RB		 1510
1511 // If there weren't any sort tokens, we shouldn't sort by score, sort by NULL instead
1512 if (count($toks) == 0) {
1513 return 'NULL';
1514 }
1515
2a93b634
RB		 1516 foreach ($toks as $sub => $token) {
1517 $scores[] = XDB::format('SUM(' . $sub . '.score + IF (' . $sub . '.token = {?}, 5, 0) )', $token);
1518 }
1519 return implode(' + ', $scores);
40585144
RB		 1520 }
1521}
1522// }}}
1523
8363588b 1524// {{{ class UFO_Registration
53eae167
RB		 1525/** Sorts users based on registration date
1526 */
ccc951d9 1527class UFO_Registration extends PlFilterOrder
38c6fe96 1528{
61f61261 1529 protected function getSortTokens(PlFilter &$uf)
38c6fe96 1530 {
6c1e97ae 1531 $uf->requireAccounts();
009b8ab7 1532 return 'a.registration_date';
38c6fe96 1533 }
009b8ab7 1534}
8363588b 1535// }}}
38c6fe96 1536
8363588b 1537// {{{ class UFO_Birthday
53eae167
RB		 1538/** Sorts users based on next birthday date
1539 */
ccc951d9 1540class UFO_Birthday extends PlFilterOrder
009b8ab7 1541{
61f61261 1542 protected function getSortTokens(PlFilter &$uf)
38c6fe96 1543 {
6c1e97ae 1544 $uf->requireProfiles();
009b8ab7 1545 return 'p.next_birthday';
38c6fe96
FB		 1546 }
1547}
8363588b 1548// }}}
38c6fe96 1549
8363588b 1550// {{{ class UFO_ProfileUpdate
53eae167
RB		 1551/** Sorts users based on last profile update
1552 */
ccc951d9 1553class UFO_ProfileUpdate extends PlFilterOrder
009b8ab7 1554{
61f61261 1555 protected function getSortTokens(PlFilter &$uf)
009b8ab7 1556 {
6c1e97ae 1557 $uf->requireProfiles();
009b8ab7
FB		 1558 return 'p.last_change';
1559 }
1560}
8363588b 1561// }}}
009b8ab7 1562
8363588b 1563// {{{ class UFO_Death
53eae167
RB		 1564/** Sorts users based on death date
1565 */
ccc951d9 1566class UFO_Death extends PlFilterOrder
009b8ab7 1567{
61f61261 1568 protected function getSortTokens(PlFilter &$uf)
009b8ab7 1569 {
6c1e97ae 1570 $uf->requireProfiles();
009b8ab7
FB		 1571 return 'p.deathdate';
1572 }
1573}
8363588b 1574// }}}
009b8ab7 1575
6c1e97ae
FB		 1576// {{{ class UFO_Uid
1577/** Sorts users based on their uid
1578 */
ccc951d9 1579class UFO_Uid extends PlFilterOrder
6c1e97ae
FB		 1580{
1581 protected function getSortTokens(PlFilter &$uf)
1582 {
1583 $uf->requireAccounts();
93b0da52 1584 return '$UID';
6c1e97ae
FB		 1585 }
1586}
c752a130 1587// }}}
6c1e97ae
FB		 1588
1589// {{{ class UFO_Hruid
1590/** Sorts users based on their hruid
1591 */
ccc951d9 1592class UFO_Hruid extends PlFilterOrder
6c1e97ae
FB		 1593{
1594 protected function getSortTokens(PlFilter &$uf)
1595 {
1596 $uf->requireAccounts();
1597 return 'a.hruid';
1598 }
1599}
1600// }}}
1601
1602// {{{ class UFO_Pid
1603/** Sorts users based on their pid
1604 */
ccc951d9 1605class UFO_Pid extends PlFilterOrder
6c1e97ae
FB		 1606{
1607 protected function getSortTokens(PlFilter &$uf)
1608 {
1609 $uf->requireProfiles();
93b0da52 1610 return '$PID';
6c1e97ae
FB		 1611 }
1612}
c752a130 1613// }}}
6c1e97ae
FB		 1614
1615// {{{ class UFO_Hrpid
1616/** Sorts users based on their hrpid
1617 */
ccc951d9 1618class UFO_Hrpid extends PlFilterOrder
6c1e97ae
FB		 1619{
1620 protected function getSortTokens(PlFilter &$uf)
1621 {
1622 $uf->requireProfiles();
1623 return 'p.hrpid';
1624 }
1625}
1626// }}}
1627
009b8ab7 1628
d865c296
FB		 1629/***********************************
1630 *********************************
1631 USER FILTER CLASS
1632 *********************************
1633 ***********************************/
1634
8363588b 1635// {{{ class UserFilter
2d83cac9
RB		 1636/** This class provides a convenient and centralized way of filtering users.
1637 *
1638 * Usage:
1639 * $uf = new UserFilter(new UFC_Blah($x, $y), new UFO_Coin($z, $t));
1640 *
1641 * Resulting UserFilter can be used to:
1642 * - get a list of User objects matching the filter
1643 * - get a list of UIDs matching the filter
1644 * - get the number of users matching the filter
1645 * - check whether a given User matches the filter
1646 * - filter a list of User objects depending on whether they match the filter
1647 *
1648 * Usage for UFC and UFO objects:
1649 * A UserFilter will call all private functions named XXXJoins.
1650 * These functions must return an array containing the list of join
1651 * required by the various UFC and UFO associated to the UserFilter.
1652 * Entries in those returned array are of the following form:
1653 * 'join_tablealias' => array('join_type', 'joined_table', 'join_criter')
1654 * which will be translated into :
1655 * join_type JOIN joined_table AS join_tablealias ON (join_criter)
1656 * in the final query.
1657 *
1658 * In the join_criter text, $ME is replaced with 'join_tablealias', $PID with
913a4e90 1659 * profile.pid, and $UID with accounts.uid.
2d83cac9
RB		 1660 *
1661 * For each kind of "JOIN" needed, a function named addXXXFilter() should be defined;
1662 * its parameter will be used to set various private vars of the UserFilter describing
1663 * the required joins ; such a function shall return the "join_tablealias" to use
1664 * when referring to the joined table.
1665 *
1666 * For example, if data from profile_job must be available to filter results,
aab2ffdd 1667 * the UFC object will call $uf-addJobFilter(), which will set the 'with_pj' var and
2d83cac9
RB		 1668 * return 'pj', the short name to use when referring to profile_job; when building
1669 * the query, calling the jobJoins function will return an array containing a single
1670 * row:
1671 * 'pj' => array('left', 'profile_job', '$ME.pid = $UID');
1672 *
1673 * The 'register_optional' function can be used to generate unique table aliases when
1674 * the same table has to be joined several times with different aliases.
1675 */
9b8e5fb4 1676class UserFilter extends PlFilter
a087cc8d 1677{
9b8e5fb4 1678 protected $joinMethods = array();
7ca75030 1679
61f61261
RB		 1680 protected $joinMetas = array(
1681 '$PID' => 'p.pid',
1682 '$UID' => 'a.uid',
9b8e5fb4 1683 );
d865c296 1684
a087cc8d 1685 private $root;
24e08e33 1686 private $sort = array();
ccc951d9 1687 private $grouper = null;
784745ce 1688 private $query = null;
24e08e33 1689 private $orderby = null;
784745ce 1690
7f26cd69
RB		 1691 // Store the current 'search' visibility.
1692 private $profile_visibility = null;
1693
2daf7250
RB		 1694 private $lastusercount = null;
1695 private $lastprofilecount = null;
d865c296 1696
24e08e33 1697 public function __construct($cond = null, $sort = null)
5dd9d823 1698 {
06598c13 1699 if (empty($this->joinMethods)) {
d865c296
FB		 1700 $class = new ReflectionClass('UserFilter');
1701 foreach ($class->getMethods() as $method) {
1702 $name = $method->getName();
1703 if (substr($name, -5) == 'Joins' && $name != 'buildJoins') {
06598c13 1704 $this->joinMethods[] = $name;
d865c296
FB		 1705 }
1706 }
1707 }
5dd9d823 1708 if (!is_null($cond)) {
06598c13 1709 if ($cond instanceof PlFilterCondition) {
5dd9d823
FB		 1710 $this->setCondition($cond);
1711 }
1712 }
24e08e33 1713 if (!is_null($sort)) {
ccc951d9 1714 if ($sort instanceof PlFilterOrder) {
24e08e33 1715 $this->addSort($sort);
d865c296
FB		 1716 } else if (is_array($sort)) {
1717 foreach ($sort as $s) {
1718 $this->addSort($s);
1719 }
24e08e33
FB		 1720 }
1721 }
7f26cd69
RB		 1722
1723 // This will set the visibility to the default correct level.
1724 $this->profile_visibility = new ProfileVisibility();
1725 }
1726
1727 public function getVisibilityLevels()
1728 {
1729 return $this->profile_visibility->levels();
1730 }
1731
1732 public function getVisibilityLevel()
1733 {
1734 return $this->profile_visibility->level();
1735 }
1736
1737 public function restrictVisibilityTo($level)
1738 {
1739 $this->profile_visibility->setLevel($level);
1740 }
1741
1742 public function getVisibilityCondition($field)
1743 {
1744 return $field . ' IN ' . XDB::formatArray($this->getVisibilityLevels());
5dd9d823
FB		 1745 }
1746
784745ce
FB		 1747 private function buildQuery()
1748 {
2a93b634
RB		 1749 // The root condition is built first because some orders need info
1750 // available only once all UFC have set their conditions (UFO_Score)
1751 if (is_null($this->query)) {
1752 $where = $this->root->buildCondition($this);
226626ae
FB		 1753 $where = str_replace(array_keys($this->joinMetas),
1754 $this->joinMetas,
1755 $where);
2a93b634 1756 }
d865c296
FB		 1757 if (is_null($this->orderby)) {
1758 $orders = array();
1759 foreach ($this->sort as $sort) {
1760 $orders = array_merge($orders, $sort->buildSort($this));
1761 }
1762 if (count($orders) == 0) {
1763 $this->orderby = '';
1764 } else {
1765 $this->orderby = 'ORDER BY ' . implode(', ', $orders);
1766 }
226626ae
FB		 1767 $this->orderby = str_replace(array_keys($this->joinMetas),
1768 $this->joinMetas,
1769 $this->orderby);
d865c296 1770 }
784745ce 1771 if (is_null($this->query)) {
2a93b634 1772 if ($this->with_accounts) {
b8dcf62d
RB		 1773 $from = 'accounts AS a';
1774 } else {
1775 $this->requireProfiles();
1776 $from = 'profiles AS p';
1777 }
f7ea7450 1778 $joins = $this->buildJoins();
b8dcf62d 1779 $this->query = 'FROM ' . $from . '
784745ce
FB		 1780 ' . $joins . '
1781 WHERE (' . $where . ')';
1782 }
1783 }
1784
ccc951d9
RB		 1785 public function hasGroups()
1786 {
1787 return $this->grouper != null;
1788 }
1789
1790 public function getGroups()
1791 {
1792 return $this->getUIDGroups();
1793 }
1794
1795 public function getUIDGroups()
1796 {
1797 $this->requireAccounts();
1798 $this->buildQuery();
1799 $token = $this->grouper->getGroupToken($this);
1800
1801 $groups = XDB::fetchAllRow('SELECT ' . $token . ', COUNT(a.uid)
1802 ' . $this->query . '
1803 GROUP BY ' . $token,
1804 0);
1805 return $groups;
1806 }
1807
1808 public function getPIDGroups()
1809 {
1810 $this->requireProfiles();
1811 $this->buildQuery();
1812 $token = $this->grouper->getGroupToken($this);
1813
1814 $groups = XDB::fetchAllRow('SELECT ' . $token . ', COUNT(p.pid)
1815 ' . $this->query . '
1816 GROUP BY ' . $token,
1817 0);
1818 return $groups;
1819 }
1820
7ca75030 1821 private function getUIDList($uids = null, PlLimit &$limit)
d865c296 1822 {
b8dcf62d 1823 $this->requireAccounts();
d865c296 1824 $this->buildQuery();
7ca75030 1825 $lim = $limit->getSql();
d865c296 1826 $cond = '';
45b20ca0 1827 if (!empty($uids)) {
bde68f05 1828 $cond = XDB::format(' AND a.uid IN {?}', $uids);
d865c296
FB		 1829 }
1830 $fetched = XDB::fetchColumn('SELECT SQL_CALC_FOUND_ROWS a.uid
1831 ' . $this->query . $cond . '
1832 GROUP BY a.uid
1833 ' . $this->orderby . '
7ca75030 1834 ' . $lim);
2daf7250 1835 $this->lastusercount = (int)XDB::fetchOneCell('SELECT FOUND_ROWS()');
d865c296
FB		 1836 return $fetched;
1837 }
1838
043b104b
RB		 1839 private function getPIDList($pids = null, PlLimit &$limit)
1840 {
1841 $this->requireProfiles();
1842 $this->buildQuery();
1843 $lim = $limit->getSql();
1844 $cond = '';
1845 if (!is_null($pids)) {
bde68f05 1846 $cond = XDB::format(' AND p.pid IN {?}', $pids);
043b104b
RB		 1847 }
1848 $fetched = XDB::fetchColumn('SELECT SQL_CALC_FOUND_ROWS p.pid
1849 ' . $this->query . $cond . '
1850 GROUP BY p.pid
1851 ' . $this->orderby . '
1852 ' . $lim);
2daf7250 1853 $this->lastprofilecount = (int)XDB::fetchOneCell('SELECT FOUND_ROWS()');
043b104b
RB		 1854 return $fetched;
1855 }
1856
434570c4
FB		 1857 private static function defaultLimit($limit) {
1858 if ($limit == null) {
1859 return new PlLimit();
1860 } else {
1861 return $limit;
1862 }
1863 }
1864
a087cc8d
FB		 1865 /** Check that the user match the given rule.
1866 */
1867 public function checkUser(PlUser &$user)
1868 {
b8dcf62d 1869 $this->requireAccounts();
784745ce
FB		 1870 $this->buildQuery();
1871 $count = (int)XDB::fetchOneCell('SELECT COUNT(*)
1872 ' . $this->query . XDB::format(' AND a.uid = {?}', $user->id()));
1873 return $count == 1;
a087cc8d
FB		 1874 }
1875
043b104b
RB		 1876 /** Check that the profile match the given rule.
1877 */
1878 public function checkProfile(Profile &$profile)
1879 {
1880 $this->requireProfiles();
1881 $this->buildQuery();
1882 $count = (int)XDB::fetchOneCell('SELECT COUNT(*)
1883 ' . $this->query . XDB::format(' AND p.pid = {?}', $profile->id()));
1884 return $count == 1;
1885 }
1886
1887 /** Default filter is on users
a087cc8d 1888 */
434570c4 1889 public function filter(array $users, $limit = null)
a087cc8d 1890 {
434570c4 1891 return $this->filterUsers($users, self::defaultLimit($limit));
043b104b
RB		 1892 }
1893
1894 /** Filter a list of users to extract the users matching the rule.
1895 */
434570c4 1896 public function filterUsers(array $users, $limit = null)
043b104b 1897 {
434570c4 1898 $limit = self::defaultLimit($limit);
b8dcf62d 1899 $this->requireAccounts();
4927ee54
FB		 1900 $this->buildQuery();
1901 $table = array();
1902 $uids = array();
1903 foreach ($users as $user) {
07eb5b0e
FB		 1904 if ($user instanceof PlUser) {
1905 $uid = $user->id();
1906 } else {
1907 $uid = $user;
1908 }
1909 $uids[] = $uid;
1910 $table[$uid] = $user;
4927ee54 1911 }
7ca75030 1912 $fetched = $this->getUIDList($uids, $limit);
a087cc8d 1913 $output = array();
4927ee54
FB		 1914 foreach ($fetched as $uid) {
1915 $output[] = $table[$uid];
a087cc8d
FB		 1916 }
1917 return $output;
1918 }
1919
043b104b
RB		 1920 /** Filter a list of profiles to extract the users matching the rule.
1921 */
434570c4 1922 public function filterProfiles(array $profiles, $limit = null)
043b104b 1923 {
434570c4 1924 $limit = self::defaultLimit($limit);
043b104b
RB		 1925 $this->requireProfiles();
1926 $this->buildQuery();
1927 $table = array();
1928 $pids = array();
1929 foreach ($profiles as $profile) {
1930 if ($profile instanceof Profile) {
1931 $pid = $profile->id();
1932 } else {
1933 $pid = $profile;
1934 }
1935 $pids[] = $pid;
1936 $table[$pid] = $profile;
1937 }
1938 $fetched = $this->getPIDList($pids, $limit);
1939 $output = array();
1940 foreach ($fetched as $pid) {
1941 $output[] = $table[$pid];
1942 }
1943 return $output;
1944 }
1945
434570c4 1946 public function getUIDs($limit = null)
7ca75030 1947 {
833a6e86
FB		 1948 $limit = self::defaultLimit($limit);
1949 return $this->getUIDList(null, $limit);
7ca75030
RB		 1950 }
1951
ad27b22e
FB		 1952 public function getUID($pos = 0)
1953 {
983f3864 1954 $uids =$this->getUIDList(null, new PlLimit(1, $pos));
ad27b22e
FB		 1955 if (count($uids) == 0) {
1956 return null;
1957 } else {
1958 return $uids[0];
1959 }
1960 }
1961
434570c4 1962 public function getPIDs($limit = null)
043b104b 1963 {
833a6e86
FB		 1964 $limit = self::defaultLimit($limit);
1965 return $this->getPIDList(null, $limit);
043b104b
RB		 1966 }
1967
ad27b22e
FB		 1968 public function getPID($pos = 0)
1969 {
983f3864 1970 $pids =$this->getPIDList(null, new PlLimit(1, $pos));
ad27b22e
FB		 1971 if (count($pids) == 0) {
1972 return null;
1973 } else {
1974 return $pids[0];
1975 }
1976 }
1977
434570c4 1978 public function getUsers($limit = null)
4927ee54 1979 {
7ca75030 1980 return User::getBulkUsersWithUIDs($this->getUIDs($limit));
d865c296
FB		 1981 }
1982
ad27b22e
FB		 1983 public function getUser($pos = 0)
1984 {
1985 $uid = $this->getUID($pos);
1986 if ($uid == null) {
1987 return null;
1988 } else {
1989 return User::getWithUID($uid);
1990 }
1991 }
1992
0d906109
RB		 1993 public function iterUsers($limit = null)
1994 {
1995 return User::iterOverUIDs($this->getUIDs($limit));
1996 }
1997
00f83317 1998 public function getProfiles($limit = null, $fields = 0x0000, $visibility = null)
043b104b 1999 {
00f83317 2000 return Profile::getBulkProfilesWithPIDs($this->getPIDs($limit), $fields, $visibility);
043b104b
RB		 2001 }
2002
00f83317 2003 public function getProfile($pos = 0, $fields = 0x0000, $visibility = null)
ad27b22e
FB		 2004 {
2005 $pid = $this->getPID($pos);
2006 if ($pid == null) {
2007 return null;
2008 } else {
00f83317 2009 return Profile::get($pid, $fields, $visibility);
ad27b22e
FB		 2010 }
2011 }
2012
00f83317 2013 public function iterProfiles($limit = null, $fields = 0x0000, $visibility = null)
0d906109 2014 {
00f83317 2015 return Profile::iterOverPIDs($this->getPIDs($limit), true, $fields, $visibility);
0d906109
RB		 2016 }
2017
434570c4 2018 public function get($limit = null)
d865c296 2019 {
7ca75030 2020 return $this->getUsers($limit);
4927ee54
FB		 2021 }
2022
aaf70eb8 2023
d865c296 2024 public function getTotalCount()
4927ee54 2025 {
2daf7250
RB		 2026 return $this->getTotalUserCount();
2027 }
2028
2029 public function getTotalUserCount()
2030 {
2031 if (is_null($this->lastusercount)) {
2032 $this->requireAccounts();
aa21c568 2033 $this->buildQuery();
2daf7250
RB		 2034 return (int)XDB::fetchOneCell('SELECT COUNT(DISTINCT a.uid)
2035 ' . $this->query);
2036 } else {
2037 return $this->lastusercount;
2038 }
2039 }
2040
2041 public function getTotalProfileCount()
2042 {
2043 if (is_null($this->lastprofilecount)) {
2044 $this->requireProfiles();
2045 $this->buildQuery();
2046 return (int)XDB::fetchOneCell('SELECT COUNT(DISTINCT p.pid)
7e735012 2047 ' . $this->query);
38c6fe96 2048 } else {
2daf7250 2049 return $this->lastprofilecount;
38c6fe96 2050 }
4927ee54
FB		 2051 }
2052
9b8e5fb4 2053 public function setCondition(PlFilterCondition &$cond)
a087cc8d
FB		 2054 {
2055 $this->root =& $cond;
784745ce 2056 $this->query = null;
a087cc8d
FB		 2057 }
2058
9b8e5fb4 2059 public function addSort(PlFilterOrder &$sort)
24e08e33 2060 {
ccc951d9
RB		 2061 if (count($this->sort) == 0 && $sort instanceof PlFilterGroupableOrder)
2062 {
2063 $this->grouper = $sort;
2064 }
d865c296
FB		 2065 $this->sort[] = $sort;
2066 $this->orderby = null;
24e08e33
FB		 2067 }
2068
a087cc8d
FB		 2069 static public function getLegacy($promo_min, $promo_max)
2070 {
a087cc8d 2071 if ($promo_min != 0) {
784745ce 2072 $min = new UFC_Promo('>=', self::GRADE_ING, intval($promo_min));
5dd9d823 2073 } else {
88c31faf 2074 $min = new PFC_True();
a087cc8d 2075 }
a087cc8d 2076 if ($promo_max != 0) {
784745ce 2077 $max = new UFC_Promo('<=', self::GRADE_ING, intval($promo_max));
a087cc8d 2078 } else {
88c31faf 2079 $max = new PFC_True();
a087cc8d 2080 }
9b8e5fb4 2081 return new UserFilter(new PFC_And($min, $max));
a087cc8d 2082 }
784745ce 2083
07eb5b0e
FB		 2084 static public function sortByName()
2085 {
913a4e90 2086 return array(new UFO_Name(Profile::LASTNAME), new UFO_Name(Profile::FIRSTNAME));
07eb5b0e
FB		 2087 }
2088
2089 static public function sortByPromo()
2090 {
913a4e90 2091 return array(new UFO_Promo(), new UFO_Name(Profile::LASTNAME), new UFO_Name(Profile::FIRSTNAME));
07eb5b0e
FB		 2092 }
2093
aa21c568
FB		 2094 static private function getDBSuffix($string)
2095 {
2d6329a2
FB		 2096 if (is_array($string)) {
2097 if (count($string) == 1) {
2098 return self::getDBSuffix(array_pop($string));
2099 }
2100 return md5(implode('|', $string));
2101 } else {
2102 return preg_replace('/[^a-z0-9]/i', '', $string);
2103 }
aa21c568
FB		 2104 }
2105
2106
2d83cac9
RB		 2107 /** Stores a new (and unique) table alias in the &$table table
2108 * @param &$table Array in which the table alias must be stored
2109 * @param $val Value which will then be used to build the join
2110 * @return Name of the newly created alias
2111 */
aa21c568
FB		 2112 private $option = 0;
2113 private function register_optional(array &$table, $val)
2114 {
2115 if (is_null($val)) {
2116 $sub = $this->option++;
2117 $index = null;
2118 } else {
2119 $sub = self::getDBSuffix($val);
2120 $index = $val;
2121 }
2122 $sub = '_' . $sub;
2123 $table[$sub] = $index;
2124 return $sub;
2125 }
784745ce 2126
b8dcf62d
RB		 2127 /** PROFILE VS ACCOUNT
2128 */
f7ea7450
RB		 2129 private $with_profiles = false;
2130 private $with_accounts = false;
b8dcf62d
RB		 2131 public function requireAccounts()
2132 {
2133 $this->with_accounts = true;
2134 }
2135
a9ef52c9
RB		 2136 public function accountsRequired()
2137 {
2138 return $this->with_accounts;
2139 }
2140
b8dcf62d
RB		 2141 public function requireProfiles()
2142 {
2143 $this->with_profiles = true;
2144 }
2145
a9ef52c9
RB		 2146 public function profilesRequired()
2147 {
2148 return $this->with_profiles;
2149 }
2150
b8dcf62d
RB		 2151 protected function accountJoins()
2152 {
2153 $joins = array();
2a93b634 2154 if ($this->with_profiles && $this->with_accounts) {
5c412626
FB		 2155 $joins['ap'] = PlSqlJoin::left('account_profiles', '$ME.uid = $UID AND FIND_IN_SET(\'owner\', ap.perms)');
2156 $joins['p'] = PlSqlJoin::left('profiles', '$PID = ap.pid');
b8dcf62d
RB		 2157 }
2158 return $joins;
2159 }
2160
d865c296
FB		 2161 /** DISPLAY
2162 */
38c6fe96 2163 const DISPLAY = 'display';
d865c296
FB		 2164 private $pd = false;
2165 public function addDisplayFilter()
2166 {
b8dcf62d 2167 $this->requireProfiles();
d865c296
FB		 2168 $this->pd = true;
2169 return '';
2170 }
2171
9b8e5fb4 2172 protected function displayJoins()
d865c296
FB		 2173 {
2174 if ($this->pd) {
5c412626 2175 return array('pd' => PlSqlJoin::left('profile_display', '$ME.pid = $PID'));
d865c296
FB		 2176 } else {
2177 return array();
2178 }
2179 }
2180
f73a4f1b
RB		 2181 /** LOGGER
2182 */
2183
2184 private $with_logger = false;
2185 public function addLoggerFilter()
2186 {
2187 $this->with_logger = true;
2188 $this->requireAccounts();
2189 return 'ls';
2190 }
2191 protected function loggerJoins()
2192 {
2193 $joins = array();
2194 if ($this->with_logger) {
5c412626 2195 $joins['ls'] = PlSqlJoin::left('log_sessions', '$ME.uid = $UID');
f73a4f1b
RB		 2196 }
2197 return $joins;
2198 }
2199
784745ce
FB		 2200 /** NAMES
2201 */
784745ce
FB		 2202
2203 static public function assertName($name)
2204 {
07613cdd 2205 if (!DirEnum::getID(DirEnum::NAMETYPES, $name)) {
9b8e5fb4 2206 Platal::page()->kill('Invalid name type: ' . $name);
784745ce
FB		 2207 }
2208 }
2209
2210 private $pn = array();
784745ce
FB		 2211 public function addNameFilter($type, $variant = null)
2212 {
b8dcf62d 2213 $this->requireProfiles();
784745ce
FB		 2214 if (!is_null($variant)) {
2215 $ft = $type . '_' . $variant;
2216 } else {
2217 $ft = $type;
2218 }
2219 $sub = '_' . $ft;
2220 self::assertName($ft);
2221
2222 if (!is_null($variant) && $variant == 'other') {
aa21c568 2223 $sub .= $this->option++;
784745ce 2224 }
07613cdd 2225 $this->pn[$sub] = DirEnum::getID(DirEnum::NAMETYPES, $ft);
784745ce
FB		 2226 return $sub;
2227 }
2228
9b8e5fb4 2229 protected function nameJoins()
784745ce
FB		 2230 {
2231 $joins = array();
2232 foreach ($this->pn as $sub => $type) {
5c412626 2233 $joins['pn' . $sub] = PlSqlJoin::left('profile_name', '$ME.pid = $PID AND $ME.typeid = {?}', $type);
784745ce
FB		 2234 }
2235 return $joins;
2236 }
2237
40585144
RB		 2238 /** NAMETOKENS
2239 */
2a93b634
RB		 2240 private $name_tokens = array();
2241 private $nb_tokens = 0;
2242
2243 public function addNameTokensFilter($token)
40585144
RB		 2244 {
2245 $this->requireProfiles();
2a93b634
RB		 2246 $sub = 'sn' . (1 + $this->nb_tokens);
2247 $this->nb_tokens++;
2248 $this->name_tokens[$sub] = $token;
2249 return $sub;
40585144
RB		 2250 }
2251
2252 protected function nameTokensJoins()
2253 {
f7ea7450 2254 /* We don't return joins, since with_sn forces the SELECT to run on search_name first */
2a93b634
RB		 2255 $joins = array();
2256 foreach ($this->name_tokens as $sub => $token) {
2257 $joins[$sub] = PlSqlJoin::left('search_name', '$ME.pid = $PID');
40585144 2258 }
2a93b634
RB		 2259 return $joins;
2260 }
2261
2262 public function getNameTokens()
2263 {
2264 return $this->name_tokens;
40585144
RB		 2265 }
2266
a7f8e48a
RB		 2267 /** NATIONALITY
2268 */
2269
2270 private $with_nat = false;
2271 public function addNationalityFilter()
2272 {
2273 $this->with_nat = true;
2274 return 'ngc';
2275 }
2276
2277 protected function nationalityJoins()
2278 {
2279 $joins = array();
2280 if ($this->with_nat) {
5c412626 2281 $joins['ngc'] = PlSqlJoin::left('geoloc_countries', '$ME.iso_3166_1_a2 = p.nationality1 OR $ME.iso_3166_1_a2 = p.nationality2 OR $ME.iso_3166_1_a2 = p.nationality3');
a7f8e48a
RB		 2282 }
2283 return $joins;
2284 }
2285
784745ce
FB		 2286 /** EDUCATION
2287 */
2288 const GRADE_ING = 'Ing.';
2289 const GRADE_PHD = 'PhD';
2290 const GRADE_MST = 'M%';
2291 static public function isGrade($grade)
2292 {
93c2f133 2293 return ($grade !== 0) && ($grade == self::GRADE_ING || $grade == self::GRADE_PHD || $grade == self::GRADE_MST);
784745ce
FB		 2294 }
2295
2296 static public function assertGrade($grade)
2297 {
2298 if (!self::isGrade($grade)) {
ad27b22e 2299 Platal::page()->killError("Diplôme non valide: $grade");
784745ce
FB		 2300 }
2301 }
2302
d865c296
FB		 2303 static public function promoYear($grade)
2304 {
2305 // XXX: Definition of promotion for phds and masters might change in near future.
2306 return ($grade == UserFilter::GRADE_ING) ? 'entry_year' : 'grad_year';
2307 }
2308
784745ce
FB		 2309 private $pepe = array();
2310 private $with_pee = false;
784745ce
FB		 2311 public function addEducationFilter($x = false, $grade = null)
2312 {
b8dcf62d 2313 $this->requireProfiles();
784745ce 2314 if (!$x) {
aa21c568
FB		 2315 $index = $this->option;
2316 $sub = $this->option++;
784745ce
FB		 2317 } else {
2318 self::assertGrade($grade);
2319 $index = $grade;
2320 $sub = $grade[0];
2321 $this->with_pee = true;
2322 }
2323 $sub = '_' . $sub;
2324 $this->pepe[$index] = $sub;
2325 return $sub;
2326 }
2327
9b8e5fb4 2328 protected function educationJoins()
784745ce
FB		 2329 {
2330 $joins = array();
2331 if ($this->with_pee) {
5c412626 2332 $joins['pee'] = PlSqlJoin::inner('profile_education_enum', 'pee.abbreviation = \'X\'');
784745ce
FB		 2333 }
2334 foreach ($this->pepe as $grade => $sub) {
2335 if ($this->isGrade($grade)) {
5c412626
FB		 2336 $joins['pe' . $sub] = PlSqlJoin::left('profile_education', '$ME.eduid = pee.id AND $ME.pid = $PID');
2337 $joins['pede' . $sub] = PlSqlJoin::inner('profile_education_degree_enum', '$ME.id = pe' . $sub . '.degreeid AND $ME.abbreviation LIKE {?}', $grade);
784745ce 2338 } else {
5c412626
FB		 2339 $joins['pe' . $sub] = PlSqlJoin::left('profile_education', '$ME.pid = $PID');
2340 $joins['pee' . $sub] = PlSqlJoin::inner('profile_education_enum', '$ME.id = pe' . $sub . '.eduid');
2341 $joins['pede' . $sub] = PlSqlJoin::inner('profile_education_degree_enum', '$ME.id = pe' . $sub . '.degreeid');
784745ce
FB		 2342 }
2343 }
2344 return $joins;
2345 }
4927ee54
FB		 2346
2347
2348 /** GROUPS
2349 */
2350 private $gpm = array();
4927ee54
FB		 2351 public function addGroupFilter($group = null)
2352 {
b8dcf62d 2353 $this->requireAccounts();
4927ee54 2354 if (!is_null($group)) {
4aae4d2c 2355 if (is_int($group) || ctype_digit($group)) {
4927ee54
FB		 2356 $index = $sub = $group;
2357 } else {
2358 $index = $group;
aa21c568 2359 $sub = self::getDBSuffix($group);
4927ee54
FB		 2360 }
2361 } else {
aa21c568 2362 $sub = 'group_' . $this->option++;
4927ee54
FB		 2363 $index = null;
2364 }
2365 $sub = '_' . $sub;
2366 $this->gpm[$sub] = $index;
2367 return $sub;
2368 }
2369
9b8e5fb4 2370 protected function groupJoins()
4927ee54
FB		 2371 {
2372 $joins = array();
2373 foreach ($this->gpm as $sub => $key) {
2374 if (is_null($key)) {
5c412626
FB		 2375 $joins['gpa' . $sub] = PlSqlJoin::inner('groups');
2376 $joins['gpm' . $sub] = PlSqlJoin::left('group_members', '$ME.uid = $UID AND $ME.asso_id = gpa' . $sub . '.id');
4aae4d2c 2377 } else if (is_int($key) || ctype_digit($key)) {
5c412626 2378 $joins['gpm' . $sub] = PlSqlJoin::left('group_members', '$ME.uid = $UID AND $ME.asso_id = ' . $key);
4927ee54 2379 } else {
5c412626
FB		 2380 $joins['gpa' . $sub] = PlSqlJoin::inner('groups', '$ME.diminutif = {?}', $key);
2381 $joins['gpm' . $sub] = PlSqlJoin::left('group_members', '$ME.uid = $UID AND $ME.asso_id = gpa' . $sub . '.id');
4927ee54
FB		 2382 }
2383 }
2384 return $joins;
0fb3713c
RB		 2385 }
2386
2387 /** BINETS
2388 */
2389
a7f8e48a
RB		 2390 private $with_bi = false;
2391 private $with_bd = false;
d7ddf29b 2392 public function addBinetsFilter($with_enum = false)
0fb3713c
RB		 2393 {
2394 $this->requireProfiles();
a7f8e48a
RB		 2395 $this->with_bi = true;
2396 if ($with_enum) {
2397 $this->with_bd = true;
2398 return 'bd';
2399 } else {
2400 return 'bi';
2401 }
0fb3713c
RB		 2402 }
2403
2404 protected function binetsJoins()
2405 {
2406 $joins = array();
a7f8e48a 2407 if ($this->with_bi) {
5c412626 2408 $joins['bi'] = PlSqlJoin::left('profile_binets', '$ME.pid = $PID');
0fb3713c 2409 }
a7f8e48a 2410 if ($this->with_bd) {
5c412626 2411 $joins['bd'] = PlSqlJoin::left('profile_binet_enum', '$ME.id = bi.binet_id');
a7f8e48a 2412 }
0fb3713c 2413 return $joins;
4927ee54 2414 }
aa21c568
FB		 2415
2416 /** EMAILS
2417 */
2418 private $e = array();
2419 public function addEmailRedirectFilter($email = null)
2420 {
b8dcf62d 2421 $this->requireAccounts();
aa21c568
FB		 2422 return $this->register_optional($this->e, $email);
2423 }
2424
2425 private $ve = array();
2426 public function addVirtualEmailFilter($email = null)
2427 {
21401768 2428 $this->addAliasFilter(self::ALIAS_FORLIFE);
aa21c568
FB		 2429 return $this->register_optional($this->ve, $email);
2430 }
2431
21401768
FB		 2432 const ALIAS_BEST = 'bestalias';
2433 const ALIAS_FORLIFE = 'forlife';
aa21c568
FB		 2434 private $al = array();
2435 public function addAliasFilter($alias = null)
2436 {
b8dcf62d 2437 $this->requireAccounts();
aa21c568
FB		 2438 return $this->register_optional($this->al, $alias);
2439 }
2440
9b8e5fb4 2441 protected function emailJoins()
aa21c568
FB		 2442 {
2443 global $globals;
2444 $joins = array();
2445 foreach ($this->e as $sub=>$key) {
2446 if (is_null($key)) {
5c412626 2447 $joins['e' . $sub] = PlSqlJoin::left('emails', '$ME.uid = $UID AND $ME.flags != \'filter\'');
aa21c568 2448 } else {
2d6329a2
FB		 2449 if (!is_array($key)) {
2450 $key = array($key);
2451 }
aab2ffdd 2452 $joins['e' . $sub] = PlSqlJoin::left('emails', '$ME.uid = $UID AND $ME.flags != \'filter\'
2f1c94e0 2453 AND $ME.email IN {?}', $key);
aa21c568
FB		 2454 }
2455 }
21401768 2456 foreach ($this->al as $sub=>$key) {
aa21c568 2457 if (is_null($key)) {
5c412626 2458 $joins['al' . $sub] = PlSqlJoin::left('aliases', '$ME.uid = $UID AND $ME.type IN (\'alias\', \'a_vie\')');
21401768 2459 } else if ($key == self::ALIAS_BEST) {
5c412626 2460 $joins['al' . $sub] = PlSqlJoin::left('aliases', '$ME.uid = $UID AND $ME.type IN (\'alias\', \'a_vie\') AND FIND_IN_SET(\'bestalias\', $ME.flags)');
21401768 2461 } else if ($key == self::ALIAS_FORLIFE) {
5c412626 2462 $joins['al' . $sub] = PlSqlJoin::left('aliases', '$ME.uid = $UID AND $ME.type = \'a_vie\'');
aa21c568 2463 } else {
2d6329a2
FB		 2464 if (!is_array($key)) {
2465 $key = array($key);
2466 }
aab2ffdd 2467 $joins['al' . $sub] = PlSqlJoin::left('aliases', '$ME.uid = $UID AND $ME.type IN (\'alias\', \'a_vie\')
bde68f05 2468 AND $ME.alias IN {?}', $key);
aa21c568 2469 }
aa21c568 2470 }
21401768 2471 foreach ($this->ve as $sub=>$key) {
aa21c568 2472 if (is_null($key)) {
5c412626 2473 $joins['v' . $sub] = PlSqlJoin::left('virtual', '$ME.type = \'user\'');
aa21c568 2474 } else {
2d6329a2
FB		 2475 if (!is_array($key)) {
2476 $key = array($key);
2477 }
bde68f05 2478 $joins['v' . $sub] = PlSqlJoin::left('virtual', '$ME.type = \'user\' AND $ME.alias IN {?}', $key);
aa21c568 2479 }
5c412626
FB		 2480 $joins['vr' . $sub] = PlSqlJoin::left('virtual_redirect',
2481 '$ME.vid = v' . $sub . '.vid
2482 AND ($ME.redirect IN (CONCAT(al_forlife.alias, \'@\', {?}),
2483 CONCAT(al_forlife.alias, \'@\', {?}),
2484 a.email))',
2485 $globals->mail->domain, $globals->mail->domain2);
aa21c568
FB		 2486 }
2487 return $joins;
2488 }
3f42a6ad
FB		 2489
2490
c4b24511
RB		 2491 /** ADDRESSES
2492 */
036d1637 2493 private $with_pa = false;
c4b24511
RB		 2494 public function addAddressFilter()
2495 {
b8dcf62d 2496 $this->requireProfiles();
036d1637
RB		 2497 $this->with_pa = true;
2498 return 'pa';
c4b24511
RB		 2499 }
2500
2b9ca54d
RB		 2501 private $with_pac = false;
2502 public function addAddressCountryFilter()
2503 {
2504 $this->requireProfiles();
2505 $this->addAddressFilter();
2506 $this->with_pac = true;
2507 return 'gc';
2508 }
2509
d7ddf29b 2510 private $with_pal = false;
2b9ca54d
RB		 2511 public function addAddressLocalityFilter()
2512 {
2513 $this->requireProfiles();
2514 $this->addAddressFilter();
2515 $this->with_pal = true;
2516 return 'gl';
2517 }
2518
9b8e5fb4 2519 protected function addressJoins()
c4b24511
RB		 2520 {
2521 $joins = array();
036d1637 2522 if ($this->with_pa) {
5c412626 2523 $joins['pa'] = PlSqlJoin::left('profile_addresses', '$ME.pid = $PID');
c4b24511 2524 }
2b9ca54d 2525 if ($this->with_pac) {
5c412626 2526 $joins['gc'] = PlSqlJoin::left('geoloc_countries', '$ME.iso_3166_1_a2 = pa.countryID');
2b9ca54d
RB		 2527 }
2528 if ($this->with_pal) {
5c412626 2529 $joins['gl'] = PlSqlJoin::left('geoloc_localities', '$ME.id = pa.localityID');
2b9ca54d 2530 }
c4b24511
RB		 2531 return $joins;
2532 }
2533
2534
4083b126
RB		 2535 /** CORPS
2536 */
2537
2538 private $pc = false;
2539 private $pce = array();
2540 private $pcr = false;
2541 public function addCorpsFilter($type)
2542 {
b8dcf62d 2543 $this->requireProfiles();
4083b126
RB		 2544 $this->pc = true;
2545 if ($type == UFC_Corps::CURRENT) {
2546 $pce['pcec'] = 'current_corpsid';
2547 return 'pcec';
2548 } else if ($type == UFC_Corps::ORIGIN) {
2549 $pce['pceo'] = 'original_corpsid';
2550 return 'pceo';
2551 }
2552 }
2553
2554 public function addCorpsRankFilter()
2555 {
b8dcf62d 2556 $this->requireProfiles();
4083b126
RB		 2557 $this->pc = true;
2558 $this->pcr = true;
2559 return 'pcr';
2560 }
2561
9b8e5fb4 2562 protected function corpsJoins()
4083b126
RB		 2563 {
2564 $joins = array();
2565 if ($this->pc) {
5c412626 2566 $joins['pc'] = PlSqlJoin::left('profile_corps', '$ME.pid = $PID');
4083b126
RB		 2567 }
2568 if ($this->pcr) {
5c412626 2569 $joins['pcr'] = PlSqlJoin::left('profile_corps_rank_enum', '$ME.id = pc.rankid');
4083b126
RB		 2570 }
2571 foreach($this->pce as $sub => $field) {
5c412626 2572 $joins[$sub] = PlSqlJoin::left('profile_corps_enum', '$ME.id = pc.' . $field);
4083b126
RB		 2573 }
2574 return $joins;
2575 }
2576
6a99c3ac
RB		 2577 /** JOBS
2578 */
2579
61f61261
RB		 2580 const JOB_SECTOR = 0x0001;
2581 const JOB_SUBSECTOR = 0x0002;
2582 const JOB_SUBSUBSECTOR = 0x0004;
2583 const JOB_ALTERNATES = 0x0008;
2584 const JOB_USERDEFINED = 0x0010;
2585 const JOB_CV = 0x0020;
2586
2587 const JOB_SECTORIZATION = 0x000F;
2588 const JOB_ANY = 0x003F;
6a99c3ac
RB		 2589
2590 /** Joins :
2591 * pj => profile_job
2592 * pje => profile_job_enum
2593 * pjse => profile_job_sector_enum
2594 * pjsse => profile_job_subsector_enum
2595 * pjssse => profile_job_subsubsector_enum
2596 * pja => profile_job_alternates
3ac45f10 2597 * pjt => profile_job_terms
6a99c3ac
RB		 2598 */
2599 private $with_pj = false;
2600 private $with_pje = false;
2601 private $with_pjse = false;
2602 private $with_pjsse = false;
2603 private $with_pjssse = false;
2604 private $with_pja = false;
3ac45f10 2605 private $with_pjt = 0;
6a99c3ac
RB		 2606
2607 public function addJobFilter()
2608 {
b8dcf62d 2609 $this->requireProfiles();
6a99c3ac
RB		 2610 $this->with_pj = true;
2611 return 'pj';
2612 }
2613
2614 public function addJobCompanyFilter()
2615 {
2616 $this->addJobFilter();
2617 $this->with_pje = true;
2618 return 'pje';
2619 }
2620
2621 public function addJobSectorizationFilter($type)
2622 {
2623 $this->addJobFilter();
2624 if ($type == self::JOB_SECTOR) {
2625 $this->with_pjse = true;
2626 return 'pjse';
2627 } else if ($type == self::JOB_SUBSECTOR) {
2628 $this->with_pjsse = true;
2629 return 'pjsse';
2630 } else if ($type == self::JOB_SUBSUBSECTOR) {
2631 $this->with_pjssse = true;
2632 return 'pjssse';
2633 } else if ($type == self::JOB_ALTERNATES) {
2634 $this->with_pja = true;
2635 return 'pja';
2636 }
2637 }
2638
3ac45f10
PC		 2639 /**
2640 * Adds a filter on job terms of profile.
2641 * @param $nb the number of job terms to use
2642 * @return an array of the fields to filter (one for each term).
2643 * Code using this function should used returned field as is (contains table and field name).
2644 */
2645 public function addJobTermsFilter($nb = 1)
2646 {
2647 $this->with_pjt = $nb;
2648 $jobtermstable = array();
2649 for ($i = 1; $i <= $nb; ++$i) {
2650 $jobtermstable[] = 'pjtr_'.$i.'.jtid_1';
2651 }
2652 return $jobtermstable;
2653 }
2654
9b8e5fb4 2655 protected function jobJoins()
6a99c3ac
RB		 2656 {
2657 $joins = array();
2658 if ($this->with_pj) {
5c412626 2659 $joins['pj'] = PlSqlJoin::left('profile_job', '$ME.pid = $PID');
6a99c3ac
RB		 2660 }
2661 if ($this->with_pje) {
5c412626 2662 $joins['pje'] = PlSqlJoin::left('profile_job_enum', '$ME.id = pj.jobid');
6a99c3ac
RB		 2663 }
2664 if ($this->with_pjse) {
5c412626 2665 $joins['pjse'] = PlSqlJoin::left('profile_job_sector_enum', '$ME.id = pj.sectorid');
6a99c3ac
RB		 2666 }
2667 if ($this->with_pjsse) {
5c412626 2668 $joins['pjsse'] = PlSqlJoin::left('profile_job_subsector_enum', '$ME.id = pj.subsectorid');
6a99c3ac
RB		 2669 }
2670 if ($this->with_pjssse) {
5c412626 2671 $joins['pjssse'] = PlSqlJoin::left('profile_job_subsubsector_enum', '$ME.id = pj.subsubsectorid');
6a99c3ac
RB		 2672 }
2673 if ($this->with_pja) {
5c412626 2674 $joins['pja'] = PlSqlJoin::left('profile_job_alternates', '$ME.subsubsectorid = pj.subsubsectorid');
6a99c3ac 2675 }
3ac45f10
PC		 2676 if ($this->with_pjt > 0) {
2677 for ($i = 1; $i <= $this->with_pjt; ++$i) {
2678 $joins['pjt_'.$i] = PlSqlJoin::left('profile_job_term', '$ME.pid = $PID');
2679 $joins['pjtr_'.$i] = PlSqlJoin::left('profile_job_term_relation', '$ME.jtid_2 = pjt_'.$i.'.jtid');
2680 }
2681 }
6a99c3ac
RB		 2682 return $joins;
2683 }
2684
0a2e9c74
RB		 2685 /** NETWORKING
2686 */
2687
2688 private $with_pnw = false;
2689 public function addNetworkingFilter()
2690 {
b8dcf62d 2691 $this->requireAccounts();
0a2e9c74
RB		 2692 $this->with_pnw = true;
2693 return 'pnw';
2694 }
2695
9b8e5fb4 2696 protected function networkingJoins()
0a2e9c74
RB		 2697 {
2698 $joins = array();
2699 if ($this->with_pnw) {
5c412626 2700 $joins['pnw'] = PlSqlJoin::left('profile_networking', '$ME.pid = $PID');
0a2e9c74
RB		 2701 }
2702 return $joins;
2703 }
2704
6d62969e
RB		 2705 /** PHONE
2706 */
2707
2d83cac9 2708 private $with_ptel = false;
6d62969e
RB		 2709
2710 public function addPhoneFilter()
2711 {
b8dcf62d 2712 $this->requireAccounts();
2d83cac9 2713 $this->with_ptel = true;
6d62969e
RB		 2714 return 'ptel';
2715 }
2716
9b8e5fb4 2717 protected function phoneJoins()
6d62969e
RB		 2718 {
2719 $joins = array();
2d83cac9 2720 if ($this->with_ptel) {
5c412626 2721 $joins['ptel'] = PlSqlJoin::left('profile_phones', '$ME.pid = $PID');
6d62969e
RB		 2722 }
2723 return $joins;
2724 }
2725
ceb512d2
RB		 2726 /** MEDALS
2727 */
2728
2d83cac9 2729 private $with_pmed = false;
ceb512d2
RB		 2730 public function addMedalFilter()
2731 {
b8dcf62d 2732 $this->requireProfiles();
2d83cac9 2733 $this->with_pmed = true;
ceb512d2
RB		 2734 return 'pmed';
2735 }
2736
9b8e5fb4 2737 protected function medalJoins()
ceb512d2
RB		 2738 {
2739 $joins = array();
2d83cac9 2740 if ($this->with_pmed) {
5c412626 2741 $joins['pmed'] = PlSqlJoin::left('profile_medals', '$ME.pid = $PID');
ceb512d2
RB		 2742 }
2743 return $joins;
2744 }
2745
671b7073
RB		 2746 /** MENTORING
2747 */
2748
2749 private $pms = array();
459e6f81 2750 private $mjtr = false;
671b7073
RB		 2751 const MENTOR_EXPERTISE = 1;
2752 const MENTOR_COUNTRY = 2;
2753 const MENTOR_SECTOR = 3;
459e6f81 2754 const MENTOR_TERM = 4;
671b7073
RB		 2755
2756 public function addMentorFilter($type)
2757 {
b8dcf62d 2758 $this->requireAccounts();
671b7073 2759 switch($type) {
4a93c3a3
RB		 2760 case self::MENTOR_EXPERTISE:
2761 $this->pms['pme'] = 'profile_mentor';
671b7073 2762 return 'pme';
4a93c3a3
RB		 2763 case self::MENTOR_COUNTRY:
2764 $this->pms['pmc'] = 'profile_mentor_country';
671b7073 2765 return 'pmc';
4a93c3a3
RB		 2766 case self::MENTOR_SECTOR:
2767 $this->pms['pms'] = 'profile_mentor_sector';
671b7073 2768 return 'pms';
459e6f81
PC		 2769 case self::MENTOR_TERM:
2770 $this->pms['pmt'] = 'profile_mentor_term';
2771 $this->mjtr = true;
2772 return 'mjtr';
671b7073 2773 default:
5d2e55c7 2774 Platal::page()->killError("Undefined mentor filter.");
671b7073
RB		 2775 }
2776 }
2777
9b8e5fb4 2778 protected function mentorJoins()
671b7073
RB		 2779 {
2780 $joins = array();
2781 foreach ($this->pms as $sub => $tab) {
5c412626 2782 $joins[$sub] = PlSqlJoin::left($tab, '$ME.pid = $PID');
671b7073 2783 }
459e6f81
PC		 2784 if ($this->mjtr) {
2785 $joins['mjtr'] = PlSqlJoin::left('profile_job_term_relation', '$ME.jtid_2 = pmt.jtid');
2786 }
671b7073
RB		 2787 return $joins;
2788 }
2789
3f42a6ad
FB		 2790 /** CONTACTS
2791 */
2792 private $cts = array();
2793 public function addContactFilter($uid = null)
2794 {
c96da6c1 2795 $this->requireProfiles();
3f42a6ad
FB		 2796 return $this->register_optional($this->cts, is_null($uid) ? null : 'user_' . $uid);
2797 }
2798
9b8e5fb4 2799 protected function contactJoins()
3f42a6ad
FB		 2800 {
2801 $joins = array();
2802 foreach ($this->cts as $sub=>$key) {
2803 if (is_null($key)) {
5c412626 2804 $joins['c' . $sub] = PlSqlJoin::left('contacts', '$ME.contact = $PID');
3f42a6ad 2805 } else {
5c412626 2806 $joins['c' . $sub] = PlSqlJoin::left('contacts', '$ME.uid = {?} AND $ME.contact = $PID', substr($key, 5));
3f42a6ad
FB		 2807 }
2808 }
2809 return $joins;
2810 }
4e7bf1e0
FB		 2811
2812
2813 /** CARNET
2814 */
2815 private $wn = array();
2816 public function addWatchRegistrationFilter($uid = null)
2817 {
b8dcf62d 2818 $this->requireAccounts();
4e7bf1e0
FB		 2819 return $this->register_optional($this->wn, is_null($uid) ? null : 'user_' . $uid);
2820 }
2821
2822 private $wp = array();
2823 public function addWatchPromoFilter($uid = null)
2824 {
b8dcf62d 2825 $this->requireAccounts();
4e7bf1e0
FB		 2826 return $this->register_optional($this->wp, is_null($uid) ? null : 'user_' . $uid);
2827 }
2828
2829 private $w = array();
2830 public function addWatchFilter($uid = null)
2831 {
b8dcf62d 2832 $this->requireAccounts();
4e7bf1e0
FB		 2833 return $this->register_optional($this->w, is_null($uid) ? null : 'user_' . $uid);
2834 }
2835
9b8e5fb4 2836 protected function watchJoins()
4e7bf1e0
FB		 2837 {
2838 $joins = array();
2839 foreach ($this->w as $sub=>$key) {
2840 if (is_null($key)) {
5c412626 2841 $joins['w' . $sub] = PlSqlJoin::left('watch');
4e7bf1e0 2842 } else {
5c412626 2843 $joins['w' . $sub] = PlSqlJoin::left('watch', '$ME.uid = {?}', substr($key, 5));
4e7bf1e0
FB		 2844 }
2845 }
2846 foreach ($this->wn as $sub=>$key) {
2847 if (is_null($key)) {
5c412626 2848 $joins['wn' . $sub] = PlSqlJoin::left('watch_nonins', '$ME.ni_id = $UID');
4e7bf1e0 2849 } else {
5c412626 2850 $joins['wn' . $sub] = PlSqlJoin::left('watch_nonins', '$ME.uid = {?} AND $ME.ni_id = $UID', substr($key, 5));
4e7bf1e0
FB		 2851 }
2852 }
2853 foreach ($this->wn as $sub=>$key) {
2854 if (is_null($key)) {
5c412626 2855 $joins['wn' . $sub] = PlSqlJoin::left('watch_nonins', '$ME.ni_id = $UID');
4e7bf1e0 2856 } else {
5c412626 2857 $joins['wn' . $sub] = PlSqlJoin::left('watch_nonins', '$ME.uid = {?} AND $ME.ni_id = $UID', substr($key, 5));
4e7bf1e0
FB		 2858 }
2859 }
2860 foreach ($this->wp as $sub=>$key) {
2861 if (is_null($key)) {
5c412626 2862 $joins['wp' . $sub] = PlSqlJoin::left('watch_promo');
4e7bf1e0 2863 } else {
5c412626 2864 $joins['wp' . $sub] = PlSqlJoin::left('watch_promo', '$ME.uid = {?}', substr($key, 5));
4e7bf1e0
FB		 2865 }
2866 }
2867 return $joins;
2868 }
48885bbe
FB		 2869
2870
470d14f6
FB		 2871 /** PHOTOS
2872 */
2873 private $with_photo;
2874 public function addPhotoFilter()
2875 {
2876 $this->requireProfiles();
2877 $this->with_photo = true;
7f26cd69 2878 return 'photo';
470d14f6
FB		 2879 }
2880
2881 protected function photoJoins()
2882 {
2883 if ($this->with_photo) {
2884 return array('photo' => PlSqlJoin::left('profile_photos', '$ME.pid = $PID'));
2885 } else {
2886 return array();
2887 }
2888 }
2889
2890
48885bbe
FB		 2891 /** MARKETING
2892 */
2893 private $with_rm;
2894 public function addMarketingHash()
2895 {
2896 $this->requireAccounts();
2897 $this->with_rm = true;
2898 }
2899
2900 protected function marketingJoins()
2901 {
2902 if ($this->with_rm) {
5c412626 2903 return array('rm' => PlSqlJoin::left('register_marketing', '$ME.uid = $UID'));
48885bbe
FB		 2904 } else {
2905 return array();
2906 }
2907 }
a087cc8d 2908}
8363588b 2909// }}}
3f42a6ad 2910
a7d9ab89
RB		 2911// {{{ class ProfileFilter
2912class ProfileFilter extends UserFilter
2913{
434570c4 2914 public function get($limit = null)
a7d9ab89
RB		 2915 {
2916 return $this->getProfiles($limit);
2917 }
2daf7250
RB		 2918
2919 public function filter(array $profiles, $limit = null)
2920 {
2921 return $this->filterProfiles($profiles, self::defaultLimit($limit));
2922 }
2923
2924 public function getTotalCount()
2925 {
2926 return $this->getTotalProfileCount();
2927 }
ccc951d9
RB		 2928
2929 public function getGroups()
2930 {
2931 return $this->getPIDGroups();
2932 }
a7d9ab89
RB		 2933}
2934// }}}
2935
a087cc8d
FB		 2936// vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8:
2937?>
plat/al