Merge pull request cakephp#5048 from cakephp/3.0-fr

[fr] And another batch of FR translations

fr/appendices/3-4-migration-guide.rst

@@ -102,6 +102,8 @@ Autres dépréciations
 * ``Event::data()`` est dépréciée. Utilisez ``Event::getData()`` à la place.
 * La valeur de ``Auth.redirect`` stockée en session n'est plus utilisée. Un
   paramètre d'URL est maintenant utilisé pour stocker l'URL de redirection.
+  Ceci retire cependant la possibilité de définir une URL de redirection en
+  session en dehors des scénarios de login.
 * ``AuthComponent`` ne stocke plus les URLs de redirection quand l'URL non
   autorisée n'est pas une action ``GET``.
 * L'option ``ajaxLogin`` du ``AuthComponent`` est dépréciée. Vous devez maintenant
@@ -353,6 +355,14 @@ variations mineures qui pourraient avoir un impact sur votre application :
   des pièces jointes en utilisant ``mime_content_type`` si le "content-type"
   n'est pas spécifié. Auparavant, les pièces jointes étaient considérées comme
   'application/octet-stream' par défaut.
+* CakePHP utilise maintenant l'opérateur ``...`` à la place de ``call_user_func_array()``.
+  Si vous passez des tableaux associatifs, vous devez mettre à jour votre code
+  pour passer des tableaux à index numériques en utilisant la méthode ``array_values()``
+  pour les méthodes suivantes :
+
+  * ``Cake\Mailer\Mailer::send()``
+  * ``Cake\Controller\Controller::setAction()``
+  * ``Cake\Http\ServerRequest::is()``
 
 Visibility Changes
 ==================

fr/controllers/components/authentication.rst

@@ -277,8 +277,7 @@ Après avoir connecté un utilisateur, vous voudrez généralement le rediriger
 l'endroit d'où il vient. Passez une URL pour définir la destination vers
 laquelle l'utilisateur doit être redirigé après s'être connecté.
 
-Si aucun paramètre n'est passé, elle obtient l'URL de redirection
-d'authentification. L'URL retournée correspond aux règles suivantes:
+Si aucun paramètre n'est passé, l'URL retournée suivra les règles suivantes :
 
 - Retourne l'URL normalisée du paramètre URL redirect s'il est présent et qu'il
   pointe sur le même domaine que celui de l'application. Avant 3.4.0, la valeur

fr/controllers/request-response.rst

@@ -513,6 +513,13 @@ Vous pouvez le faire en utilisant
         return $response;
     }
 
+    // Avant 3.4.0
+    $file = $this->Attachments->getFile($id);
+    $this->response->file($file['path']);
+    // Retourne la réponse pour éviter que le controller n'essaie de
+    // rendre la vue
+    return $this->response;
+
 Comme montré dans l'exemple ci-dessus, vous devez passer le
 chemin du fichier à la méthode. CakePHP va envoyer le bon en-tête de type de
 contenu si c'est un type de fichier connu listé dans
@@ -528,6 +535,12 @@ d'être affiché dans le navigateur en spécifiant les options::
         ['download' => true, 'name' => 'foo']
     );
 
+    // Avant 3.4.0
+    $this->response->file(
+        $file['path'],
+        ['download' => true, 'name' => 'foo']
+    );
+
 les options possibles sont:
 
 name

fr/core-libraries/internationalization-and-localization.rst

@@ -642,6 +642,18 @@ Sélection Automatique de Locale Basée sur les Données de Requêtes
 En utilisant le ``LocaleSelectorFilter`` dans votre application, CakePHP
 définira automatiquement la locale en se basant sur l'utilisateur actuel::
 
+    // dans src/Application.php
+    use Cake\I18n\Middleware\LocaleSelectorMiddleware;
+
+    // Mise à jour de la méthode "middleware" pour ajouter le nouveau middleware
+    public function middleware($middleware)
+    {
+        // Add middleware and set the valid locales
+        $middleware->add(new LocaleSelectorMiddleware(['en_US', 'fr_FR']));
+    }
+
+
+    // Avant 3.3.0, il faut utiliser un DispatchFilter
     // dans config/bootstrap.php
     DispatcherFactory::add('LocaleSelector');
 

fr/core-libraries/validation.rst

@@ -180,20 +180,20 @@ classe :php:class:`~Cake\\Validation\\Validation`. Cela facilite l'utilisation
 des méthodes de cette classe en règles de validation. Lors de l'utilisation
 conjointe de Validators et de l'ORM, des providers supplémentaires sont
 configurés pour la table et les objets entity. Vous pouvez utiliser la méthode
-``provider()`` pour ajouter un provider supplémentaire que votre application
+``setProvider()`` pour ajouter un provider supplémentaire que votre application
 a besoin d'utiliser::
 
     $validator = new Validator();
 
     // Utilise une instance de l'object.
-    $validator->provider('custom', $myObject);
+    $validator->setProvider('custom', $myObject);
 
     // Utilise un nom de classe. Les méthodes doivent être static.
-    $validator->provider('custom', 'App\Model\Validation');
+    $validator->setProvider('custom', 'App\Model\Validation');
 
 Les providers de Validation peuvent être des objets, ou des noms de classe. Si
 un nom de classe est utilisé, les méthodes doivent être static. Pour utiliser
-un provider autre que 'default', assurez-vous de définir la clé ``provider()``
+un provider autre que 'default', assurez-vous de définir la clé ``setProvider()``
 dans votre règle::
 
     // Utilise une règle à partir du provider de la table
@@ -216,7 +216,7 @@ pays, par exemple::
         public function validationDefault(Validator $validator)
         {
             // Ajoute le provider au validator
-            $validator->provider('fr', 'Localized\Validation\FrValidation');
+            $validator->setProvider('fr', 'Localized\Validation\FrValidation');
             // utilise le provider dans une règle de validation de champ
             $validator->add('phoneField', 'myCustomRuleNameForPhone', [
                 'rule' => 'phone',

fr/development/routing.rst

@@ -159,7 +159,7 @@ du tableau devraient être appelées après les éléments de route dans l'URL,
 les éléments par défaut: ``:controller``, ``:action``, et ``:plugin``. Les
 valeurs dans le tableau sont les valeurs par défaut pour ces clés. Regardons
 quelques exemples simples avant que nous commencions à voir l'utilisation du
-troisième paramètre de connect()::
+troisième paramètre de ``connect()``::
 
     $routes->connect(
         '/pages/*',
@@ -250,7 +250,7 @@ route: ``:controller`` et ``:id``. L'élément ``:controller`` est l'élément d
 route par défaut de CakePHP, donc le router sait comment matcher et identifier
 les noms de controller dans les URLs. L'élément ``:id`` est un élément de route
 personnalisé, et doit être clarifié plus loin en spécifiant une expression
-régulière correspondante dans le troisième paramètre de connect().
+régulière correspondante dans le troisième paramètre de ``connect()``.
 
 CakePHP ne produit pas automatiquement d'urls en minuscule avec des tirets quand
 vous utilisez le paramètre ``:controller``. Si vous avez besoin de ceci,
@@ -277,8 +277,8 @@ d'une application CakePHP 2.x, vous pouvez utiliser à la place la classe
     correctement.
 
 Une fois que cette route a été définie, la requête ``/apples/5`` est la même
-que celle requêtant ``/apples/view/5``. Les deux appelleraient la méthode view()
-de ApplesController. A l'intérieur de la méthode view(), vous aurez besoin
+que celle requêtant ``/apples/view/5``. Les deux appelleraient la méthode ``view()``
+de ApplesController. A l'intérieur de la méthode ``view()``, vous aurez besoin
 d'accéder à l'ID passé à ``$this->request->getParam('id')``.
 
 Si vous avez un unique controller dans votre application et que vous ne
@@ -316,7 +316,7 @@ nous est familier: c'est une route par défaut qui dit à CakePHP d'attendre
 un nom de controller.
 
 Ensuite, nous spécifions quelques valeurs par défaut. Quel que soit le
-controller, nous voulons que l'action index() soit appelée.
+controller, nous voulons que l'action ``index()`` soit appelée.
 
 Finalement, nous spécifions quelques expressions régulières qui vont
 matcher les années, mois et jours sous forme numérique. Notez que les
@@ -326,7 +326,7 @@ dessus, mais ne pas grouper avec les parenthèses.
 
 Une fois définie, cette route va matcher ``/articles/2007/02/01``,
 ``/posts/2004/11/16``, gérant les requêtes
-pour les actions index() de ses controllers respectifs, avec les paramètres de
+pour les actions ``index()`` de ses controllers respectifs, avec les paramètres de
 date dans ``$this->request->getParam()``.
 
 Il y a plusieurs éléments de route qui ont une signification spéciale dans
@@ -895,8 +895,8 @@ renommer vos actions::
         'actions' => ['update' => 'put', 'create' => 'add']
     ]);
 
-Le code ci-dessus va utiliser ``put()`` pour l'action ``edit()``, et
-``create()`` au lieu de ``add()``.
+Le code ci-dessus va utiliser la méthode ``put()`` pour l'action ``edit()``, et
+``add()`` au lieu de ``create()``.
 
 Mapper des Routes de Ressource Supplémentaires
 ----------------------------------------------
@@ -1052,10 +1052,10 @@ générés vont automatiquement être mises à jour.
 
 Si vous créez des URLs en utilisant des chaînes de caractères comme::
 
-    $this->Html->link('View', '/articles/view/' + $id);
+    $this->Html->link('View', '/articles/view/' . $id);
 
-Et ensuite plus tard, vous décidez que ``/posts`` devrait vraiment être
-appelé 'articles' à la place, vous devrez aller dans toute votre application
+Et ensuite plus tard, vous décidez que ``/articles`` devrait vraiment être
+appelé 'posts' à la place, vous devrez aller dans toute votre application
 en renommant les URLs. Cependant, si vous définissiez votre lien comme::
 
     $this->Html->link(

fr/views/helpers/form.rst

@@ -1672,6 +1672,8 @@ Créer des Boutons Indépendants et des liens POST
         ouvert. À la place, utilisez l'option ``block`` pour mettre en mémoire
         tampon le formulaire dans des :ref:`view-blocks`
 
+.. _customizing-templates:
+
 Personnaliser les Templates que FormHelper Utilise
 ==================================================
 
@@ -1965,7 +1967,12 @@ voulez construire un widget Autocomplete, vous pouvez le faire comme ceci::
 
 
 Évidemment, c'est un exemple très simple, mais il montre comment développer
-un widget personnalisé.
+un widget personnalisé. Ce widget ferait un rendu du template "autocomplete",
+si défini comme ceci par exemple::
+
+    $this->Form->setTemplates([
+        'autocomplete' => '<input type="autocomplete" name="{{name}}" {{attrs}} />'
+    ]);
 
 Utiliser les Widgets
 --------------------