diff --git a/Documentation/typo3/fluid/latest/Base.rst b/Documentation/typo3/fluid/latest/Base.rst index 658de78..b1b0109 100644 --- a/Documentation/typo3/fluid/latest/Base.rst +++ b/Documentation/typo3/fluid/latest/Base.rst @@ -12,12 +12,26 @@ Base ViewHelper `` ========================== +.. deprecated:: TYPO3 v11.5 + + The :html:`` ViewHelper is not suitable in almost all use cases + and has been deprecated: In most cases the :php:`PageRenderer` takes care of the + main :html:`` markup, directly, or indirectly via TypoScript :html:`config.baseURL`. ViewHelper which creates a :html:`` tag. The Base URI is taken from the current request. +.. _typo3-fluid-base-migration: + +Migration +========= + +If the ViewHelper is still needed, copy +:php:`TYPO3\CMS\Fluid\ViewHelpers\BaseViewHelper` to the consuming extension, +giving the ViewHelper a happy life in an extension specific namespace. + Examples ======== diff --git a/Documentation/typo3/fluid/latest/Be/Buttons/Shortcut.rst b/Documentation/typo3/fluid/latest/Be/Buttons/Shortcut.rst index d79e807..acd6ebe 100644 --- a/Documentation/typo3/fluid/latest/Be/Buttons/Shortcut.rst +++ b/Documentation/typo3/fluid/latest/Be/Buttons/Shortcut.rst @@ -12,13 +12,11 @@ Be.buttons.shortcut ViewHelper `` ======================================================== - +.. deprecated:: TYPO3 v11.5 + Will be removed in TYPO3 v12. It was only introduced as "experimental". ViewHelper which returns shortcut button with icon. -.. note:: - This ViewHelper is experimental! - Examples ======== @@ -36,7 +34,7 @@ Explicitly set parameters to be stored in the shortcut:: Shortcut button as known from the TYPO3 backend. This time only the specified GET parameters and SET[]-settings will be stored. -.. note: +.. note:: Normally you won't need to set getVars & setVars parameters in Extbase modules. diff --git a/Documentation/typo3/fluid/latest/Be/Container.rst b/Documentation/typo3/fluid/latest/Be/Container.rst index fe47394..1c97391 100644 --- a/Documentation/typo3/fluid/latest/Be/Container.rst +++ b/Documentation/typo3/fluid/latest/Be/Container.rst @@ -12,10 +12,31 @@ Be.container ViewHelper `` ========================================== +.. deprecated:: 11.5 + This backend module related ViewHelper mostly provides the same functionality + as :ref:`typo3-fluid-be-pagerenderer`, + with the additional opportunity to render an empty doc header. ViewHelper which allows you to create extbase based modules in the style of TYPO3 default modules. +.. _typo3-fluid-be-containermigration: + +Migration +========= + +When this ViewHelper is used to register additional backend module +resources like CSS or JavaScript, :ref:`typo3-fluid-be-pagerenderer` can be +used as drop-in replacement. + +If the ViewHelper is used to additionally render an empty ModuleTemplate, +this part should be moved to a controller instead. Simple example: + +.. code-block:: php + + $moduleTemplate->setContent($view->render()); + return new HtmlResponse($moduleTemplate->renderContent()); + Examples ======== diff --git a/Documentation/typo3/fluid/latest/Uri/Email.rst b/Documentation/typo3/fluid/latest/Uri/Email.rst index 607aa4f..2bcc6ac 100644 --- a/Documentation/typo3/fluid/latest/Uri/Email.rst +++ b/Documentation/typo3/fluid/latest/Uri/Email.rst @@ -12,6 +12,13 @@ Uri.email ViewHelper `` ==================================== +.. deprecated:: TYPO3 v11.5 + + In favor of allowing more content security policy scenarios, :js:`URI` + is not used anymore per default. As a result, :html:`` + ViewHelper became obsolete. The ViewHelper will be removed with TYPO3 v12.0. + + See :ref:`typo3-fluid-uri-email-migration` for details. Email URI ViewHelper. @@ -19,6 +26,24 @@ Generates an email URI incorporating TYPO3s `spamProtectEmailAddresses`_ TypoScr .. _spamProtectEmailAddresses: https://docs.typo3.org/m/typo3/reference-typoscript/master/en-us/Setup/Config/Index.html#spamprotectemailaddresses +.. _typo3-fluid-uri-email-migration: + +Migration +========= + +In case :typoscript:`config.spamProtectEmailAddresses` is used, make use of +:html:`` ViewHelper which returns the +complete :html:`` tag like this: + +.. code-block:: html + + user(at)my.example(dot)com + +In case spam-protected is not used or not useful (for example in backend user +interface), view-helper invocation can be omitted completely. + + Example =======