ajouté commentaires pour expliquer...

Etienne Pallier
1 parent 44c40ec0
Showing 1 changed file with 18 additions and 1 deletions Show diff stats
src/Controller/UsersController.php
@@ -177,11 +177,16 @@ class UsersController extends AppController
      */
     public function add()
     {
+        // Création d'un objet User VIDE avec tous les champs
         $user = $this->Users->newEntity();
+        
+        // (POST) Un user vient d'être créé, on le sauve en BD, 
+        // puis on va sur la vue individuelle de ce nouveau user
         if ($this->request->is('post')) {
             $user = $this->Users->patchEntity($user, $this->request->getData());
             if ($this->Users->save($user)) {
                 $this->Flash->success(__('L\'utilisateur a bien été ajouté.'));
+                // On va maintenant à la vue individuelle de ce nouvel utilisateur
                 return $this->redirect([
                     'action' => 'view',
                     $user->id
@@ -190,6 +195,10 @@ class UsersController extends AppController
                 $this->Flash->error(__('L\'utilisateur n\'a pas pu être ajouté.'));
             }
         }
+        
+        // (pas POST) Ici, on vient sur la vue d'ajout (add.ctp) pour la première fois 
+        // On prépare donc quelques listes qui seront nécessaires à cette vue
+        
         $groupesMetiers = $this->Users->GroupesMetiers->find('list', [
             'keyField' => 'id',
             'valueField' => 'nom'
@@ -202,18 +211,26 @@ class UsersController extends AppController
             'keyField' => 'id',
             'valueField' => 'nom'
         ]);
+        // On recup tous les users du LDAP (ou fakeLDAP si on n'est pas en mode LDAP)
         $users = TableRegistry::get('LdapConnections')->getListUsers();
-        // tri des utilisateurs par nom
+        // Tri des utilisateurs par nom
         sort($users);
+        // Formatage en $utilisateurs["Etienne Pallier"] = "Etienne Pallier" ...
         $utilisateurs = [];
         for ($i = 0; $i < sizeof($users); $i ++) {
             $utilisateurs[$users[$i]] = $users[$i];
         }
+        //debug($users);
+        //debug($utilisateurs);
  
+        // On passe à la vue add.ctp toutes les variables créés ci-dessus 
+        // "user" est l'utilisateur $user créé au début, et qui est vide
         $this->set(compact('user', 'groupesMetiers', 'utilisateurs', 'groupesThematiques', 'sur_categorie'));
         $this->set('_serialize', [
             'user'
         ]);
+        
+        // Ici, la vue add.ctp (formulaire d'ajout d'un user) est maintenant automatiquement affichée
     }
  
     /**