Wie migriert man von Grid Elements zur TYPO3-Container-Erweiterung?

Möchten Sie von Grid Elements zur TYPO3-Container-Erweiterung migrieren? In diesem Artikel erfahren Sie mehr über verschiedene Ansätze – 1. automatische Migration mit einer Erweiterung und 2. manuelle Migration – zur Übertragung bestehender Grid Elements-Konfigurationen auf EXT.

Seit vielen Jahren bietet Grid Elements TYPO3-Projekten flexible Grid-Funktionen. Das Grid Elements-Team hat durch die langjährige Pflege und Weiterentwicklung dieser Lösung einen wichtigen Beitrag zum TYPO3-Ökosystem geleistet. Die Community schätzt dieses Engagement und diese Arbeit.

Viele TYPO3-Projekte benötigen flexible Inhaltsstrukturen, die über die Möglichkeiten der standardmäßigen Backend-Layouts hinausgehen. EXT:container bietet hierfür einen weiteren Ansatz zur Erstellung flexibler Container- und Grid-Strukturen.

Seit letztem Jahr haben wir (T3Planet und NITSAN) unsere TYPO3-Templates von EXT auf EXT migriert. Bei neuen Projekten kann EXT je nach den Anforderungen des jeweiligen Projekts eingesetzt werden.

Warum eigentlich? Lesen Sie den Blog weiter; Sie werden eine Antwort erhalten ;)

Bevor wir mit dem Blogbeitrag beginnen, möchten wir B13 GmbH für die Entwicklung und Pflege der EXT TYPO3-Erweiterung danken, die einen alternativen Ansatz zu Grid Elements bietet. Unser Dank gilt auch dem Grid Elements-Team für seinen langjährigen Beitrag zur TYPO3-Community.

Jetzt wollen wir herausfinden, wie man von EXT.gridelements zu EXT:container mit zwei Optionen migrieren kann.

Wenn Sie an einer manuellen Migration von Grid Elements zu EXT:container interessiert sind, dann versuchen Sie es mit der folgenden Schritt-für-Schritt-Anleitung.

Hinweis: Die folgenden Beispiele wurden ursprünglich mit den nachstehenden Versionen getestet.

• TYPO3 10.4.20
• TYPO3 11.5.4 LTS
• EXT.gridelements 9.4.0
• EXT:container 1.4.0

Schritt 1. Beispielkonfiguration von Grid Elements

Zu Testzwecken finden Sie hier die Beispielkonfiguration von Grid Elements für den Datensatz.

mod.web_layout.BackendLayouts {
  yourKey {
    title = Your Title
    icon = EXT:yourpackage/Resources/Public/Images/BackendLayouts/yourIcon.gif
    config {
      backend_layout {
        colCount = 2
        rowCount = 1
        rows {
          1 {
            columns {
              1 {
                name = Column1
                colPos = 1
              }
              2 {
                name = Column2
                colPos = 2
              }
            }
          }
        }
      }
    }
  }
}

Schritt 2. EXT:container Konfiguration registrieren

Lassen Sie uns die Konfiguration von EXT:container genauso wie EXT.gridelements mit Simple title und colPos erstellen.

$containerRegistry->configureContainer(
    (
    new \B13\Container\Tca\ContainerConfiguration(
        'yourKey',
        'Your Title',
        '',
        [
            [
                [
                    'name' => 'Column1',
                    'colPos' => 1
                ],
                [
                    'name' => 'Column2',
                    'colPos' => 2
                ],
            ]
        ]
    )
    )
);

Schritt 3. CType migrieren (mit Update-SQL)

Nun ist es an der Zeit, alle CType-Datensätze des Grid Element in den Container zu migrieren.

UPDATE `tt_content` SET `CType`=CONCAT('yourKey’, `tx_gridelements_backend_layout`) WHERE `CType`='gridelements_pi1';

UPDATE `tt_content` SET `colPos`= `tx_gridelements_columns`,`tx_container_parent`=`tx_gridelements_container` WHERE `colPos`=-1;

Schritt 4. TYPO3 Fluid-Vorlage einrichten

mit `lib.containerElement`, Wir müssen die Standardkonfiguration von TypoScript so einrichten, dass sie Ihr benutzerdefiniertes Layout, Ihre Vorlagen und Teilbereiche außer Kraft setzt.

lib.containerElement =< lib.contentElement
lib.containerElement {
    layoutRootPaths {
        100 = EXT:fluid_styled_content/Resources/Private/Layouts
        110 = EXT:yourpackage/Resources/Private/Layouts/Containers
    }

    templateRootPaths {
        100 = EXT:fluid_styled_content/Resources/Private/Templates
        110 = EXT:yourpackage/Resources/Private/Templates/Containers
    }

    partialRootPaths {
        100 = EXT:fluid_styled_content/Resources/Private/Partials
        110 = EXT:yourpackage/Resources/Private/Partials/Containers
    }

    dataProcessing {
        10 = B13\Container\DataProcessing\ContainerProcessor
    }
}

Schritt 5. Dem Container zuweisen

Sie müssen eine Reihe von TypoScript-Objekten Ihres Containers erstellen, um `lib.containerElement` zuzuweisen, indem Sie den Namen der Fluid-Vorlage zuweisen.

tt_content.yourKey < lib.containerElement
tt_content.yourKey {
    templateName = yourTemplate
}

Schritt 6. Erledigt!

Jetzt ist Ihre TYPO3 Fluid-Vorlage bereit für den Container.

Grid Elements und EXT bieten unterschiedliche Ansätze zur Konfiguration der erlaubten Inhaltselemente. EXT kann zusammen mit kompatiblen TYPO3-Erweiterungen wie EXT verwendet werden, um erlaubte oder eingeschränkte Inhaltselementtypen zu definieren.

EXT:container ist eine kompatible TYPO3-Erweiterung EXT.content_defender. Es ist sehr nützlich, erlaubte oder verweigerte Inhaltselementtypen zu definieren.

Hier ist die Beispielkonfiguration des Containers mit EXT.content_defender.

$containerRegistry->configureContainer(
    (
    new \B13\Container\Tca\ContainerConfiguration(
        'YourName',
        'YourTitle',
        '',
        [
            [
                [
                    'name' => 'Column1',
                    'colPos' => 1,
                    'allowed' => [
                        'CType' => 'header,text,textpic,image,textmedia,bullets,form_formframework'
                    ]
                ],
                [
                    'name' => 'Column2',
                    'colPos' => 2,
                    'allowed' => [
                        'CType' => 'header,text,textpic,image,textmedia,bullets,form_formframework'
                    ]
                ],
            ]
        ]
    )
    )
);

Vielen Dank, dass Sie meinen Blog gelesen haben. Ich hoffe, der Beitrag hat Ihnen gefallen und Sie konnten dabei etwas Neues lernen.

Haben Sie bereits ein TYPO3-Projekt von Grid Elements zu EXT:container migriert? Wir würden gerne von Ihren Erfahrungen und Ihrem gewählten Migrationsansatz hören. Teilen Sie Ihre Gedanken gerne im Kommentarfeld mit.

Viel Erfolg bei der Migration!