DeepL Base

DeepL Base 

Extension key

deepl_base

Package name

web-vision/deepl-base

Version

main

Language

en

Copyright

2018

Author

web-vision GmbH & Contributors

Rendered

Mon, 27 Apr 2026 08:51:42 +0000

License

This document is published under the Open Publication License.

This extension provides basic and shared functionality required by multiple extensions and includes:

  • DEPRECATED Replaces the PageLayout module localization wizard for TYPO3 v13 to a dynamic and extensible way keeping the look and feel from TYPO3 v13 native wizard. This includes dispatching several PSR-14 events to allow other extension to register custom translation modes, for example EXT:deepltranslate_core or EXT:deepl_write.

    TYPO3 v14 introduced a new Localization Handler allowing extensions to extend that in a more proper way and incooperate better with the completely revamped localization handling and therefore the implementation is untouched for it.

    Select `Translate with DeepL` localization mode in TYPo3 v13
  • \WebVision\Deepl\Base\Imaging\IconProvider\DeeplBaseSvgIconProvider to allow providing SVG Icons for action not coming from a SVG Sprite with icon-color support (light and dark mode) .

ChangeLog 

Every change to the web-vision/deepl-base extension is documented here.

Breaking: Removed TYPO3 v12 support 

Description 

Support for TYPO3 v12 has been removed for 2.x based on our dual TYPO3 core version support per major version as casual support matrix.

This includes removing code paths and configurations only required for TYPO3 v12.

Impact 

TYPO3 v12 or older instances cannot update to the 2.x version and are required to upgrade TYPO3 to be able to install the next version of the EXT:deepltranslate_core and related extensions/addons based on this version.

Extension cannot be installed in that version but does not break otherwise.

Affected installations 

TYPO3 v12 or older instances with EXT:deepl_base version 1.x.

Migration 

Upgrade TYPO3 to supported version for 2.x beforehand or in the same step.

Feature: Added DeeplBaseSvgIconProvider 

Description 

The custom \WebVision\Deepl\Base\Imaging\IconProvider\DeeplBaseSvgIconProvider is added to allow registration and rendering of color mode aware SVG icons, for example as action icons on buttons.

The \TYPO3\CMS\Core\Imaging\IconProvider\SvgIconProvider lacks this ability, because it renders <img /> tags for the inline markup usage and \TYPO3\CMS\Core\Imaging\IconProvider\SvgSpriteIconProvider is not usable in all cases.

Example registration 

EXT:my_ext/Configuration/Icons.php 
<?php

declare(strict_types=1);

use WebVision\Deepl\Base\Imaging\IconProvider\DeeplBaseSvgIconProvider;

return [
    'myext-color-mode-aware-icon' => [
        'provider' => DeeplBaseSvgIconProvider::class,
        'source' => 'EXT:my_ext/Resources/Public/Icons/color-mode-aware-icon.svg',
    ],
];
Copied!

Impact 

Allows the registration of color mode aware SVG icons.

Feature: Added TYPO3 v14 Support 

Description 

TYPO3 v14.3.* has been added coming with following changes:

Replacing TYPO3 localization wizard is restricted to TYPO3 v13 and deprecated 

For TYPO3 v14 the streamlined and revamped overall localization handling is adopted and making use of the new Localization Handler feature. That means, that the look and feel is different based on the used TYPO3 version even with the same extension version.

To respect this replacing the localization wizard JavaScript together with the related PSR-14 events are restricted to TYPO v13 only and is also now deprecated:

  • TYPO3 v13 localization mode selection in PageLayout module:

    Select `Translate with DeepL` localization mode in TYPo3 v13

Impact 

web-vision/deepltranslate-core can now be installed and used in TYPO3 v14.3 instances.

Supported features are completely available for TYPO3 v13 and v14, except that generic TYPO3 handling is used provided by these versions.

Deprecation: Deprecated TYPO3 v13 support 

Description 

Following classes are deprecated and will be removed in 3.0.0:

  • \WebVision\Deepl\Base\Core13\Controller\Backend\LocalizationController
  • \WebVision\Deepl\Base\Core13\EventListener\DefaultTranslationDropdownEventListener
  • \WebVision\Deepl\Base\Core13\EventListener\PrepareLocalizationProcessDataHandlerCommandMapForTypo3LocalizationModes
  • \WebVision\Deepl\Base\Core13\EventListener\ProvideDefaultTypo3LocalizationModesEventListener
  • \WebVision\Deepl\Base\Localization\LocalizationMode
  • \WebVision\Deepl\Base\Localization\LocalizationModeCollection

Following PSR-14 are deprecated and will be removed in 3.0.0:

  • \WebVision\Deepl\Base\Event\GetLocalizationModesEvent only dispatched in TYPO3 v13.
  • \WebVision\Deepl\Base\Event\LocalizationProcessPrepareDataHandlerCommandMapEvent only dispatched in TYPO3 v13.

Impact 

Instances with extension using these classes or events will either get PHP Fatal errors or possible dependency injection issues.

web-vision extension requiring this extension will take care of this.

Affected installations 

All instances with extension relating to this extension.

Migration 

There is no migration for the deprecated classes, interfaces and events. They are now longer required in TYPO3 v14 and are only kept to keep TYPO3 v13 support up.

Sitemap