DIVI 5 Migration: Der komplette Guide für Agenturen

Holzklötze wandern von einem Holztablett in ein weißes Tablett, dazwischen eine kobaltblaue KugelKI-generiert
Inhalt

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:

AspektDIVI 4DIVI 5
DatenspeicherungShortcodesJSON/Block-Format
Visual BuilderJSX (React)TypeScript/React
Settings-Definitionget_fields() in PHPmodule.json + TypeScript
PHP-StrukturEine große KlasseModulare Traits
StylingCSS + Inline-StylesSCSS + 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

  1. Compatibility Check

    Scannt Ihre komplette Website und erstellt einen detaillierten Report: Welche Module sind kompatibel, welche nicht?

  2. Automatische Konvertierung

    Alle kompatiblen Module werden automatisch vom Shortcode-Format ins neue Block-Format konvertiert.

  3. 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

  1. Inventar erstellen

    Listen Sie alle Ihre Custom-Module auf: Name, Typ, Anzahl der Settings.

  2. Extension-Boilerplate klonen

    Holen Sie sich das offizielle Example-Repo von Elegant Themes.

  3. Module einzeln migrieren

    Beginnen Sie mit dem einfachsten Modul. Erstellen Sie alle erforderlichen DIVI 5 Dateien.

  4. Auf Staging testen

    Aktivieren Sie Ihre neue Extension auf einer Staging-Umgebung. Führen Sie den Migrator aus.

  5. 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 Michael

Lieber betreuen lassen?

Updates, Backups und Überwachung übernimmt wp-einfach.de – zum festen Monatspreis.

Zu wp-einfach.de