Fix docs and upgrade path for 3.0 (#424)

matthiasseghers · alexander-schranz · web-flow · commit 4ac82dde99fe · 2026-03-03T12:08:57.000Z
* Remove type declaration from sulu_form_api route

Remove unnecessary type declaration for sulu_form_api.

* Fix form rendering in dynamic.md

* Remove debug dump from dynamic.md

Remove debug dump of resource in dynamic.md.

* Update form rendering in dynamic.md

* Improve form rendering instructions in upgrade guide

Updated Twig template for form handling in UPGRADE-3.0.md.

* Update UPGRADE-3.0.md

* Update UPGRADE-3.0.md

Co-authored-by: Alexander Schranz &lt;alexander@sulu.io&gt;

* Update UPGRADE-3.0.md

---------

Co-authored-by: Alexander Schranz &lt;alexander@sulu.io&gt;
diff --git a/Resources/doc/dynamic.md b/Resources/doc/dynamic.md
@@ -89,9 +89,10 @@ has been submitted successfully!
 <body>
     {% if content.form %}
         {% if app.request.get('send') != 'true' %}
+            {% set form_view = sulu_form_build(content.form, 'page', resource.id) %}
             {# FORM THEME #}
-            {% form_theme content.form '@SuluForm/themes/basic.html.twig' %}
-            {{ form(content.form) }}
+            {% form_theme form_view '@SuluForm/themes/basic.html.twig' %}
+            {{ form(form_view) }}
         {% else %}
             {{ view.form.entity.successText|raw }}
         {% endif %}
diff --git a/Resources/doc/index.md b/Resources/doc/index.md
@@ -63,7 +63,6 @@ Add the following lines to `config/routes/sulu_admin.yaml`
 
 ```yml
 sulu_form_api:
-    type: rest
     resource: "@SuluFormBundle/Resources/config/routing_api.yml"
     prefix: /admin/api
 ```
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -10,18 +10,17 @@ The `SingleFormSelection` content type has been replaced with the new Sulu 3.0 c
 
 The form is no longer built during content resolution. Instead, use the new `sulu_form_build` Twig function to build the form at render time:
 
-**before:**
-
-```twig
-{{ form(content.formProperty) }}
-```
-
-**after:**
-
-```twig
-{% set form = sulu_form_build(content.formProperty, 'page', page.id) %}
-{% if form %}
-    {{ form(form) }}
+```diff
+{% if content.form %}
+    {% if app.request.get('send') != 'true' %}
+-        {% form_theme content.form '@SuluForm/themes/basic.html.twig' %}
+-        {{ form(content.form) }}
++        {% set form_view = sulu_form_build(content.form, 'page', resource.id) %}
++        {% form_theme form_view '@SuluForm/themes/basic.html.twig' %}
++        {{ form(form_view) }}
+    {% else %}
+        {{ view.form.entity.successText|raw }}
+    {% endif %}
 {% endif %}
 ```
 
