From: Tim Düsterhus <duesterhus@woltlab.com>
Date: Thu, 20 Jan 2022 10:48:16 +0000 (+0100)
Subject: Add `|json` template modifier
X-Git-Tag: 5.5.0_Alpha_1~200^2~3
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=e178fa84dc06861c5aba3d14e03161c5396fe9a7;p=GitHub%2FWoltLab%2FWCF.git

Add `|json` template modifier
---

diff --git a/wcfsetup/install/files/lib/system/template/plugin/JsonModifierTemplatePlugin.class.php b/wcfsetup/install/files/lib/system/template/plugin/JsonModifierTemplatePlugin.class.php
new file mode 100644
index 0000000000..16e3652dca
--- /dev/null
+++ b/wcfsetup/install/files/lib/system/template/plugin/JsonModifierTemplatePlugin.class.php
@@ -0,0 +1,34 @@
+<?php
+
+namespace wcf\system\template\plugin;
+
+use wcf\system\template\TemplateEngine;
+use wcf\util\JSON;
+
+/**
+ * JSON encodes the given value.
+ *
+ * Usage:
+ *  { "title": {$foo->getTitle()|json} }
+ *
+ * Depending on the location you might need to either HTML-encode the resulting JSON string
+ * or not. Within a `<script>` tag, additional HTML-encoding usually is an error, as HTML is
+ * not interpreted within there, thus `{@$var|json}` with the additional `@` will need to be
+ * used.
+ *
+ * @author  Tim Duesterhus
+ * @copyright   2001-2022 WoltLab GmbH
+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package WoltLabSuite\Core\System\Template\Plugin
+ * @since 5.5
+ */
+class JsonModifierTemplatePlugin implements IModifierTemplatePlugin
+{
+    /**
+     * @inheritDoc
+     */
+    public function execute($tagArgs, TemplateEngine $tplObj)
+    {
+        return JSON::encode($tagArgs[0]);
+    }
+}