[DOCS] 7.5 Docs Part 3/4 34/43434/2
authorMathias Schreiber <mathias.schreiber@wmdb.de>
Sat, 19 Sep 2015 12:52:18 +0000 (14:52 +0200)
committerBenni Mack <benni@typo3.org>
Sat, 19 Sep 2015 20:11:24 +0000 (22:11 +0200)
Proofread and move Important Documentation

Change-Id: If03e5b5807f6e696d4ae4178663658d79f329ded
Reviewed-on: http://review.typo3.org/43434
Reviewed-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Tested-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Reviewed-by: Benni Mack <benni@typo3.org>
Tested-by: Benni Mack <benni@typo3.org>
18 files changed:
typo3/sysext/core/Documentation/Changelog/7.5/Important-68128-PHPMagicQuoteHandlingRemoved.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/7.5/Important-68758-CommandControllersAllowedInSubfolders.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/7.5/Important-68917-UpdateJQueryTo2x.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/7.5/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/7.5/Important-69531-RemoveSpriteManagerIconViewHelper.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/7.5/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/master/Important-68128-PHPMagicQuoteHandlingRemoved.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-68758-CommandControllersAllowedInSubfolders.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-68917-UpdateJQueryTo2x.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69531-RemoveSpriteManagerIconViewHelper.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69736-SelectOptionIconsInOptionTagsRemoved.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst [deleted file]
typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Deprecation-69736-SelectOptionIconsInOptionTagsRemoved.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst [new file with mode: 0644]
typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst [new file with mode: 0644]

diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-68128-PHPMagicQuoteHandlingRemoved.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-68128-PHPMagicQuoteHandlingRemoved.rst
new file mode 100644 (file)
index 0000000..79e6046
--- /dev/null
@@ -0,0 +1,16 @@
+====================================================
+Important: #68128 - PHP Magic Quote Handling removed
+====================================================
+
+Description
+===========
+
+In PHP versions prior to PHP 5.4 the option of adding slashes (magic quotes) to
+the superglobals ``$_GET`` and ``$_POST`` was causing inconsistent data handling.
+TYPO3 therefore always added slashes to these variables on every request to
+streamline the handling of the superglobals. The corresponding methods
+``GeneralUtility::_GET()``, ``GeneralUtility::_GP()`` and ``GeneralUtility::_POST()``
+have been changed to not strip off slashes anymore.
+
+Since the PHP option was completely removed, TYPO3 is not adding slashes anymore,
+and also does not strip the slashes anymore when using the methods within GeneralUtility.
diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-68758-CommandControllersAllowedInSubfolders.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-68758-CommandControllersAllowedInSubfolders.rst
new file mode 100644 (file)
index 0000000..4fbeb07
--- /dev/null
@@ -0,0 +1,16 @@
+=============================================================
+Important: #68758 - Command controllers allowed in subfolders
+=============================================================
+
+Description
+===========
+
+Extbase command controllers can now reside in arbitary subfolders within the
+``Command`` folder. This allows for better grouping and namespacing of commands.
+
+Given a command controller resides in ``my_ext/Classes/Command/Hello/WorldCommandController.php``,
+it can now be invoked like this:
+
+.. code-block:: shell
+
+       typo3/cli_dispatch.sh extbase my_ext:hello:world <arguments>
diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-68917-UpdateJQueryTo2x.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-68917-UpdateJQueryTo2x.rst
new file mode 100644 (file)
index 0000000..f443fc7
--- /dev/null
@@ -0,0 +1,12 @@
+=========================================
+Important: #68917 - Updated jQuery to 2.x
+=========================================
+
+Description
+===========
+
+With the step from jQuery 1.x to 2.x support for older browsers and "dirty workarounds"
+have been dropped. Since TYPO3 CMS doesn't support "older" browsers (IE < 9) anymore, jQuery
+was updated from 1.x to 2.x. For extensions that ran fine with an up-to-date 1.x-version
+that shouldn't really make much difference. There might however be edge-cases where
+extension-authors might need to adapt their jQuery scripts for 2.x.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst
new file mode 100644 (file)
index 0000000..ff7dd4e
--- /dev/null
@@ -0,0 +1,40 @@
+============================================================================
+Important: #69084 - Adding Extbase Objects with NOT NULL columns has changed
+============================================================================
+
+Description
+===========
+
+To better support databases that don't silently convert ``NULL`` values to
+an empty default value for database columns defined as ``NOT NULL`` the
+``insertObject()`` method tries to determine the appropriate value for a column.
+
+Extbase object properties that have a value of ``NULL`` will be skipped when
+preparing the record to enable the DBMS default value to be used. This behavior
+has not changed compared to TYPO3 CMS 7.4 but allows proper support for DBMS that
+are strict about ``NOT NULL`` columns by defining appropriate default values for
+properties in the models.
+
+
+Example database schema:
+
+.. code-block:: sql
+
+       CREATE TABLE tx_blogexample_domain_model_blog (
+               title varchar(255) DEFAULT '' NOT NULL
+       );
+
+Example model definition:
+
+.. code-block:: php
+
+       class Blog extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
+
+               /**
+                * The blog's title.
+                *
+                * @var string
+                */
+               protected $title = '';
+
+       }
diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-69531-RemoveSpriteManagerIconViewHelper.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-69531-RemoveSpriteManagerIconViewHelper.rst
new file mode 100644 (file)
index 0000000..9521e70
--- /dev/null
@@ -0,0 +1,9 @@
+======================================================
+Important: #69531 - Remove SpriteManagerIconViewHelper
+======================================================
+
+Description
+===========
+
+The ``\TYPO3\CMS\Backend\ViewHelpers\SpriteManagerIconViewHelper`` is not used anymore and has been removed.
+Use ``\TYPO3\CMS\Core\ViewHelpers\IconViewHelper`` instead
diff --git a/typo3/sysext/core/Documentation/Changelog/7.5/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst b/typo3/sysext/core/Documentation/Changelog/7.5/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst
new file mode 100644 (file)
index 0000000..52fcfbd
--- /dev/null
@@ -0,0 +1,12 @@
+==============================================================
+Important: #69909 - FAL-based Database Fields moved to integer
+==============================================================
+
+Description
+===========
+
+The FAL-related fields in the database tables ``pages``, ``pages_language_overlay`` and ``tt_content`` that contained
+a comma-separated list of paths to files were migrated at 6.2 with the shipped update wizards to IRRE fields.
+The database fields ``pages.media``, ``pages_language_overlay.media``, ``tt_content.image`` and ``tt_content.media``
+now only contain numeric values, which are handled by the DataHandler and the Reference Index, holding
+the number of references. The database fields are now changed to be only int fields, instead fields of type ``text``.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-68128-PHPMagicQuoteHandlingRemoved.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-68128-PHPMagicQuoteHandlingRemoved.rst
deleted file mode 100644 (file)
index f1c8dc6..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-====================================================
-Important: #68128 - PHP Magic Quote Handling removed
-====================================================
-
-Description
-===========
-
-In PHP versions prior to PHP 5.4 the option of adding slashes (magic quotes) to the superglobals ``$_GET`` and ``$_POST`` was causing inconsistent data handling. TYPO3 has therefore always added slashes to these variables
-on every request to streamline the handling of the superglobals. The corresponding methods ``GeneralUtility::_GET()``, ``GeneralUtility::_GP()`` and ``GeneralUtility::_POST()`` have been changed to not strip off slashes anymore.
-
-Since the PHP option was completely removed, TYPO3 is not adding slashes anymore, and also does not strip
-the slashes anymore when using the methods within GeneralUtility.
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-68758-CommandControllersAllowedInSubfolders.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-68758-CommandControllersAllowedInSubfolders.rst
deleted file mode 100644 (file)
index 2dd63fd..0000000
+++ /dev/null
@@ -1,14 +0,0 @@
-=============================================================
-Important: #68758 - Command controllers allowed in subfolders
-=============================================================
-
-Description
-===========
-
-Extbase command controllers can now reside in arbitary subfolders within the ``Command`` folder. This allows for better grouping and namespacing of commands.
-
-Given a command controller resides in ``my_ext/Classes/Command/Hello/WorldCommandController.php``, it can be invoked like this:
-
-.. code-block:: shell
-
-       typo3/cli_dispatch.sh extbase my_ext:hello:world <arguments>
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-68917-UpdateJQueryTo2x.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-68917-UpdateJQueryTo2x.rst
deleted file mode 100644 (file)
index 42b04e3..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-=========================================
-Important: #68917 - Updated jQuery to 2.x
-=========================================
-
-Description
-===========
-
-With the step from jQuery 1.x to 2.x support for older browsers and "dirty workarounds"
-were dropped. Since TYPO3 CMS doesn't support "older" browsers (IE < 9) anymore, jQuery
-was updated from 1.x to 2.x. For extensions that ran fine with an up-to-date 1.x-version
-that shouldn't really make much difference. There might however be edge-cases where
-extension-authors might need to adapt their jQuery scripts for 2.x.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69084-AddingExtbaseObjectsWithNOTNULLColumnsHasChanged.rst
deleted file mode 100644 (file)
index dba50ef..0000000
+++ /dev/null
@@ -1,41 +0,0 @@
-============================================================================
-Important: #69084 - Adding Extbase Objects with NOT NULL columns has changed
-============================================================================
-
-Description
-===========
-
-To better support databases that don't silently convert NULL values to
-an empty default value for database column defined as NOT NULL the
-`├ČnsertObject()`` method tries to determine the appropriate value for
-a column.
-
-Extbase object properties that have a value of NULL will be skipped when
-preparing the record to enable the DBMS default value to be used. This
-behavior has not changed compared to TYPO3 CMS 7.4 but allows proper
-support for DBMS that are strict about NOT NULL columns by defining
-appropriate default values for properties in the models.
-
-
-Example database schema:
-
-.. code-block:: sql
-
-       CREATE TABLE tx_blogexample_domain_model_blog (
-               title varchar(255) DEFAULT '' NOT NULL
-       );
-
-Example model definition:
-
-.. code-block:: php
-
-       class Blog extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
-
-               /**
-                * The blog's title.
-                *
-                * @var string
-                */
-               protected $title = '';
-
-       }
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst
deleted file mode 100644 (file)
index 44e1495..0000000
+++ /dev/null
@@ -1,13 +0,0 @@
-=====================================================================
-Important: #69137 - Link Wizard popup width and height fields removed
-=====================================================================
-
-Description
-===========
-
-Opening links in popups with width/height definition is very rare usecase nowadays.
-
-For user convenience, to have less clutter in the UI, the width and height fields have been removed.
-The editor is not able to select a width and height anymore, it can still be entered manually though.
-
-The RTE option ``buttons.link.popupSelector.disabled`` has no effect anymore.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69531-RemoveSpriteManagerIconViewHelper.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69531-RemoveSpriteManagerIconViewHelper.rst
deleted file mode 100644 (file)
index 9521e70..0000000
+++ /dev/null
@@ -1,9 +0,0 @@
-======================================================
-Important: #69531 - Remove SpriteManagerIconViewHelper
-======================================================
-
-Description
-===========
-
-The ``\TYPO3\CMS\Backend\ViewHelpers\SpriteManagerIconViewHelper`` is not used anymore and has been removed.
-Use ``\TYPO3\CMS\Core\ViewHelpers\IconViewHelper`` instead
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69736-SelectOptionIconsInOptionTagsRemoved.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69736-SelectOptionIconsInOptionTagsRemoved.rst
deleted file mode 100644 (file)
index c0c1cd1..0000000
+++ /dev/null
@@ -1,10 +0,0 @@
-===========================================================
-Important: #69736 - Select option iconsInOptionTags removed
-===========================================================
-
-Description
-===========
-
-The option ``iconsInOptionTags`` of TCA ``select`` fields was removed due to little support in browsers.
-
-The usage of this option results in a deprecation log entry and is automatically removed in TCA tables during bootstrap.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst
deleted file mode 100644 (file)
index e101527..0000000
+++ /dev/null
@@ -1,27 +0,0 @@
-====================================================================
-Important: #69846 - Have eIDs with PSR-7 without ControllerInterface
-====================================================================
-
-Description
-===========
-
-In order to allow the same logic as with the routing and the direct information which method to call, the
-ControllerInterface is not mandatory anymore.
-
-Remove the ``implements ControllerInterface`` instruction in the affected class. The former ``processRequest``
-method may be changed to:
-
-.. code-block:: php
-
-       public function anyMethodNameYouLike(ServerRequestInterface $request, \Psr\Http\Message\ResponseInterface $response) {
-       }
-
-Please note that the ``$response`` object is now passed into the method directly, thus you must not create a new object
-by ``$response = GeneralUtility::makeInstance(Response::class);``
-
-The eID_include registration in :file:`ext_localconf.php` must be changed in such case to
-
-.. code-block:: php
-
-       $GLOBALS['TYPO3_CONF_VARS']['FE']['eID_include']['identifier'] = \Foo\Bar::class . '::anyMethodNameYouLike';
-
diff --git a/typo3/sysext/core/Documentation/Changelog/master/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst b/typo3/sysext/core/Documentation/Changelog/master/Important-69909-FAL-basedDatabaseFieldsMovedToInteger.rst
deleted file mode 100644 (file)
index 52fcfbd..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-==============================================================
-Important: #69909 - FAL-based Database Fields moved to integer
-==============================================================
-
-Description
-===========
-
-The FAL-related fields in the database tables ``pages``, ``pages_language_overlay`` and ``tt_content`` that contained
-a comma-separated list of paths to files were migrated at 6.2 with the shipped update wizards to IRRE fields.
-The database fields ``pages.media``, ``pages_language_overlay.media``, ``tt_content.image`` and ``tt_content.media``
-now only contain numeric values, which are handled by the DataHandler and the Reference Index, holding
-the number of references. The database fields are now changed to be only int fields, instead fields of type ``text``.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Deprecation-69736-SelectOptionIconsInOptionTagsRemoved.rst b/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Deprecation-69736-SelectOptionIconsInOptionTagsRemoved.rst
new file mode 100644 (file)
index 0000000..f22b735
--- /dev/null
@@ -0,0 +1,28 @@
+===========================================================
+Important: #69736 - Select option iconsInOptionTags removed
+===========================================================
+
+Description
+===========
+
+The option ``iconsInOptionTags`` of TCA ``select`` fields has been removed due
+to little support in browsers.
+
+
+Impact
+======
+
+The usage of this option triggers a deprecation log entry and is automatically
+removed in TCA tables during bootstrap.
+
+
+Affected Installations
+======================
+
+Any ``TCA`` configuration using ``iconsInOptionTags``.
+
+
+Migration
+=========
+
+Remove usage of this option.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst b/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69137-LinkWizardPopupWidthAndHeightFieldsRemoved.rst
new file mode 100644 (file)
index 0000000..2f5dd1d
--- /dev/null
@@ -0,0 +1,14 @@
+=====================================================================
+Important: #69137 - Link Wizard popup width and height fields removed
+=====================================================================
+
+Description
+===========
+
+Opening links in popups with width/height definition is a very rare usecase nowadays.
+
+For user convenience and to have less clutter in the UI, the width and height
+fields have been removed.
+The editor is not able to select a width and height anymore, it can still be entered manually though.
+
+The RTE option ``buttons.link.popupSelector.disabled`` has no effect anymore.
\ No newline at end of file
diff --git a/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst b/typo3/sysext/core/Documentation/Changelog/master/needs_to_be_merged_into_github/Important-69846-HaveEIDsWithPSR-7WithoutControllerInterface.rst
new file mode 100644 (file)
index 0000000..636c99c
--- /dev/null
@@ -0,0 +1,27 @@
+====================================================================
+Important: #69846 - Have eIDs with PSR-7 without ControllerInterface
+====================================================================
+
+Description
+===========
+
+In order to allow the same logic as with the routing and the direct information
+which method to call, implementing ``ControllerInterface`` is not mandatory anymore.
+
+Remove the ``implements ControllerInterface`` instruction in the affected class. The former ``processRequest``
+method may (and should) be changed to:
+
+.. code-block:: php
+
+       public function anyMethodNameYouLike(ServerRequestInterface $request, \Psr\Http\Message\ResponseInterface $response) {
+       }
+
+Please note that the ``$response`` object is now passed into the method directly, thus you must not create a new object
+by ``$response = GeneralUtility::makeInstance(Response::class);`` any more.
+
+The eID_include registration in :file:`ext_localconf.php` must be changed in such case to
+
+.. code-block:: php
+
+       $GLOBALS['TYPO3_CONF_VARS']['FE']['eID_include']['identifier'] = \Foo\Bar::class . '::anyMethodNameYouLike';
+