README

Replaces every frontend image with a static placeholder while running on a Development application context. Real content images (photos, uploaded media) never render locally, regardless of environment or file source - useful when the site handles sensitive imagery (e.g. photos of people) that shouldn't be visible on developer machines, and as a side effect saves bandwidth from not loading real assets locally.

What it replaces

FAL-processed images - content elements, <f:image>, TypoScript / Fluid-rendered backgrounds - via a TYPO3\CMS\Core\Resource\Event\AfterFileProcessingEvent listener.
Raw HTML images - hardcoded <img> markup from RTE bodytext, lazy-load data-src/data-srcset attributes, and inline background-image/background CSS - via a PSR-15 middleware that rewrites the final rendered response.

Both mechanisms check TYPO3\CMS\Core\Core\Environment::getContext()->isDevelopment() and are no-ops everywhere else (Production, Testing).

Installation

composer require --dev woit/filereplace
vendor/bin/typo3 extension:setup

The composer vendor is woit, not wit - the wit namespace was already taken on Packagist when this was first published, so woit is intentional, not a typo.

Installing it as a require-dev dependency means it is not even present in a production build that runs composer install --no-dev.

Configuration

Controlled by TYPO3_CONTEXT plus a few settings in the extension configuration (Admin Tools > Settings > Extension Configuration > wit_filereplace): restricting the swap to the frontend, excluding specific content element CTypes, and using a custom placeholder image. See Documentation/Configuration/Index.rst for details.

Documentation

Full documentation lives in Documentation/.

License

GPL-2.0-or-later, see LICENSE.

woit / filereplace

Package info

Security

Statistics