README

========================

Version 13.4.2 | 21.1.2026

Tested with TYPO3 LTS 13.4.24 under PHP 8.4
Tested with TYPO3 LTS 12.4.34 under PHP 8.3
Tested with TYPO3 LTS 12.4.6 under PHP 8.1
Tested with TYPO3 LTS 11.4.31 under PHP 7.4 \ (use older version of extension!)

works on following database tables / fields: \

sys_template -> config and constants
pages -> TSconfig
fe_users -> TSconfig
fe_groups -> TSconfig
be_users -> TSconfig
be_groups -> TSconfig backend_layout -> config
tx_gridemelements_backend_layout -> config \

You have more Database tables with TSconfig ? feel free to add an issue or a pull request.

comes with 2 additional commands:

RepairPrimaryKey Command

As TYPO now automatically adds a primary key to all mm tables on uid_local and uid_foreign,
But it may exists rows by accident with duplicate entries. but this stops upgrade Process
This command deletes rows with duplicate entries in a given database Table . \

UpdateFiles Command

Fixes filenames and there Content on a local DEV mashine in a given folder renames if needed extenion of file from

'ts', 'txt', 'text' , 't3' , 't3s' , 'tscript'  

to 'typoscript' or 'tsconfig'

Important NOTICE

1. you should have a database copy!

2. you should be aware in case of many pages or fe_users, it may be slow

3. run this wizard on production system only if you have tested it locally

4. you should have experience to cun typo3 console command

5. you should work with any vcs like git

6. make a copy of your template folder for easier testing

7. replace -vv against -vvv to get more verbose output in follwing commands

8. maybe this is needed ./vendor/bin/typo3 cache:flush

   ./vendor/bin/typo3 upgrade:run jveUpgradewizard_upgradeTemplates -vv

   ./vendor/bin/typo3 jvelletti:updatefiles --path=/test -vv

Fixes file ending .ts .txt and .text etc to .typoscript in database with warning

CONST UNWANTED_EXTENSIONS = ['ts', 'txt', 'text' , 't3' , 't3s' , 'tscript'  ] ;

@import 'EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.ts'
@import 'EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.txt'
@import 'EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.text'

Fixes wrong "EXT:" or missing "EXT: syntax

not required, but helps to make extension to fiddle result easier

@import "FILE:EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript"
@import "/typo3conf/ext/jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript"

Fixes INCLUDE_TYPOSCRIPT src=

<INCLUDE_TYPOSCRIPT src="/typo3conf/ext/jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript"> 
<INCLUDE_TYPOSCRIPT src='/typo3conf/ext/jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript'>

Changes double quote " char to single quote '

not required, but helps to make extension to fiddle result easier

 @import "EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript"

Result in all cases:

@import 'EXT:jve_template/Configuration/TypoScript/TSConfig/TSConfig.typoscript'

fixes also lines starting with # but keep coment status intakt.

Warns if file in fileadmin and not in any EXT Folder:

 @import "/fileadmin/template/TSConfig/TSConfig.typoscript" 

Fixes files In a given template Folder on a local test systems

./vendor/bin/typo3 jvelletti:updatefiles  -vv

enter path to your Template folder f.e. :

/vendor/jvelletti/jve-upgradewizard/Configuration/TypoScript/

this extension comes along with some test files there. check the content to see some common error / outdated syntax \

you are asked to confirm changes with "yes"

you can also start the script with a given path: but sill will have to enter "yes"

(argument --force to skip confirmation is planned after sevaral tests that it is working correctly)

./vendor/bin/typo3 jvelletti:updatefiles --path=/vendor/jvelletti/jve-upgradewizard/Configuration/TypoScript/  -vv

the Console command searches for all files with definied Endings :

CONST UNWANTED_EXTENSIONS = ['ts', 'txt', 'text' , 't3' , 't3s' , 'tscript'  ] ;

Renames these files if needed to ".typoscript" and fixes the content of this tiles in same way like database entries
lines without "@import" and "INCLUDE_TYPOSCRIPT" are unchanged \

Fixes since version 12.4.18 also typocript lines :

page.includeJSFooter.main = /typo3conf/ext/ ... main.js
page.includeCss.application = /typo3conf/ext/ ... application.css
shortcutIcon = /typo3conf/ext/ .. icon.ico
logo = /typo3conf/ext/ .. logo.png ( .gif /  .jpg )

Restrictions

1. does not fix entries in folder "/fileadmin" like @import "/fileadmin/tscript.ts"
2. does not fix CSS/javascript files itself, if background images or font path is loading from public folder of extension

Best pratices

as maybe 3 steps are needed: renaming the files in filesystem and changing the name of imported file in database,
and finally a Clear TYPO§ Cache, the website will not be available for some time.
If you need to avoid this and have no other option, try the following steps

1. create a Feature branch for the migration f.e.: "migration-feature"

2. create a copy of the template file Folder outside of the doc root f.e. "backup-migration"

3. run updateData command on template Files:

   ./vendor/bin/typo3 jvelletti:updatefiles --path=/vendor/your-vendor/your-template-ext/Configuration/TypoScript/ -vv

4. filenames with old extensions will be renamed by the script command

5. push this to "migration-feature" Branch

6. create a 'final-feature' branch from result.

7. run Upgradewizard manuall via cli on local dev mashine to update local your database entries and do needed tests

   ./vendor/bin/typo3 upgrade:run jveUpgradewizard_upgradeTemplates -vv

   on success:

8. switch back to "migration-feature" Branch

9. copy OLD files (with wrong file extensions or old IMPORT_TYPOSCRIPT syntaxt) from "backup-migration"

10. push this to "migration-feature" Branch (so BOTH file versions exist: the WANTED New ones and OLD used via database)

11. pull this to the webserver

12. run Upgradewizard manuall via cli

    ./vendor/bin/typo3 upgrade:run jveUpgradewizard_upgradeTemplates -vv

13. As in step 10 you have both versions of files, it is not import if upgrade takes time.

14. As with step 11 your database now shuld only use New renamed files you can cleanup.

15. to remove the OLD template files, switch to 'final-feature' branch

repair translation files in any otzher extension folder

this will add approved="yes" to all xlf files in a given Resource folder

./vendor/bin/typo3 jvelletti:approvexlf --path=/vendor/jve/jv-events -vv

Internal reminder for the extension maintainer:

To Update this extension in TER:
change version Number to "x.y.z" in Documentation\ in Settings.cfg and Index.rst
create Tag "x.y.z"
git push --tags

create new zip file:
cd vendor/jvelletti/jve-upgradewizard
git archive -o "jve_upgradewizard_x.y.z.zip" HEAD

f.e.:
git archive -o "jve_upgradewizard_12.4.33.zip" HEAD

Upload ZIP File to https://extensions.typo3.org/my-extensions
git push

setup packagist Webhook:
https://packagist.org/api/update-package?username=jvelletti

api Token from Profile:
https://packagist.org/profile/

check:
https://intercept.typo3.com/admin/docs/deployments
https://packagist.org/packages/jvelletti/jve_upgradewizard
https://extensions.typo3.org/extension/jve_upgradewizard/