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

TYPO3.CMS/Releases/7.5/Deprecation

From TYPO3Wiki
Jump to: navigation, search

Contents

Deprecation: #55419 - Streamline file conflict mode handling

Description

Conflicts in file names and folder names when uploading new files or creating new folders are now handled uniformly with constants within the core. Therefore a new enumeration has been introduced to provide the available values: \TYPO3\CMS\Core\Resource\DuplicationBehavior.

Provided constants are
 ;* DuplicationBehavior::CANCEL
  • DuplicationBehavior::REPLACE
  • DuplicationBehavior::RENAME
Before this change there were two sets of strings used to define the behavior upon conflicts.
 ;* Set1: cancel, replace and changeName
Set2
  • cancel, overrideExistingFile and renameNewFile

As they are redundant they are now represented by a new set of constants:

* CANCEL, REPLACE and RENAME

All usages of strings of the former sets have been replaced with their counterparts from the new set. In the enumeration the former values have been mapped to the new values and marked for deprecation.

Impact

Using changeName, overrideExistingFile or renameNewFile for file conflict handling will result in a deprecation log entry.

Affected Installations

All third party code that calls one of the listed methods with $conflictMode either set to changeName, overrideExistingFile or renameNewFile.

Migration

Use the provided enumeration \TYPO3\CMS\Core\Resource\DuplicationBehavior instead.

Example

$resourceStorage->copyFile($file, $targetFolder, 'target-file-name', DuplicationBehavior::RENAME);

Deprecation: #66588 - POST Data in selectviewhelper should have higher priority than "value" value

Description

Submitted form data has precedence over value arguments.

This adjusts the behavior of all Form ViewHelpers so that any submitted value is redisplayed even if a "value" argument has been specified.

The issue with this, however, was that upon re-display of the form due to property-mapping or validation errors the value argument had precedence over the previously submitted value.

Impact

This is a breaking change if you expect the previous behavior of form ViewHelpers always being pre-populated with the specified value attribute / bound object property even when re-displaying the form upon validation errors.

Besides this the change marks AbstractFormFieldViewHelper::getValue() as deprecated. If you call that method in your custom ViewHelpers you should use AbstractFormFieldViewHelper::getValueAttribute() instead and call AbstractFormFieldViewHelper::addAdditionalIdentityPropertiesIfNeeded() explicitly if the ViewHelper might be bound to (sub)entities.

The default usage of getValueAttribute() did not respect the submitted form data, because not every viewhelper needs this feature. But you can enable the usage of the form data by setting AbstractFormFieldViewHelper::respectSubmittedDataValue to TRUE.

Deprecation: #68128 - GeneralUtility slash-related methods

Description

The following methods within GeneralUtility used to add or remove slashes have been marked as deprecated.

GeneralUtility::addSlashesOnArray()
GeneralUtility::stripSlashesOnArray()
GeneralUtility::slashArray()

Impact

Any usage of these methods will trigger a deprecation log entry.

Affected Installations

Extensions that call these PHP methods directly.

Migration

Remove usage of these methods from custom extensions.

Deprecation: #68760 - Deprecate class ModuleSettings

Description

In older TYPO3 versions t3lib_modSettings (as ModuleSettings class was called before) was used to save the current settings of backend modules. This kind of settings is nowadays stored in backend users uc array. For that reason ModuleSettings is now marked for removal in TYPO3 CMS 8.

Impact

Using ModuleSettings will trigger a deprecation log entry.

Affected Installations

Any TYPO3 installation with custom extensions using this class and its methods.

Migration

Remove usage of this class from custom extensions.

Deprecation: #68804 - CLI-related constants and methods

Description

Logic regarding regular CLI-based scripts with the CLIkey option has been moved into the CliRequestHandler.

Therefore, the following method has been marked as deprecated:

BackendUserAuthentication->checkCLIuser()

Additionally, the following constants and global parameters have been marked for deprecation in CLI context.

const TYPO3_cliKey
const TYPO3_cliInclude
$GLOBALS['MCONF']['name']
$GLOBALS['temp_cliScriptPath']
$GLOBALS['temp_cliKey']

The method, constants and variables will be removed in TYPO3 CMS 8.

Impact

Calling BackendUserAuthentication->checkCLIuser() directly will now trigger a deprecation log entry.

Affected Installations

Installations with custom entry points in a CLI environment that make use of the method, constants or variables above.

Migration

Use the native $_SERVER['argv'] or the given Input object directly in your code to detect the current CLI-relevant data.

Deprecation: #68860 - Deprecate SelectImage.initEventHandler

Description

Removes the calls of SelectImage.initEventHandler method. This was limited to WebKit UserAgents and the provided implementation of require was wrong, so that the EventListener was not registered at all. Nevertheless the functionality of drag and drop is not broken without the initEventHandler.

Impact

Throws console log with deprecation message.

Affected Installations

All installations calling SelectImage.initEventHandler.

Migration

Remove the call of SelectImage.initEventHandler.

Deprecation: #69028 - RelationHandler convertPosNeg()

Description

Method convertPosNeg() of class TYPO3\CMS\Core\Database\RelationHandler has been marked as deprecated.

Impact

The method should not be used any longer and will be removed with TYPO3 CMS 8.

Affected Installations

The method is rather internal and relatively unlikely to be used by third party modules. Searching for the string convertPosNeg may reveal possible usages.

Migration

The method was used together with the dropped neg_foreign_table setting for TCA select fields. If this functionality is still needed, the method could be copied over to the third party application that uses it.

Deprecation: #69057 - Deprecate IconUtility and move methods into IconFactory

Description

The IconUtility class will be removed with TYPO3 CMS 8. All public methods of this class have been marked as deprecated:

  • IconUtility::skinImg()
  • IconUtility::getIcon()
  • IconUtility::getSpriteIcon()
  • IconUtility::getSpriteIconForFile()
  • IconUtility::getSpriteIconForRecord()
  • IconUtility::getSpriteIconForResource()
  • IconUtility::getSpriteIconClasses()

The PageTSConfig setting mod.wizards.newContentElement.wizardItems.*.elements.*.icon also has been marked as deprecated.

The IconUtilityOverrideResourceIconHookInterface interface will be removed with TYPO3 CMS 8.

Impact

Any usage of these methods will trigger a deprecation log entry.

Affected Installations

Extensions that call these PHP methods directly. Extensions that register own content elements with an icon for the new content element wizard.

Migration

Use the new IconFactory class instead of IconUtility.

For content element wizard register your icon in IconRegistry::registerIcon() and use the new setting: mod.wizards.newContentElement.wizardItems.*.elements.*.iconIdentifier

Deprecation: #69078 - TemplateService::$tempPath

Description

The \TYPO3\CMS\Core\TypoScript\TemplateService::$tempPath member variable is not used anymore inside the core, therefore it has been marked as deprecated and will be removed with CMS 8.

Affected Installations

Any installation using third party code, which accesses TemplateService::$tempPath.

Migration

Remove any reference to TemplateService::$tempPath.

Deprecation: #69262 - Move marker substitution functionality to own class

Description

The marker substitution functionality has been moved from core/Classes/Html/HtmlParser.php to it's own class core/Classes/Service/MarkerBasedTemplateService.php

The following methods within HtmlParser have been marked as deprecated.

HtmlParser::getSubpart()
HtmlParser::substituteSubpart()
HtmlParser::substituteSubpartArray()
HtmlParser::substituteMarker()
HtmlParser::substituteMarkerArray()
HtmlParser::substituteMarkerAndSubpartArrayRecursive()

Impact

Any usage of these methods will trigger a deprecation log entry.

Affected Installations

Extensions that call these PHP methods directly.

Migration

Change the use statement from TYPO3\CMS\Core\Html\HtmlParser to TYPO3\CMS\Core\Service\MarkerBasedTemplateService and create an instance of this service class. The methods are not static anymore, but named as before.

$templateService = GeneralUtility::makeInstance(MarkerBasedTemplateService::class);
$templateService->getSubpart()
$templateService->substituteSubpart()
$templateService->substituteSubpartArray()
$templateService->substituteMarker()
$templateService->substituteMarkerArray()
$templateService->substituteMarkerAndSubpartArrayRecursive()

Deprecation: #69269 - Deprecate BackendUtility::getPathType_web_nonweb

Description

Method getPathType_web_nonweb() of class TYPO3\CMS\Backend\Utility\BackendUtility has been marked as deprecated.

Impact

The method should not be used any longer and will be removed with TYPO3 CMS 8.

Affected Installations

The method is unused in the core since at least TYPO3 CMS 6.2. Searching for the string getPathType_web_nonweb may reveal possible usages.

Migration

Use path functions from TYPO3\CMS\Core\Utility\PathUtility.

Deprecation: #69371 - Form element IMAGEBUTTON

Description

Form element IMAGEBUTTON of class TYPO3\CMS\Form\Domain\Model\Element\ImagebuttonElement has been marked as deprecated. The related attribute scr of class TYPO3\CMS\Form\Domain\Model\Attribute\SrcAttribute has been marked as deprecated.

Impact

The element IMAGEBUTTON should not be used any longer because it is outdated and will be removed with TYPO3 CMS 8.

Affected Installations

All installations which use the form element IMAGEBUTTON. All installations which use a form typoscript like this:

10 = IMAGEBUTTON
10 {
    label = Image button
    src = /typo3conf/ext/someExt/some/picture.png
    value = value
}

Migration

No Migration is planned.

Deprecation: #69401 - Adopt form to support the Extbase/ Fluid MVC stack

Description

Form is now based on Extbase/ Fluid for frontend rendering. Therefore all TypoScript based layout settings have been marked as deprecated. Using the following code is not recommended anymore:

10 = FORM
10 {
    layout {
        containerWrap = <div><elements /></div>
        elementWrap = <div><element /></div>
    }
}

Impact

All .layout TypoScript properties should not be used anymore. Backward compatibility algorithms will be removed with TYPO3 CMS 8.

Affected Installations

All installations using .layout TypoScript properties.

Migration

Move away from .layout TypoScript properties and move to Fluid based templating.

Deprecation: #69535 - Deprecate TYPO3CMSFluidViewHelpersBeButtonsIconViewHelper

Description

\TYPO3\CMS\Fluid\ViewHelpers\Be\Buttons\IconViewHelper has been marked as deprecated.

Impact

The viewhelper should not be used any longer and will be removed with TYPO3 CMS 8.

Affected Installations

Extensions which use the viewhelper.

Migration

Use the core icon viewhelper \TYPO3\CMS\Core\ViewHelpers\IconViewHelper instead.

Example: Instead of <f:be.buttons.icon icon="apps-pagetree-collapse" /> use <core:icon identifier="apps-pagetree-collapse" />

Deprecation: #69561 - Replace sprite icons with IconFactory in ContextMenu

Description

The \TYPO3\CMS\Backend\ContextMenu\ContextMenuAction::$class member variable is not used anymore inside Core, therefore it has been marked as deprecated and will be removed with CMS 8.

Affected Installations

Any installation using third party code, which accesses ContextMenuAction::$class.

Migration

Remove any reference to ContextMenuAction::$class.

Deprecation: #69562 - Deprecate helper methods for redundant CSRF protection

Description

The method BackendUtility::getUrlToken has been introduced as shortcut to protect data manipulating entry points tce_db.php tce_file.php and alt_doc.php from CSRF attacks. These entry points have been replaced with proper modules or routing, which are CSRF protected by default. With this BackendUtility::getUrlToken is not needed anymore and therefore has been marked as deprecated.

Impact

Third party code using BackendUtility::getUrlToken will trigger deprecation log entries.

Affected Installations

Extensions using the above code.

Migration

These method calls can safely be removed, when generating links to former entry points tce_db.php tce_file.php and alt_doc.php with the API method calls : BackendUtility::getModuleUrl('tce_db'), BackendUtility::getModuleUrl('tce_file') or BackendUtility::getModuleUrl('record_edit').

Deprecation: #69568 - Various FormEngine related methods

Description

The following methods have been marked as deprecated and should not no longer be used:

  • BackendUtility::getExcludeFields()
  • BackendUtility::getExplicitAuthFieldValues()
  • BackendUtility::getSystemLanguages()
  • BackendUtility::getRegisteredFlexForms()
  • BackendUtility::exec_foreign_table_where_query()
  • BackendUtility::replaceMarkersInWhereClause()

Impact

Using those methods will trigger a deprecation log entry.

Affected Installations

The impact is rather low in general since those methods were mostly internal in the first place and only used within FormEngine scope. It is unlikely extensions are affected by this change.

Migration

If still used, extensions should switch to own solutions for those methods.

Deprecation: #69705 - Add unified refresh icon

Description

The icon actions-system-refresh has been marked as deprecated in TYPO3\CMS\Core\Imaging\IconRegistry and will be removed with TYPO3 CMS 8. All requests for actions-system-refresh will now show actions-refresh.

Impact

Using IconUtility or IconFactory to fetch the icon actions-system-refresh will trigger a deprecation log entry.

Affected Installations

Installations with third party extensions that use the icon actions-system-refresh.

Migration

Use the icon actions-refresh instead.

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.

Deprecation: #69754 - Deprecate relative path to extension directory and using filename only in TCA ctrl iconfile

Description

  • Using relative paths to refer to the extension directory for iconfiles in TCA['ctrl']['iconfile'] has been marked as deprecated.
  • Using filenames only to refer to an iconfile in TCA['ctrl'] has been marked as deprecated.

Impact

  • TCA definitions in TCA['ctrl']['iconfile'] containing '../typo3conf/ext/' or calls to \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extRelPath() will trigger a deprecation log entry.
  • TCA definitions in TCA['ctrl']['iconfile'] containing a filename only will trigger a deprecation log entry.

Affected Installations

Any installation with extensions defining TCA['ctrl']['iconfile'] by using ../typo3conf/ext/ or only a filename.

Migration

Relative paths

Use EXT: instead of relative path '../typo3conf/ext/' or \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extRelPath(), e.g.

'ctrl' => array(
    'iconfile' => \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extRelPath('my_extension') . 'Resources/Public/Icons/image.png'
),

has to be migrated to

'ctrl' => array(
    'iconfile' => 'EXT:my_extension/Resources/Public/Icons/image.png'
),

Filename only

Use a full absolute path or an EXT: definition instead of a filename only:

'ctrl' => array(
    'iconfile' => '_icon_ftp.gif'
),

has to be migrated to

'ctrl' => array(
    'iconfile' => 'EXT:t3skin/icons/gfx/i/_icon_ftp.gif'
),

or

'ctrl' => array(
    // You can use absolute paths (to your web root folder) to the icons but
    // it is discouraged to do so as these icons belong to an extension they
    // should also be stored in this extension
    'iconfile' => '/fileadmin/icons/_icon_ftp.gif'
),

Deprecation: #69938 - HIDE_L10N_SIBLINGS FlexFormdisplayCond

Description

The flexform HIDE_L10N_SIBLINGS display condition has been marked as deprecated and will be removed with CMS 8. The condition could only be used with translation mode langChildren=1 to only show the field for the default language.

Impact

FlexForms using this condition will show the field separately for each language again.