Ein Dolix-Modul installieren

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

Um Dolibarr selbst und nicht ein Modul zu aktualisieren, siehe die Anleitungen : Dolibarr-Update ohne Ausfälle,Dolibarr über die Kommandozeile aktualisieren.

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 12 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	Ein Eintrag: Rechnung \| Zahlung › Liste der Vorlagen › Vorlagenpreise aktualisieren. Die Schaltfläche erscheint außerdem in der Ansicht eines Angebotsentwurfs und einer Rechnungsvorlage.
Bezugsnebenkosten	Ja	Menü ProdukteWarenlager„Bezugsnebenkosten“, und Reiter „Bezugsnebenkosten“ auf der Karte einer Lieferantenbestellung.
Noch zu fakturieren	Ja	Menü Einkauf \| VertriebKundenaufträge„Noch zu fakturieren“. Ein Reiter „Noch zu fakturieren“ an jedem Kundenauftrag.
Update-Bereitschaftsprüfung	Keine	Menü StartAdmin-Tools„Update-Bereitschaftsprüfung“.
USt-Hinweise Europa	Keine	Kein Menü. Auf der Rechnungskarte eine Zeile „Gedruckter USt-Hinweis“ und das Attribut „USt-Hinweis“. Einstellungen: EinstellungenModule/AnwendungenUSt-Hinweise Europa.
Belege in Spesenabrechnungen	Keine	Kein Menüeintrag. Das Modul greift ein, wenn das PDF der Spesenabrechnung erzeugt wird; seine Einstellungen liegen unter EinstellungenModule/Anwendungen.
TakePOS-Guthabenkonto	Ja	Kein Menüeintrag. Registerkarte „Guthaben“ auf der Geschäftspartner- und auf der Mitgliederkarte; Schaltfläche „Guthaben“ auf dem Zahlungsbildschirm von TakePOS.

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.
Bezugsnebenkosten	Vier Tabellen: llx_dolixapproche_dossier (Lieferakten: Referenz, Bezeichnung, Ankunftsdatum, Status, Notiz), llx_dolixapproche_order (die jeder Akte zugeordneten Lieferantenbestellungen), llx_dolixapproche_frais (Kosten: Bezeichnung, Art, Nettobetrag, Verteilungsschlüssel, verknüpfte Lieferantenrechnung) und llx_dolixapproche_journal (jeder geänderte Wert mit altem und neuem Wert, Menge, Bestand und Betrag, um ihn rückgängig machen zu können).
Noch zu fakturieren	Keine Tabelle. Das Modul liest Aufträge, Rechnungen und die Verknüpfungen zwischen Dokumenten; es schreibt nichts in die Datenbank. Seine zwei Einstellungen werden als Dolibarr-Konstanten gespeichert: DOLIXRAF_INCLUDE_DRAFTS und DOLIXRAF_INCLUDE_SHIPMENTS.
Update-Bereitschaftsprüfung	Keine Tabelle. Das Modul legt weder Tabellen noch Einstellungen noch Dateien an: Der Bericht wird bei jeder Anfrage berechnet, Downloads werden direkt erzeugt.
USt-Hinweise Europa	Keine Tabelle. Bei der Aktivierung fügt das Modul den Rechnungen ein ergänzendes Attribut „USt-Hinweis“ hinzu (Feld dolixtva_case, also eine Spalte von llx_facture_extrafields) und speichert seine Einstellungen als Konstanten. Wenn Sie die Korrektur des französischen Hinweises einschalten, wird der korrigierte Text in den überschriebenen Übersetzungen von Dolibarr gespeichert (Tabelle llx_overwrite_trans), wie es EinstellungenÜbersetzung tun würde.
Belege in Spesenabrechnungen	Keine Tabelle. Der Modulordner enthält kein Verzeichnis sql/. Bei der Aktivierung speichert das Modul drei Einstellungen in den Konstanten von Dolibarr. Wird ein Beleg zurückgestellt, wird dies in einer kleinen Datei festgehalten, documents/dolixjustif/quarantaine_.json, nicht in der Datenbank.
TakePOS-Guthabenkonto	Eine Tabelle: llx_dolixpm_recharge. Sie speichert eine Zeile pro Aufladung (Geschäftspartner, Anzahlungsrechnung, Betrag, Datum, Benutzer, Anmerkung, Mandant). Das Guthaben selbst wird dort nicht gespeichert: Es ist die Summe der verfügbaren Dolibarr-Guthaben aus diesen Anzahlungsrechnungen.

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 12 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