PHPackages                             web-vision/deepl-base - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. web-vision/deepl-base

ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility)

web-vision/deepl-base
=====================

DeepL Base - Provides shared things across deepl related extensions, for example a shared point when overriding same TYPO3 backend fluid files are required and similar.

2.0.3(3d ago)0130.2k↓33.6%1[1 PRs](https://github.com/web-vision/deepl-base/pulls)4GPL-2.0-or-laterPHPPHP ^8.2 || ^8.3 || ^8.4 || ^8.5

Since Jun 10Pushed 3d ago5 watchersCompare

[ Source](https://github.com/web-vision/deepl-base)[ Packagist](https://packagist.org/packages/web-vision/deepl-base)[ Docs](https://www.web-vision.de/en/automated-translations-with-typo3-and-deepl.html)[ RSS](/packages/web-vision-deepl-base/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (87)Versions (27)Used By (4)

TYPO3 Extension `DeepL Base`
============================

[](#typo3-extension-deepl-base)

URL**Repository:****Read online:****TER:**[https://extensions.typo3.org/extension/deepl\_base/](https://extensions.typo3.org/extension/deepl_base/)Description
-----------

[](#description)

This package is a TYPO Extension providing some shared things required by multiple deepl translate or write related extensions, which should work together but must work independent of each other, requiring this shared base extension as common ground.

Note

This extension does not provide anything useful as direct usage, and makes no sense to install it standalone. Should only be a dependency for other extensions.

Compatibility
-------------

[](#compatibility)

BranchVersionTYPO3PHPmain2.0.x-devv138.2, 8.3, 8.4, 8.5 (depending on TYPO3)1^1, 1.0.x-devv12 + v138.1, 8.2, 8.3, 8.4 (depending on TYPO3)Installation
------------

[](#installation)

Install with your flavour:

- [TER](https://extensions.typo3.org/extension/deepl_base/)
- Extension Manager
- composer

We prefer composer installation:

```
composer require 'web-vision/deepl-base':'2.*.*@dev'
```

Note

Until first release you may need to ensure allowing dev versions but preferring stable releases which requires:

```
composer config minimum-stability "dev" \
&& composer config "prefer-stable" true \
&& composer require 'web-vision/deepl-base':'2.*.*@dev'
```

Documentation
-------------

[](#documentation)

Note

For the start, the documentation for developers and integrators is contained here in the README.md file and will be converted into rendered documentation at a later point.

### PageLayout module localization model - Translation Modes

[](#pagelayout-module-localization-model---translation-modes)

### ViewHelper

[](#viewhelper)

#### InjectVariablesViewHelper

[](#injectvariablesviewhelper)

`InjectVariablesViewHelper` can be placed in fluid templates and requires to define a speaking identifier used to dispatch the PSR-14 `ModifyInjectVariablesViewHelperEvent` event, which can be used to set or modify variables either in the global current template scope or for children rendering scope.

##### Example usage in fluid template

[](#example-usage-in-fluid-template)

```

    Render {globalOrLocalVariableProviderVariable} only available in children
    context.

Render {globalOnlyVariableProviderVariable} only ignoring local variable provider
changes.

```

##### Explicit usage from this extension

[](#explicit-usage-from-this-extension)

```

```

###### What does it do?

[](#what-does-it-do)

This part renders partials registered by an EventListener. With this identifier an extension could provide its own translation dropdown for the Backend PageView. The extension must be self-aware registering a partial, which is callable by Fluid.

A working example is provided at `Classes/EventListener/DefaultTranslationDropdownEventListener.php`and `Resources/Private/Backend/Partials/Translation/DefaultTranslationDropdown.html`.

##### ModifyInjectVariablesViewHelperEvent

[](#modifyinjectvariablesviewhelperevent)

- `getIdentifier(): string`: identifier used within the fluid template and should
- `getGlobalVariableProvider(): VariableProviderInterface`: provides the fluid variable container of the current context. Modification will be available after the ViewHelper and within the children context unless overridden within the `getLocalVariableProvider`.
- `getLocalVariableProvider(): VariableProviderInterface`: provides the fluid variable container with children context only variables, overriding global variables. Local variable does not change the variables in the template after the ViewHelper call.

### Modified Backend Templates

[](#modified-backend-templates)

Note

Modifed backend templates are listed here describing the modification, for example, if one or more [InjectVariableViewhelper](#injectvariablesviewhelper)has been placed along with the identifier and use-case.

Create a release (maintainers only)
-----------------------------------

[](#create-a-release-maintainers-only)

Prerequisites:

- git binary
- ssh key allowed to push new branches to the repository
- GitHub command line tool `gh` installed and configured with user having permission to create pull requests.

**Prepare release locally**

> Set `RELEASE_BRANCH` to branch release should happen, for example: 'main'. Set `RELEASE_VERSION` to release version working on, for example: '1.0.0'.

```
echo '>> Create release based on configuration' ; \
  RELEASE_BRANCH='main' ; \
  RELEASE_VERSION="2.0.3"
  DEV_VERSION="2.0.4"
  echo ">> Checkout branches" && \
  git checkout main && \
  git fetch --all && \
  git pull --rebase && \
  git checkout ${RELEASE_BRANCH} && \
  git pull --rebase && \
  echo ">> Create release ${RELEASE_VERSION}" && \
  git checkout -b release-${RELEASE_VERSION} && \
  sed -i "s/^COMPOSER_ROOT_VERSION.*/COMPOSER_ROOT_VERSION=\"${RELEASE_VERSION}\"/" Build/Scripts/runTests.sh && \
  sed -i "s/^  RELEASE_VERSION.*/  RELEASE_VERSION=\"${RELEASE_VERSION}\"/" README.md && \
  sed -i "s/^  DEV_VERSION.*/  DEV_VERSION=\"${DEV_VERSION}\"/" README.md && \
  tailor set-version ${RELEASE_VERSION} && \
  composer config "extra"."typo3/cms"."version" "${RELEASE_VERSION}" && \
  echo "${RELEASE_VERSION}" > VERSION && \
  git add . && \
  git commit -m "[RELEASE] ${RELEASE_VERSION}" && \
  git push --set-upstream origin release-${RELEASE_VERSION} && \
  gh pr create --fill --base ${RELEASE_BRANCH} --title "[RELEASE] ${RELEASE_VERSION}" && \
  sleep 10 && \
  gh pr checks --watch --interval 2 && \
  sleep 10 && \
  gh pr merge -rd --admin && \
  git remote prune origin && \
  git tag ${RELEASE_VERSION} && \
  git push origin ${RELEASE_VERSION} && \
  echo ">> Post-release - set dev version: ${DEV_VERSION}-dev" && \
  git checkout -b set-version-${DEV_VERSION} && \
  sed -i "s/^COMPOSER_ROOT_VERSION.*/COMPOSER_ROOT_VERSION=\"${DEV_VERSION}-dev\"/" Build/Scripts/runTests.sh && \
  tailor set-version ${DEV_VERSION} && \
  composer config "extra"."typo3/cms"."version" "${DEV_VERSION}-dev" && \
  echo "${DEV_VERSION}-dev" > VERSION && \
  git add . && \
  git commit -m "[TASK] Set dev version ${DEV_VERSION}" && \
  git push --set-upstream origin set-version-${DEV_VERSION} && \
  gh pr create --fill --base ${RELEASE_BRANCH} --title "[TASK] Set dev version \"${DEV_VERSION}-dev\"" && \
  sleep 10 && \
  gh pr checks --watch --interval 2 && \
  sleep 10 && \
  gh pr merge -rd --admin && \
  git remote prune origin
```

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance99

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 93.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~35 days

Recently: every ~0 days

Total

12

Last Release

3d ago

Major Versions

1.0.3 → 2.0.02026-04-27

1.0.5 → 2.0.22026-06-28

PHP version history (2 changes)1.0.0PHP ^8.1 || ^8.2 || ^8.3 || ^8.4

2.0.0PHP ^8.2 || ^8.3 || ^8.4 || ^8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1453466?v=4)[Stefan Bürk](/maintainers/sbuerk)[@sbuerk](https://github.com/sbuerk)

---

Top Contributors

[![sbuerk](https://avatars.githubusercontent.com/u/1453466?v=4)](https://github.com/sbuerk "sbuerk (56 commits)")[![calien666](https://avatars.githubusercontent.com/u/11405116?v=4)](https://github.com/calien666 "calien666 (2 commits)")[![eliashaeussler](https://avatars.githubusercontent.com/u/16313625?v=4)](https://github.com/eliashaeussler "eliashaeussler (1 commits)")[![IchHabRecht](https://avatars.githubusercontent.com/u/1453345?v=4)](https://github.com/IchHabRecht "IchHabRecht (1 commits)")

---

Tags

translateextensionTYPO3 CMSdeepl

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/web-vision-deepl-base/health.svg)

```
[![Health](https://phpackages.com/badges/web-vision-deepl-base/health.svg)](https://phpackages.com/packages/web-vision-deepl-base)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[web-vision/wv_deepltranslate

DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages.

33304.3k](/packages/web-vision-wv-deepltranslate)[web-vision/deepltranslate-core

DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages.

33142.5k8](/packages/web-vision-deepltranslate-core)[yoast-seo-for-typo3/yoast_seo

Yoast SEO for TYPO3

511.7M9](/packages/yoast-seo-for-typo3-yoast-seo)[friendsoftypo3/visual-editor

TYPO3 CMS Visual Editor - Brings a modern WYSIWYG editing experience to TYPO3 CMS.

576.1k2](/packages/friendsoftypo3-visual-editor)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)