Merge branch 'release/8.2.1'

Author: rhukster

CHANGELOG.md

@@ -1,8 +1,14 @@
+# v8.2.1
+## 12/28/2025
+
+1. [](#bugfix)
+    * Fix for bad `Twig::setEscaper()` logic
+
 # v8.2.0
-## 112/27/2025
+## 12/27/2025
 
 1. [](#improved)
-    - Use new Twig::setEscaper() helper if it exists
+    - Use new `Twig::setEscaper()` helper if it exists
     - Automated form none refresh `refresh_nonce` (false by default)
 1. [](#bugfix)
     - Fix spacer field [#623](https://github.com/getgrav/grav-plugin-form/pulls/623)

blueprints.yaml

@@ -1,7 +1,7 @@
 name: Form
 slug: form
 type: plugin
-version: 8.2.0
+version: 8.2.1
 description: Enables forms handling and processing
 icon: check-square
 author:

form.php

@@ -375,12 +375,21 @@ public function onTwigInitialized(): void
             new TwigFunction('forms', [$this, 'getForm'])
         );
 
-        // Grav 1.8+ has setEscaper() helper that handles all Twig versions
+        // Register yaml escaper for Twig
         $twig = $this->grav['twig'];
         if (method_exists($twig, 'setEscaper')) {
+            // Grav 1.8.0-beta.29+ has setEscaper() helper
             $twig->setEscaper('yaml', function ($twig, $string, $charset) {
                 return Yaml::dump($string);
             });
+        } elseif (class_exists('Twig\Runtime\EscaperRuntime')) {
+            // Grav 1.8.0-beta.1 to .28 with Twig 3.x (no helper yet)
+            $twig->twig()->getRuntime('Twig\Runtime\EscaperRuntime')->setEscaper(
+                'yaml',
+                function ($string, $charset) {
+                    return Yaml::dump($string);
+                }
+            );
         } else {
             // Grav 1.7 with Twig 1.x
             $twig->twig()->getExtension(CoreExtension::class)->setEscaper(