Überblick – Die Meister-Familie
Der Allesmeister (Am) sorgt dafür, dass andere Anwendungen (Katalogmeister, Farbmeister, …) ihre Inhalte als Zettel im Zettelmeister (Zm) darstellen und bedienen können. Dazu liefert jede Anwendung eine kleine HTML-API – Am dokumentiert das Muster und stellt Hilfsskripte bereit.
Das API-Muster
Jede Anwendung stellt einen /api/div-Endpunkt bereit,
der benannte HTML-Abschnitte (Divs) zurückliefert.
Der Zm holt diese über seinen PHP-Proxy und zeigt sie im Zettel an.
Zm-Proxy – erweiterbar
$_apiZiele = [
'opnn' => 'https://opnn.fl.de/api/div/', // Node.js (div im Pfad)
'km' => 'https://km.fl.de/api/div.php', // PHP (div als ?div=)
// 'fm' => 'https://farbmeister.de/api/div.php',
];
Div-Nummern
| Div | Inhalt | Auth |
|---|---|---|
2-wegweiser | Navigationsspalte | zmkey |
3-anmelden | Anmeldeformular (opnn) | – |
4-suche | Suchformular | – |
5-ergebnis | Daten-Ausgabe | zmkey |
6-bericht | Meldungen / Fehler | – |
km-API · km.fl.de/api/div.php
PHP-API für den Katalogmeister. DB: OffenesProjektKm,
Tabelle Flugautos (1655 Einträge).
| Aufruf | Liefert |
|---|---|
?div=4-suche&q=Begriff | Suchformular |
?div=5-ergebnis&route=search&q=Begriff | Treffer-Tabelle (max. 50) |
?div=5-ergebnis&route=liste&seite=1 | Alle Einträge (25 pro Seite) |
?div=2-wegweiser | Navigationsspalte |
?div=6-bericht&msg=Text&typ=error | Meldungskasten |
km.js – Zm-Shortcuts
kmSucheNeu() // Suchzettel (Formular + Ergebnisse) kmListeNeu() // Alle Einträge, seitenweise kmWegweiserNeu() // Navigationsspalte
Zettel-JSON-Feld opDiv:
{ "quelle": "km", "rezept": "suche", "params": {} }
Shell-Skripte · am.fl.de/sh/
| Skript | Zweck |
|---|---|
am_konfig.sh |
Pfade zu Am, Zm, Km; DB-Zugangsdaten; Km-API-Pfad |
am_hilfe.sh |
am_log · am_zettel_json ·
am_zettel_hinzufuegen · am_welt_liste |
test_zettel.sh |
Grundmuster: Erläuterungszettel in Zm einfügen |
sh/km/km_zm.sh |
Km-Zubringer: legt Km-Wegweiser, Km-Suche, Km-Liste in der Zm-Welt an |
Einbinden
source /home/www/am.fl.de/html/sh/am_konfig.sh source /home/www/am.fl.de/html/sh/am_hilfe.sh zettel=$(am_zettel_json --titel "Titel" --inhalt "<p>Text</p>" --farbe "#d4ffea") am_zettel_hinzufuegen "$ZM_DATEN/1/willkommen.json" "$zettel"
am_zettel_json – Parameter
| Parameter | Voreinstellung | Bedeutung |
|---|---|---|
--titel | Neuer Zettel | Titel |
--inhalt | <p></p> | HTML-Inhalt |
--farbe | #FFFFEE | Hintergrundfarbe (Hex) |
--winkel | 0 | Drehung in Grad |
--breite / --hoehe | 300 / 200 | Größe in px |
--stichworte | – | Komma-getrennte Schlüsselwörter |
--link | – | Klickziel-URL |
--op-div | – | JSON für API-Zettel, z.B. '{"quelle":"km","rezept":"suche","params":{}}' |
am_zettel_entfernen
am_zettel_entfernen "$ZM_DATEN/1/willkommen.json" "km-zubringer" # Entfernt alle Zettel deren stichworte-Feld "km-zubringer" enthält
km_zm.sh – Km-Zubringer
# Standard: legt 3 Zettel in $KM_ZM_WELT an bash /home/www/am.fl.de/html/sh/km/km_zm.sh # Andere Zm-Welt als Ziel: bash /home/www/am.fl.de/html/sh/km/km_zm.sh /pfad/zur/welt.json
Legt drei Zettel an (Stichwort km-zubringer, Farbe #d4ffea):
| Zettel | Rezept | Inhalt |
|---|---|---|
| Km-Wegweiser | wegweiser | Navigationsspalte (240 × 360) |
| Km-Suche | suche | Suchformular + Ergebnisse (440 × 480) |
| Km-Liste | liste | Alle Einträge seitenweise (480 × 520) |
Bei jedem Aufruf werden alte km-zubringer-Zettel zuerst entfernt,
dann frische angelegt.
Zertifikate & nginx
echo "DOMAIN.de" | sudo bash /usr/local/bin/zert.sh # Voraussetzung: /home/www/DOMAIN/html muss existieren
Einrichtungs-Protokoll
- 2026-06-07✓
DL: Domain
am.fl.de→ 46.225.170.170 · Ordner · GitHub-Repo delinde/Allesmeister - 2026-06-07✓
CC: HTTPS via
zert.sh· nginx · Git init + push (SSH) - 2026-06-07✓
CC: Verzeichnisstruktur
sh/ js/ vorlagen/ protokoll/ - 2026-06-07✓
CC:
am_konfig.sh·am_hilfe.sh·test_zettel.sh·jqinstalliert - 2026-06-07✓
CC: Erläuterungszettel Am + Km in
zm/daten/1/willkommen.json - 2026-06-08✓
CC:
km.fl.de/api/div.php– km-API (Suche, Liste, Wegweiser) - 2026-06-08✓
CC:
zm/km.jsv1 · Dispatcher in index.js · Km-Suche-Zettel in Zm - 2026-06-08✓
CC: Zm-Proxy erweitert (
$_apiZiele) · GitHub: delinde/Katalogmeister - 2026-06-08✓ CC: am.fl.de – Dokumentationsseite
- 2026-06-08✓
CC:
sh/km/km_zm.sh– Km-Zubringer (Wegweiser · Suche · Liste) ·am_hilfe.sh:--op-div+am_zettel_entfernen