[!!!][FEATURE] Add PSR-14 Events to manipulate form before created or… (#6006)

* [!!!][FEATURE] Add PSR-14 Events to manipulate form before created or saved

Resolves: https://review.typo3.org/c/Packages/TYPO3.CMS/+/90561
Resolves: TYPO3-Documentation/Changelog-To-Doc#1309

Releases: main

* [!!!][FEATURE] Add PSR-14 Events to manipulate form before created or saved

Resolves: https://review.typo3.org/c/Packages/TYPO3.CMS/+/90561
Resolves: TYPO3-Documentation/Changelog-To-Doc#1309

Releases: main

* Correction from code review

Author: linawolf

Documentation/ApiOverview/Events/Events/Form/BeforeFormIsCreatedEvent.rst

@@ -0,0 +1,41 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; BeforeFormIsCreatedEvent
+
+..  _BeforeFormIsCreatedEvent:
+
+========================
+BeforeFormIsCreatedEvent
+========================
+
+..  versionadded:: 14.0
+    The event :php-short:`TYPO3\CMS\Form\Event\BeforeFormIsCreatedEvent`
+    serves as a direct replacement for the removed hook
+    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/form']['beforeFormCreate']`.
+
+The event :php-short:`TYPO3\CMS\Form\Event\BeforeFormIsCreatedEvent` allows a
+to modify a form before it gets created. The event is dispatched just right
+before a new form is created in the backend.
+
+..  seealso::
+    *   `BeforeFormIsSavedEvent <https://docs.typo3.org/permalink/t3coreapi:beforeformissavedevent>`_
+        is called right before a form is saved in the backend form editor.
+    *   The backend form editor is described in detail in the `TYPO3 Form manual
+        - Form editor <https://docs.typo3.org/permalink/typo3/cms-form:apireference-formeditor>`_.
+
+..  _BeforeFormIsCreatedEvent-example:
+
+Example
+=======
+
+..  literalinclude:: _BeforeFormIsCreatedEvent/_MyEventListener.php
+    :language: php
+    :caption: EXT:my_extension/Classes/EventListener/MyEventListener.php
+
+..  include:: /_includes/EventsAttributeAddedNew.rst.txt
+
+..  _BeforeFormIsCreatedEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Form/BeforeFormIsCreatedEvent.rst.txt

Documentation/ApiOverview/Events/Events/Form/BeforeFormIsSavedEvent.rst

@@ -0,0 +1,40 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; BeforeFormIsSavedEvent
+
+..  _BeforeFormIsSavedEvent:
+
+======================
+BeforeFormIsSavedEvent
+======================
+
+..  versionadded:: 14.0
+    The event :php-short:`TYPO3\CMS\Form\Event\BeforeFormIsSavedEvent`
+    serves as a direct replacement for the removed hook
+    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/form']['beforeFormSave']`.
+
+The event :php-short:`TYPO3\CMS\Form\Event\BeforeFormIsSavedEvent` allows a
+to modify a form definition as well as the form persistence identifier before
+it gets saved. It is dispatched just right before a form is saved in the backend.
+
+..  seealso::
+    *   `BeforeFormIsCreatedEvent <https://docs.typo3.org/permalink/t3coreapi:beforeformiscreatedevent>`_
+        is called right before a form is created in the backend form editor.
+    *   The backend form editor is described in detail in the `TYPO3 Form manual
+        - Form editor <https://docs.typo3.org/permalink/typo3/cms-form:apireference-formeditor>`_.
+
+..  _BeforeFormIsSavedEvent-example:
+
+Example
+=======
+
+..  literalinclude:: _BeforeFormIsSavedEvent/_MyEventListener.php
+    :caption: EXT:my_extension/Classes/EventListener/MyEventListener.php
+
+..  include:: /_includes/EventsAttributeAddedNew.rst.txt
+
+..  _BeforeFormIsSavedEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Form/BeforeFormIsSavedEvent.rst.txt

Documentation/ApiOverview/Events/Events/Form/_BeforeFormIsCreatedEvent/_MyEventListener.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MyVendor\MyExtension\EventListener;
+
+use TYPO3\CMS\Core\Attribute\AsEventListener;
+use TYPO3\CMS\Form\Event\BeforeFormIsCreatedEvent;
+
+#[AsEventListener(
+    identifier: 'my-extension/before-form-is-created',
+)]
+final readonly class MyEventListener
+{
+    public function __invoke(BeforeFormIsCreatedEvent $event): void
+    {
+        $event->form['label'] = 'foo';
+    }
+}

Documentation/ApiOverview/Events/Events/Form/_BeforeFormIsSavedEvent/_MyEventListener.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MyVendor\MyExtension\EventListener;
+
+use TYPO3\CMS\Core\Attribute\AsEventListener;
+use TYPO3\CMS\Form\Event\BeforeFormIsSavedEvent;
+
+#[AsEventListener(
+    identifier: 'my-extension/before-form-is-saved',
+)]
+final readonly class MyEventListener
+{
+    public function __invoke(BeforeFormIsSavedEvent $event): void
+    {
+        $event->form['label'] = 'foo';
+    }
+}

Documentation/CodeSnippets/Config/Api/Events/EventsForm.php

@@ -7,4 +7,16 @@
         'targetFileName' => 'CodeSnippets/Events/Form/AfterFormDefinitionLoadedEvent.rst.txt',
         'withCode' => false,
     ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Form\Event\BeforeFormIsSavedEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Form/BeforeFormIsSavedEvent.rst.txt',
+        'withCode' => false,
+    ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Form\Event\BeforeFormIsCreatedEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Form/BeforeFormIsCreatedEvent.rst.txt',
+        'withCode' => false,
+    ],
 ];

Documentation/CodeSnippets/Events/Form/BeforeFormIsCreatedEvent.rst.txt

@@ -0,0 +1,13 @@
+..  Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets
+..  php:namespace::  TYPO3\CMS\Form\Event
+
+..  php:class:: BeforeFormIsCreatedEvent
+
+    Listeners to this Event will be able to modify the form definition
+    and persistence identifier before a new form is created.
+
+    ..  php:attr:: formPersistenceIdentifier
+        :public:
+
+    ..  php:attr:: form
+        :public:

Documentation/CodeSnippets/Events/Form/BeforeFormIsSavedEvent.rst.txt

@@ -0,0 +1,13 @@
+..  Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets
+..  php:namespace::  TYPO3\CMS\Form\Event
+
+..  php:class:: BeforeFormIsSavedEvent
+
+    Listeners to this Event will be able to modify the form definition
+    and persistence identifier before a form is saved.
+
+    ..  php:attr:: formPersistenceIdentifier
+        :public:
+
+    ..  php:attr:: form
+        :public: