[TASK] Deprecate page.javascriptLibs.* 05/55605/3
authorFrank Naegler <frank.naegler@typo3.org>
Thu, 8 Feb 2018 14:32:29 +0000 (15:32 +0100)
committerChristian Kuhn <lolli@schwarzbu.ch>
Thu, 8 Feb 2018 19:12:31 +0000 (20:12 +0100)
The settings page.javascriptLibs and page.javascriptLibs.jQuery
have been marked as deprecated and will be removed in CMS 10.

Resolves: #83806
Releases: master
Change-Id: I72d20919a30c724716a6c75ba409679f0671c68c
Reviewed-on: https://review.typo3.org/55605
Reviewed-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Tested-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Reviewed-by: Christian Kuhn <lolli@schwarzbu.ch>
Tested-by: Christian Kuhn <lolli@schwarzbu.ch>
typo3/sysext/core/Documentation/Changelog/master/Deprecation-83806-DeprecatePagejavascriptLibsAndPagejavascriptLibsjQuery.rst [new file with mode: 0644]
typo3/sysext/frontend/Classes/Page/PageGenerator.php
typo3/sysext/t3editor/Resources/Private/tsref.xml

diff --git a/typo3/sysext/core/Documentation/Changelog/master/Deprecation-83806-DeprecatePagejavascriptLibsAndPagejavascriptLibsjQuery.rst b/typo3/sysext/core/Documentation/Changelog/master/Deprecation-83806-DeprecatePagejavascriptLibsAndPagejavascriptLibsjQuery.rst
new file mode 100644 (file)
index 0000000..7ab2c21
--- /dev/null
@@ -0,0 +1,39 @@
+.. include:: ../../Includes.txt
+
+==================================================================================
+Deprecation: #83806 - Deprecate page.javascriptLibs and page.javascriptLibs.jQuery
+==================================================================================
+
+See :issue:`83806`
+
+Description
+===========
+
+The settings :typoscript:`page.javascriptLibs` and :typoscript:`page.javascriptLibs.jQuery` have been marked as deprecated and will be removed in CMS 10.
+
+
+Impact
+======
+
+Installations that use :typoscript:`page.javascriptLibs` or :typoscript:`page.javascriptLibs.jQuery` will trigger a deprecation warning.
+
+
+Affected Installations
+======================
+
+All installations that use one of the above settings.
+
+
+Migration
+=========
+
+Use one of the following settings to add jQuery:
+
+* :typoscript:`page.includeJSLibs`
+* :typoscript:`page.includeJSFooterlibs`
+* :typoscript:`page.includeJS`
+* :typoscript:`page.includeJSFooter`
+* :typoscript:`page.headerData`
+* :typoscript:`page.footerData`
+
+.. index:: Frontend, TypoScript, NotScanned
index d4a4917..95b9fb9 100644 (file)
@@ -351,8 +351,14 @@ class PageGenerator
         }
         // Javascript Libraries
         if (is_array($tsfe->pSetup['javascriptLibs.'])) {
+            // @deprecated since TYPO3 v9, will be removed in TYPO3 v10, the setting page.javascriptLibs has been deprecated and will be removed in TYPO3 CMS 10.
+            trigger_error('The setting page.javascriptLibs has been deprecated and will be removed in TYPO3 CMS 10', E_USER_DEPRECATED);
+
             // Include jQuery into the page renderer
             if (!empty($tsfe->pSetup['javascriptLibs.']['jQuery'])) {
+                // @deprecated since TYPO3 v9, will be removed in TYPO3 v10, the setting page.javascriptLibs.jQuery has been deprecated and will be removed in TYPO3 CMS 10.
+                trigger_error('The setting page.javascriptLibs.jQuery has been deprecated and will be removed in TYPO3 CMS 10', E_USER_DEPRECATED);
+
                 $jQueryTS = $tsfe->pSetup['javascriptLibs.']['jQuery.'];
                 // Check if version / source is set, if not set variable to "NULL" to use the default of the page renderer
                 $version = $jQueryTS['version'] ?? null;
index dc5c431..dc1249f 100644 (file)
@@ -5131,18 +5131,6 @@ TYPO3.settings = {"TS":{"setting1":"Hello","setting2":"GoOnTop"}};
                        <default><![CDATA[
 ]]></default>
                </property>
-               <property name="javascriptLibs" type="array">
-                       <description><![CDATA[array of Strings
-       This allows to include the JavaScript libraries that are shipped with the TYPO3 Core.
-
-javascriptLibs {
-     # includes jQuery
-   jQuery = 1
-}
-]]></description>
-                       <default><![CDATA[
-]]></default>
-               </property>
                <property name="jsInline" type="CARRAY">
                        <description><![CDATA[Use cObjects for creating inline JavaScript