Installation und Update

Der Ablauf ist für alle sechs Module gleich. Er wird hier einmal beschrieben, und jede Modulseite verweist darauf, statt ihn auf eigene Weise zu wiederholen. Rechnen Sie mit drei Minuten.

Dolibarr: 19.0 Minimum
PHP: 7.4 Minimum
Speicherort: htdocs/custom/
Lizenz: GPL v3+

Voraussetzungen

Eine Dolibarr-Installation in Version 19.0 oder neuer. Die Version wird unter StartÜber angezeigt, und unten auf jeder Seite.
PHP 7.4 oder neuer, die Mindestversion, die alle sechs Deskriptoren angeben.
Der Ordner für externe Module, htdocs/custom/, vorhanden und beschreibbar, wenn Sie über die Oberfläche installieren.
Das Dolibarr-Modul, von dem das installierte Modul abhängt — je nach Fall Angebote oder Geschäftspartner. Jede Modulseite nennt es.
Ein Administratorkonto, für die Dauer der Aktivierung.

Über die Oberfläche installieren

Das ist der kürzeste Weg und der, den Sie zuerst versuchen sollten.

Laden Sie die ZIP-Datei des Moduls aus dem DoliStore auf Ihren Rechner herunter.
Öffnen Sie in Dolibarr StartEinstellungenModule/Anwendungen.
Öffnen Sie die Registerkarte „Externes Modul hinzufügen“, wählen Sie die ZIP-Datei aus und laden Sie sie hoch. Dolibarr entpackt sie selbst nach htdocs/custom/.
Das Modul erscheint in der Liste. Aktivieren Sie es mit dem Schalter in seiner Zeile.

Fehlt diese Registerkarte oder schlägt das Hochladen fehl, wurde das Hochladen von Modulen in dieser Installation deaktiviert, oder der Ordner custom ist nicht beschreibbar. Installieren Sie dann per Datei.

Per Datei installieren

Für Shared Hosting, bei dem das Hochladen über die Oberfläche gesperrt ist, oder für einen Server, auf den Sie per SSH zugreifen.

Entpacken Sie die ZIP-Datei auf Ihrem Rechner.
Laden Sie den entstandenen Ordner nach htdocs/custom/ hoch, ohne ihn umzubenennen. Sie sollten zum Beispiel htdocs/custom/dolixmasse/core/modules/… erhalten, und nicht htdocs/custom/dolixmasse/dolixmasse/….
Prüfen Sie, ob die Dateien für das Konto des Webservers lesbar sind. Nach einem Upload per FTP ist das die Prüfung, die die meisten Fälle löst.
Laden Sie StartEinstellungenModule/Anwendungen neu: Das Modul steht in der Liste. Aktivieren Sie es.

Aktivieren und Berechtigungen vergeben

Die Aktivierung legt an, was das Modul anlegen muss — seine Verlaufstabelle, wenn es eine hat, sein ergänzendes Attribut, wenn es eines hinzufügt. Sie löscht nichts.

Die Berechtigungen werden anschließend unter StartBenutzer und Gruppen vergeben, auf der Registerkarte „Berechtigungen“ des betreffenden Benutzers oder der betreffenden Gruppe.

Von jedem Modul hinzugefügte Berechtigungen
Modul	Eigene Berechtigung	Wo das Modul erscheint
Marge pro Tag	Keine	Kein Menüeintrag. Das Modul erscheint in der Ansicht und in der Liste der Angebote.
E-Mail-Domain ändern	Ja	Menü Geschäftspartner„Change an email domain“.
Massenbearbeitung	Ja	Menü Geschäftspartner„Bulk update“.
Aufgaben verschieben	Ja	Menü Projekte„Move tasks“ (Aufgaben verschieben).
Dublettenerkennung	Ja	Menü Geschäftspartner„Duplicates“.
Preise aktualisieren	Ja	Kein Menüeintrag. Die Schaltfläche erscheint in der Ansicht des Angebots, wenn dieses im Entwurf ist und mindestens eine Position enthält, die mit einem Produkt verknüpft ist.

Ein Modul aktualisieren

Holen Sie die neue Version aus dem DoliStore.
Deaktivieren Sie das Modul in der Modulliste. Die Deaktivierung löscht keine Daten: weder die Tabellen noch die Einstellungen noch die erfassten Werte.
Ersetzen Sie den Ordner des Moduls in htdocs/custom/ durch den neuen, oder laden Sie die ZIP-Datei erneut über die Registerkarte zum Hinzufügen hoch.
Aktivieren Sie das Modul wieder. Einstellungen und Verlauf sind unverändert vorhanden.

Die Versionshistorie jeder Modulseite ist aus der mit dem Modul gelieferten Datei ChangeLog.md übernommen: Es kann keine zwei verschiedenen Geschichten geben.
Auf jeder Modulseite, Abschnitt „Versionshistorie“

Deinstallieren, und was in der Datenbank bleibt

Wird ein Modul deaktiviert, verschwinden seine Bildschirme und Spalten. Was es in die Datenbank geschrieben hat, bleibt — das ist Absicht, damit eine versehentliche Deaktivierung nichts zerstört. Hier sehen Sie, Modul für Modul, was das umfasst.

Was jedes Modul nach der Deaktivierung in der Datenbank hinterlässt
Modul	Was es in Ihre Datenbank schreibt
Marge pro Tag	Keine Tabelle. Der Ordner des Moduls enthält kein Verzeichnis sql/. Bei der Aktivierung legt das Modul für die Angebote ein ergänzendes Attribut „Planned days“ (Code mpj_journees) an: Der Wert wird in der Tabelle der ergänzenden Attribute der Angebote gespeichert, die in Dolibarr bereits vorhanden ist.
E-Mail-Domain ändern	Eine Tabelle: llx_dolixdomaine_log. Sie speichert den Verlauf der Vorgänge (Datum, Benutzer, alte Domain, neue Domain, Anzahl der geänderten Geschäftspartner, Kontakte und Mitglieder, Mandant). Es werden keine Geschäftsdaten darin gespeichert.
Massenbearbeitung	Eine Tabelle: llx_dolixmasse_log. Sie speichert den Verlauf der Vorgänge (Datum, Benutzer, Objekt, Feld, angewendeter Filter, neuer Wert, Anzahl der geänderten Datensätze, Mandant). Es werden keine Geschäftsdaten darin gespeichert.
Aufgaben verschieben	Eine Tabelle: llx_dolixtaches_log. Sie speichert den Verlauf der Verschiebungen (Datum, Benutzer, ID der Aufgabe, ihre Referenz und ihre Bezeichnung zum Zeitpunkt der Verschiebung, Quellprojekt, Zielprojekt, Indikator für das Verschieben der Dokumente, Entität). Keine Geschäftsdaten werden dort gespeichert.
Dublettenerkennung	Eine Tabelle: llx_dolixdoublons_log. Sie speichert den Verlauf der Zusammenführungen (Datum, Benutzer, Objekttyp, beibehaltener Datensatz, zusammengeführter Datensatz, Namen beider Datensätze, Mandant).
Preise aktualisieren	Keine Tabelle, kein ergänzendes Attribut. Der Ordner des Moduls enthält kein Verzeichnis sql/. Das Modul speichert lediglich zwei Einstellungen in den Konstanten von Dolibarr.

Wenn das Modul nicht erscheint

Fünf Prüfungen, in dieser Reihenfolge. Sie decken die meisten Fälle ab.

Liegt der Ordner an der richtigen Stelle? Der Modulordner muss direkt in htdocs/custom/ liegen und genau seinen technischen Namen tragen — den auf seiner Modulseite angegebenen. Ein doppelt verschachtelter Ordner (custom/dolixmasse/dolixmasse) ist die häufigste Ursache.
Kann der Webserver die Dateien lesen? Nach dem Entpacken per FTP oder SSH gehören die Dateien manchmal einem anderen Konto als dem des Webservers. Das Modul bleibt dann in der Liste unsichtbar.
Ist die Dolibarr-Version ausreichend? Alle sechs Module verlangen mindestens Dolibarr 19.0 und mindestens PHP 7.4. Die Dolibarr-Version wird unter StartÜber angezeigt.
Ist das Modul aktiviert, von dem es abhängt? Jede Modulseite nennt das Dolibarr-Modul, das zuerst aktiviert werden muss — je nach Fall Angebote oder Geschäftspartner. Ohne dieses erscheint der erwartete Bildschirm nicht.
Wurden die Berechtigungen vergeben? Ein aktiviertes Modul ohne vergebene Berechtigung bleibt für den Benutzer unsichtbar. Die Berechtigungen werden unter StartBenutzer und Gruppen vergeben, Registerkarte „Berechtigungen“.

Nichts davon?

Schreiben Sie an support@dolix.fr mit Ihrer Dolibarr-Version, dem betroffenen Modul und seiner Version sowie der wörtlich kopierten Fehlermeldung.

Supportseite