Wochenplan: Mein WordPress-Plugin für Essensplanung, Einkauf und Vorrat

Keine Zeit? Hier die Kurzversion in 30 Sekunden.
- Wochenplan ist ein eigenes WordPress-Plugin, mit dem unsere Familie Mahlzeiten für die Woche plant: Gerichte per Drag & Drop auf Frühstück, Mittag und Abend ziehen, getrennt nach Erwachsenen und Kindern.
- Aus dem Plan entsteht automatisch die Einkaufsliste, umgerechnet auf die Personenzahl und abzüglich dessen, was im Vorrat steht. Den Vorrat kann man per Barcode-Scanner mit dem Handy pflegen.
- Dazu kommen geteilte und private TO-DO-Listen mit Unterpunkten, Push-Nachrichten, eine tägliche Mail mit dem Tagesplan und Vorschläge, was sich aus dem Vorrat kochen lässt.
- Technik: PHP ohne Framework, eigene Datenbanktabellen, REST-API mit Schema-Prüfung, JavaScript als ES-Module ohne Build-Schritt, Web Push ohne Bibliothek. Entwickelt und getestet wird gegen eine lokale WordPress-Instanz.
- Das Projekt gibt es seit etwa zwei Jahren, und ich arbeite weiter aktiv daran. Am Ende stelle ich sieben Ideen vor, die als Nächstes dazukommen könnten, und überlege laut, ob das Plugin irgendwann offiziell bei WordPress erscheint.
Die Frage „Was essen wir heute?“ kommt bei uns zuverlässig gegen halb fünf. Meistens dann, wenn es für einen spontanen Einkauf schon knapp wird. Lange haben wir das mit einem Zettel am Kühlschrank gelöst, später mit einer geteilten Notiz-App und am Ende mit einer Mischung aus beidem. Funktioniert hat es nie richtig. Die Einkaufsliste wusste nichts vom Plan, der Plan nichts vom Vorrat, und spätestens wenn ein Kind mitisst, das eigene Portionen braucht, war die Rechnerei im Kopf wieder da.
Also habe ich mir das Werkzeug gebaut, das ich haben wollte. Es ist ein WordPress-Plugin geworden, weil meine Seite ohnehin auf WordPress läuft und ich so Benutzerverwaltung, Login und Mediathek geschenkt bekomme. Was vor etwa zwei Jahren als kleiner Essensplan angefangen hat, ist inzwischen ziemlich gewachsen, und fertig bin ich damit noch lange nicht. Ich arbeite weiterhin aktiv daran, meistens dann, wenn uns im Alltag wieder etwas fehlt. Zeit für einen Rundgang.
Der Plan: eine Woche auf einen Blick
Das Herzstück ist die Wochenansicht. Oben stehen die sieben Tage, darunter drei Blöcke für Frühstück, Mittag- und Abendessen. Jeder Block hat zwei Reihen, eine für die Erwachsenen und eine für die Kinder. Das klingt nach einem Detail, war aber der eigentliche Grund für das ganze Projekt: Bei uns isst das Kind mittags oft etwas anderes als wir, und ich wollte das sauber abbilden, ohne zwei Pläne zu führen.

Links liegt die Liste aller Gerichte. Von dort zieht man ein Gericht einfach auf den passenden Platz. Karten lassen sich zwischen Tagen, Mahlzeiten und Gruppen verschieben, und in der Kopfzeile stellt man ein, für wie viele Erwachsene und Kinder gekocht wird. Jede Karte kann davon abweichen, etwa wenn am Freitag Besuch kommt. Mit den Pfeilen neben der Kalenderwoche blättert man vor und zurück.
Klickt man auf eine Karte, öffnet sich das Gericht mit Bild, Link zum Originalrezept, Kommentar, Bewertung und der Zutatenliste, bereits umgerechnet auf die Personenzahl dieser Karte.

Gerichte pflegen, ohne sich zu ärgern
Ein Gericht anzulegen soll schneller gehen, als ein Rezept abzuschreiben. Name, Bild, Rezept-Link und Kommentar sind schnell gemacht. Spannender sind die Zutaten. Jede Zeile besteht aus Zutat, Menge und Einheit, darunter steht immer eine leere Zeile für die nächste Zutat. Wer keine Menge einträgt, bekommt „nach Bedarf“, das ist praktisch für Salz und Pfeffer.

Im Hintergrund läuft ein Zutatenkatalog mit. Tippe ich „Zwiebeln“, erkennt das Plugin die vorhandene Zutat „Zwiebel“. Aus „etwas Butter“ wird Butter, aus 1 kg werden 1000 g. Unbekannte Zutaten landen beim Speichern automatisch im Katalog. Im Admin-Bereich kann man Zutaten umbenennen oder zusammenführen, und die Änderung zieht sich dann durch alle Gerichte, den Vorrat und die gespeicherten Barcodes. Dazu gibt es Sterne-Bewertungen pro Person und eine Marke „Geprüft“ für Rezepte, bei denen Mengen und Zutaten wirklich stimmen.
Die Einkaufsliste rechnet selbst
Hier spart das Plugin im Alltag die meiste Zeit. Die Einkaufsliste wird aus allen geplanten Mahlzeiten berechnet, auch über mehrere Wochen hinweg. Mengen werden zusammengefasst, Gramm und Kilogramm genauso wie Milliliter und Liter, Einzahl und Mehrzahl werden als dieselbe Zutat erkannt. Mahlzeiten, die schon gegessen sind, fallen raus: Frühstück zählt ab zehn Uhr nicht mehr, Mittag ab 14 und Abendessen ab 20 Uhr.

Neben den berechneten Zutaten kann man eigene Artikel eintragen, also Spülmittel, Kaffee oder Windeln. Jeder Eintrag merkt sich, wer ihn angelegt hat, und lässt sich einer Person zuweisen. Die bekommt dann eine Mail. Steht dieselbe Zutat einmal aus dem Plan und einmal von Hand auf der Liste, führt das Plugin beides zu einer Zeile zusammen und zeigt darunter, woher die Mengen kommen. Abgehaktes rutscht nach unten, Gelöschtes landet für 30 Tage im Papierkorb.
Vorrat, Barcode-Scanner und „Was kochen?“
Der Reiter „Was kochen?“ dreht die Frage um. Links steht der Vorrat: Was ist da, und wie viel? Rechts schlägt das Plugin Gerichte vor, sortiert danach, wie wenig man noch einkaufen müsste. Gute Bewertungen geben bei Gleichstand den Ausschlag. Der Vorrat wird außerdem von der Einkaufsliste abgezogen. Wenn noch ein Kilo Spaghetti im Schrank liegt, taucht die Packung für die Bolognese gar nicht erst auf.

Damit der Vorrat nicht zur lästigen Pflegeaufgabe wird, gibt es einen Barcode-Scanner. Am Handy öffnet sich die Kamera, man hält sie auf die Packung und bucht mit „+ Eingekauft“ oder „? Verbraucht“. Kennt das Plugin den Code noch nicht, fragt es Open Food Facts nach Produktname und Packungsgröße. Die Zutat wird vorgeschlagen, man bestätigt einmal, und ab dann reicht der Scan. Wichtig war mir dabei, dass nur die Barcode-Nummer das Haus verlässt. Die Abfrage läuft über den eigenen Server, und auch das Produktbild kommt über ihn.

Listen für alles andere
Irgendwann wollten wir nicht mehr zwei Apps nebeneinander haben, und so ist der Reiter TO-DO entstanden. Neben der Einkaufsliste gibt es beliebig viele eigene Listen, geteilt für die ganze Familie oder privat. Einträge haben Fälligkeiten, Notizen und Unterpunkte. Überfälliges ist rot, Fälliges von heute grün.

Benachrichtigungen kommen auf zwei Wegen. Morgens um sechs gibt es auf Wunsch eine Mail mit dem Tagesplan. Ändert jemand die Einkaufsliste oder den Plan, bekommen die anderen eine Push-Nachricht aufs Handy. Damit das nicht nervt, werden Änderungen 15 Minuten gesammelt und als eine Nachricht verschickt. Wer die Änderung selbst gemacht hat, bekommt nichts.
Am Handy wie eine App
Die meiste Zeit benutzen wir den Wochenplan am Handy, im Supermarkt oder in der Küche. Unter 1000 Pixeln Breite stellt sich die Oberfläche komplett um: eine Tagesleiste oben, die Reiter als feste Leiste unten, Dialoge als Bottom Sheets. Über ein Web-App-Manifest lässt sich die Seite auf den Startbildschirm legen und öffnet sich dann ohne Browserleiste. Auf dem iPhone ist das sogar Voraussetzung für Push-Nachrichten.

Ein Blick unter die Haube
Technisch habe ich ein paar bewusste Entscheidungen getroffen. Das Plugin kommt ohne Framework und ohne Build-Prozess aus. Der PHP-Teil ist in Module aufgeteilt, für Gerichte, Plan, Listen, Vorrat, Zutaten, Barcodes, Push und Einstellungen. Die Daten liegen in eigenen Tabellen, die per dbDelta angelegt und bei Versionssprüngen erweitert werden. Gerichte sind ein eigener Beitragstyp, damit Beitragsbilder, Papierkorb und Admin-Masken von WordPress mitkommen.
Die Oberfläche spricht ausschließlich mit einer eigenen REST-API unter wochenplan/v1. Jede Route hat ein Argument-Schema, WordPress prüft Typen, Wertebereiche und erlaubte Werte, bevor der eigentliche Code überhaupt läuft. Zugriff hat nur, wer im Admin ausdrücklich freigeschaltet ist. Fremde private Listen sind serverseitig gesperrt, nicht nur in der Oberfläche ausgeblendet.
Das JavaScript besteht aus nativen ES-Modulen, die über eine Import-Map mit Versionsnummer geladen werden. Es gibt kein npm, kein Bundling und kein Transpilieren. Die Oberfläche läuft auf einer eigenen Seite ohne Theme, ist für Suchmaschinen gesperrt und wird nicht gecacht.
Zwei Teile haben mir besonders Spaß gemacht. Der Barcode-Scanner nutzt den BarcodeDetector des Browsers, wo es ihn gibt, also vor allem in Chrome unter Android. Auf dem iPhone springt ein Fallback auf Basis von ZXing als WebAssembly ein, das direkt aus dem Plugin geladen wird und nicht von einem CDN. Und Web Push läuft komplett ohne Bibliothek: VAPID-Signatur mit ES256 und die Verschlüsselung nach RFC 8291 mit dem, was PHP über OpenSSL mitbringt. Ob das stimmt, prüft ein Test gegen den offiziellen Testvektor aus dem RFC.
Überhaupt die Tests: PHP- und JavaScript-Logik teilen sich eine gemeinsame Datei mit Testfällen, damit der Zutaten-Parser auf beiden Seiten garantiert gleich rechnet. Entwickelt und getestet wird gegen eine lokale WordPress-Instanz. Erst wenn dort alles läuft, geht eine neue Version auf den Server. Den Tagesversand stößt ein echter Cronjob beim Hoster an, nicht WP-Cron, weil das bei einer gecachten Seite zu unzuverlässig war.
Was noch kommen könnte
Fertig ist so ein Werkzeug nie. Diese Ideen stehen auf meiner Liste:
- Rezept-Import per Link: Viele Rezeptseiten liefern strukturierte Daten nach schema.org. Link einfügen, Name, Bild, Portionen und Zutaten werden übernommen, der Zutatenkatalog gleicht den Rest ab.
- Vorrat automatisch abbuchen: Ein Knopf „Gekocht“ an der Karte zieht die verbrauchten Zutaten vom Vorrat ab. Im Moment zählt der Vorrat für jede Woche voll.
- Wochenvorschlag auf Knopfdruck: Den leeren Plan aus bewährten Gerichten füllen, mit Rücksicht auf Bewertung, Vorrat und Abwechslung, damit nicht dreimal Nudeln drankommen.
- Haltbarkeit im Vorrat: Beim Scannen optional ein Mindesthaltbarkeitsdatum mitspeichern. Was bald abläuft, rutscht in den Vorschlägen nach oben und landet in der Morgenmail.
- Einkaufsliste nach Gängen sortiert: Statt alphabetisch nach Abteilungen wie Obst und Gemüse, Kühlregal und Trockenwaren. Am besten in der Reihenfolge des eigenen Supermarkts.
- Offline im Laden: Der Service Worker ist schon da. Er könnte die Einkaufsliste zwischenspeichern und Haken nachträglich übertragen, wenn im Markt mal wieder kein Netz ist.
- Kochmodus: Ein Gericht in großer Schrift Schritt für Schritt, mit Timer, und der Bildschirm bleibt dank Wake Lock an, auch wenn die Hände gerade voller Teig sind.
Irgendwann auch für andere?
Bisher läuft der Wochenplan nur bei uns. Je mehr er kann, desto öfter frage ich mich aber, ob er nicht auch anderen Familien helfen würde. Eine offizielle Veröffentlichung im Plugin-Verzeichnis von WordPress wäre der naheliegende Weg. Mit den Details und Voraussetzungen dafür habe ich mich allerdings noch nicht beschäftigt. Ich vermute, dass vor allem Dinge wie Übersetzbarkeit, Einstellungen statt fest eingebauter Werte und eine ordentliche Dokumentation dazukämen. Das schaue ich mir in Ruhe an, bevor ich etwas verspreche.
Am meisten freue ich mich ehrlich gesagt auf den Rezept-Import, denn das Abtippen von Zutaten ist der letzte Teil, der sich noch nach Arbeit anfühlt. Wie plant ihr eure Woche? Zettel, App oder ganz spontan?
Christian Ackermann
Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.