DIVI 5 Migration: Der komplette Guide für Agenturen
KI-generiertInhalt
DIVI 5 ist ein kompletter Rewrite – und Ihre Custom-Module laufen erstmal nur im Kompatibilitätsmodus. Was das bedeutet und wie Sie richtig migrieren.
DIVI 5 ist nicht einfach ein Update – es ist eine komplette Neuentwicklung. Elegant Themes hat den Builder von Grund auf neu geschrieben. Das bringt massive Performance-Vorteile, bedeutet aber auch: Ihre Custom-Module aus dem DIVI Module Builder müssen angepasst werden.
Das Problem: Kompatibilitätsmodus
Wenn Sie mit dem DIVI Module Builder oder eigenen Extensions Custom-Module gebaut haben, werden diese nach dem Update auf DIVI 5 nicht einfach verschwinden. Sie funktionieren weiterhin – aber im sogenannten Kompatibilitätsmodus.
Wichtig zu verstehen
Wenn eine Seite auch nur EIN Modul enthält, das nicht für DIVI 5 migriert wurde, wird für diese Seite das komplette DIVI 4 Framework geladen. Die Performance-Vorteile von DIVI 5 sind damit für diese Seite dahin.
Das bedeutet konkret: Sie bauen sich eine technische Schuld auf. Je länger Sie warten, desto mehr Seiten nutzen den langsamen Kompatibilitätsmodus.
Was sich technisch ändert
DIVI 5 ist ein fundamentaler Architektur-Wechsel. Hier die wichtigsten Unterschiede:
| Aspekt | DIVI 4 | DIVI 5 |
|---|---|---|
| Datenspeicherung | Shortcodes | JSON/Block-Format |
| Visual Builder | JSX (React) | TypeScript/React |
| Settings-Definition | get_fields() in PHP | module.json + TypeScript |
| PHP-Struktur | Eine große Klasse | Modulare Traits |
| Styling | CSS + Inline-Styles | SCSS + CSS-in-JS |
Von Shortcodes zu Blocks
Der größte Unterschied: DIVI 4 speichert Module als WordPress-Shortcodes:
[et_pb_custom_module title="Hallo Welt" _builder_version="4.27.0"]
Hier steht der Inhalt...
[/et_pb_custom_module]
DIVI 5 verwendet stattdessen ein JSON-basiertes Block-Format:
{
"id": "module-abc123",
"name": "d5/custom-module",
"attrs": {
"title": {
"desktop": { "value": "Hallo Welt" }
}
}
}
Der DIVI 5 Migrator
Jetzt die gute Nachricht: Sie müssen nicht jede Seite manuell anfassen! DIVI 5 kommt mit einem eingebauten Migrator-System:
WordPress Admin → Divi → Divi 5 Migrator
Was der Migrator macht
Compatibility Check
Scannt Ihre komplette Website und erstellt einen detaillierten Report: Welche Module sind kompatibel, welche nicht?
Automatische Konvertierung
Alle kompatiblen Module werden automatisch vom Shortcode-Format ins neue Block-Format konvertiert.
Legacy-Wrapping
Module ohne DIVI 5 Support werden in Shortcodes verpackt und laufen im Kompatibilitätsmodus weiter.
Der Schlüssel: d4Name
Damit der Migrator Ihr neues DIVI 5 Modul als Nachfolger des alten erkennt, muss der d4Name in der module.json exakt dem alten Slug entsprechen.
Der Migrations-Workflow
Inventar erstellen
Listen Sie alle Ihre Custom-Module auf: Name, Typ, Anzahl der Settings.
Extension-Boilerplate klonen
Holen Sie sich das offizielle Example-Repo von Elegant Themes.
Module einzeln migrieren
Beginnen Sie mit dem einfachsten Modul. Erstellen Sie alle erforderlichen DIVI 5 Dateien.
Auf Staging testen
Aktivieren Sie Ihre neue Extension auf einer Staging-Umgebung. Führen Sie den Migrator aus.
Live schalten
Wenn alles funktioniert: Backup erstellen, Extension auf Live aktivieren.
Die neue Dateistruktur
Ein DIVI 5 Modul besteht aus deutlich mehr Dateien als in DIVI 4:
my-divi5-extension/
├── modules/
│ └── MyModule/
│ ├── MyModuleTrait/
│ │ ├── CustomCssTrait.php
│ │ ├── ModuleStylesTrait.php
│ │ └── RenderCallbackTrait.php
│ └── MyModule.php
├── src/
│ └── components/
│ └── my-module/
│ ├── module.json
│ ├── edit.tsx
│ ├── settings-content.tsx
│ ├── settings-design.tsx
│ └── styles.tsx
├── package.json
└── webpack.config.js
Migrations-Checkliste
Für jedes Modul sollten Sie folgende Punkte abhaken:
Checkliste
Fazit und Empfehlung
DIVI 5 ist ein großer Schritt nach vorne – aber er erfordert Arbeit. Die gute Nachricht: Sie müssen nicht alles auf einmal migrieren.
Meine Empfehlung: Beginnen Sie jetzt mit der Migration Ihrer wichtigsten Module. Je länger Sie warten, desto mehr technische Schulden häufen Sie an.
Michael Rademacher, realmaker
Ressourcen
Michael Rademacher
Gründer von realmaker
Michael Rademacher gründete realmaker 2003. Er entwickelt WordPress-Websites und Software, produziert Filme und Livestreams und schreibt hier über das, was er in Kundenprojekten lernt.
Über MichaelLieber betreuen lassen?
Updates, Backups und Überwachung übernimmt wp-einfach.de – zum festen Monatspreis.
