[TASK] Prepare 14.1.0 release

Author: wazum

CHANGELOG.md

@@ -5,13 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [14.1.0] - 2026-05-15
 
 ### Added
 
 - Opt-in **async conversion mode** (`async = 1`): WebP conversions are queued in a new `tx_webp_queue` table and processed out-of-band by a TYPO3 Scheduler task. Closes [#17](https://github.com/plan2net/webp/issues/17).
 - New CLI command `webp:process-queue` with optional `--folder=PATH` argument to convert images in non-FAL folders (e.g., `typo3temp/assets/online_media/`). Closes [#73](https://github.com/plan2net/webp/issues/73).
 - New `async_throttle_ms` configuration to space conversions out with randomized jitter, preventing thundering-herd CPU/IO.
+- UpgradeWizard `webp.truncateFailedAttemptsBeforeColumnResize` to unblock upgrades from older releases that shipped `tx_webp_failed.configuration_hash` as `VARCHAR(40)`; the wizard empties the cache of failed attempts so TYPO3's database analyzer can shrink the column to `VARCHAR(32)`. Closes [#95](https://github.com/plan2net/webp/issues/95).
+
+### Fixed
+
+- `ExternalConverter` now preserves non-ASCII bytes in filenames (e.g., German umlauts, accented characters) when passing paths to external converters like `cwebp`. PHP's `escapeshellarg()` silently drops multibyte bytes under `LC_CTYPE=C`, which mangled filenames like `Mövenpick.png` to `Mvenpick.png` and caused conversion to silently fail. Closes [#89](https://github.com/plan2net/webp/issues/89).
+- TYPO3 14.3 no longer logs an `ext_emconf.php` deprecation notice on every request; `composer.json` now declares `extra.typo3/cms.version` and `extra.typo3/cms.Package.providesPackages` so `PackageManager` recognises the extension as composer-only-capable.
 
 ## [14.0.0] - 2026-05-14
 
@@ -32,4 +38,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The listener now normalises `FileReference` inputs to their underlying `File` before the repository lookup — fixes a latent v12/v13 bug where the wrong UID was being queried.
 - `FileNameFilter` no longer emits PHP 8+ warnings on invalid filter regex patterns.
 
+[14.1.0]: https://github.com/plan2net/webp/releases/tag/14.1.0
 [14.0.0]: https://github.com/plan2net/webp/releases/tag/14.0.0

README.md

@@ -74,12 +74,12 @@ Then:
 
 1. Activate the extension if your TYPO3 is in non-Composer mode (Composer mode activates it automatically).
 2. Flush TYPO3 and PHP caches.
-3. Clear processed files (Admin Tools → Maintenance → Remove Temporary Assets).
+3. Clear processed files (*System → Maintenance → Remove Temporary Assets* on TYPO3 v14; *Admin Tools → Maintenance* on v12/v13).
 4. Add the [webserver rewrite rules](#webserver-configuration).
 
 ## Updating
 
-After a `composer update`, **save the extension settings at least once** via *Admin Tools → Settings → Extension Configuration → webp*. TYPO3 only writes default values to `LocalConfiguration` when you save the settings form, so any new defaults the upgraded version ships won't take effect until you do.
+After a `composer update`, **save the extension settings at least once** via the Extension Configuration backend module (*System → Settings → Extension Configuration → webp* on TYPO3 v14; *Admin Tools → Settings → Extension Configuration → webp* on v12/v13). TYPO3 only writes default values to `LocalConfiguration` when you save the settings form, so any new defaults the upgraded version ships won't take effect until you do.
 
 ## Configuration
 
@@ -233,7 +233,7 @@ By default the extension converts images synchronously inside the request that p
 
 1. Set `async = 1` in the extension configuration.
 2. Run TYPO3's database analyzer so `tx_webp_queue` is created.
-3. Register a TYPO3 Scheduler task: **System → Scheduler → Add task → Type: "WebP: process conversion queue"**. Pick a frequency that matches your throughput (every minute for busy sites, hourly for low-traffic).
+3. Register a TYPO3 Scheduler task: **System → Scheduler → Add task → Type: "Process conversion queue (webp)"**. Pick a frequency that matches your throughput (every minute for busy sites, hourly for low-traffic).
 4. Make sure the scheduler itself runs — either via `vendor/bin/typo3 scheduler:run` in cron, or a daemonized runner.
 
 The listener will now enqueue new conversions; the scheduler task drains the queue in the background. Existing siblings stay; the extension does not retroactively backfill.
@@ -398,7 +398,7 @@ Common cases:
 | File still served as JPEG after a successful generation | Webserver rewrite rule missing or shadowed by another rule          |
 | Sibling left behind after deleting the source | None — that's the bug fixed in 14.0.0; upgrade                              |
 
-After changing `processor_colorspace`, clean up any processed files (Admin Tools → Maintenance → Remove Temporary Assets) so the change takes effect on existing images.
+After changing `processor_colorspace`, clean up any processed files via the Maintenance backend module (*System → Maintenance → Remove Temporary Assets* on TYPO3 v14; *Admin Tools → Maintenance* on v12/v13) so the change takes effect on existing images.
 
 ## Known limitations
 
@@ -411,7 +411,7 @@ After changing `processor_colorspace`, clean up any processed files (Admin Tools
 
 To remove all generated `.webp` files (e.g. before a converter or quality change):
 
-1. *Admin Tools → Maintenance → Remove Temporary Assets*
+1. *System → Maintenance → Remove Temporary Assets* (TYPO3 v14) or *Admin Tools → Maintenance → Remove Temporary Assets* (v12/v13).
 2. Click *Scan temporary files*.
 3. Click the button labelled with the storage path.
 

composer.json

@@ -1,6 +1,6 @@
 {
   "name": "plan2net/webp",
-  "license": "GPL-3.0",
+  "license": "GPL-3.0-or-later",
   "description": "Creates WebP copies for images (TYPO3 CMS)",
   "type": "typo3-cms-extension",
   "homepage": "https://www.plan2.net/",
@@ -50,7 +50,7 @@
   "extra": {
     "typo3/cms": {
       "extension-key": "webp",
-      "version": "14.0.0",
+      "version": "14.1.0",
       "cms-package-dir": "{$vendor-dir}/typo3/cms",
       "web-dir": ".Build/Web",
       "Package": {

ext_emconf.php

@@ -8,7 +8,7 @@
     'author_email' => 'wk@plan2.net',
     'state' => 'stable',
     'author_company' => 'plan2net GmbH',
-    'version' => '14.0.0',
+    'version' => '14.1.0',
     'constraints' => [
         'depends' => [
             'typo3' => '12.4.0-14.99.99',