This extension can be used to migrate a project from EXT:gridelements to EXT:container.
A quick introduction in how to use this extension.
What does this extension do? See some screenshots
Learn how to use this extension in detail.
See the CLI command options for this extension.
What are the limitations of this extension? Where can you report problems?
About this extension, the author, the project etc
We assume you have composer-based TYPO3 installation with extension
EXT:gridelments (
gridelementsteam/) installed.
Make Backups or work on a development system
Warning
Create a backup of your database and filesystem before applying these steps. It is highly recommended to use this extension on a development system only.
Install EXT:container
composer req b13/containerKeep EXT:gridelements installed for now.
Install EXT:gridtocontainer
composer req --dev sbublies/gridtocontainerSee the chapter on Installation. Make sure the TypoScript template is included. We install the extension as a dev-requirement as it should not be used on productive systems.
Check which of the available grid elements are in use
Go to the module Admin tools > Grid migration provided by this extension. See also What grid elements do i have on my site?.
Create alternative containers for each grid element
See the EXT:container documentation.
Migrate all grid elements to containers
Using the module Admin tools > Grid migration migrate all grid elements to the respective containers. See also Migrate grid elements from gridelements layout key.
Optional: Migrate FlexForm content
If your grid elements used FlexForms you have to migrate the values stored in the FlexForms by other means. See chapter Known problems.
Check the migration
Is everything being displayed as expected in frontend and backend?
Remove EXT:gridelements and this extension
Remove or replace all extensions that require EXT:gridelements and remove the requirement from your sitepackage. Then remove EXT:gridelements. You can also remove EXT:gridtocontainer after successfully migrating all containers:
composer remove gridelementsteam/gridelements sbublies/gridtocontainerClean up the database
Search in the database for content elements that still use the
colpos
-1 and resolve them. See chapter Clean up the database for details.
Make a database compare
Got to Admin tools > Maintenance > Analyze Database and undo all changes that EXT:gridelements made to your database.
This extension can be used to migrate a project from EXT:gridelements to EXT:container.
For each gridelement used in your installation you can manually chose to which container element it should be migrated. By default the column numbers are kept. However, it is also possible to adjust the column number of the related content elements.
This extension should only be used on development systems. It is not recommended to use it on productive systems. It can only be used by administrators with system maintainer rights.
The migration module
See the Quick start to get started in the TYPO3 CMS Backend or get started with the command line, see Command Reference
It is not recommended to use this extension on productive systems. If you do make sure you have a current database backup and no editors working on your page.
After installation you need to include the TypoScript template in your root pages template.
In a current composer-based TYPO3 installation you can install this extension like this:
composer req sbublies/gridtocontainerThe extension will be automatically activated.
If you are using TYPO3 version 9 or 10 require the fitting version:
composer req sbublies/gridtocontainer:"^10.4"And activate the extension in Admin Tools > Extension Manager.
Download gridtocontainer from the TER (TYPO3 Extension Repository)
Upload it in Admin Tools > Extension Manager and activate it there.
Have a look at the Quick start.
The following reference was automatically generated from code.
The following options can be used with every command:
-h, --help -q, --quiet -V, --version --ansi|--no-ansi -n, --no-interaction -v|vv|vvv, --verbose Display help for the command
The -h command displays help for the command:
vendor/bin/typo3 gridtocontainer:migrateall -hgrididentifiercontaineridentifierflexformidentifieroldcolumidscolumnidsNote
Only users with system maintainer rights can use this extension.
Go to the module Admin tools > Grid migration:
Click on click here in the important notice box in the first step. After that the extension analyzes your page and also gives you first instructions.
Click on Migration form gridelements layout key in the dropdown to migrate all elements on the web page using layout key.
You can use the new Abstract Upgrater for an automated migration. For this you only have to register your UpgradeWizards in the Services.yaml.
Load the upgrater into your upgrade function as follows:
use SBublies\Gridtocontainer\Upgrades\AbstractGridtoCoUpdaterAdd your own upgrater in your own extension as follows:
namespace VENDOR\EXTENSION\Upgrades;
use TYPO3\CMS\Install\Attribute\UpgradeWizard;
use SBublies\Gridtocontainer\Upgrades\AbstractGridtoCoUpdater
#[UpgradeWizard('gridtocontainer_GridelementUpdaterExample')]
class GridelementUpdaterExample extends AbstractGridtoCoUpdater
{
protected const GRID_IDENTIFIER = 'updaterexample';
protected const CONTAINER_IDENTIFIER = 'container_updaterexample';
protected const FLEXFORM_IDENTIFIER = 'old';
protected const OLD_COLUMS = '0,1';
protected const NEW_COLUMS = '10000,10001';
}Search in the database for content elements that still use the
colpos
-1:
SELECT * FROM tt_content where colpos=-1;In most cases all content elements that had been deleted in TYPO3 can also be deleted from the database.
Warning
This step cannot be undone! Make a backup first
DELETE FROM tt_content where colpos=-1 and deleted=1;Then make a database compare at Admin tools > Maintenance > Analyze Database.
If you find further limitations, please report an issue on GitLab.
{release}
en
Stefan Bublies and all contributors
This extension documentation is published under the Creative Commons Attribution 4.0 International (CC BY 4.0) license
The content of this document is related to TYPO3 CMS, a GNU/GPL CMS/Framework available from typo3.org .
This documentation is community documentation for the TYPO3 extension gridtocontainer
It is maintained as part of this third party extension.
If you find an error or something is missing, please: Report a Problem
You are welcome to help improve this guide. As this project is hosted on GitLab there is no "Edit on Github" button available.
Thanks to Stefan Bublies, who created this extension and some initial documentation. Thanks to Lina Wolf for creating the initial version of this manual.