Inhaltsverzeichnis

  1. Einführung

  2. Warum nach einem Update Anzeigeprobleme auftreten

  3. Häufige Arten von Anzeigeproblemen

  4. Vorbereitung auf Updates: Vorbeugen ist besser als Heilen

  5. Erste Schritte zur Diagnose von UI-Problemen

  6. Cache und Browserdaten löschen

  7. Theme-Kompatibilität und CSS-Konflikte

  8. Defekte Menüs, Schaltflächen oder Layouts

  9. JavaScript-Fehler und wie man sie erkennt

  10. Modulkonflikte und Legacy-Code

  11. Vorübergehendes Zurücksetzen auf eine stabile Schnittstelle

  12. Wenn CustomizeInterface oder Oblyon kaputt gehen

  13. Verwenden der Entwicklertools in Ihrem Browser

  14. Beheben von Problemen mit Sprachdateien und Beschriftungen

  15. Probleme an die Dolibarr-Community melden

  16. Best Practices für langfristige Schnittstellenstabilität

1. Einleitung

Dolibarr ERP/CRM entwickelt sich rasant weiter. Jede neue Version bringt Verbesserungen, Fehlerbehebungen und Architekturänderungen mit sich. Dies gewährleistet zwar eine kontinuierliche Verbesserung, führt aber manchmal zu Anzeigeproblemen – insbesondere bei Anpassungen, veralteten Modulen oder Browser-Caches. Dieser Artikel bietet eine vollständige Anleitung zur Identifizierung und Behebung von Anzeigeproblemen nach der Aktualisierung Ihrer Dolibarr-Instanz.

2. Warum nach einem Update Anzeigeprobleme auftreten

Zu den häufigsten Ursachen zählen:

  • CSS- oder JavaScript-Änderungen in Kerndateien

  • Alte Designs oder Module sind nicht mehr kompatibel

  • Browser-Cache mit veralteten Assets

  • Benutzerdefinierter Code steht im Konflikt mit neuen DOM-Strukturen

  • In Sprach- oder Übersetzungsdateien fehlen neue Zeichenfolgen

Diese Probleme treten häufig bei Open-Source-ERP-Plattformen auf, bei denen Modularität und Anpassung wichtige Merkmale sind.

3. Häufige Arten von Anzeigeproblemen

Hier sind typische UI-Probleme nach Updates:

  • Fehlende Menüs oder Elemente in der Seitenleiste

  • Überlappende Schaltflächen oder fehlerhafte Layouts

  • Felder werden nicht richtig angezeigt

  • Tabs reagieren nicht auf Klicks

  • Leere Abschnitte in Formularen oder Dashboards

  • Unerwartete Farben, Symbole oder Schriftarten

4. Vorbereitung auf Updates: Vorbeugen ist besser als Heilen

Vor dem Upgrade:

  • Sichern Sie die gesamte Datenbank und das Dateisystem

  • Deaktivieren Sie Drittanbietermodule vorübergehend

  • Dokumentieren Sie alle benutzerdefinierten Designs oder CSS

  • Beachten Sie die vorherige Versionsnummer und die Änderungsprotokolle

  • Testen Sie zuerst in einer Staging-Umgebung

Durch die Durchführung dieser Schritte verringern Sie Ihr Risiko und verkürzen die Genesungszeit.

5. Erste Schritte zur Diagnose von UI-Problemen

Wenn nach der Aktualisierung Anzeigeprobleme auftreten:

  1. Öffnen Sie Dolibarr in einem privaten/Inkognito-Fenster

  2. Wechseln Sie zum Standarddesign (z. B. Eldy).

  3. Vergleichen Sie Administrator- und normale Benutzerbildschirme

  4. Aktivieren Sie den Debug-Modus in conf.php

Auf diese Weise können Sie feststellen, ob es sich um ein Cache-Problem, ein Designproblem oder einen tiefer liegenden Fehler handelt.

6. Cache und Browserdaten löschen

Ein entscheidender erster Schritt:

  • Browser-Cache leeren (STRG+UMSCHALT+ENTF)

  • Löschen Sie den Cache-Ordner von Dolibarr: documents/temp/

  • Entfernen Sie alle zwischengespeicherten CSS/JS-Dateien in theme/

  • Neustart des Webservers (insbesondere nach PHP-Änderungen)

Viele UI-Probleme verschwinden nach dem Leeren des Caches.

7. Theme-Kompatibilität und CSS-Konflikte

Wenn Sie Oblyon oder ein anderes benutzerdefiniertes Design verwenden:

  • Stellen Sie sicher, dass die neue Dolibarr-Version unterstützt wird

  • Überprüfen Sie die Änderungsprotokolle auf veraltete Selektoren oder Klassen

  • Stellen Sie das Eldy-Design wieder her und testen Sie es erneut

  • Suchen Sie nach überschriebenen .tpl.php or .css Dateien

CSS-Selektoren oder Vorlagenänderungen im Dolibarr-Kern können visuelle Layouts unbemerkt beschädigen.

8. Defekte Menüs, Schaltflächen oder Layouts

Häufig verursacht durch:

  • Änderungen in den wichtigsten JavaScript-Bibliotheken

  • Geänderte Menüpositionen werden nicht mehr unterstützt

  • Aktualisierungen der HTML-Struktur (z. B. hinzugefügte Wrapper)

Solutions:

  • Untersuchen Sie HTML mit Browser-Entwicklungstools

  • CSS-Überschreibungen basierend auf dem neuen Layout erneut anwenden

  • Menüpositionen in den Moduleinstellungen zurücksetzen

9. JavaScript-Fehler und wie man sie erkennt

Verwenden Sie die Entwicklerkonsole Ihres Browsers (F12 > Registerkarte „Konsole“):

  • Suchen Sie nach roten Fehlermeldungen (z. B. Uncaught ReferenceError)

  • Überprüfen Sie, aus welcher Datei sie stammen (Design, Modul oder Kern).

  • Deaktivieren Sie Plugins einzeln, um zu testen, was es verursacht

JS-Fehler können dazu führen, dass Dropdowns, Modale oder AJAX-Updates nicht mehr funktionieren.

10. Modulkonflikte und Legacy-Code

Nach der Aktualisierung von Dolibarr können einige ältere Module:

  • Laden Sie veraltete jQuery-Versionen

  • Verwenden Sie veraltete Hooks oder Trigger

  • Defekte Tabs oder Aktionen hinzufügen

Überprüfen Sie jedes Drittanbietermodul:

  • Nacheinander deaktivieren

  • Suchen Sie nach Fehlerprotokollen

  • Kontaktieren Sie die Entwickler für Updates

11. Vorübergehendes Zurücksetzen auf eine stabile Schnittstelle

So stabilisieren Sie das System:

  • Verwenden Sie vorübergehend das Eldy-Thema

  • Deaktivieren Sie alle optionalen Module

  • Berechtigungen von Grund auf neu zuweisen, wenn Menüs fehlen

Auf diese Weise können Sie arbeiten, während Sie tiefer liegende Probleme beheben.

12. Wenn CustomizeInterface oder Oblyon kaputt gehen

Beide Module basieren auf zentralen UI-Strukturen.

  • Überprüfen Sie, ob die neue Version von Dolibarr die HTML-Struktur geändert hat

  • Besuchen Sie Dolistore für die neuesten Modul-Updates

  • Problematisches CSS vorübergehend auskommentieren

  • Verwenden Sie den Debug-Modus des Moduls, falls verfügbar

13. Verwenden der Entwicklertools in Ihrem Browser

So überprüfen Sie Anzeigeprobleme:

  • Klicken Sie mit der rechten Maustaste auf ein defektes Element > Untersuchen

  • Überprüfen Sie angewendete Stile und übernommene Regeln

  • Testen Sie Änderungen live im Browser, um CSS zu korrigieren

  • Überprüfen Sie die Registerkarte „Netzwerk“ auf fehlende Assets (404-Fehler).

Dies ist Ihr bester Verbündeter bei der Lösung von Front-End-Problemen.

14. Beheben von Problemen mit Sprachdateien und Beschriftungen

Nach den Updates stellen Sie möglicherweise Folgendes fest:

  • Fehlende Übersetzungen

  • Alte Etiketten werden nicht angezeigt

Fixes:

  • Sprachcache leeren (admin/tools.php?action=clear_langcache)

  • Aktualisieren Sie Ihre Sprachpakete bei Bedarf manuell

  • Suchen Sie nach Dateiüberschreibungen in langs/custom/

15. Melden von Problemen an die Dolibarr-Community

Wenn alles andere fehlschlägt:

  • Besuchen Sie github.com/Dolibarr/dolibarr/issues

  • Einschließen: Versionsinformationen, Screenshots, Fehlerprotokolle, Modulliste

  • Seien Sie genau: Browser, Betriebssystem, verwendete benutzerdefinierte Designs

Die Community ist aktiv und reaktionsschnell.

16. Best Practices für langfristige Schnittstellenstabilität

  • Vermeiden Sie die Änderung von Kerndateien – verwenden Sie Hooks und Overrides

  • Halten Sie Themen und Module auf dem neuesten Stand

  • Verwenden Sie Staging-Umgebungen zum Testen von Updates

  • Dokumentieren Sie alle an der Benutzeroberfläche vorgenommenen Anpassungen

  • Treten Sie der Dolibarr-Community bei, um UI-bezogene Updates zu verfolgen