Enable Twig cache by default

Author: Florens Verschelde

doc/options.md

@@ -13,9 +13,21 @@ c::set('twig.usephp', true);
 // For instance 'error/system'. Falls back to c::get('error').
 c::set('twig.error', '');
 
+// List of additional functions that should be available in templates
+c::set('twig.env.functions', ['myCustomFunction']);
+
+// List of classes that can be instantiated from templates (with the `new()` function)
+c::set('twig.env.classes', ['SomeClass']);
+```
+
+## Advanced
+
+```
 // Use Twig’s PHP cache?
-// (Note that Kirby has its own HTML cache.)
-c::set('twig.cache', false);
+// Enabled by default. Note that Kirby has its own HTML cache for pages,
+// so this might be extra work, but for pages which are often not cached
+// (e.g. search pages with a specific query string) this could be useful.
+c::set('twig.cache', true);
 
 // Disable autoescaping or specify autoescaping type
 // http://twig.sensiolabs.org/doc/api.html#environment-options
@@ -24,10 +36,4 @@ c::set('twig.autoescape', true);
 // Should Twig throw errors when using undefined variables or methods?
 // Defaults to the value of the 'debug' option
 c::set('twig.strict', c::get('debug', false));
-
-// List of additional functions that should be available in templates
-c::set('twig.env.functions', ['myCustomFunction']);
-
-// List of classes that can be instantiated from templates (with the `new()` function)
-c::set('twig.env.classes', ['SomeClass']);
 ```

src/TwigRenderer.php

@@ -124,7 +124,7 @@ public function __construct()
         $options  = [
             'debug' => $debug,
             'strict_variables' => C::get('twig.strict', $debug),
-            'cache' => C::get('twig.cache', false) ? $cacheDir : false,
+            'cache' => C::get('twig.cache', true) ? $cacheDir : false,
             'autoescape' => C::get('twig.autoescape', true)
         ];