SubtotalTitle - Dolibarr Modul

Erweitert Rechnungen, Angebote und Kundenaufträge um Sections, Textzeilen und Zwischensummen.

---

🔑 ODT Template Schlüsselwörter

Zeilen-Variablen (pro Zeile in row.lines)

Variable	Wert	Beschreibung
{line_is_section}	1/""	Zeile ist eine Section (Überschrift)
{line_is_textline}	1/""	Zeile ist eine Textzeile
{line_is_subtotal}	1/""	Zeile ist eine Zwischensumme
{line_is_product}	1/""	Zeile ist ein Produkt mit Produktreferenz
{line_is_free_line}	1/""	Zeile ist eine freie Zeile (ohne Produktreferenz)
{line_is_normal}	1/""	Zeile ist normal (special_code = 0)
{line_is_special}	1/""	Zeile ist Section, Text ODER Subtotal
{line_special_code}	0-102	special_code Wert der Zeile

Globale Variablen (für das gesamte Dokument)

Variable	Wert	Beschreibung
{object_has_sections}	1/""	Dokument enthält mindestens eine Section
{object_has_textlines}	1/""	Dokument enthält mindestens eine Textzeile
{object_has_speciallines}	1/""	Dokument enthält Sections, Textzeilen oder Subtotals
{object_count_sections}	Zahl	Anzahl der Sections im Dokument
{object_count_textlines}	Zahl	Anzahl der Textzeilen im Dokument
{object_count_subtotals}	Zahl	Anzahl der Zwischensummen im Dokument

special_code Werte

Typ	special_code
Normales Produkt	0
Section (Überschrift)	100
Textzeile	101
Zwischensumme	102

ODT Template Beispiel

[!-- IF {object_has_sections} --]
Dieses Dokument enthält {object_count_sections} Section(s).
[!-- ENDIF {object_has_sections} --]

[!-- BEGIN row.lines --]

[!-- IF {line_is_section} --]
═══════════════════════════════════════
{line_desc}
═══════════════════════════════════════
[!-- ENDIF {line_is_section} --]

[!-- IF {line_is_textline} --]
{line_desc}
[!-- ENDIF {line_is_textline} --]

[!-- IF {line_is_product} --]
{line_pos}	{line_qty}	{line_ref}	{line_desc}	{line_up_locale} €	{line_price_ht_locale} €
[!-- ENDIF {line_is_product} --]

[!-- IF {line_is_free_line} --]
{line_pos}	{line_qty}	{line_desc}	{line_up_locale} €	{line_price_ht_locale} €
[!-- ENDIF {line_is_free_line} --]

[!-- IF {line_is_subtotal} --]
───────────────────────────────────────
Zwischensumme:	{line_price_ht_locale} €
───────────────────────────────────────
[!-- ENDIF {line_is_subtotal} --]

[!-- END row.lines --]

---

📋 Modul-Funktionen

Sections (Überschriften)

• Erstellen von Überschriften zur Strukturierung
• Produkte können per Drag & Drop oder Link-Button zugeordnet werden
• Optional: Zwischensumme für jede Section anzeigen
• Ein-/Ausklappen von Sections

Textzeilen

• Freie Textzeilen ohne Preis
• Ideal für Hinweise, Bedingungen oder Erklärungen

Zwischensummen

• Automatische Berechnung der Summe aller Produkte in einer Section
• Checkbox zum Ein-/Ausschalten pro Section

Dokument-Synchronisation

• 📄 Checkbox bei jeder Section/Textzeile/Subtotal: Element zum Dokument hinzufügen
• → Zum Dokument / ← Aus Dokument Buttons: Alle Elemente auf einmal synchronisieren
• Grüner Rand = Element ist im Dokument/PDF enthalten
• Buttons werden nur angezeigt wenn Sections oder Textzeilen vorhanden sind

Unterstützte Dokumenttypen

• Rechnungen (Factures)
• Angebote (Propals)
• Kundenaufträge (Commandes)

---

🔧 Installation

1. Dateien kopieren

htdocs/custom/subtotaltitle/
├── class/
│   ├── actions_subtotaltitle.class.php
│   └── DocumentTypeHelper.class.php
├── ajax/
│   ├── add_to_section.php
│   ├── assign_last_product.php
│   ├── cleanup_subtotals.php
│   ├── create_section.php
│   ├── create_textline.php
│   ├── get_textlines.php
│   ├── move_section.php
│   ├── reorder_all.php
│   ├── sync_to_facturedet.php
│   └── toggle_subtotal.php
├── core/
│   ├── modules/
│   │   └── modSubtotalTitle.class.php
│   └── substitutions/
│       └── functions_subtotaltitle.lib.php
├── js/
│   └── subtotaltitle.js
├── css/
│   └── subtotaltitle.css
├── lib/
│   └── subtotaltitle.lib.php
└── sql/
    └── llx_facture_lines_manager.sql

2. Modul aktivieren

Im Dolibarr Backend unter Home → Setup → Modules das Modul SubtotalTitle aktivieren.

Die Datenbanktabelle llx_facture_lines_manager wird automatisch erstellt.

3. Modul-Konfiguration

In core/modules/modSubtotalTitle.class.php muss folgendes gesetzt sein:

$this->module_parts = array(
    'substitutions' => 1,   // Für ODT-Variablen
    'hooks' => array(
        'data' => array('invoicecard', 'propalcard', 'ordercard'),
        'entity' => '0'
    )
);

---

🗄️ Datenbank

Tabelle: llx_facture_lines_manager

Feld	Typ	Beschreibung
rowid	INT	Primary Key
fk_facture	INT	FK zu Rechnung
fk_propal	INT	FK zu Angebot
fk_commande	INT	FK zu Kundenauftrag
document_type	VARCHAR(20)	'invoice', 'propal', 'order'
line_type	VARCHAR(20)	'section', 'product', 'text', 'subtotal'
fk_facturedet	INT	FK zu llx_facturedet
fk_propaldet	INT	FK zu llx_propaldet
fk_commandedet	INT	FK zu llx_commandedet
title	VARCHAR(255)	Titel für Sections/Text
parent_section	INT	FK zur übergeordneten Section
line_order	INT	Sortierreihenfolge
show_subtotal	TINYINT	Zwischensumme anzeigen (0/1)
collapsed	TINYINT	Section eingeklappt (0/1)
in_facturedet	TINYINT	Im Dokument enthalten (0/1)

---

📝 Changelog

Version 1.0

• Initiale Version mit Section-, Text- und Subtotal-Unterstützung
• ODT-Substitutionsvariablen
• Multi-Dokument-Support (Rechnungen, Angebote, Kundenaufträge)
• Drag & Drop Sortierung
• Dokument-Synchronisation

---

📄 Lizenz

Copyright (C) 2026 Eduard Wisch data@data-it-solution.de

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder Version 3 der Lizenz oder (nach Ihrer Wahl) jede spätere Version.