Entité People: Ajout getNomComplet()

src/UnicaenLdap/Entity/People.php

@@ -55,6 +55,30 @@ class People extends Entity
 
     ];
 
+    /**
+     * Retourne le nom complet de cet individu LDAP.
+     *
+     * @param boolean $nomEnMajuscule Mettre le nom de famille en majuscules ?
+     * @param boolean $avecCivilite Inclure la civilité ?
+     * @param boolean $prenomDabord Mettre le prénom avant le nom de famille ?
+     * @return string
+     */
+    public function getNomComplet($nomEnMajuscule = false, $avecCivilite = false, $prenomDabord = false)
+    {
+        $sn = $this->get('sn');
+        $sn = is_array($sn) ? current($sn) : $sn;
+
+        if (!$sn) {
+            return '';
+        }
+
+        $nom = $nomEnMajuscule ? strtoupper($sn) : $sn;
+        $prenom = $this->get('givenname');
+        $civilite = $avecCivilite ? ' ' . $this->get('supannCivilite') : null;
+
+        return ($prenomDabord ? $prenom . ' ' . $nom : $nom . ' ' . $prenom) . $civilite;
+    }
+
     /**
      * Détermine si l'individu est actif ou non
      *