Add documentation on customizing field settings with autoFields turne…

…d on

docs/customizing-templates.rst

@@ -66,6 +66,31 @@ applying formatters to any of your fields. Whenever you use the
         }
     }
 
+You may also specify formatters using the ``scaffold.field_settings``
+configuration key. This is useful if you want to display all fields but wish
+to only configure the settings for one or two.
+
+.. code-block:: php
+
+    <?php
+    namespace App\Controller;
+
+    class ArticlesController extends AppController
+    {
+        public function index()
+        {
+            $action = $this->Crud->action();
+            $action->config('scaffold.field_settings', [
+                'published_time' => [
+                    'formatter' => function ($name, Time $value) {
+                        return $value->nice();
+                    }
+                ],
+            ]);
+            return $this->Crud->execute();
+        }
+    }
+
 Formatting with a Callable
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

src/Listener/ViewListener.php

@@ -307,11 +307,12 @@ protected function _scaffoldFields(array $associations = [])
             $scaffoldFields[$field] += ['formatter' => null];
         }
 
-        $fieldFormatters = $action->config('scaffold.field_formatters');
-        if (empty($fieldFormatters)) {
-            $fieldFormatters = [];
+        $fieldSettings = $action->config('scaffold.field_settings');
+        if (empty($fieldSettings)) {
+            $fieldSettings = [];
         }
-        $scaffoldFields = Hash::merge($scaffoldFields, $fieldFormatters);
+        $fieldSettings = array_intersect_key($fieldSettings, $scaffoldFields);
+        $scaffoldFields = Hash::merge($scaffoldFields, $fieldSettings);
 
         return $scaffoldFields;
     }