Merge conflict Gerrit cannot merge this change. It needs a rebase onto main.

Review main Work in progress Orphaned Breaking

90533[!!!][WIP][FEATURE] Store OnlineMedia preview images in FAL storage

Benni Mack CR 0 V 0 Hard +592 −2 updated 01/27/26, 22:02

Commit message

OnlineMedia preview images (YouTube/Vimeo thumbnails) are now stored
as proper FAL files instead of temporary files in typo3temp. This
enables preview images to be stored in the same storage as their
source files and to be processed like regular images.

Changes:
* Add preview relationship fields to sys_file_metadata table
* Extend OnlineMediaHelperInterface with FAL preview methods
* Implement FAL storage integration in AbstractOnlineMediaHelper
* Update YouTube and Vimeo helpers with backward compatibility
* Add upgrade wizard for migrating existing preview images
* Enable preview image processing through FAL pipeline

Benefits:
* Preview images follow same storage configuration as source files
* Preview images can be cropped, resized, and processed normally
* Full FAL metadata support including alt text and descriptions
* Database relationships enable better content management
* Cloud storage and CDN support for preview images

Breaking changes:
* OnlineMediaHelperInterface extended with new methods
* AbstractOnlineMediaHelper has new abstract method

ToDo:
* Clean up the AbstractOnlineMediaHelper

Note:
* This change was created with help of Claude Code

Test this change

Run a command in your clone of the TYPO3 Core. Then try what the change does and vote on Verified in Gerrit. How to review a patch

Check out patch set 2
git fetch https://review.typo3.org/Packages/TYPO3.CMS refs/changes/33/90533/2 && git checkout FETCH_HEAD
Cherry-pick onto main
git fetch https://review.typo3.org/Packages/TYPO3.CMS refs/changes/33/90533/2 && git cherry-pick FETCH_HEAD

Review

  • Code review CR 0 Needs a vote
  • Verified V 0 Needs a vote
    • core-ci +1 CI

Files 9

Review log 46

  1. Benni Mack uploaded patch set 1 09/01/25, 15:08

  2. core-ci voted on patch set 1 V +1 09/01/25, 15:16 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/84168

  3. Benni Mack marked it work in progress 10/16/25, 19:36

  4. Benni Mack rebased onto patch set 2 V +1 10/16/25, 19:36

  5. core-ci voted on patch set 2 V +1 10/16/25, 19:50 Core CI is happy: https://git.typo3.org/typo3/CI/cms/-/pipelines/86842

  6. Garvin Hicking commented on patch set 2 10/24/25, 13:29

    (just a node, I know WIP and such, but I had to see what clau(w)d its way into the code ;) )

    AbstractOnlineMediaHelper.php:272 Unresolved

    There is a specific get() method for this, utilize that one? Also, since this came up for me quite a few times today: Do we want makeInstance() for these kind of calls, or do we prefer inject() methods? Or "getters" that wrap around makeInstance calls? Above, also ConnectionPool is handled like this. I do think Claude/AI has the tendency to prefer makeInstance.

    OnlineMediaHelperInterface.php:81 Unresolved

    I think this `@return` is obsolete, also something that Claude often auto-adds (might be part of a "Guidelines" basic prompt to not do this)