Wie migriere Grid-Element zur Container Erweiterung in TYPO3?

Möchten Sie die bekannten EXT.gridelements auf die neuen EXT.container TYPO3 Extensions migrieren? In diesem Artikel finden Sie zwei Möglichkeiten (1. Automatische Erweiterung basiert, 2. Manuell migrieren), um erfolgreich von alten EXT.gridelements zu neuen glänzenden EXT.container TYPO3 Erweiterungen zu aktualisieren.

Die EXT.gridelements Extension ist seit vielen Jahren die einzige TYPO3 Extension, die ein flexibles Grid-System zur Verfügung stellt - die Community schätzt ihr Engagement und ihre Bemühungen. Moderne TYPO3-Websites brauchen mehr Flexibilität als das Standard-Backend-Layout-Feature von TYPO3. Glücklicherweise sind die TYPO3-Leute immer begierig auf Innovationen, und EXT.container wurde eingeführt.

Seit letztem Jahr haben wir (T3Terminal und NITSAN) haben bereits alle bestehenden Systeme migriert TYPO3-Vorlagen von EXT.gridelements zu EXT:container (natürlich, neue Projekte werden nur mit EXT.container entwickelt ;)

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

Bevor wir mit dem Blog beginnen, möchten wir diesen Blog der B13 GmbH widmen, die die coole EXT.container TYPO3 Extension - Eine Alternative zu EXT.gridelements - entwickelt und betreut hat. #T3Kudos an alle, die zu dieser TYPO3-Extension beigetragen haben. Natürlich danke ich auch dem Team Gridelements, das der TYPO3-Community seit Jahren eine so gute Lösung zur Verfügung stellt.

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

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

Hinweis: Die folgenden Schritte wurden in der unten aufgeführten Version getestet.

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

Schritt 1. Beispielkonfiguration von EXT.gridelements

Zu Testzwecken finden Sie hier die Beispielkonfiguration von EXT.gridelements 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-Elements 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.

Standardmäßig bietet EXT.gridelements eine Funktion, um die Konfiguration von Inhaltselementen zu erlauben oder zu verbieten. Aber, EXT.container bietet keine solche Anpassung.

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'
                    ]
                ],
            ]
        ]
    )
    )
);

Danke, dass Sie meinen Blog gelesen haben. Ich hoffe, es hat Ihnen gefallen und Sie haben gut gelernt.

Sind Sie ein Fan der TYPO3 EXT.container extension? Und warum? Was ist Ihre Lieblingsmethode, um EXT.gridelements zu EXT.container zu migrieren? Ich würde gerne Ihre Meinung in der Kommentarbox erfahren.

Have a Happy Migration!