Dolibarr ist eine leistungsstarke Open-Source-ERP- und CRM-Lösung, die von Unternehmen jeder Größe zur Verwaltung von Vorgängen wie Rechnungsstellung, Inventar, Personalwesen und mehr eingesetzt wird. Wie bei jedem Business-Tool sind Branding und visuelle Identität wichtig. Einer der ersten Schritte, um Dolibarr wirklich zu Ihrem zu machen, ist die Anpassung des Erscheinungsbilds – insbesondere des Logos und des Farbschemas. Diese umfassende Anleitung führt Sie Schritt für Schritt durch den gesamten Prozess, damit Ihre Dolibarr-Instanz die Marke Ihres Unternehmens widerspiegelt.

Inhaltsverzeichnis

  1. Einführung in Dolibarr

  2. Warum Dolibarr anpassen?

  3. Die Dateistruktur von Dolibarr verstehen

  4. Vorbereiten Ihrer benutzerdefinierten Assets

  5. Ändern des Logos

    • Logo der Anmeldeseite

    • Logo für die obere Navigation

    • PDF-Dokument-Logos

  6. Anpassen des Farbschemas

    • CSS-Dateien und Designs

    • Ändern von Designdateien

    • Benutzerdefiniertes CSS verwenden

  7. Erstellen und Anwenden eines benutzerdefinierten Designs

  8. Tipps zum Beibehalten von Anpassungen während Updates

  9. Zurückkehren zum Standardaussehen

  10. Abschließende Gedanken und Best Practices

1. Einführung in Dolibarr

Dolibarr ERP/CRM ist eine modulare Software-Suite, die Unternehmen die Verwaltung einer Vielzahl von Aktivitäten ermöglicht. Sie basiert auf PHP und nutzt MySQL oder PostgreSQL für die Datenbankverwaltung. Dank Open Source bietet sie ein hohes Maß an Flexibilität und Anpassungsmöglichkeiten. Nutzer können sie an ihre spezifischen betrieblichen Anforderungen anpassen, ohne die Lizenzbeschränkungen proprietärer Software.

Dolibarr kann vor Ort installiert oder auf einem Cloud-Server gehostet werden und ist somit für eine breite Nutzerbasis zugänglich. Es ist beliebt bei kleinen und mittleren Unternehmen (KMU), Freiberuflern und NGOs, die eine Komplettlösung für ihr Geschäftsmanagement suchen.

2. Warum Dolibarr anpassen?

Markenkonsistenz ist für die interne und externe Kommunikation unerlässlich. Eine personalisierte Dolibarr-Installation kann:

  • Verbessern Sie die Benutzererfahrung, indem Sie die Benutzeroberfläche an das Unternehmensbranding anpassen

  • Verbessern Sie die Professionalität bei Kundeninteraktionen (z. B. beim Senden von PDF-Rechnungen)

  • Erleichtern Sie die Navigation und interne Nutzung Ihrer Instanz

Bei der Anpassung geht es nicht nur um Ästhetik, sondern auch um Benutzerfreundlichkeit und Identität. Indem Sie das Erscheinungsbild von Dolibarr anpassen, integrieren Sie es besser in das Ökosystem Ihres Unternehmens.

3. Die Dateistruktur von Dolibarr verstehen

Bevor Sie Änderungen vornehmen, ist es wichtig, die Struktur von Dolibarr zu verstehen. Wenn Sie wissen, wo bestimmte Dateien zu finden sind, sparen Sie Zeit und vermeiden unnötige Fehler.

Die typische Dolibarr-Installation umfasst die folgenden Verzeichnisse:

  • /htdocs - Das wichtigste über das Internet zugängliche Verzeichnis

  • /htdocs/theme - Enthält alle themenbezogenen Dateien

  • /htdocs/includes - Enthält Kernkonfigurationsdateien

  • /documents - Speichert hochgeladene Dokumente und Logos

Innerhalb /htdocs/theme, jeder Unterordner entspricht einem Thema (z. B. eldy, md, bureau2crea). Jeder Designordner enthält CSS-Dateien, Bilder und JavaScript, die für dieses Design spezifisch sind.

4. Vorbereiten Ihrer benutzerdefinierten Assets

Bevor Sie mit den Änderungen beginnen, sammeln Sie Ihre benutzerdefinierten Assets:

  • Logodateien: Vorzugsweise im PNG-Format mit transparentem Hintergrund

  • Farbcodes: Hex-Codes der Primär- und Sekundärfarben Ihrer Marke

  • Sicherungskopie: Sichern Sie vor der Änderung immer die Original-Designdateien

Wenn diese bereitstehen, ist ein reibungsloser Anpassungsprozess gewährleistet.

5. Ändern des Logos

Dolibarr verwendet für verschiedene Bereiche der Anwendung unterschiedliche Logos. Sie müssen Ihr neues Logo an mehreren Stellen ersetzen oder darauf verweisen.

Logo der Anmeldeseite

Das Logo der Anmeldeseite befindet sich häufig unter folgendem Pfad:

/htdocs/theme/eldy/img/logo_login.png

So ändern Sie es:

  1. Benennen Sie Ihr benutzerdefiniertes Logo um in logo_login.png.

  2. Ersetzen Sie die Originaldatei in der img Verzeichnis.

  3. Leeren Sie den Browser-Cache oder starten Sie den Webserver neu, um die Änderungen anzuzeigen.

Logo für die obere Navigation

Das Logo oben links in der Kopfzeile der Anwendung befindet sich hier:

/htdocs/theme/eldy/img/logo_setup.png

Schritte zur Änderung:

  1. Benennen Sie Ihr neues Logo um in logo_setup.png.

  2. Ersetzen Sie die Datei in der gleichen img Verzeichnis.

  3. Passen Sie die Größe optional per CSS an, wenn es nicht richtig passt.

PDF-Dokument-Logos

Auch Rechnungen, Angebote und andere von Dolibarr erstellte PDF-Dokumente verwenden Logos. Diese werden üblicherweise im Dokumentenverzeichnis gespeichert oder pro Drittanbieter bzw. Unternehmen angegeben.

So legen Sie ein benutzerdefiniertes Logo fest:

  1. Gehe zu Home > Setup > Firma/Organisation.

  2. Laden Sie Ihr Logo im Abschnitt „Auf Dokumenten verwendetes Logo“ hoch.

  3. Speichern Sie die Einstellungen und testen Sie durch die Generierung einer PDF-Rechnung.

Jeder Drittanbieter kann außerdem individuell sein eigenes Logo festlegen, was für den Betrieb mit mehreren Standorten oder mehreren Marken nützlich ist.

6. Anpassen des Farbschemas

Dolibarr-Themes werden mit CSS erstellt. Das Standard-Theme heißt eldy, aber es gibt noch andere, die geklont oder geändert werden können.

CSS-Dateien und Designs

Die CSS-Dateien des Designs befinden sich in:

/htdocs/theme/eldy/style.css.php

Dies ist eine dynamische PHP-Datei, die CSS ausgibt. Durch direktes Bearbeiten können Sie Farben global ändern.

Zu den gängigen Farbreferenzen in der Datei gehören:

--colorbackbody: #f4f4f4;
--colorbackhmenu1: #333;
--colortexttitle: #222;

Ändern von Designdateien

So ändern Sie Farben:

  1. Öffne style.css.php in einem Code-Editor.

  2. Suchen Sie nach der CSS-Variable, die Sie ändern möchten (z. B. --colorbackbody).

  3. Ersetzen Sie den Wert durch Ihre Markenfarbe.

  4. Speichern und aktualisieren Sie Ihre Dolibarr-Instanz.

Testen Sie immer zuerst in einer Entwicklungsumgebung.

Benutzerdefiniertes CSS verwenden

Anstatt das Standarddesign zu bearbeiten, können Sie eine benutzerdefinierte CSS-Datei erstellen:

  1. Kopieren Sie den vorhandenen Themenordner und benennen Sie ihn um (z. B. mytheme).

  2. Ändern style.css.php und alle darin enthaltenen Bildelemente.

  3. Gehe zu Home > Setup > Anzeige > Design und wählen Sie Ihr benutzerdefiniertes Design aus.

Dies ist ein sichererer Ansatz, da dadurch vermieden wird, dass Änderungen bei Aktualisierungen überschrieben werden.

7. Erstellen und Anwenden eines benutzerdefinierten Designs

So erstellen Sie ein vollständig benutzerdefiniertes Design:

  1. Duplizieren eines vorhandenen Themenordners:

cp -r /htdocs/theme/eldy /htdocs/theme/mytheme

  1. Bearbeiten style.css.php im neuen Ordner, damit es zu Ihrer Farbpalette passt.

  2. Bildelemente ersetzen (wie Logos) in Ihrem benutzerdefinierten Designverzeichnis.

  3. Aktualisieren Sie die Themenauswahl in den Einstellungen von Dolibarr.

Dieser Ansatz ermöglicht die vollständige Kontrolle über die Benutzeroberfläche und gewährleistet die Kompatibilität mit zukünftigen Updates (vorausgesetzt, Dolibarr überarbeitet die Themenverwaltung nicht).

8. Tipps zur Beibehaltung von Anpassungen bei Updates

Dolibarr wird aktiv gepflegt, und Updates können Kerndateien überschreiben. So vermeiden Sie den Verlust Ihrer Anpassungen:

  • Verwenden Sie einen benutzerdefinierten Designordner: Ändern Sie das Standarddesign niemals direkt.

  • Dokumentieren Sie Ihre Änderungen: Führen Sie ein Änderungsprotokoll der bearbeiteten Dateien und ersetzten Assets.

  • Automatisieren Sie Backups: Regelmäßige Backups helfen Ihnen beim Wiederherstellen, wenn durch Updates etwas kaputt geht.

  • Testen Sie Updates in einer Staging-Umgebung: Aktualisieren Sie Ihre Live-Installation niemals ohne Tests.

Wenn Sie diese Vorgehensweisen befolgen, sparen Sie sich stundenlange Nacharbeit.

9. Zurück zum Standard-Erscheinungsbild

Wenn etwas schief geht oder Sie einfach zurück möchten:

  1. Stellen Sie die Original-Logodateien aus einer Sicherung wieder her.

  2. Wechseln Sie zurück zum Standarddesign unter Anzeige > Design.

  3. Löschen Sie Ihren benutzerdefinierten Designordner oder benennen Sie ihn um, um Konflikte zu vermeiden.

10. Abschließende Gedanken und bewährte Vorgehensweisen

Die Anpassung von Dolibarr kann die Benutzererfahrung verbessern und die Marke Ihres Unternehmens stärken. Wichtig ist jedoch, dies systematisch zu tun:

  • Planen Sie Ihre Änderungen im Voraus.

  • Verwenden Sie Entwicklungs- und Stagingumgebungen.

  • Bewahren Sie Backups und Dokumentationen auf.

  • Bleiben Sie bei benutzerdefinierten Designs, um Störungen während Upgrades zu minimieren.

Ob Sie ein Logo anpassen oder die gesamte Benutzeroberfläche überarbeiten – durch die Personalisierung wird Dolibarr zu einem selbstverständlichen Bestandteil Ihres Geschäftsbetriebs. Mit den Schritten in dieser Anleitung können Sie das Erscheinungsbild Ihrer Instanz sicher steuern.