Ultimatepropale

📌 Modulversion: 24.0.0 📅 Letzte Aktualisierung: 07.10.2026 👤 Herausgeber/Lizenz: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Sprachen der Benutzeroberfläche: 📧 Support: per E-Mail an contact@atoo-net.com ✅ Dolibarr-Kompatibilität: Dolibarr 24 ✅ Erforderliches Modul: Angebote ✅ Erforderliche PHP-Version: PHP 8.2 oder höher 💡 Kostenlose Updates für ein Jahr innerhalb derselben Version, danach 50 % Rabatt auf die Folgeversion.

Geben Sie Ihren Dolibarr-Angeboten das Erscheinungsbild Ihres Unternehmens mit UltimatePropale

Das Modul UltimatePropale ersetzt die native PDF-Vorlage von Dolibarr für Angebote durch eine vollständig anpassbare Vorlage: ultimatepropale_propal.

Damit legen Sie Ihr Erscheinungsbild fest (Logo, Farben, Ränder, Seitenhintergrund, Spaltenbreiten), bestimmen genau, was gedruckt wird, hängen Ihre AGB oder zusätzliche PDF-Dateien an, fügen Barcodes und QR-Codes hinzu und lassen das Angebot von Ihrem Kunden online unterschreiben.

Keine einzige Codezeile ist nötig: alles wird in den Verwaltungsseiten des Moduls eingestellt, mit grafischen Vorschauen und Ziehpunkten zur Größenänderung mit der Maus.

UltimatePropale ist die auf Angebote spezialisierte Ausgabe des Moduls UltimatePDF. Für Aufträge und Rechnungen siehe UltimatepdfLight oder UltimateInvoice. Für Verträge, Lieferungen, Lieferscheine, Spesenabrechnungen, Serviceaufträge, Projekte, Produkte/Stücklisten oder Lieferantendokumente ist die Vollversion UltimatePDF erforderlich.

🎨 Was Sie anpassen können

🧩 Zwei Konfigurationsebenen, die man nicht verwechseln sollte

Das Modul beruht auf zwei getrennten Begriffen:

1. Das Design (Reiter Vorlagen) legt fest, wie das Angebot aussieht: Farben, Ränder, Logo, Firmenalias, Seitenhintergrund, Spaltenbreiten.

2. Die Seiten Optionen und Angebote bestimmen, was gedruckt wird: sichtbare Spalten, Adressblöcke, Pflichtangaben, Bestätigungsblock, gedruckte Unterschriften.

Mehrere Designs können nebeneinander bestehen. Standardmäßig ist nur eines aktiv, und eine Auswahl oben rechts in der Anwendung wechselt sofort zwischen ihnen, ohne die Einstellungen erneut aufzurufen.

Jeder Block des Design-Formulars hat eine eigene Schaltfläche Speichern: Sie bestätigen Block für Block, ohne Ihre Eingaben in den anderen zu verlieren.

🖌️ Grafische Anpassung (Designs)

• Seitenhintergrund: Hintergrundbild oder Hintergrund-PDF, um ein fertig gestaltetes Briefpapier zu verwenden, mit Einstellung von Transparenz und X/Y-Positionierung.

• Kopfzeile: Höhe und Breite des Logos, zweites Logo für einen Partner oder eine Zertifizierung, Breite des Absenderblocks mit Drag-and-drop-Vorschau und Voreinstellung Fensterumschlag nach französischer Postnorm.

• Firmenalias: drucken Sie einen Firmennamen, eine Adresse, ein Kapital oder eine USt-IdNr., die von der tatsächlichen juristischen Person abweichen, für eine Handelsmarke oder eine Tochtergesellschaft.

• Vektorsymbole: die Symbole für Telefon, Mobiltelefon, Fax, E-Mail und Website der Adressblöcke sind Font-Awesome-Symbole, scharf in jeder Zoomstufe, mit einer pro Design einstellbaren Farbe.

• Ränder und Spalten: PDF-Ränder und Breite jeder Spalte der Positionstabelle (Referenz, Bild, MwSt., Einzelpreis, Menge, Einheit, Rabatt), mit der Maus auf einer grafischen Vorschau größenveränderbar.

• Fußzeile: Schriftgröße, für den freien Text reservierte Höhe, Text- und Hintergrundfarbe.

• Schrift: Wahl der Dokumentschrift, mit DejaVuSans für erweiterte oder kyrillische Zeichensätze.

• Export / Import: jedes Design wird in eine JSON-Datei exportiert und im selben oder einem anderen Dolibarr importiert, auch ein aus UltimatePDF, UltimatepdfLight oder UltimateInvoice exportiertes Design. Das importierte Design wird deaktiviert angelegt und umbenannt, wenn seine Bezeichnung bereits existiert: nichts wird überschrieben.

• Echte PDF-Vorschau: eine Schaltfläche im Formular erzeugt das PDF des neuesten Angebots mit den gerade eingegebenen Einstellungen, ohne sie zu speichern. Die Blöcke des Formulars lassen sich wie ein Akkordeon zuklappen.

📄 Inhalt des Angebots

Die Optionen werden unabhängig voneinander per einfachem Kontrollkästchen aktiviert:

📎 PDF-Zusammenführung und allgemeine Geschäftsbedingungen

📑 Präsentationsseiten und Online-Unterschrift

Das Angebot kann mit einer echten Verkaufspräsentation beginnen und anschließend vom Kunden auf einer Webseite unterschrieben werden, ohne Ausdruck und ohne Scan.

🔎 Barcodes und QR-Codes

• Produkt-Barcodes (EAN13 mit Prüfziffer, CODE128, CODE39) und Geschäftspartner-Barcodes, oben oder unten auf der Seite.

• QR-Codes des eigenen Unternehmens (MyCompany) oder des Geschäftspartners. Oben im Angebot ist jeweils nur ein QR-Code erlaubt, um Überlagerungen zu vermeiden.

🧱 Kompatibilität mit dem Modul Milestone

UltimatePropale erkennt die Meilensteinzeilen des Moduls Milestone: Sie werden bei der Berechnung des Positionsgewichts und des Einzelpreises nach Rabatt nicht wie gewöhnliche Produktzeilen behandelt und behalten im PDF ihre eigene Formatierung.

📖 Integriertes Benutzerhandbuch

Ein vollständiges Handbuch auf Französisch, Englisch, Deutsch, Spanisch und Italienisch ist direkt in den Moduleinstellungen, Reiter Benutzerhandbuch, in der Sprache der Oberfläche abrufbar.

Es beschreibt jede Option Bildschirm für Bildschirm, mit einem durchgehenden roten Faden: Anlegen eines Designs, Einstellen der Optionen, Erzeugen und Unterschreiben eines Angebots. Es wird mit jeder Version aktualisiert.

⚙️ Voraussetzungen

⚙️ Installation

Das Zip des Moduls ist etwa 1,5 MB groß: es bleibt unter der Upload-Grenze von 2 MB, die Dolibarr und PHP standardmäßig anwenden, eine restriktivere Installation kann es jedoch ablehnen. Es gibt drei Methoden, von der einfachsten bis zur technischsten.

Methode 1: Installation über die Dolibarr-Oberfläche

1. Start → Einstellungen → Module/Anwendungen, Reiter Externe Module bereitstellen/installieren.

2. Die .zip-Datei des Moduls auswählen und dann auf Datei hochladen klicken.

Antwortet Dolibarr mit „Die Datei ist zu groß oder wurde nicht angegeben“, ist eine der drei folgenden Grenzen zu niedrig (es gilt die kleinste):

Die geltenden Werte werden angezeigt, wenn Sie mit der Maus über das Informationssymbol rechts neben der Schaltfläche Datei hochladen fahren, sowie unter Start → Admin-Tools → PHP-Info. Starten Sie nach einer Änderung der php.ini den Webserver oder PHP-FPM neu, falls der Hoster dies nicht übernimmt. Beim Shared Hosting sind diese Grenzen nicht immer änderbar: verwenden Sie dann Methode 2 oder 3.

Methode 2: manuelle Installation auf dem Server (SSH)

1. Das Zip auf den Server kopieren und entpacken: unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip

2. Den Modulordner kopieren: cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /pfad/zu/dolibarr/htdocs/custom/

3. Dem Webserver bei Bedarf die Rechte geben: chown -R www-data:www-data /pfad/zu/dolibarr/htdocs/custom/ultimatepropale

4. Prüfen, dass sich das Modul in htdocs/custom/ultimatepropale befindet (und nicht in htdocs/custom/htdocs/ultimatepropale).

Methode 3: Upload per FTP / SFTP (letzter Ausweg)

1. Das Zip auf Ihrem Computer entpacken: es enthält einen Ordner htdocs, der seinerseits den Ordner ultimatepropale enthält.

2. Mit einem FTP/SFTP-Client (zum Beispiel FileZilla) den Ordner ultimatepropale (weder das Zip noch den umgebenden Ordner htdocs) in das Verzeichnis custom von Dolibarr hochladen (neben admin, core, conf…; je nach Hoster in htdocs, httpdocs, www oder public_html).

3. Im Protokoll des Clients prüfen, dass keine Datei fehlgeschlagen ist, und dann, dass der Pfad …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php existiert.

Danach

1. Das Modul unter Start → Einstellungen → Module, Reiter Atoo-Net, aktivieren.

2. Die Vorlage ultimatepropale_propal in der Auswahlliste Vorlagen der Angebotskarte auswählen.

3. ultimatepropale_propal unter Start → Einstellungen → Module → Angebote (Spalte Standard) als Standardvorlage wählen: sie wird bei der Freigabe und bei Massenaktionen verwendet. Die frühere Vorlage ultimate_propal verschwindet mit UltimatePDF.

🧭 Typische Anwendungsfälle

• Ihre Angebote an Ihr Erscheinungsbild anpassen: ohne eine maßgeschneiderte PDF-Vorlage entwickeln zu lassen.

• Unter einer Handelsmarke verkaufen: mit dem Firmenalias einen Firmennamen oder eine Adresse drucken, die von der juristischen Person abweichen.

• Angebote unterschreiben lassen: gedruckter Bestätigungsblock oder Bereich für die Online-Unterschrift des Kunden.

• Ihr Angebot präsentieren: Präsentationsseiten vor dem Angebot hinzufügen und die aufeinanderfolgenden Versionen verfolgen.

• Angebote per Post versenden: die Voreinstellung für Fensterumschläge und die Falzmarke verwenden.

• Ihre AGB immer anhängen: automatisch das richtige Vertragsdokument und die technischen Datenblätter der Produkte an jedes Angebot anhängen.

❓ FAQ

• Was ist der Unterschied zu UltimatePDF, UltimatepdfLight und UltimateInvoice?
  UltimatePropale ist die auf Angebote beschränkte Ausgabe von UltimatePDF. UltimatepdfLight deckt Angebote, Aufträge und Rechnungen ab, UltimateInvoice nur Rechnungen. UltimatePDF deckt zusätzlich Verträge, Lieferungen, Spesenabrechnungen, Serviceaufträge, Projekte, Produkte und Lieferantendokumente ab.

• Verändert das Modul den Kern von Dolibarr?
  Nein. UltimatePropale fügt eine zusätzliche Dokumentvorlage hinzu und stützt sich auf die Standard-Hooks. Die nativen PDF-Vorlagen bleiben verfügbar: Sie können jederzeit zurückwechseln, indem Sie sie auf der Karte erneut auswählen.

• Kann ich mehrere unterschiedliche Layouts haben?
  Ja. Legen Sie so viele Designs an wie nötig. Standardmäßig ist nur eines aktiv, und eine Auswahl oben rechts in der Anwendung wechselt zwischen ihnen.

• Kann ich ein Design aus UltimatePDF übernehmen?
  Ja. Exportieren Sie es in UltimatePDF, UltimatepdfLight oder UltimateInvoice als JSON und importieren Sie es dann in UltimatePropale.

• Sind technische Kenntnisse erforderlich?
  Nein. Die gesamte Konfiguration erfolgt in den Verwaltungsseiten, mit grafischen Vorschauen. Keine Datei muss geändert werden.

• Ist das Modul mit den Meilensteinen des Moduls Milestone kompatibel?
  Ja. Meilensteinzeilen werden erkannt und behalten im PDF ihre eigene Formatierung.

• Werden meine bestehenden Angebote verändert?
  Nein. Nur Angebote, die nach der Aktivierung der Vorlage neu erzeugt werden, verwenden das neue Layout. Bereits erzeugte PDF-Dateien bleiben unverändert.

• Landet die Online-Unterschrift an der richtigen Stelle, wenn ich ein Deckblatt, Präsentationsseiten und AGB hinzufüge?
  Ja. Bei jeder Erzeugung schreibt die Vorlage die Nummer der Seite mit dem Einverständnis-Rahmen in das PDF; Dolibarr setzt die Unterschrift dorthin, unabhängig von der Zahl der Präsentationsseiten und der Länge der Anhänge. Erzeugen Sie das PDF nach jeder Änderung des Angebots einfach neu, bevor Sie den Link versenden.

Warum UltimatePropale verwenden?

• Angebote im Erscheinungsbild Ihres Unternehmens erhalten, ohne eine maßgeschneiderte PDF-Vorlage entwickeln zu lassen

• Das Layout in Verwaltungsseiten einstellen, mit Vorschauen und Größenänderung per Maus

• Mehrere Designs anlegen und mit einem Klick zwischen ihnen wechseln

• Ein vorhandenes Briefpapier als Seitenhintergrund verwenden, als Bild oder PDF

• Dank Firmenalias unter einer Handelsmarke verkaufen

• Genau die Spalten und Blöcke wählen, die auf dem Angebot erscheinen

• Angebote online unterschreiben lassen

• AGB und zusätzliche PDF-Dateien automatisch anhängen

• Barcodes und QR-Codes hinzufügen

• Die native Dolibarr-Vorlage jederzeit verfügbar halten

⚠️ Wichtige Empfehlung

Wie bei jedem Modul, das das Erscheinungsbild von Geschäftsdokumenten verändert, testen Sie UltimatePropale auf einer Testinstanz, bevor Sie es produktiv einsetzen.

Erstellen Sie vor Beginn eine vollständige Sicherung:

• der Dolibarr-Datenbank

• des Dolibarr-Dokumentenverzeichnisses

Erzeugen Sie nach der Konfiguration ein kurzes und ein langes, mehrseitiges Angebot und prüfen Sie Adressblöcke, Summen, Fußzeile und das Fehlen leerer Seiten, bevor Sie die Vorlage allgemein einsetzen.

📖 Dokumentation

Die vollständige Dokumentation des Moduls steht im offiziellen Dolibarr-Wiki zur Verfügung:

👉 Dolibarr-Wiki – Modul UltimatePropale (DE)

Dokumentation in weiteren Sprachen:

👉 Dolibarr-Wiki – Modul UltimatePropale (FR)

👉 Dolibarr-Wiki – Modul UltimatePropale (EN)

👉 Dolibarr-Wiki – Modul UltimatePropale (ES)

👉 Dolibarr-Wiki – Modul UltimatePropale (IT)

Ein vollständiges Benutzerhandbuch ist außerdem im Modul integriert, im Reiter Benutzerhandbuch seiner Konfigurationsseite.

Mehr Module