2 /***************************************************************************
3 * Copyright (C) 2003-2011 Polytechnique.org *
4 * http://opensource.polytechnique.org/ *
6 * This program is free software; you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation; either version 2 of the License, or *
9 * (at your option) any later version. *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program; if not, write to the Free Software *
19 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
20 ***************************************************************************/
22 class Profile
implements PlExportable
26 const LASTNAME
= 'lastname';
27 const FIRSTNAME
= 'firstname';
28 const NICKNAME
= 'nickname';
29 const PSEUDONYM
= 'pseudonym';
32 const VN_MARITAL
= 'marital';
33 const VN_ORDINARY
= 'ordinary';
34 const VN_OTHER
= 'other';
37 const DN_FULL
= 'directory_name';
38 const DN_DISPLAY
= 'yourself';
39 const DN_YOURSELF
= 'yourself';
40 const DN_DIRECTORY
= 'directory_name';
41 const DN_PRIVATE
= 'private_name';
42 const DN_PUBLIC
= 'public_name';
43 const DN_SHORT
= 'short_name';
44 const DN_SORT
= 'sort_name';
45 /* education related names */
46 const EDU_X
= 'École polytechnique';
47 const DEGREE_X
= 'Ingénieur';
48 const DEGREE_M
= 'Master';
49 const DEGREE_D
= 'Doctorat';
51 static public $name_variants = array(
52 self
::LASTNAME
=> array(self
::VN_MARITAL
, self
::VN_ORDINARY
),
53 self
::FIRSTNAME
=> array(self
::VN_ORDINARY
, self
::VN_INI
, self
::VN_OTHER
)
56 const ADDRESS_MAIN
= 0x00000001;
57 const ADDRESS_PERSO
= 0x00000002;
58 const ADDRESS_PRO
= 0x00000004;
59 const ADDRESS_ALL
= 0x00000006;
60 const ADDRESS_POSTAL
= 0x00000008;
62 const EDUCATION_MAIN
= 0x00000010;
63 const EDUCATION_EXTRA
= 0x00000020;
64 const EDUCATION_ALL
= 0x00000040;
65 const EDUCATION_FINISHED
= 0x00000080;
66 const EDUCATION_CURRENT
= 0x00000100;
68 const JOBS_MAIN
= 0x00001000;
69 const JOBS_ALL
= 0x00002000;
70 const JOBS_FINISHED
= 0x00004000;
71 const JOBS_CURRENT
= 0x00008000;
73 const NETWORKING_ALL
= 0x00070000;
74 const NETWORKING_WEB
= 0x00010000;
75 const NETWORKING_IM
= 0x00020000;
76 const NETWORKING_SOCIAL
= 0x00040000;
78 const PHONE_LINK_JOB
= 0x00100000;
79 const PHONE_LINK_ADDRESS
= 0x00200000;
80 const PHONE_LINK_PROFILE
= 0x00400000;
81 const PHONE_LINK_COMPANY
= 0x00800000;
82 const PHONE_LINK_ANY
= 0x00F00000;
84 const PHONE_TYPE_FAX
= 0x01000000;
85 const PHONE_TYPE_FIXED
= 0x02000000;
86 const PHONE_TYPE_MOBILE
= 0x04000000;
87 const PHONE_TYPE_ANY
= 0x07000000;
89 const PHONE_ANY
= 0x07F00000;
91 const FETCH_ADDRESSES
= 0x000001;
92 const FETCH_CORPS
= 0x000002;
93 const FETCH_EDU
= 0x000004;
94 const FETCH_JOBS
= 0x000008;
95 const FETCH_MEDALS
= 0x000010;
96 const FETCH_NETWORKING
= 0x000020;
97 const FETCH_MENTOR_COUNTRY
= 0x000080;
98 const FETCH_PHONES
= 0x000100;
99 const FETCH_JOB_TERMS
= 0x000200;
100 const FETCH_MENTOR_TERMS
= 0x000400;
102 const FETCH_MINIFICHES
= 0x00012D; // FETCH_ADDRESSES | FETCH_EDU | FETCH_JOBS | FETCH_NETWORKING | FETCH_PHONES
104 const FETCH_ALL
= 0x0007FF; // OR of FETCH_*
106 static public $descriptions = array(
107 'search_names' => 'Noms',
108 'nationality1' => 'Nationalité',
109 'nationality2' => '2e nationalité',
110 'nationality3' => '3e nationalité',
111 'promo_display' => 'Promotion affichée',
112 'email_directory' => 'Email annuaire papier',
113 'networking' => 'Messageries…',
114 'tels' => 'Téléphones',
115 'edus' => 'Formations',
116 'promo' => 'Promotion de sortie',
117 'birthdate' => 'Date de naissance',
118 'yourself' => 'Nom affiché',
119 'freetext' => 'Commentaire',
120 'freetext_pub' => 'Affichage du commentaire',
121 'photo' => 'Photographie',
122 'photo_pub' => 'Affichage de la photographie',
123 'addresses' => 'Adresses',
127 'section' => 'Section',
128 'binets' => 'Binets',
129 'medals' => 'Décorations',
130 'medals_pub' => 'Affichage des décorations',
131 'competences' => 'Compétences',
132 'langues' => 'Langues',
133 'expertise' => 'Expertises (mentoring)',
134 'terms' => 'Compétences (mentoring)',
135 'countries' => 'Pays (mentoring)'
138 private $fetched_fields = 0x000000;
143 private $owner_fetched = false
;
144 private $data = array();
146 private $visibility = null
;
149 private function __construct(array $data)
152 $this->pid
= $this->data
['pid'];
153 $this->hrpid
= $this->data
['hrpid'];
154 $this->visibility
= new ProfileVisibility();
162 public function hrid()
167 public function owner()
169 if ($this->owner
== null
&& !$this->owner_fetched
) {
170 $this->owner_fetched
= true
;
171 $this->owner
= User
::getSilent($this);
176 public function isActive()
178 if ($this->owner()) {
179 return $this->owner
->isActive();
184 public function promo()
189 public function yearpromo()
191 return intval(substr($this->promo
, 1, 4));
194 /** Check if user is an orange (associated with several promos)
196 public function isMultiPromo()
198 return $this->grad_year
!= $this->entry_year +
$this->mainEducationDuration();
201 /** Returns an array with all associated promo years.
203 public function yearspromo()
206 $d = -$this->deltaPromoToGradYear();
207 for ($g = $this->entry_year +
$this->mainEducationDuration(); $g <= $this->grad_year
; ++
$g) {
213 public function mainEducation()
215 if (empty($this->promo
)) {
218 return $this->promo
{0};
222 public function mainGrade()
224 switch ($this->mainEducation()) {
226 return UserFilter
::GRADE_ING
;
228 return UserFilter
::GRADE_MST
;
230 return UserFilter
::GRADE_PHD
;
236 public function mainEducationDuration()
238 switch ($this->mainEducation()) {
250 /** Number of years between the promotion year until the
251 * graduation year. In standard schools it's 0, but for
252 * Polytechnique the promo year is the entry year.
254 public function deltaPromoToGradYear()
256 if ($this->mainEducation() == 'X') {
257 return $this->mainEducationDuration();
262 /** Print a name with the given formatting:
270 public function name($format)
272 return str_replace(array('%s', '%f', '%l', '%F', '%S', '%p'),
273 array($this->isFemale() ?
'•' : '',
274 $this->firstName(), $this->lastName(),
275 $this->fullName(), $this->shortName(),
276 $this->promo()), $format);
279 public function fullName($with_promo = false
)
282 return $this->full_name
. ' (' . $this->promo
. ')';
284 return $this->full_name
;
287 public function shortName($with_promo = false
)
290 return $this->short_name
. ' (' . $this->promo
. ')';
292 return $this->short_name
;
295 public function firstName()
297 return $this->firstname
;
300 public function firstNames()
302 return $this->nameVariants(self
::FIRSTNAME
);
305 public function lastName()
307 return $this->lastname
;
310 public function lastNames()
312 return $this->nameVariants(self
::LASTNAME
);
315 public function isFemale()
317 return $this->sex
== PlUser
::GENDER_FEMALE
;
320 public function isDead()
322 return ($this->deathdate
!= null
);
325 public function displayEmail()
329 return $o->bestEmail();
331 return $this->email_directory
;
335 public function data()
341 private function nameVariants($type)
343 $vals = array($this->$type);
344 foreach (self
::$name_variants[$type] as $var) {
345 $vartype = $type . '_' . $var;
346 $varname = $this->$vartype;
347 if ($varname != null
&& $varname != "") {
351 return array_unique($vals);
354 public function nationalities()
357 $countries = DirEnum
::getOptions(DirEnum
::COUNTRIES
);
358 if ($this->nationality1
) {
359 $nats[$this->nationality1
] = $countries[$this->nationality1
];
361 if ($this->nationality2
) {
362 $nats[$this->nationality2
] = $countries[$this->nationality2
];
364 if ($this->nationality3
) {
365 $nats[$this->nationality3
] = $countries[$this->nationality3
];
370 public function __get($name)
372 if (property_exists($this, $name)) {
376 if (isset($this->data
[$name])) {
377 return $this->data
[$name];
383 public function __isset($name)
385 return property_exists($this, $name) ||
isset($this->data
[$name]);
388 public function __unset($name)
390 if (property_exists($this, $name)) {
393 unset($this->data
[$name]);
400 * *always deletes in: profile_addresses, profile_binets, profile_job,
401 * profile_langskills, profile_mentor, profile_networking,
402 * profile_phones, profile_skills, watch_profile
403 * *always keeps in: profile_corps, profile_display, profile_education,
404 * profile_medals, profile_name, profile_photos, search_name
405 * *modifies: profiles
407 public function clear()
410 'profile_job', 'profile_langskills', 'profile_mentor',
411 'profile_networking', 'profile_skills', 'watch_profile',
412 'profile_phones', 'profile_addresses', 'profile_binets');
414 foreach ($tables as $t) {
415 XDB
::execute('DELETE FROM ' . $t . '
420 XDB
::execute("UPDATE profiles
421 SET cv = NULL, freetext = NULL, freetext_pub = 'private',
422 medals_pub = 'private', alias_pub = 'private',
423 email_directory = NULL
428 /** Sets the level of visibility of the profile
429 * Sets $this->visibility to a list of valid visibilities.
430 * @param one of the self::VIS_* values
432 public function setVisibilityLevel($visibility)
434 $this->visibility
->setLevel($visibility);
437 /** Determine whether an item with visibility $visibility can be displayed
438 * with the current level of visibility of the profile
439 * @param $visibility The level of visibility to be checked
441 public function isVisible($visibility)
443 return $this->visibility
->isVisible($visibility);
446 /** Stores the list of fields which have already been fetched for this Profile
448 public function setFetchedFields($fields)
450 if (($fields | self
::FETCH_ALL
) != self
::FETCH_ALL
) {
451 Platal
::page()->kill("Invalid fetched fields: $fields");
454 $this->fetched_fields
= $fields;
457 /** Have we already fetched this field ?
459 private function fetched($field)
461 if (!array_key_exists($field, ProfileField
::$fields)) {
462 Platal
::page()->kill("Invalid field: $field");
465 return ($this->fetched_fields
& $field);
468 /** If not already done, fetches data for the given field
469 * @param $field One of the Profile::FETCH_*
470 * @return A ProfileField, or null
472 private function getProfileField($field)
474 if (!array_key_exists($field, ProfileField
::$fields)) {
475 Platal
::page()->kill("Invalid field: $field");
477 if ($this->fetched($field)) {
480 $this->fetched_fields
= $this->fetched_fields |
$field;
483 $cls = ProfileField
::$fields[$field];
485 return ProfileField
::getForPID($cls, $this->id(), $this->visibility
);
488 /** Consolidates internal data (addresses, phones, jobs)
490 private function consolidateFields()
492 // Link phones to addresses
493 if ($this->phones
!= null
) {
494 if ($this->addresses
!= null
) {
495 $this->addresses
->addPhones($this->phones
);
498 if ($this->jobs
!= null
) {
499 $this->jobs
->addPhones($this->phones
);
503 // Link addresses to jobs
504 if ($this->addresses
!= null
&& $this->jobs
!= null
) {
505 $this->jobs
->addAddresses($this->addresses
);
508 // Link jobterms to jobs
509 if ($this->jobs
!= null
&& $this->jobterms
!= null
) {
510 $this->jobs
->addJobTerms($this->jobterms
);
516 private $photo = null
;
517 public function getPhoto($fallback = true
, $data = false
)
519 if ($this->has_photo
) {
520 if ($data && ($this->photo
== null ||
$this->photo
->mimeType
== null
)) {
521 $res = XDB
::fetchOneAssoc('SELECT attach, attachmime, x, y, last_update
523 WHERE pid = {?}', $this->pid
);
524 $this->photo
= PlImage
::fromData($res['attach'], 'image/' .$res['attachmime'], $res['x'], $res['y'], $res['last_update']);
525 } else if ($this->photo
== null
) {
526 $this->photo
= PlImage
::fromData(null
, null
, $this->photo_width
, $this->photo_height
);
529 } else if ($fallback) {
530 if ($this->mainEducation() == 'X') {
531 return PlImage
::fromFile(dirname(__FILE__
) . '/../htdocs/images/none_x.png', 'image/png');
533 return PlImage
::fromFile(dirname(__FILE__
) . '/../htdocs/images/none_md.png', 'image/png');
540 private $addresses = null
;
541 public function setAddresses(ProfileAddresses
$addr)
543 $this->addresses
= $addr;
544 $this->consolidateFields();
547 private function fetchAddresses()
549 if ($this->addresses
== null
&& !$this->fetched(self
::FETCH_ADDRESSES
)) {
550 $addr = $this->getProfileField(self
::FETCH_ADDRESSES
);
552 $this->setAddresses($addr);
553 $this->fetchPhones();
558 public function getAddresses($flags, $limit = null
)
560 $this->fetchAddresses();
562 if ($this->addresses
== null
) {
565 return $this->addresses
->get($flags, $limit);
568 public function iterAddresses($flags, $limit = null
)
570 return PlIteratorUtils
::fromArray($this->getAddresses($flags, $limit), 1, true
);
573 public function getMainAddress()
575 $main = $this->getAddresses(self
::ADDRESS_MAIN
);
576 $perso = $this->getAddresses(self
::ADDRESS_PERSO
);
579 return array_pop($main);
580 } else if (count($perso)) {
581 return array_pop($perso);
589 private $phones = null
;
590 public function setPhones(ProfilePhones
$phones)
592 $this->phones
= $phones;
593 $this->consolidateFields();
596 private function fetchPhones()
598 if ($this->phones
== null
&& !$this->fetched(self
::FETCH_PHONES
)) {
599 $phones = $this->getProfileField(self
::FETCH_PHONES
);
600 if (isset($phones)) {
601 $this->setPhones($phones);
606 public function getPhones($flags, $limit = null
)
608 $this->fetchPhones();
609 if ($this->phones
== null
) {
612 return $this->phones
->get($flags, $limit);
617 private $educations = null
;
618 public function setEducations(ProfileEducation
$edu)
620 $this->educations
= $edu;
623 public function getEducations($flags, $limit = null
)
625 if ($this->educations
== null
&& !$this->fetched(self
::FETCH_EDU
)) {
626 $this->setEducations($this->getProfileField(self
::FETCH_EDU
));
629 if ($this->educations
== null
) {
632 return $this->educations
->get($flags, $limit);
635 public function getExtraEducations($limit = null
)
637 return $this->getEducations(self
::EDUCATION_EXTRA
, $limit);
642 private $corps = null
;
643 public function setCorps(ProfileCorps
$corps)
645 $this->corps
= $corps;
648 public function getCorps()
650 if ($this->corps
== null
&& !$this->fetched(self
::FETCH_CORPS
)) {
651 $this->setCorps($this->getProfileField(self
::FETCH_CORPS
));
658 private $networks = null
;
659 public function setNetworking(ProfileNetworking
$nw)
661 $this->networks
= $nw;
664 public function getNetworking($flags, $limit = null
)
666 if ($this->networks
== null
&& !$this->fetched(self
::FETCH_NETWORKING
)) {
667 $nw = $this->getProfileField(self
::FETCH_NETWORKING
);
669 $this->setNetworking($nw);
672 if ($this->networks
== null
) {
675 return $this->networks
->get($flags, $limit);
678 public function getWebSite()
680 $site = $this->getNetworking(self
::NETWORKING_WEB
, 1);
681 if (count($site) != 1) {
684 $site = array_pop($site);
691 private $jobs = null
;
692 public function setJobs(ProfileJobs
$jobs)
695 $this->consolidateFields();
698 private function fetchJobs()
700 if ($this->jobs
== null
&& !$this->fetched(self
::FETCH_JOBS
)) {
701 $jobs = $this->getProfileField(self
::FETCH_JOBS
);
703 $this->setJobs($jobs);
704 $this->fetchAddresses();
709 public function getJobs($flags, $limit = null
)
713 if ($this->jobs
== null
) {
716 return $this->jobs
->get($flags, $limit);
719 public function getMainJob()
721 $job = $this->getJobs(self
::JOBS_MAIN
, 1);
722 if (count($job) != 1) {
725 return array_pop($job);
730 private $jobterms = null
;
731 public function setJobTerms(ProfileJobTerms
$jobterms)
733 $this->jobterms
= $jobterms;
734 $this->consolidateFields();
737 private $mentor_countries = null
;
738 public function setMentoringCountries(ProfileMentoringCountries
$countries)
740 $this->mentor_countries
= $countries;
743 public function getMentoringCountries()
745 if ($this->mentor_countries
== null
&& !$this->fetched(self
::FETCH_MENTOR_COUNTRY
)) {
746 $this->setMentoringCountries($this->getProfileField(self
::FETCH_MENTOR_COUNTRY
));
749 if ($this->mentor_countries
== null
) {
752 return $this->mentor_countries
->countries
;
756 /** List of job terms to specify mentoring */
757 private $mentor_terms = null
;
759 * set job terms to specify mentoring
760 * @param $terms a ProfileMentoringTerms object listing terms only for this profile
762 public function setMentoringTerms(ProfileMentoringTerms
$terms)
764 $this->mentor_terms
= $terms;
767 * get all job terms that specify mentoring
768 * @return an array of JobTerms objects
770 public function getMentoringTerms()
772 if ($this->mentor_terms
== null
&& !$this->fetched(self
::FETCH_MENTOR_TERMS
)) {
773 $this->setMentoringTerms($this->getProfileField(self
::FETCH_MENTOR_TERMS
));
776 if ($this->mentor_terms
== null
) {
779 return $this->mentor_terms
->get();
786 public function getBinets()
788 if ($this->visibility
->isVisible(ProfileVisibility
::VIS_PRIVATE
)) {
789 return XDB
::fetchColumn('SELECT binet_id
791 WHERE pid = {?}', $this->id());
796 public function getBinetsNames()
798 if ($this->visibility
->isVisible(ProfileVisibility
::VIS_PRIVATE
)) {
799 return XDB
::fetchColumn('SELECT text
800 FROM profile_binets AS pb
801 LEFT JOIN profile_binet_enum AS pbe ON (pbe.id = pb.binet_id)
802 WHERE pb.pid = {?}', $this->id());
810 private $medals = null
;
811 public function setMedals(ProfileMedals
$medals)
813 $this->medals
= $medals;
816 public function getMedals()
818 if ($this->medals
== null
&& !$this->fetched(self
::FETCH_MEDALS
)) {
819 $this->setMedals($this->getProfileField(self
::FETCH_MEDALS
));
821 if ($this->medals
== null
) {
824 return $this->medals
->medals
;
827 public function compareNames($firstname, $lastname)
829 $_lastname = mb_strtoupper($this->lastName());
830 $_firstname = mb_strtoupper($this->firstName());
831 $lastname = mb_strtoupper($lastname);
832 $firstname = mb_strtoupper($firstname);
834 $isOk = (mb_strtoupper($_firstname) == mb_strtoupper($firstname));
835 $tokens = preg_split("/[ \-']/", $lastname, -1, PREG_SPLIT_NO_EMPTY
);
838 foreach ($tokens as $str) {
839 $isOk &= (strpos($_lastname, $str) !== false
);
840 $maxlen = max($maxlen, strlen($str));
843 return ($isOk && ($maxlen > 2 ||
$maxlen == strlen($_lastname)));
848 public function export()
851 'hrpid' => $this->hrid(),
852 'display_name' => $this->shortName(),
853 'full_name' => $this->fullName(),
854 'directory_name' => $this->directory_name
,
855 'promo' => $this->promo(),
856 'year_promo' => $this->yearpromo(),
857 'is_active' => $this->isActive(),
858 'first_name' => $this->firstName(),
859 'last_name' => $this->lastName(),
860 'is_female' => $this->isFemale(),
864 private static function fetchProfileData(array $pids, $respect_order = true
, $fields = 0x0000, $visibility = null
)
866 if (count($pids) == 0) {
870 if ($respect_order) {
871 $order = 'ORDER BY ' . XDB
::formatCustomOrder('p.pid', $pids);
876 $visibility = new ProfileVisibility($visibility);
878 $it = XDB
::Iterator('SELECT p.pid, p.hrpid, p.xorg_id, p.ax_id, p.birthdate, p.birthdate_ref,
879 p.next_birthday, p.deathdate, p.deathdate_rec, p.sex = \'female\' AS sex,
880 IF ({?}, p.cv, NULL) AS cv, p.medals_pub, p.alias_pub, p.email_directory,
881 p.last_change, p.nationality1, p.nationality2, p.nationality3,
882 IF (p.freetext_pub IN {?}, p.freetext, NULL) AS freetext,
883 pe.entry_year, pe.grad_year,
884 IF ({?}, pse.text, NULL) AS section,
885 pn_f.name AS firstname, pn_l.name AS lastname,
886 IF( {?}, pn_n.name, NULL) AS nickname,
887 IF(pn_uf.name IS NULL, pn_f.name, pn_uf.name) AS firstname_ordinary,
888 IF(pn_ul.name IS NULL, pn_l.name, pn_ul.name) AS lastname_ordinary,
889 pd.yourself, pd.promo, pd.short_name, pd.public_name AS full_name,
890 pd.directory_name, pd.public_name, pd.private_name,
891 IF(pp.pub IN {?}, pp.display_tel, NULL) AS mobile,
892 (ph.pub IN {?} AND ph.attach IS NOT NULL) AS has_photo,
893 ph.x AS photo_width, ph.y AS photo_height,
894 p.last_change < DATE_SUB(NOW(), INTERVAL 365 DAY) AS is_old,
895 pm.expertise AS mentor_expertise,
898 INNER JOIN profile_display AS pd ON (pd.pid = p.pid)
899 INNER JOIN profile_education AS pe ON (pe.pid = p.pid AND FIND_IN_SET(\'primary\', pe.flags))
900 LEFT JOIN profile_section_enum AS pse ON (pse.id = p.section)
901 INNER JOIN profile_name AS pn_f ON (pn_f.pid = p.pid
902 AND pn_f.typeid = ' . self
::getNameTypeId('firstname', true
) . ')
903 INNER JOIN profile_name AS pn_l ON (pn_l.pid = p.pid
904 AND pn_l.typeid = ' . self
::getNameTypeId('lastname', true
) . ')
905 LEFT JOIN profile_name AS pn_uf ON (pn_uf.pid = p.pid
906 AND pn_uf.typeid = ' . self
::getNameTypeId('firstname_ordinary', true
) . ')
907 LEFT JOIN profile_name AS pn_ul ON (pn_ul.pid = p.pid
908 AND pn_ul.typeid = ' . self
::getNameTypeId('lastname_ordinary', true
) . ')
909 LEFT JOIN profile_name AS pn_n ON (pn_n.pid = p.pid
910 AND pn_n.typeid = ' . self
::getNameTypeId('nickname', true
) . ')
911 LEFT JOIN profile_phones AS pp ON (pp.pid = p.pid AND pp.link_type = \'user\' AND tel_type = \'mobile\')
912 LEFT JOIN profile_photos AS ph ON (ph.pid = p.pid)
913 LEFT JOIN profile_mentor AS pm ON (pm.pid = p.pid)
914 LEFT JOIN account_profiles AS ap ON (ap.pid = p.pid AND FIND_IN_SET(\'owner\', ap.perms))
918 $visibility->isVisible(ProfileVisibility
::VIS_PRIVATE
), // CV
919 $visibility->levels(), // freetext
920 $visibility->isVisible(ProfileVisibility
::VIS_PRIVATE
), // section
921 $visibility->isVisible(ProfileVisibility
::VIS_PRIVATE
), // nickname
922 $visibility->levels(), // mobile
923 $visibility->levels(), // photo
926 return new ProfileIterator($it, $pids, $fields, $visibility);
929 public static function getPID($login)
931 if ($login instanceof PlUser
) {
932 return XDB
::fetchOneCell('SELECT pid
933 FROM account_profiles
934 WHERE uid = {?} AND FIND_IN_SET(\'owner\', perms)',
936 } else if (ctype_digit($login)) {
937 return XDB
::fetchOneCell('SELECT pid
939 WHERE pid = {?}', $login);
941 return XDB
::fetchOneCell('SELECT pid
943 WHERE hrpid = {?}', $login);
947 public static function getPIDsFromUIDs($uids, $respect_order = true
)
949 if ($respect_order) {
950 $order = 'ORDER BY ' . XDB
::formatCustomOrder('uid', $uids);
954 return XDB
::fetchAllAssoc('uid', 'SELECT ap.uid, ap.pid
955 FROM account_profiles AS ap
956 WHERE FIND_IN_SET(\'owner\', ap.perms)
957 AND ap.uid IN ' . XDB
::formatArray($uids) .'
961 /** Return the profile associated with the given login.
963 public static function get($login, $fields = 0x0000, $visibility = null
)
965 if (is_array($login)) {
966 $pf = new Profile($login);
967 $pf->setVisibilityLevel($visibility);
970 $pid = self
::getPID($login);
971 if (!is_null($pid)) {
972 $it = self
::iterOverPIDs(array($pid), false
, $fields, $visibility);
975 /* Let say we can identify a profile using the identifiers of its owner.
977 if (!($login instanceof PlUser
)) {
978 $user = User
::getSilent($login);
979 if ($user && $user->hasProfile()) {
980 return $user->profile();
987 public static function iterOverUIDs($uids, $respect_order = true
, $fields = 0x0000, $visibility = null
)
989 return self
::iterOverPIDs(self
::getPIDsFromUIDs($uids), $respect_order, $fields, $visibility);
992 public static function iterOverPIDs($pids, $respect_order = true
, $fields = 0x0000, $visibility = null
)
994 return self
::fetchProfileData($pids, $respect_order, $fields, $visibility);
997 /** Return profiles for the list of pids.
999 public static function getBulkProfilesWithPIDs(array $pids, $fields = 0x0000, $visibility = null
)
1001 if (count($pids) == 0) {
1004 $it = self
::iterOverPIDs($pids, true
, $fields, $visibility);
1005 $profiles = array();
1006 while ($p = $it->next()) {
1007 $profiles[$p->id()] = $p;
1012 /** Return profiles for uids.
1014 public static function getBulkProfilesWithUIDS(array $uids, $fields = 0x000, $visibility = null
)
1016 if (count($uids) == 0) {
1019 return self
::getBulkProfilesWithPIDs(self
::getPIDsFromUIDs($uids), $fields, $visibility);
1022 public static function isDisplayName($name)
1024 return $name == self
::DN_FULL ||
$name == self
::DN_DISPLAY
1025 ||
$name == self
::DN_YOURSELF ||
$name == self
::DN_DIRECTORY
1026 ||
$name == self
::DN_PRIVATE ||
$name == self
::DN_PUBLIC
1027 ||
$name == self
::DN_SHORT ||
$name == self
::DN_SORT
;
1030 /** Returns the closest "accounts only" name type for $name
1032 public static function getAccountEquivalentName($name)
1036 case self
::DN_DIRECTORY
:
1038 return 'directory_name';
1040 case self
::DN_PUBLIC
:
1042 case self
::DN_PRIVATE
:
1043 case self
::DN_SHORT
:
1044 case self
::DN_YOURSELF
:
1046 return 'display_name';
1050 public static function getNameTypeId($type, $for_sql = false
)
1052 if (!S
::has('name_types')) {
1053 $table = XDB
::fetchAllAssoc('type', 'SELECT id, type
1054 FROM profile_name_enum');
1055 S
::set('name_types', $table);
1057 $table = S
::v('name_types');
1060 return XDB
::escape($table[$type]);
1062 return $table[$type];
1066 public static function rebuildSearchTokens($pids, $transaction = true
)
1068 if (!is_array($pids)) {
1069 $pids = array($pids);
1071 $keys = XDB
::iterator("(SELECT n.pid AS pid, n.name AS name, e.score AS score,
1072 IF(FIND_IN_SET('public', e.flags), 'public', '') AS public
1073 FROM profile_name AS n
1074 INNER JOIN profile_name_enum AS e ON (n.typeid = e.id)
1075 WHERE n.pid IN {?} AND NOT FIND_IN_SET('not_displayed', e.flags))
1077 (SELECT n.pid AS pid, n.particle AS name, 0 AS score,
1078 IF(FIND_IN_SET('public', e.flags), 'public', '') AS public
1079 FROM profile_name AS n
1080 INNER JOIN profile_name_enum AS e ON (n.typeid = e.id)
1081 WHERE n.pid IN {?} AND NOT FIND_IN_SET('not_displayed', e.flags))
1085 while ($key = $keys->next()) {
1086 if ($key['name'] == '') {
1090 $toks = preg_split('/[ \'\-]+/', strtolower(replace_accent($key['name'])),
1091 -1, PREG_SPLIT_NO_EMPTY
);
1092 $toks = array_reverse($toks);
1094 /* Split the score between the tokens to avoid the user to be over-rated.
1095 * Let says my user name is "Machin-Truc Bidule" and I also have a user named
1096 * 'Machin Truc'. Distributing the score force "Machin Truc" to be displayed
1097 * before "Machin-Truc" for both "Machin Truc" and "Machin" searches.
1099 $eltScore = ceil(((float)$key['score'])/((float)count($toks)));
1101 foreach ($toks as $tok) {
1102 $token = $tok . $token;
1103 $names["$pid-$token"] = XDB
::format('({?}, {?}, {?}, {?}, {?})',
1104 $token, $pid, soundex_fr($token),
1105 $eltScore, $key['public']);
1109 XDB
::startTransaction();
1111 XDB
::execute('DELETE FROM search_name
1114 if (count($names) > 0) {
1115 XDB
::rawExecute('INSERT INTO search_name (token, pid, soundex, score, flags)
1116 VALUES ' . implode(', ', $names));
1123 /** The school identifier consists of 6 digits. The first 3 represent the
1124 * promotion entry year. The last 3 indicate the student's rank.
1126 * Our identifier consists of 8 digits and both half have the same role.
1127 * This enables us to deal with bigger promotions and with a wider range
1130 * getSchoolId returns a school identifier given one of ours.
1131 * getXorgId returns a X.org identifier given a school identifier.
1133 public static function getSchoolId($xorgId)
1135 if (!preg_match('/^[0-9]{8}$/', $xorgId)) {
1139 $year = intval(substr($xorgId, 0, 4));
1140 $rank = intval(substr($xorgId, 5, 3));
1143 } elseif ($year < 2000) {
1144 $year = intval(substr(1900 - $year, 1, 3));
1145 return sprintf('%02u0%03u', $year, $rank);
1147 $year = intval(substr(1900 - $year, 1, 3));
1148 return sprintf('%03u%03u', $year, $rank);
1152 public static function getXorgId($schoolId)
1154 if (!preg_match('/^[0-9]{6}$/', $schoolId)) {
1158 $year = intval(substr($schoolId, 0, 3));
1159 $rank = intval(substr($schoolId, 3, 3));
1167 return sprintf('%04u%04u', 1900 +
$year, $rank);
1173 /** Iterator over a set of Profiles
1175 class ProfileIterator
implements PlIterator
1177 private $iterator = null
;
1179 private $visibility;
1181 const FETCH_ALL
= 0x000033F; // FETCH_ADDRESSES | FETCH_CORPS | FETCH_EDU | FETCH_JOBS | FETCH_MEDALS | FETCH_NETWORKING | FETCH_PHONES | FETCH_JOB_TERMS
1183 public function __construct(PlIterator
$it, array $pids, $fields = 0x0000, ProfileVisibility
$visibility = null
)
1185 require_once 'profilefields.inc.php';
1187 if ($visibility == null
) {
1188 $visibility = new ProfileVisibility();
1191 $this->fields
= $fields;
1192 $this->visibility
= $visibility;
1195 $callbacks = array();
1198 $callbacks[0] = PlIteratorUtils
::arrayValueCallback('pid');
1199 $cb = PlIteratorUtils
::objectPropertyCallback('pid');
1201 $fields = $fields & self
::FETCH_ALL
;
1202 for ($field = 1; $field < $fields; $field *= 2) {
1203 if (($fields & $field) ) {
1204 $callbacks[$field] = $cb;
1205 $subits[$field] = new ProfileFieldIterator($field, $pids, $visibility);
1209 $this->iterator
= PlIteratorUtils
::parallelIterator($subits, $callbacks, 0);
1212 private function hasData($field, $vals)
1214 return ($this->fields
& $field) && ($vals[$field] != null
);
1217 private function fillProfile(array $vals)
1219 $pf = Profile
::get($vals[0]);
1220 $pf->setVisibilityLevel($this->visibility
->level());
1221 $pf->setFetchedFields($this->fields
);
1223 if ($this->hasData(Profile
::FETCH_PHONES
, $vals)) {
1224 $pf->setPhones($vals[Profile
::FETCH_PHONES
]);
1226 if ($this->hasData(Profile
::FETCH_ADDRESSES
, $vals)) {
1227 $pf->setAddresses($vals[Profile
::FETCH_ADDRESSES
]);
1229 if ($this->hasData(Profile
::FETCH_JOBS
, $vals)) {
1230 $pf->setJobs($vals[Profile
::FETCH_JOBS
]);
1232 if ($this->hasData(Profile
::FETCH_JOB_TERMS
, $vals)) {
1233 $pf->setJobTerms($vals[Profile
::FETCH_JOB_TERMS
]);
1236 if ($this->hasData(Profile
::FETCH_CORPS
, $vals)) {
1237 $pf->setCorps($vals[Profile
::FETCH_CORPS
]);
1239 if ($this->hasData(Profile
::FETCH_EDU
, $vals)) {
1240 $pf->setEducations($vals[Profile
::FETCH_EDU
]);
1242 if ($this->hasData(Profile
::FETCH_MEDALS
, $vals)) {
1243 $pf->setMedals($vals[Profile
::FETCH_MEDALS
]);
1245 if ($this->hasData(Profile
::FETCH_NETWORKING
, $vals)) {
1246 $pf->setNetworking($vals[Profile
::FETCH_NETWORKING
]);
1252 public function next()
1254 $vals = $this->iterator
->next();
1255 if ($vals == null
) {
1258 return $this->fillProfile($vals);
1261 public function first()
1263 return $this->iterator
->first();
1266 public function last()
1268 return $this->iterator
->last();
1271 public function total()
1273 return $this->iterator
->total();
1277 // vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8: