[fr] cakephp#4672, cakephp#4677 and cakephp#4683

fr/intro/conventions.rst

@@ -80,8 +80,9 @@ de votre application.
 Conventions pour les Models et les Bases de Données
 ===================================================
 
-Les noms de classe de model sont au pluriel et en CamelCase. ``Users``,
-``ArticleCategories`` et ``UserFavoritePages`` en sont des exemples.
+Les noms de classe de model sont au pluriel, en CamelCase et finissent par
+``Table``. ``UsersTable``, ``ArticleCategoriesTable`` et
+``UserFavoritePagesTable`` en sont des exemples.
 
 Les noms de tables correspondant aux models CakePHP sont au pluriel et utilisent
 le caractère souligné (underscore). Les tables correspondantes aux models

fr/orm/query-builder.rst

@@ -302,7 +302,7 @@ table à ``select()``::
     // Sélectionne seulement id et title de la table articles
     $query = $articlesTable->find();
     $query
-        ->select(['slug' => $query->func()->concat(['title', '-', 'id'])])
+        ->select(['slug' => $query->func()->concat(['title' => 'identifier', '-', 'id' => 'identifier'])])
         ->select($articlesTable); // Sélectionne tous les champs de articles
 
 .. _using-sql-functions:

fr/orm/retrieving-data-and-resultsets.rst

@@ -305,22 +305,37 @@ peuvent être atteintes avec les jointures::
         'valueField' => 'author.name'
     ])->contain(['Authors']);
 
+Personnaliser la Sortie Clé-Valeur
+----------------------------------
+
 Enfin il est possible d'utiliser les closures pour accéder aux méthodes de
-mutation des entities dans vos finds list. Cet exemple vous montre l'utilisation
-de la méthode de mutation ``_getFullName()`` de l'entity Author::
+mutation des entities dans vos finds list. ::
+
+    // Dasn votre Entity Authors, créez un champ virtuel à utiliser en tant que
+    champ à afficher:
+    protected function _getLabel()
+    {
+        return $this->_properties['first_name'] . ' ' . $this->_properties['last_name']
+          . ' / ' . __('User ID %s', $this->_properties['user_id']);
+    }
+
+Cet exemple montre l'utilisation de la méthode accesseur ``_getLabel()`` à
+partir de l'entity Author. ::
 
+    // Dans vos finders/controller:
     $query = $articles->find('list', [
         'keyField' => 'id',
         'valueField' => function ($article) {
-            return $article->author->get('full_name');
+            return $article->author->get('label');
         }
     ]);
 
-Vous pouvez aussi récupérer le nom complet directement dans la liste en
-utilisant. ::
+Vous pouvez aussi récupérer le label dans la liste directement en utilisant. ::
 
-    $this->displayField('full_name');
-    $query = $authors->find('list');
+    // Dans AuthorsTable::initialize():
+    $this->displayField('label'); // Va utiliser Author::_getLabel()
+    // Dans votre finders/controller:
+    $query = $authors->find('list'); // Va utiliser AuthorsTable::displayField()
 
 Trouver des Données Threaded
 ============================