Probleme nach dem Aktualisieren.

DXPR Builder lernenWebsite verwaltenProblem beheben

Bringen Sie ein fehlgeschlagenes Update zu Ende. Fast immer wurde der Code aktualisiert, aber nicht die Datenbank, eine übrige Modulkopie steht im Weg oder eine Abhängigkeit fehlt.

Update in der richtigen Reihenfolge ausführen

  1. Sichern Sie die Datenbank.
  2. Führen Sie composer require drupal/dxpr_builder aus, mit einer Versionsbedingung, falls Sie Releases pinnen.
  3. Führen Sie drush updb -y aus (oder besuchen Sie /update.php).
  4. Führen Sie drush cr aus.
  5. Öffnen Sie eine Builder-Seite und speichern Sie sie erneut.

Wichtig: Deinstallieren Sie das Modul für ein Update niemals. Eine Deinstallation löscht gespeicherte Vorlagen, Profile und Einstellungen.

Composer zeigt einen Fehler

  • „Could not find a version of package drupal/dxpr_builder matching your minimum-stability“. 3.x erscheint als Beta-Releases. Erlauben Sie sie in der Bedingung: composer require 'drupal/dxpr_builder:^3.0@beta'.
  • „Could not find a matching version of package dxpr/dxpr_builder“. Das Paket auf drupal.org heißt drupal/dxpr_builder. Ersetzen Sie dxpr/dxpr_builder durch drupal/dxpr_builder in composer.json und führen Sie dann composer update drupal/dxpr_builder aus.
  • Composer verweigert, weil der Ordner nicht per Composer verwaltet wird. Eine Kopie wurde von Hand hochgeladen. Löschen Sie modules/contrib/dxpr_builder und führen Sie den require-Befehl erneut aus.
  • „Disk quota exceeded“ oder „write failed“. Schaffen Sie vor dem erneuten Versuch Speicherplatz auf dem Server frei.

Das Datenbank-Update schlägt fehl

  • „Unable to install modules key due to missing modules key“. 3.x braucht das Key-Modul, und Update 9020 installiert es. Sein Code fehlt, weil das Modul nicht mit Composer installiert wurde. Führen Sie composer require drupal/key aus, dann drush updb -y erneut aus.
  • Ein benannter Update-Hook schlägt fehl. Führen Sie drush updb -vvv aus und fügen Sie den kompletten Fehler Ihrem Ticket bei.
  • „module 'dxpr_builder_page' is missing its dependency module field_group“. Das Submodul DXPR Builder Drag and Drop Page braucht Field Group. Führen Sie composer require drupal/field_group aus, dann drush en dxpr_builder_page -y aus.

Seiten wirken nach dem Update kaputt

Manche Releases konvertieren altes Markup, etwa Owl-Karussells und Kreis-Zähler, in Stapeln während drush updb. Fehlgeschlagene Elemente bleiben ausstehend.

  1. Gehen Sie zu DXPR Studio > DXPR Builder > Content items > Migrations (/admin/dxpr_studio/dxpr_builder/migration-status).
  2. Zeigt eine Migration Pending an, klicken Sie auf Run now oder Run all pending migrations.
  3. Prüfen Sie unter Reports > Recent log messages die Elemente, die ein Stapel übersprungen hat.

Composer verweigert ein Drupal-Core-Major-Upgrade

DXPR Builder 3.x unterstützt Drupal 10.2 und höher sowie Drupal 11.

  1. Prüfen Sie die Release-Notes von DXPR Builder, DXPR Theme und DXPR Theme Helper auf die Version, die den neuen Major unterstützt.
  2. Führen Sie Upgrade Status aus, um zu sehen, welche Pakete nicht bereit sind.
  3. Pinnen Sie den Core-Major in composer.json. Ein uneingeschränktes composer require drupal/core-recommended kann versehentlich den nächsten Major ziehen.

Der Editor ging direkt nach dem Update kaputt

Folgen Sie Der Editor erscheint nicht. Die häufigsten Ursachen dort folgen auf ein Teil-Update: ausstehende Datenbank-Updates, veraltete Dateien und ein Aggregations-Cache aus dem alten Release.

Ich migriere von Glazed Builder

DXPR Builder 3.x konvertiert keine Glazed-Klassennamen in gespeicherten Inhalten mehr. Aktualisieren Sie zuerst auf das letzte 2.x-Release und führen Sie dessen Datenbank-Updates aus, dann auf 3.x. Siehe Von DXPR Builder 1.x oder 2.x migrieren.

Die Lösung bestätigen

drush updb meldet keine ausstehenden Updates, drush pm:list --filter=dxpr zeigt die beabsichtigten Versionen, und eine erneut gespeicherte Builder-Seite rendert im Editor und für Besucher gleich.

Wie geht es weiter?

DXPR Builder aktualisieren: das Routine-Update-Verfahren.