templavoilaplus/templavoilaplus

Building kit for custom pages and content elements with individual fields, containers and backend layouts. Supporting drag'n'drop and multiple references.

12.0.0 2023-12-14 13:14 UTC

Requires

• php: >=8.1.0 <8.2.99
• typo3/cms-core: ^12.4.0
• typo3/cms-frontend: ^12.4.0

Requires (Dev)

• codeception/codeception: ^4.1 || ^5.0.0
• codeception/module-asserts: ^2.0 || ^3.0.0
• codeception/module-cli: ^2
• codeception/module-webdriver: ^2 || ^3.0.0
• ergebnis/composer-normalize: 2.28.3
• friendsofphp/php-cs-fixer: ^3.4.0
• helhum/typo3-console: ^8.0.0 || ^v7.1.1
• helmich/typo3-typoscript-lint: ^2.5.2 || ^v3.1.0
• jangregor/phpstan-prophecy: ^1.0.0
• jpmschuler/tvplus_test_theme: *@dev
• php-coveralls/php-coveralls: ^2.5.2
• phpspec/prophecy: dev-master as 1.18
• phpspec/prophecy-phpunit: dev-master
• phpstan/extension-installer: ^1.1.0
• phpstan/phpstan: ^1.6.2
• phpstan/phpstan-phpunit: ^1.1.1
• phpunit/phpunit: ^10.1.0
• saschaegerer/phpstan-typo3: ^1.1.2
• seld/jsonlint: ^1.9.0
• squizlabs/php_codesniffer: ^3.6.2
• symfony/yaml: ^4.4.29 || ^5.3.6 || ^6.0
• typo3/cms-impexp: ^12.4.0
• typo3/cms-lowlevel: ^12.4.0
• typo3/coding-standards: ^0.7.1
• typo3/minimal: ^v12.4.0
• typo3/testing-framework: ^8.0.0

Conflicts

• templavoila/templavoila: *
• typo3-ter/templavoila: *

Replaces

• typo3-ter/templavoilaplus: 12.0.0

GPL-2.0-or-later

• Alexander Opitz

• template
• extension
• engine
• typo3

README

TemplaVoilà! Plus (TV+) is an extension for the TYPO3 content management system which adds an easy way to extend content elements and rendering to templates in Backend and Frontend. It is the follow up of the popular TemplaVoilà! extension from Kasper Skårhøj prepared for modern versions of TYPO3.

Translation and Documentation

We are using crowdin for translation handling. Please visit https://crowdin.com/project/typo3-extension-templavoilaplu to check state. You can also help there to fix issues. But also our complete documentation needs a rewrite, please help there.

Next release TV+ v12

The next TV+ release will be v12, starting with 12.0.0 as first alpha release. It will support TYPO3 v12 LTS.

Missing parts from old TemplaVoilà!

• The point-and-click mapper as XPath mapping have no feature.
• MultiLanguage as this is very hard and partly confuse, we need a "data donation" for this. Also this isn't realy a core compatible way and so Language Fallback Support isn't easy possible.
• Workspace Support is only somewhat tested, it may be buggy it may be working.
• Documentation and translation parts, please help here.

On all this missing parts, what the hell is new/better?

• Compatible with TYPO3 v8 to v11 (with TV+ v8) or with TYPO3 v12 (with TV+ 12)
• No database records for templates and structures anymore, which helps on servers which use deployments and prepare this rollouts on testing/staging systems.
• Split frontend between data organization and rendering, this allows us to integrate different templating engines like fluid.
• Backend written with fluid templates, which allows us to use fluid templates for the backend layouts or backend previews, instead of the marker based templates.
• Also the good old XPathRenderer got small features which help on recursive data handling.
• Using places, so we could create theme extensions like em_tvplus_theme_demo or UIkit theme which will extensible with your own extension.
• Supporting fluid templating in frontend beside old XPath and marker based templating.

What may come next after v12

Nobody knows and it depends on the requests from outside, from the community, from you.

How is the configuration handling differently

The handling of configuration is done inside directories called "Places". This is needed, as we want later, that you can install a base theme and extend/overwrite it partially with your own configuration data. The old configuration parts, DataStructure and TemplateObject, have been rearranged. TV+ uses now four configuration types DataConfiguration (with the clean core DataStructure), MappingConfiguration, TemplateConfiguration and BackendLayoutConfiguration. This allows for a better reusage of configuration parts and the possibility to configure different output renderer. All old entry points to extend TV+ are removed at the moment and some complete new are arising, for example the LoadSaveHandlers, which enables you to write an own configuration loader/saver for your configuration files and your own super duper configuration file format. Please take a look inside the two theme extensions or check the extension which is created while migration to understand how it looks and how it works.

How to upgrade

The TV+ Control Center resides in the admin tools section, it includes the "Update Script" to start the migration process. The "Update Script" checks first your system and tells you as much as possible what and how it does. At the end a theme extension will be generated which includes all needed parts for the installation. Afterwards you need to update your TypoScript for starting frontend output. All together can be found in the documentation. If you use deployment strategie you don't have to run the complete migration again, the information for database migration is saved in an json file, a "Server Migration Script" will show up for this.

Theme Extensions as WIP for TV+ 8

• em_tvplus_theme_demo - Demo theme using XPath Renderer
• UIkit theme - Theme using the Fluid Renderer and the UIkit inside frontend output

What would help us:

• If you need one of the following things, we would need a data donation from your system (from the tx_templavoilaplus_* tables and StaticDS files if you have), so we can't test this and try to work on a solution.
  • Update script for multiple storage pids
  • Multilanguage editing support for lDEF/vDEF systems (Systems which use the TemplaVoilà! language things and not the core ones a.k.a. langDisable/langChildren)