Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

TYPO3.CMS/Releases/7.3/Deprecation

From TYPO3Wiki
Jump to: navigation, search

Contents

Deprecation: #61829 - Deprecate config.classFile DBAL option

Description

The DBAL option config.classFile has been marked for deprecation, and will be removed with TYPO3 CMS 8.

Impact

Using config.classFile option will throw a deprecation message.

Affected Installations

Installations which use a user-defined DBAL database-handler.

Migration

Load the class using the autoloader.

Deprecation: #63453 - Deprecate renderMode attribute of FlashMessagesViewHelper

Description

Deprecated renderMode in favor of a flexible deferred rendering of flash messages in the Fluid template. This means that flash messages should no longer contain HTML, but the HTML output can and should be adjusted in the Fluid template.

Impact

Using renderMode on FlashMessage output will throw a deprecation warning.

Affected Installations

All instances using the renderMode attribute in FlashMessage output.

Migration

Adjust flash messages to contain only plain text and remove the renderMode attribute in the output Templates.

<f:flashMessages as="flashMessages">
    <ul class="typo3-flashMessages">
        <f:for each="{flashMessages}" as="flashMessage">
            <li class="alert {flashMessage.class}">
                <h4>{flashMessage.title}</h4>
                {flashMessage.message}
            </li>
        </f:for>
    </ul>
</f:flashMessages>

Deprecation: #63735 - Deprecate DataHandler->checkValue_*-methods

Description

The following internal but currently public functions have been marked as deprecated:

  • DataHandler->checkValue_text
  • DataHandler->checkValue_input
  • DataHandler->checkValue_check
  • DataHandler->checkValue_radio
  • DataHandler->checkValue_group_select
  • DataHandler->checkValue_flex

Impact

Using these functions will throw a deprecation message.

Migration

These functions are internal and should not be used outside of the core.

Deprecation: #65344 - typo3conf/extTables.php deprecated

Description

The file typo3conf/extTables.php which could be used for local TCA modifications has been marked as deprecated.

Setting $GLOBALS['TYPO3_CONF_VARS']['DB']['extTablesDefinitionScript'] together with the constant TYPO3_extTableDef_script are deprecated and should not be used any longer.

Impact

The options and files are typically used for "poor man" $GLOBALS['TCA'] overrides. This is discouraged and shouldn't be used any longer.

Migration

There are two options to migrate away from typo3conf/extTables.php usage, the first one should be preferred:

  • It is good practice to have a project / site specific extension that contains templates, TypoScript and other stuff. Create one or more dedicated extensions and use TCA overrides to apply the desired modifications. Something like $GLOBALS['TCA']['pages']['ctrl']['hideAtCopy'] = FALSE; should be moved from typo3conf/extTables.php to typo3conf/ext/<your_extension>/Configuration/TCA/Overrides/pages.php.
  • Slot the signal tcaIsBeingBuilt that is emitted in ExtensionManagementUtility.php.

Deprecation: #66789 - options deprecated in CshViewHelper

Description

The two unused options iconOnly and styleAttributes have been marked as deprecated.

Impact

The options in the CshViewHelper have been marked as deprecated and will be removed in TYPO3 CMS 8.

Migration

Remove the options where the CshViewHelper is used.

Deprecation: #66823 - Deprecate Extbase ExtensionUtility->configureModule method

Description

The method TYPO3\CMS\Extbase\Utility\ExtensionUtility->configureModule() has been marked for deprecation, and will be removed with TYPO3 CMS 8.

Impact

Calling TYPO3\CMS\Extbase\Utility\ExtensionUtility->configureModule() will throw a deprecation message.

Affected Installations

Any installation with a third-party extension making use of ExtensionUtility->configureModule() directly inside e.g. ext_tables.php.

Migration

Use the 1:1 functionality in TYPO3\CMS\Core\Utility\ExtensionManagementUtility->configureModule() directly.

Deprecation: #66905 - Deprecate uc->classicPageEditMode and editRegularContentFromId option

Description

The BE-User uc option "classicPageEditMode" which was used prior to TYPO3 CMS 4.0 has been removed some time ago. The functionality editRegularContentFromId which was then triggered in EditDocumentController has been marked for deprecation.

Impact

Any direct calls using editRegularContentFromId via GET parameter or calling editRegularContentFromId() directly from a third-party extension will trigger a deprecation message.

Affected Installations

Any installation using third-party code to restore the old behaviour.

Migration

Remove calls to the functionality.

Deprecation: #66906 - Functionality for png_to_gif conversion

Description

The global option $TYPO3_CONF_VARS[GFX][png_to_gif] has been removed. The according functionality within GraphicalFunctions->pngToGifByImagemagick() has been marked for deprecation.

Impact

Any direct calls using pngToGifByImagemagick() will now throw a deprecation warning. All installations having the option png_to_gif activated will now always show png files instead of gifs when resizing PNG images in the TYPO3 Frontend.

Affected Installations

Any installation having png_to_gif activated or having third-party extensions calling GraphicalFunctions->pngToGifByImagemagick() directly.

Migration

Remove calls to the functionality, as the result will be a PNG. If GIF conversion is needed, the functionality needs to be implemented in a custom FAL Processor inside an extension.

Deprecation: #67029 - Deprecate page.bgImg option

Description

The option page.bgImg has been marked for deprecation and will be removed with TYPO3 CMS 8.

Impact

Using page.bgImg will throw a deprecation message.

Affected Installations

Any installation which uses this TypoScript option.

Migration

Use CSS to set a background on the body.

Deprecation: #37171 - Deprecate t3editor->isEnabled()

Description

TYPO3CMST3editorT3editor->isEnabled() has been marked as deprecated and should not be called anymore.

Impact

The method isEnabled() always returns TRUE and will be removed with TYPO3 CMS 8.

Affected Installations

Any installation using third-party code that works with t3editor and calls isEnabled().

Migration

The method call should be removed.

Deprecation: #65290 - TCA changes

Description

Some details in the main Table Configuration Array, TCA, known on PHP side as $GLOBALS['TCA'] changed.

Simplified types showitem configuration using columnsOverrides

If a field is configured as type in TCA ctrl section, the value of this database field determines which fields are shown if opening a record in the backend. The shown fields are configured in TCA section types showitem and is a comma separated list of field names. Each field name can have 4 additional semicolon separated options, from which the last two have been dropped and moved:

Before:

'types' => array(
    'aType' => array(
        'showitem' => 'aField,anotherField;otherLabel;aPalette;special:configuration;a-style-indicator,thirdField',
    ),
),

If a record is opened that has the type field set to aType, it would show the three fields aField, anotherField and thirdField. The second field anotherField has further configuration and shows a different label, adds an additional palette below the field referenced as aPalette, adds special:configuration as special configuration and changes the style with its last field. The last two parameters were changed: The style configuration is obsolete since 7.1 and has been removed. The special configuration is identical to the defaultExtras field of a columns field section and can be added with this name in a newly introduced array columnsOverrides that is parallel to showitem of this type:

'types' => array(
    'aType' => array(
        'showitem' => 'aField,anotherField;otherLabel;aPalette,thirdField',
        'columnsOverrides' => array(
            'anotherField' => array(
                'defaultExtras' => 'special:configuration',
            ),
        ),
    ),
),

So, the 4th parameter has been transferred to columnsOverrides while the 5th parameter has been removed.

This change enables more flexible overrides of column configuration based on a given type. This is currently used in FormEngine only, so only view-related parameters must be overwritten here. It is not supported to change data handling related parameters like type=text to type=select or similar, but it is possible to change for example the number of rows shown in a type=text column field:

'types' => array(
    'aType' => array(
        'showitem' => 'aField,anotherField;otherLabel;aPalette,thirdField',
        'columnsOverrides' => array(
            'anotherField' => array(
                'config' => array(
                    'rows' => 42,
                ),
            ),
        ),
    ),
),

It is also possible to remove a given configuration from the default configuration using the __UNSET keyword. Again, this is only supported for view-related configuration options. Changing for instance an eval option may cripple the PHP-side validation done by the DataHandler that checks and stores values.

'types' => array(
    'aType' => array(
        'columnsOverrides' => array(
            'bodytext' => array(
                'config' => array(
                    'rows' => '__UNSET',
                ),
            ),
        ),
    ),
),

The above example would remove the rows parameter of the bodytext field columns configuration, so a default value would be used instead.

Simplified t3editor configuration

t3editor is no longer configured and enabled as wizard.

Configuration for a column field looked like this before:

'bodytext' => array(
    'config' => array(
        'type' => 'text',
        'rows' => 42,
        'wizards' => array(
            't3editor' => array(
                'type' => 'userFunc',
                'userFunc' => 'TYPO3\CMS\T3editor\FormWizard->main',
                'title' => 't3editor',
                'icon' => 'wizard_table.gif',
                'module' => array(
                    'name' => 'wizard_table'
                ),
                'params' => array(
                    'format' => 'html',
                    'style' => 'width:98%; height: 60%;'
                ),
            ),
        ),
    ),
),

The new configuration is simplified to:

'bodytext' => array(
    'exclude' => 1,
    'label' => 'aLabel',
    'config' => array(
        'type' => 'text',
        'renderType' => 't3editor',
        'format' => 'html',
        'rows' => 42,
    ),
),

In case t3editor was only enabled for a specific type, this was previously done with enableByTypeConfig within the wizard configuration and wizards[theWizardName] as the 4th semicolon separated parameter of the according field in section showitem of the type where t3editor should be enabled. Old configuration was:

'columns' => array(
    'bodytext' => array(
        'exclude' => 1,
        'label' => 'aLabel',
        'config' => array(
            'type' => 'text',
            'rows' => 42,
            'wizards' => array(
                't3editorHtml' => array(
                    'type' => 'userFunc',
                    'userFunc' => 'TYPO3\CMS\T3editor\FormWizard->main',
                    'enableByTypeConfig' => 1,
                    'title' => 't3editor',
                    'icon' => 'wizard_table.gif',
                    'module' => array(
                        'name' => 'wizard_table'
                    ),
                    'params' => array(
                        'format' => 'html',
                        'style' => 'width:98%; height: 60%;'
                    ),
                ),
            ),
        ),
    ),
),
'types' => array(
    'firstType' => array(
        'showitem' => 'bodytext;;;wizards[t3editorHtml]',
    ),
),

This now uses the new columnsOverrides feature parallel to showitem:

'columns' => array(
    'bodytext' => array(
        'config' => array(
            'type' => 'text',
            'rows' => 42,
        ),
    ),
),
'types' => array(
    'firstType' => array(
        'showitem' => 'bodytext',
        'columnsOverrides' => array(
            'bodytext' => array(
                'config' => array(
                    'format' => 'typoscript',
                    'renderType' => 't3editor',
                ),
            ),
        ),
    ),

Impact

TCA is automatically migrated during bootstrap of the TYPO3 core and the result is cached. In case TCA is still registered or changed in extensions with entries in ext_tables.php, an automatic migration of this part of TCA is only triggered if extension compatibility6 is loaded. This has a performance penalty since the migration in compatibility6 is then done on every frontend and backend script call and is not cached. It is strongly advised to move remaining TCA changes from ext_tables.php to Configuration/TCA or Configuration/TCA/Overrides of the according extension and to unload compatibility6.

Migration

An automatic migration is in place. It throws deprecation log entries in case TCA had to be changed on the fly. The migration logs give hints on what exactly has changed and the final TCA can be inspected in the backend configuration module. If outdated flexforms are used, the migration is done within the FormEngine class construct on the fly and will throw deprecation warnings as soon as a record with outdated TCA flexforms is opened in the backend.

Typical migration of the 4th showitem parameter involves moving a RTE configuration like richtext:rte_transform[flag=rte_enabled|mode=ts_css] or the type=text flags nowrap, fixed-font and enabled-tab to columnsOverrides.

Deprecation: #67297 - MySQL / DBMS field type conversion

Description

The DbalDatabaseConnection class provides generic functions that translate between native MySQL field types and ADOdb meta field types. The generic functions MySQLActualType() and MySQLMetaType have been marked as deprecated and should not be used any longer.

Impact

Although these are public functions the use was probably limited to the DBAL Extension. If used however, they will trigger a deprecation message.

Migration

Use the functions getNativeFieldType() and getMetaFieldType() provided by the DBMS specifics class.

Deprecation: #67402 - Extbase AbstractDomainObject __wakeup()

Description

Method __wakeup() has been marked as deprecated in TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject.

Affected Installations

An instance is affected if own domain objects extending AbstractDomainObject implement __wakeup() and call parent::__wakeup() as documented.

Migration

Remove calls to parent::__wakeup() from own __wakeup() implementations.