praetorius/fluid-rename

Helper to rename Fluid templates in a TYPO3 extension to *.fluid.* file extension

1.0.0 2025-11-15 13:48 UTC

Requires

• php: >=8.2
• symfony/console: ^7.2
• symfony/finder: ^7.2
• typo3/cms-core: ^14.0 || ^13.4 || dev-main
• typo3/cms-fluid: ^14.0 || ^13.4 || dev-main

GPL-2.0-or-later

README

This TYPO3 extension provides a console command that automatically detects potential Fluid template files in another installed TYPO3 extension and renames them to the new Fluid file extension *.fluid.*. Note that this file extension only works on TYPO3 >= 14.0, so if you need to support older versions, just stick to the old generic file extensions.

Warning: Use this package at your own risk! The command renames actual files in your TYPO3 project, so you should know what you're doing!

Installation

This package is provided only for composer-based TYPO3 setups:

composer req --dev praetorius/fluid-rename

Usage

# Usage with composer name:
vendor/bin/typo3 fluid:rename:templates my-vendor/my-package-name

# Usage with extension key:
vendor/bin/typo3 fluid:rename:templates my_extension

The command is a two-step process: First, templates are processed that contain clear Fluid template markers, such as a ViewHelper call or a namespace import. Then, additional files are listed that based on their file extension might also be Fluid templates.

Both steps need to be confirmed by the user by choosing one of these options:

• rename all listed files
• skip all listed files
• confirm each renaming individually

Additional CLI options might be provided to the command:

• --tree: Show discovered template files as file tree instead of path listing
• --extensions=...: Comma-separated list of file extensions that should be considered potential Fluid templates (default: html,txt,xml,json)
• --include-tests: Also process files in Tests/ directory, which are skipped by default