RudelRoots

Das RudelRoots-Modul verwaltet Zutaten für die Barf-Fütterung (biologisch artgerechte Rohfleisch-Fütterung von Hunden) in Sets und berechnet daraus benötigte Mengen und Kosten – wahlweise nach Anzahl Tagen oder nach bereits vorhandener Menge einer Zutat.

Allgemein

Zutaten & Sets

Jede Zutat erhält Name, Beschreibung, Bild, optionalen Einkaufslink, einen Grammwert pro 5 kg Hundegewicht und Tag sowie einen Preis pro 100 g. Zutaten werden zu Sets gruppiert (z. B. für unterschiedliche Fütterungspläne); ein Set kann als Standard markiert werden und wird dann beim Aufruf des Rechners automatisch vorausgewählt.

Bedarfsrechner mit zwei Modi

Im Modus „Planung nach Tagen“ gibt man die gewünschte Anzahl Tage ein, das Modul berechnet für jede Zutat des gewählten Sets die benötigte Menge und die Kosten. Im Modus „Planung nach vorhandener Menge“ wählt man stattdessen eine bereits vorhandene Zutat mit ihrer Menge in Gramm aus – das Modul errechnet daraus, für wie viele ganze Tage der Vorrat reicht, und wie viel von den übrigen Zutaten des Sets für denselben Zeitraum benötigt wird.

Übersichtsliste

Eine separate Ansicht zeigt alle hinterlegten Zutaten als Kartenraster mit Bild, Beschreibung, Preis pro 100 g und optionalem Kauflink.

Shortcodes

Shortcode	Beschreibung
weinhold_rudelroots_list	Kartenraster aller Zutaten mit Bild, Beschreibung und Preis. Keine Parameter
weinhold_rudelroots_calculator	Bedarfsrechner mit Set-Auswahl und den zwei Berechnungsmodi. Keine Parameter
rudelroots_list	/ rudelroots_calculator Legacy-Aliase ohne weinhold_-Präfix, bereits in bestehenden Beiträgen verwendet und aus Kompatibilitätsgründen weiterhin aktiv

Dateien

Datei	Inhalt
modules/rudelroots.php	Modul-Header, Initialisierung, Shortcode-Registrierung inkl. Legacy-Aliase, Audit-Log-Integration
modules/rudelroots/db.php	Tabellen, Installation/Cleanup, CRUD für Zutaten und Sets
modules/rudelroots/admin.php	Admin-Oberfläche, Formularverarbeitung, Bild-Upload
modules/rudelroots/frontend.php	Beide Shortcode-Renderer inkl. Rechenlogik für die zwei Kalkulationsmodi

Für Entwickler

Datenbank

Tabelle	Spalten	(Auswahl)
weinhold_rudelroots_ingredients	name, description, link_url, image_url, gramm_per_5kg_per_day, price_per_100g, sort_order
weinhold_rudelroots_sets	name, description, image_url, is_default, sort_order
weinhold_rudelroots_set_ingredients	set_id, ingredient_id	(eindeutige Kombination)

Rechenlogik

weinhold_rudelroots_calculate_mode_a() skaliert gramm_per_5kg_per_day jeder Zutat linear mit der eingegebenen Tagesanzahl. weinhold_rudelroots_calculate_mode_b() rechnet umgekehrt: aus der vorhandenen Menge einer gewählten Zutat und ihrem Tagesbedarf ergibt sich die exakte sowie die abgerundete Anzahl reichender Tage, die dann auf alle übrigen Zutaten des Sets angewendet wird.

Bild-Upload & Audit-Log

Bilder für Zutaten und Sets laufen über wp_handle_upload() mit eigens gesetztem Upload-Verzeichnis- und Mime-Type-Filter statt über die volle Mediathek. Speichern und Löschen von Zutaten und Sets wird – sofern das Audit-Log-Modul aktiv ist – über weinhold_audit_log_log_event() protokolliert (Events ingredient_saved, ingredient_deleted, set_saved, set_deleted).

Besonderheiten

Die Legacy-Shortcode-Aliase (rudelroots_list, rudelroots_calculator ohne weinhold_-Präfix) wurden bewusst nicht entfernt, obwohl das Framework inzwischen konsequent das weinhold_-Präfix nutzt – bereits veröffentlichte Beiträge verwenden noch die alten Namen und sollen weiter funktionieren.

Beim Löschen einer Zutat oder eines Sets werden zuerst die Verknüpfungen in weinhold_rudelroots_set_ingredients entfernt und erst danach der Haupteintrag – ohne Fremdschlüssel-Constraint auf Datenbankebene übernimmt das Modul diese Reihenfolge selbst.

Wird beim Speichern eines Sets is_default gesetzt, entfernt das Modul das Flag zuerst bei allen anderen Sets – es kann also immer nur genau ein Standard-Set geben.

Versionshistorie

Version	Datum	Änderung
1.0.0	22.09.2026	Einführung der Versionierung.

RudelRoots

The RudelRoots module manages ingredients for BARF feeding (biologically appropriate raw food for dogs) in sets and calculates the amounts and costs needed from them — either by number of days or by an amount of an ingredient already on hand.

General

Ingredients & Sets

Each ingredient gets a name, description, image, optional purchase link, a gram value per 5 kg of dog weight per day, and a price per 100 g. Ingredients are grouped into sets (e.g. for different feeding plans); a set can be marked as default and is then automatically preselected when opening the calculator.

Two-Mode Calculator

In „Plan by days“ mode, you enter the desired number of days and the module calculates the amount and cost needed for each ingredient in the selected set. In „Plan by amount on hand“ mode, you instead pick an ingredient you already have along with its amount in grams — the module works out how many whole days the supply lasts, and how much of the set’s other ingredients are needed for the same period.

Overview List

A separate view shows all stored ingredients as a card grid with image, description, price per 100 g, and an optional purchase link.

Shortcodes

Shortcode	Description
weinhold_rudelroots_list	Card grid of all ingredients with image, description, and price. No parameters
weinhold_rudelroots_calculator	Requirement calculator with set selection and the two calculation modes. No parameters
rudelroots_list	/ rudelroots_calculator Legacy aliases without the weinhold_ prefix, already used in existing posts and kept active for compatibility

Files

File	Contents
modules/rudelroots.php	Module header, initialization, shortcode registration including legacy aliases, audit log integration
modules/rudelroots/db.php	Tables, install/cleanup, CRUD for ingredients and sets
modules/rudelroots/admin.php	Admin UI, form processing, image upload
modules/rudelroots/frontend.php	Both shortcode renderers including the calculation logic for the two modes

For Developers

Database

Table	Columns	(selection)
weinhold_rudelroots_ingredients	name, description, link_url, image_url, gramm_per_5kg_per_day, price_per_100g, sort_order
weinhold_rudelroots_sets	name, description, image_url, is_default, sort_order
weinhold_rudelroots_set_ingredients	set_id, ingredient_id	(unique combination)

Calculation Logic

weinhold_rudelroots_calculate_mode_a() linearly scales each ingredient’s gramm_per_5kg_per_day by the entered number of days. weinhold_rudelroots_calculate_mode_b() works the other way: from the amount on hand of a chosen ingredient and its daily requirement, it derives the exact and the rounded-down number of days the supply lasts, then applies that to all other ingredients in the set.

Image Upload & Audit Log

Images for ingredients and sets go through wp_handle_upload() with a dedicated upload-directory and mime-type filter instead of the full media library. Saving and deleting ingredients and sets is logged via weinhold_audit_log_log_event() when the Audit Log module is active (events ingredient_saved, ingredient_deleted, set_saved, set_deleted).

Special Cases

The legacy shortcode aliases (rudelroots_list, rudelroots_calculator without the weinhold_ prefix) were deliberately kept even though the framework now consistently uses the weinhold_ prefix — already-published posts still use the old names and are meant to keep working.

When deleting an ingredient or a set, the links in weinhold_rudelroots_set_ingredients are removed first, then the main entry — without a database-level foreign key constraint, the module enforces this order itself.

When is_default is set while saving a set, the module first clears the flag on all other sets — so there can only ever be exactly one default set.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

rudelroots

RudelRoots

Zutaten & Sets

Bedarfsrechner mit zwei Modi

Übersichtsliste

Datenbank

Rechenlogik

Bild-Upload & Audit-Log

RudelRoots

Ingredients & Sets

Two-Mode Calculator

Overview List

Database

Calculation Logic

Image Upload & Audit Log

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots