PHPackages ppl/ppl-deepl-v3-extension-translator - 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. ppl/ppl-deepl-v3-extension-translator ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) ppl/ppl-deepl-v3-extension-translator ===================================== TYPO3 14 backend audit and selected-write helper for extension XLF translation files 14.3.1(3w ago)02GPL-2.0-or-laterPHPPHP >=8.2CI failing Since May 31Pushed 2w agoCompare [ Source](https://github.com/pliou/ppl_deepl_v3_extension_translator)[ Packagist](https://packagist.org/packages/ppl/ppl-deepl-v3-extension-translator)[ RSS](/packages/ppl-ppl-deepl-v3-extension-translator/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (10)Versions (12)Used By (0) PPL DeepL V3 Extension Translator ================================= [](#ppl-deepl-v3-extension-translator) TYPO3 14 backend module for auditing extension XLF files and writing selected translation fixes. The module is audit-first: - scans local extension paths and concrete vendor packages - classifies findings with the current issue taxonomy instead of a broad "missing key" bucket - never calls DeepL during a dry scan - runs the selected solution directly from the Solution tool and rescans after successful writes - creates a backup before each file write - requires protected POST requests for write actions - blocks production writes unless explicitly enabled in extension configuration - blocks vendor writes unconditionally - uses `ppl_deepl_v3_requests` as the only DeepL request layer Related DeepL V3 Packages ------------------------- [](#related-deepl-v3-packages) The DeepL V3 line is split into focused TYPO3 extensions: - `ppl/ppl-deepl-v3-requests` (`ppl_deepl_v3_requests`): shared request and configuration layer. It owns the DeepL API key lookup, endpoint selection, HTTP calls, language/glossary/style-rule fetches, custom instructions and shared approval storage. - `ppl/ppl-deepl-v3-translate` (`ppl_deepl_v3_translate`): frontend content elements and backend modules for interactive text and file translation. - `ppl/ppl-deepl-v3-batch-translation` (`ppl_deepl_v3_batch_translation`): backend workspace for translating TYPO3 page trees, pages and content elements with preflight review and controlled record writes. - `ppl/ppl-deepl-v3-extension-translator` (`ppl_deepl_v3_extension_translator`): this package. It scans extension XLF files and code usage, classifies findings and writes selected translation fixes with backups. Extension Translator uses `ppl_deepl_v3_requests` for DeepL suggestions when a reliable source text exists. It does not own API key handling or shared language/glossary/style-rule approval storage. Current issue types: ``` key_mismatch_candidate keyless_unit missing_source_from_locale_candidate missing_source_unit missing_translation_unit locale_gap missing_target todo_source todo_value equal_value unused_candidate ``` Important taxonomy rules: - `keyless_unit` and `key_mismatch_candidate` are resolved before true missing-source findings. - `missing_source_from_locale_candidate` means the source is empty; locale text is shown only as a candidate. - `missing_source_unit` means the source is genuinely absent or not reliable; the source column stays empty until the source is entered. - `missing_translation_unit` is reserved for target/translation-unit completion after source handling; source-less rows are classified as missing source first. - `locale_gap` means an existing locale file lacks a key that exists in the source file; the fix copies id + source and leaves target empty. - `missing_target` is the normal DeepL-capable translation case because a source exists and the target is missing. - `unused_candidate` replaces the old "extra key" wording because dynamic usage can make a key valid. - Code-key scanning recognizes static `LLL:EXT:` references, Fluid translation usages, TYPO3 `locallang_mod.xlf` module-label conventions and key-like dynamic labels with known prefixes. - Smoke fixture keys are not counted as production translation usage. - The Extension Translator package itself is skipped for TODO-placeholder findings because its UI intentionally names the TODO issue types. Other packages keep the normal TODO source/target checks. - DeepL actions are only offered when a reliable source text is known. - Vendor findings remain read-only. - Read-only rows stay in their real issue type and can be ignored permanently; there is no separate `cannot_change` issue type. Dashboard UI: - The module uses a dashboard layout with project scan and file selection on the left, issue tabs and problem rows in the center, and the selected issue plus solution controls on the right. - The old numbered Step 1-5 layout is not part of the current UI. - Main issue tabs keep stable widths; rarer issue types are grouped under `Other` only as a presentation shortcut. - Source-less findings keep an empty Source column. Candidate text is shown under related candidates until the user explicitly chooses it as source. - Manual source, manual target and target key inputs are prefilled from existing values when there is exactly one safe default, but user-cleared values are preserved during refreshes. Backend module: ``` PPL DeepL V3 > Extension Translator ``` Write model: - `GET` requests may only run a scan. Write-capable actions require `POST` and a valid TYPO3 FormProtection token. - The UI does not add a second confirmation step. Choose a solution, run it, and the module writes immediately when the selected rows are writable. - Before saving an XLF or code file, the writer copies the original file to `var/ppl_deepl_v3_extension_translator/backups//...`. - Automatic writes are plain-text only. Existing XLF `source` or `target` elements with inline XML markup are blocked with a clear error instead of being flattened. - Local writes are disabled in Production context unless `allowProductionWrites` is enabled in extension configuration. Supported scopes: ``` packages/ extensions/ local/ typo3conf/ext/ vendor// read-only ``` Smoke Fake DeepL: - `vendor/bin/typo3 ppl:extension-translator:smoke --reset-fixture --run-matrix` activates Fake DeepL for the matrix run and deactivates it automatically afterwards. - Use `--keep-fake` only for deliberate manual debugging. - Use `--deactivate-fake` to clear a persistent Fake DeepL context. ### Health Score 42 — FairBetter than 88% of packages Maintenance96 Actively maintained with recent releases Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~4 days Total 11 Last Release 15d ago Major Versions 12.4.0 → 14.3.02026-06-01 12.4.1 → 13.4.12026-06-28 13.4.1 → 14.3.12026-06-28 12.4.x-dev → 13.4.x-dev2026-07-09 13.4.x-dev → 14.3.x-dev2026-07-09 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/131469?v=4)[Lesior](/maintainers/PPL)[@ppl](https://github.com/ppl) --- Top Contributors [![pliou](https://avatars.githubusercontent.com/u/45556500?v=4)](https://github.com/pliou "pliou (4 commits)") ### Embed Badge ![Health badge](/badges/ppl-ppl-deepl-v3-extension-translator/health.svg) ``` [![Health](https://phpackages.com/badges/ppl-ppl-deepl-v3-extension-translator/health.svg)](https://phpackages.com/packages/ppl-ppl-deepl-v3-extension-translator) ``` ### Alternatives [friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103519.9k57](/packages/friendsoftypo3-content-blocks)[pagemachine/typo3-formlog Form log for TYPO3 23238.6k8](/packages/pagemachine-typo3-formlog)[eliashaeussler/typo3-form-consent Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form 1595.5k](/packages/eliashaeussler-typo3-form-consent)[netresearch/rte-ckeditor-image Image support in CKEditor for the TYPO3 ecosystem - by Netresearch 611.1M8](/packages/netresearch-rte-ckeditor-image)[web-vision/wv_deepltranslate DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages. 33305.5k](/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) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)