From ed267ddc0c89f9649f6bff2206155f92ef346e79 Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Wed, 17 Jan 2024 16:38:24 +0100
Subject: [PATCH] Add a form to try out shortcodes in the "guide"

---
 src/Controller/GuideController.php         | 66 +++++++++++++++++-----
 src/Resources/views/Guide/detail.html.twig | 28 +++++----
 src/Resources/views/Guide/list.html.twig   |  8 +--
 3 files changed, 73 insertions(+), 29 deletions(-)

diff --git a/src/Controller/GuideController.php b/src/Controller/GuideController.php
index 04c3530..b2e585a 100644
--- a/src/Controller/GuideController.php
+++ b/src/Controller/GuideController.php
@@ -2,6 +2,9 @@
 
 namespace Webfactory\ShortcodeBundle\Controller;
 
+use Symfony\Component\Form\Extension\Core\Type\FormType;
+use Symfony\Component\Form\Extension\Core\Type\TextareaType;
+use Symfony\Component\Form\FormFactoryInterface;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
@@ -13,8 +16,6 @@
  */
 final class GuideController
 {
-    private $twig;
-
     /**
      * @var array
      *
@@ -28,13 +29,24 @@ final class GuideController
      */
     private $shortcodeTags;
 
+    /**
+     * @var Environment|Twig_Environment
+     */
+    private $twig;
+
+    /**
+     * @var ?FormFactoryInterface
+     */
+    private $formFactory;
+
     /**
      * @param Twig_Environment|Environment $twig
      */
-    public function __construct(array $shortcodeTags, $twig)
+    public function __construct(array $shortcodeTags, $twig, FormFactoryInterface $formFactory = null)
     {
-        $this->shortcodeTags = $shortcodeTags;
+        $this->shortcodeTags = array_combine(array_map(function (array $definition): string { return $definition['shortcode']; }, $shortcodeTags), $shortcodeTags);
         $this->twig = $twig;
+        $this->formFactory = $formFactory;
     }
 
     public function listAction(): Response
@@ -42,20 +54,44 @@ public function listAction(): Response
         return new Response($this->twig->render('@WebfactoryShortcode/Guide/list.html.twig', ['shortcodeTags' => $this->shortcodeTags]));
     }
 
-    public function detailAction($shortcode, Request $request): Response
+    public function detailAction(string $shortcode, Request $request): Response
     {
-        foreach ($this->shortcodeTags as $shortcodeTag) {
-            if ($shortcodeTag['shortcode'] === $shortcode) {
-                // if custom parameters are provided, replace the example
-                $customParameters = $request->get('customParameters');
-                if ($customParameters) {
-                    $shortcodeTag['example'] = $shortcode.' '.$customParameters;
-                }
-
-                return new Response($this->twig->render('@WebfactoryShortcode/Guide/detail.html.twig', ['shortcodeTag' => $shortcodeTag]));
+        if (!isset($this->shortcodeTags[$shortcode])) {
+            throw new NotFoundHttpException();
+        }
+
+        $shortcodeTag = $this->shortcodeTags[$shortcode];
+
+        // if custom parameters are provided, replace the example
+        $customParameters = $request->get('customParameters');
+        if ($customParameters) {
+            $shortcodeTag['example'] = $shortcode.' '.$customParameters;
+        }
+
+        $example = '[' . ($shortcodeTag['example'] ?? $shortcode ) . ']';
+
+        if ($this->formFactory) {
+            $formBuilder = $this->formFactory->createBuilder(FormType::class, ['example' => $example], ['method' => 'GET']);
+            $formBuilder->add('example', TextareaType::class);
+            $form = $formBuilder->getForm();
+
+            $form->handleRequest($request);
+
+            if ($form->isSubmitted()) {
+                $example = $form->getData()['example'];
             }
+        } else {
+            $form = null;
         }
 
-        throw new NotFoundHttpException();
+        return new Response(
+            $this->twig->render(
+                '@WebfactoryShortcode/Guide/detail.html.twig', [
+                    'shortcodeTag' => $shortcodeTag,
+                    'example' => $example,
+                    'form' => $form ? $form->createView() : null,
+                ]
+            )
+        );
     }
 }
diff --git a/src/Resources/views/Guide/detail.html.twig b/src/Resources/views/Guide/detail.html.twig
index 55ff717..8c1403d 100644
--- a/src/Resources/views/Guide/detail.html.twig
+++ b/src/Resources/views/Guide/detail.html.twig
@@ -5,7 +5,8 @@
 {% endblock %}
 
 {% block content %}
-    <h1>Shortcode {{ shortcodeTag.shortcode }}</h1>
+    <h1>Shortcode preview</h1>
+    <p><b><tt>[{{ shortcodeTag.shortcode }}]</tt></b></p>
     <p>
         {% if shortcodeTag.description is defined %}
             {{ shortcodeTag.description }}
@@ -14,17 +15,24 @@
         {% endif %}
     </p>
 
-    <h2>Example</h2>
-    {% if shortcodeTag.example is defined %}
-        <p>[{{ shortcodeTag.example }}] becomes:</p>
-        <div id="rendered-example">
-            {{ ('[' ~ shortcodeTag.example ~ ']') |shortcodes }}
-        </div>
+    <p>
+        <a href="{{ path('webfactory.shortcode.guide-list') }}">Back to the shortcodes list</a>
+    </p>
+
+    {% if form %}
+        {{ form_start(form) }}
+        {{ form_widget(form) }}
+        <input type="submit" value="Show example" />
+        {{ form_end(form) }}
+    {% elseif shortcodeTag.example is defined %}
+        <p>Example code: {{ example }}</p>
     {% else %}
         <p>No example configured.</p>
     {% endif %}
 
-    <p>
-        <a href="{{ path('webfactory.shortcode.guide-list') }}">Back to the shortcodes list</a>
-    </p>
+    {% if shortcodeTag.example is defined %}
+        <div id="rendered-example">
+            {{ example|shortcodes }}
+        </div>
+    {% endif %}
 {% endblock %}
diff --git a/src/Resources/views/Guide/list.html.twig b/src/Resources/views/Guide/list.html.twig
index 5c7ec09..d2b666c 100644
--- a/src/Resources/views/Guide/list.html.twig
+++ b/src/Resources/views/Guide/list.html.twig
@@ -5,7 +5,7 @@
 {% endblock %}
 
 {% block content %}
-    <h1>List of Shortcode</h1>
+    <h1>List of shortcodes</h1>
 
     {% if shortcodeTags %}
         <table>
@@ -26,14 +26,14 @@
                             {% if shortcodeTag.description is defined %}
                                 {{ shortcodeTag.description }}
                             {% else %}
-                                No description configured
+                                No description available
                             {% endif %}
                         </td>
                         <td>
                             {% if shortcodeTag.example is defined %}
                                 [{{ shortcodeTag.example }}]
                             {% else %}
-                                No example configured
+                                No example available
                             {% endif %}
                         </td>
                     </tr>
@@ -42,6 +42,6 @@
         </table>
     {% else %}
         <p>No shortcodes configured.</p>
-        <p>See the <a href="https://github.com/webfactory/WebfactoryShortcodeBundle/blob/master/README.md">README.md of the WebfactoryShortcodeBundle</a> to configure some.</p>
+        <p>See the <a href="https://github.com/webfactory/WebfactoryShortcodeBundle/blob/master/README.md">WebfactoryShortcodeBundle README.md</a> on how to configure this documentation.</p>
     {% endif %}
 {% endblock %}