Haushaltsbuch

🏠Pro Seite

Das Modul ist ein persönliches Haushaltsbuch für Ausgaben und Einnahmen. Jede Person bekommt beim ersten Aufruf automatisch ein eigenes Buch, das nur sie selbst sieht. Ein Eintrag ist ein Beleg mit Datum, Bezeichnung und optional Bestellnummer, Notiz und Belegdateien. Der Betrag lässt sich auf mehrere Positionen aufteilen, jede mit eigener Zuständigkeit und Kategorie. Fixkosten werden automatisch gebucht, Monat und Jahr werden ausgewertet und lassen sich drucken oder als CSV exportieren.

Allgemein

Einträge und Positionen

Ein Eintrag ist entweder eine Ausgabe oder eine Einnahme. Standardmäßig hat er eine Position mit Betrag, Zuständigkeit und Kategorie. Über „Aufteilen“ kommen weitere Positionen hinzu, zum Beispiel wenn eine Amazon-Bestellung teils Weihnachtsgeschenke und teils Haushaltsbedarf enthält. Bestellnummer und Belegdateien stehen dann nur einmal am Eintrag, die Auswertung rechnet über die Positionen.

Beträge werden in deutscher Schreibweise eingegeben: „12,50“, „1.234,56“ und auch „12.50“ funktionieren. Ein Punkt mit genau drei Ziffern danach gilt als Tausenderpunkt, „1.500“ sind also 1.500 Euro.

Zuständigkeiten und Kategorien

Jede Position hat zwei Felder: die Zuständigkeit (wer trägt die Kosten, etwa „Ich“ oder „Gemeinsam“) und die Kategorie (wofür, etwa „Lebensmittel“ oder „Weihnachten“). Beide Begriffe werden beim ersten Verwenden gemerkt und danach als Vorschlag angeboten. Im Tab „Zuständigkeiten & Kategorien“ lassen sie sich umbenennen, einfärben, archivieren oder löschen. Archivierte Begriffe werden nicht mehr vorgeschlagen, bleiben aber in alten Einträgen und Auswertungen erhalten. Wer einen Begriff wie einen vorhandenen umbenennt, führt beide zusammen.

Fixkosten

Fixkosten und feste Einnahmen werden als Vorlage mit Betrag, Zuständigkeit, Kategorie, Rhythmus (monatlich, alle 2 Monate, vierteljährlich, halbjährlich, jährlich), Tag im Monat sowie Start- und optional Endmonat angelegt. Sobald ein fälliger Monat geöffnet wird, bucht das Modul die Vorlage einmalig als normalen Eintrag. Gebuchte Einträge lassen sich danach frei ändern oder löschen, ein gelöschter Eintrag kommt nicht wieder. Die Jahresansicht bucht alle fälligen Monate bis einschließlich des aktuellen Monats.

Auswertung und Export

Monats- und Jahresansicht zeigen Einnahmen, Ausgaben und Saldo, die Monatsansicht zusätzlich die Veränderung der Ausgaben zum Vormonat. Darunter folgen Tabellen nach Zuständigkeit und nach Kategorie mit Anteil an den Ausgaben sowie eine Kreuztabelle Zuständigkeit mal Kategorie. Die Jahresansicht hat ein Balkendiagramm und eine Monatstabelle, jeder Monat ist anklickbar. Unter „Abrechnung & Export“ gibt es eine Druckansicht, über die der Browser ein PDF erzeugt, und einen CSV-Export, beide wahlweise für alle oder nur eine Zuständigkeit.

Zugriff

Nutzen dürfen das Haushaltsbuch eingeloggte Mitglieder der Site, deren Rolle unter Weinhold → Nutzerverwaltung → Modulberechtigungen die Berechtigung „Ansehen“ für das Haushaltsbuch hat. Standardmäßig ist keine Rolle freigeschaltet. Niemand sieht fremde Bücher, auch Administratoren nicht, und die Admin-Seite zeigt nur die Anzahl der Bücher und Einträge.

Shortcodes

Shortcode	Beschreibung
[weinhold_household_book]	Das komplette Haushaltsbuch mit den Tabs Monat, Jahr, Fixkosten sowie Zuständigkeiten & Kategorien. Keine Parameter, jede Person sieht ihr eigenes Buch.

Dateien

modules/household_book.php – Modul-Header und init(): Install, Hooks, Audit-Log-Aktionen und Shortcode-Registrierung.

modules/household_book/db.php – Tabellen, Install und Cleanup, Lesen und Schreiben von Büchern, Begriffen, Einträgen und Positionen, Geld- und Monatshelfer, Fixkosten-Buchung und Auswertung.

modules/household_book/files.php – Belegdateien: Upload, geschützte Auslieferung und Löschen.

modules/household_book/frontend.php – Zugriffsprüfung, Formularverarbeitung, Druckansicht und CSV-Export, alle Ansichten des Shortcodes und das Inline-JS.

modules/household_book/admin.php – Admin-Seite mit Hinweisen und Zahlen, ohne Buchinhalte.

assets/weinhold_household_book.css – Styles mit dem Präfix .weinhold-household-book-, inklusive Handy-Layout und Druckansicht.

Für Entwickler

Datenbank

Alle Tabellen liegen pro Site (Präfix der jeweiligen Site) und werden per dbDelta() angelegt, Versionsschlüssel ist die Option weinhold_household_book_db_version. Die Spalte book_id steht schon in allen Tabellen, damit später mehrere oder gemeinsame Bücher ohne Umbau möglich sind. Beträge werden als Ganzzahl in Cent gespeichert.

Tabelle	Inhalt
{prefix}weinhold_hb_books	Ein Buch pro Person (owner_user_id), wird beim ersten Aufruf angelegt
{prefix}weinhold_hb_terms	Zuständigkeiten und Kategorien (kind responsibility oder category), mit Farbe und Archiv-Kennzeichen, eindeutig pro Buch, Art und Name
{prefix}weinhold_hb_entries	Einträge mit Art, Datum, Bezeichnung, Bestellnummer, Notiz und gegebenenfalls der Fixkosten-Vorlage
{prefix}weinhold_hb_positions	Positionen eines Eintrags mit Betrag in Cent, Zuständigkeit, Kategorie und optionaler Bezeichnung
{prefix}weinhold_hb_files	Belegdateien eines Eintrags (gespeicherter und ursprünglicher Name, MIME-Typ, Größe)
{prefix}weinhold_hb_recurring	Fixkosten-Vorlagen mit Rhythmus, Tag, Start- und Endmonat
{prefix}weinhold_hb_recurring_runs	Merkt pro Vorlage und Monat, dass gebucht wurde (Unique-Key auf recurring_id und month)

Fixkosten ohne Doppelbuchung

weinhold_household_book_apply_recurring() läuft beim Öffnen eines Monats. Für jede fällige Vorlage wird zuerst der Eintrag in recurring_runs geschrieben und erst danach der Beleg. Der Unique-Key verhindert so doppelte Buchungen auch bei parallelen Aufrufen, und weil der Run-Eintrag bleibt, wird ein gelöschter Fixkosten-Eintrag nicht erneut gebucht. Fällig ist eine Vorlage, wenn sie aktiv ist, der Monat im Zeitraum liegt und der Abstand zum Startmonat durch den Rhythmus teilbar ist.

Formulare und Parameter

Alle Formulare werden in weinhold_household_book_handle_frontend_actions() am Hook wp verarbeitet, mit Nonce pro Aktion und Weiterleitung danach (Post/Redirect/Get). Die Ansicht wird über Query-Parameter gesteuert:

Parameter	Beschreibung
hb_view	month, year, recurring oder terms
hb_month	Monat der Monatsansicht im Format JJJJ-MM
hb_year	Jahr der Jahresansicht
hb_edit	ID des Eintrags bzw. der Vorlage, die bearbeitet wird
hb_new	Formular für einen neuen Eintrag geöffnet anzeigen
hb_msg	Rückmeldung nach dem Speichern oder Löschen

Belegdateien

Erlaubt sind JPG, PNG, GIF, WebP, HEIC und PDF bis 15 MB, geprüft per wp_check_filetype_and_ext(). Die Dateien liegen außerhalb der Mediathek unter uploads/sites/{id}/weinhold-household-book/{book_id}/ mit zufälligem Dateinamen, der Ordner ist per .htaccess gesperrt und enthält eine leere index.php. Ausgeliefert wird nur über ?weinhold_household_book_file=ID mit Nonce, nachdem geprüft ist, dass die Datei zum Buch der angemeldeten Person gehört.

Export

?weinhold_household_book_export=print oder csv mit hb_period (JJJJ-MM oder JJJJ), optional hb_resp (ID einer Zuständigkeit) und Nonce weinhold_household_book_export. Die CSV ist mit Semikolon getrennt, hat ein UTF-8-BOM für Excel und vorzeichenbehaftete Beträge.

Audit-Log

Aktion	Bedeutung
entry_saved	Eintrag gespeichert
entry_deleted	Eintrag gelöscht
recurring_saved	Fixkosten-Vorlage gespeichert
recurring_deleted	Fixkosten-Vorlage gelöscht
term_saved	Begriff gespeichert oder zusammengeführt
term_deleted	Begriff gelöscht

Besonderheiten

Die Bücher sind bewusst privat: Weder die Admin-Seite noch das Audit-Log zeigen Beträge oder Bezeichnungen, und auch Administratoren können fremde Bücher nicht öffnen.

Das Löschen eines Begriffs entfernt nur die Zuordnung, die Positionen bleiben mit „Ohne Zuständigkeit“ bzw. „Ohne Kategorie“ erhalten. Das Löschen einer Fixkosten-Vorlage lässt bereits gebuchte Einträge stehen. Änderungen an einer Vorlage gelten nur für Monate, die noch nicht gebucht wurden.

Ein PDF entsteht über die Druckfunktion des Browsers auf einer eigenen, druckoptimierten Seite. Eine PDF-Bibliothek wird nicht verwendet.

Auf dem Handy öffnet ein Tipp auf den Monatsnamen direkt die Monatsauswahl, breite Tabellen werden dort kompakter dargestellt und Fixkosten-Vorlagen als Karten.

Versionshistorie

Version	Datum	Änderung
1.0.0	02.11.2026	Erste Veröffentlichung: Bücher pro Person, Einträge mit aufteilbaren Positionen, Zuständigkeiten und Kategorien, Fixkosten, Monats- und Jahresauswertung, Druckansicht und CSV-Export, geschützte Belegdateien.
1.0.1	03.11.2026	Handy-Ansicht überarbeitet: kein seitliches Scrollen mehr, Monatsauswahl über den Monatsnamen, einspaltige Formulare, Fixkosten als Karten, kurze Monatsnamen in der Jahrestabelle.
1.1.0	07.11.2026	Farben über das Modul Design einstellbar (Tab Haushaltsbuch, Standard sind die bisherigen Farben; die Druckansicht bleibt unverändert). Karten, Hinweise, Tabellen und Badges nutzen die gemeinsamen UI-Bausteine des Frameworks. Fehlerhinweise ohne geöffnetes Buch (z. B. nicht angemeldet) haben wieder ihre Hintergrundfarbe.
1.2.0	07.11.2026	Schriften über das Modul Design einstellbar: Text (samt Formularfeldern), Überschriften, Buttons und Reiter sowie Beträge. Druckansicht und PDF bleiben unverändert. Ohne Auswahl gilt wie bisher die Schrift des Themes.

Household Book

🏠Per site

The module is a personal household book for expenses and income. Every person automatically gets a book of their own on first use, which only they can see. An entry is a receipt with a date, a title and optionally an order number, a note and receipt files. Its amount can be split into several items, each with its own responsibility and category. Fixed costs are booked automatically, months and years are evaluated and can be printed or exported as CSV.

General

Entries and Items

An entry is either an expense or income. By default it has one item with an amount, a responsibility and a category. „Split“ adds further items, for example when an Amazon order is partly Christmas presents and partly household supplies. The order number and receipt files are then stored only once on the entry, while the evaluation works on the items.

Amounts are entered in German notation: „12,50“, „1.234,56“ and also „12.50“ work. A dot followed by exactly three digits counts as a thousands separator, so „1.500“ means 1,500 euros.

Responsibilities and Categories

Every item has two fields: the responsibility (who bears the cost, e.g. „Ich“ or „Gemeinsam“) and the category (what it is for, e.g. „Lebensmittel“ or „Weihnachten“). Both terms are remembered on first use and suggested afterwards. In the tab „Zuständigkeiten & Kategorien“ they can be renamed, coloured, archived or deleted. Archived terms are no longer suggested but stay in old entries and evaluations. Renaming a term to the name of an existing one merges the two.

Fixed Costs

Fixed costs and fixed income are created as a template with amount, responsibility, category, interval (monthly, every 2 months, quarterly, half-yearly, yearly), day of the month and a start and optional end month. As soon as a due month is opened, the module books the template once as a regular entry. Booked entries can then be changed or deleted freely, and a deleted entry does not come back. The year view books all due months up to and including the current month.

Evaluation and Export

The month and year views show income, expenses and balance, the month view additionally the change in expenses compared to the previous month. Below follow tables by responsibility and by category with the share of expenses, and a cross table of responsibility by category. The year view has a bar chart and a month table, and every month can be clicked. Under „Abrechnung & Export“ there is a print view, from which the browser creates a PDF, and a CSV export, both either for everything or for a single responsibility.

Access

The household book may be used by logged-in members of the site whose role has the „view“ permission for the household book under Weinhold → Nutzerverwaltung → Modulberechtigungen. No role is enabled by default. Nobody sees other people’s books, not even administrators, and the admin page only shows the number of books and entries.

Shortcodes

Shortcode	Description
[weinhold_household_book]	The complete household book with the tabs month, year, fixed costs and responsibilities & categories. No parameters, every person sees their own book.

Files

modules/household_book.php – module header and init(): install, hooks, audit log actions and shortcode registration.

modules/household_book/db.php – tables, install and cleanup, reading and writing books, terms, entries and items, money and month helpers, fixed cost booking and evaluation.

modules/household_book/files.php – receipt files: upload, protected delivery and deletion.

modules/household_book/frontend.php – access check, form handling, print view and CSV export, all views of the shortcode and the inline JS.

modules/household_book/admin.php – admin page with notes and numbers, without book contents.

assets/weinhold_household_book.css – styles with the prefix .weinhold-household-book-, including the phone layout and the print view.

For Developers

Database

All tables are per site (prefix of the respective site) and are created with dbDelta(), the version key is the option weinhold_household_book_db_version. The column book_id already exists in all tables so that several or shared books are possible later without restructuring. Amounts are stored as integers in cents.

Table	Content
{prefix}weinhold_hb_books	One book per person (owner_user_id), created on first use
{prefix}weinhold_hb_terms	Responsibilities and categories (kind responsibility or category), with colour and archive flag, unique per book, kind and name
{prefix}weinhold_hb_entries	Entries with type, date, title, order number, note and, if applicable, the fixed cost template
{prefix}weinhold_hb_positions	Items of an entry with amount in cents, responsibility, category and optional label
{prefix}weinhold_hb_files	Receipt files of an entry (stored and original name, MIME type, size)
{prefix}weinhold_hb_recurring	Fixed cost templates with interval, day, start and end month
{prefix}weinhold_hb_recurring_runs	Remembers per template and month that it was booked (unique key on recurring_id and month)

Fixed Costs Without Double Booking

weinhold_household_book_apply_recurring() runs when a month is opened. For every due template, the row in recurring_runs is written first and only then the receipt. The unique key thus prevents double bookings even with parallel requests, and because the run row stays, a deleted fixed cost entry is not booked again. A template is due if it is active, the month lies within its period and the distance to the start month is divisible by the interval.

Forms and Parameters

All forms are handled in weinhold_household_book_handle_frontend_actions() on the wp hook, with a nonce per action and a redirect afterwards (Post/Redirect/Get). The view is controlled via query parameters:

Parameter	Description
hb_view	month, year, recurring or terms
hb_month	Month of the month view in the format YYYY-MM
hb_year	Year of the year view
hb_edit	ID of the entry or template being edited
hb_new	Show the form for a new entry opened
hb_msg	Feedback after saving or deleting

Receipt Files

JPG, PNG, GIF, WebP, HEIC and PDF up to 15 MB are allowed, checked with wp_check_filetype_and_ext(). The files are stored outside the media library under uploads/sites/{id}/weinhold-household-book/{book_id}/ with a random file name, the folder is locked via .htaccess and contains an empty index.php. They are only delivered via ?weinhold_household_book_file=ID with a nonce, after checking that the file belongs to the book of the logged-in person.

Export

?weinhold_household_book_export=print or csv with hb_period (YYYY-MM or YYYY), optionally hb_resp (ID of a responsibility) and the nonce weinhold_household_book_export. The CSV is separated by semicolons, has a UTF-8 BOM for Excel and signed amounts.

Audit Log

Action	Meaning
entry_saved	Entry saved
entry_deleted	Entry deleted
recurring_saved	Fixed cost template saved
recurring_deleted	Fixed cost template deleted
term_saved	Term saved or merged
term_deleted	Term deleted

Special Cases

The books are private on purpose: neither the admin page nor the audit log shows amounts or titles, and administrators cannot open other people’s books either.

Deleting a term only removes the assignment, the items remain as „Ohne Zuständigkeit“ or „Ohne Kategorie“. Deleting a fixed cost template keeps entries that were already booked. Changes to a template only apply to months that have not been booked yet.

A PDF is created via the browser’s print function on a separate, print-optimised page. No PDF library is used.

On phones, tapping the month name opens the month picker directly, wide tables are shown more compactly and fixed cost templates as cards.

Version History

Version	Date	Change
1.0.0	02.11.2026	First release: one book per person, entries with splittable items, responsibilities and categories, fixed costs, month and year evaluation, print view and CSV export, protected receipt files.
1.0.1	03.11.2026	Phone layout reworked: no more horizontal scrolling, month picker via the month name, single-column forms, fixed costs as cards, short month names in the year table.
1.1.0	07.11.2026	Colors adjustable via the Design module (tab Haushaltsbuch, defaults are the previous colors; the print view stays unchanged). Cards, notices, tables and badges use the framework's shared UI building blocks. Error notices without an open book (e.g. not logged in) have their background color again.
1.2.0	07.11.2026	Fonts adjustable via the Design module: text (including form fields), headings, buttons and tabs as well as amounts. Print view and PDF stay unchanged. Without a choice the theme font applies as before.

Haushaltsbuch

Einträge und Positionen

Zuständigkeiten und Kategorien

Fixkosten

Auswertung und Export

Zugriff

Datenbank

Fixkosten ohne Doppelbuchung

Formulare und Parameter

Belegdateien

Export

Audit-Log

Household Book

Entries and Items

Responsibilities and Categories

Fixed Costs

Evaluation and Export

Access

Database

Fixed Costs Without Double Booking

Forms and Parameters

Receipt Files

Export

Audit Log

Weitere Beiträge

design

theme-weinify

languages

soundboard.weinify.de