Endlich Montag! Voller Elan fuhr ich den Rechner hoch. Ich hatte mir überlegt, zunächst die Grundstrukturen aufzubauen.

Konfigurationsdatei package.yml
(YAML)

REDAXO hat diesbezüglich geringe Anforderungen, die zwingend erfüllt werden müssen: Eine Datei zur Konfiguration, die package.yml, reicht aus. Richtig gelesen: eine einzige Datei. Einer der Vorteile an diesem Open Source CMS ist der schlanke Code.

YAML (Yet Another Markup Language) – die vereinfachte Auszeichnungssprache zur Datenserialisierung – verstehe ich in aller Regel auf Anhieb. REDAXO ist konsistent. Etwas, das einmal verstanden ist, kann überall angewandt werden. Ausnahmen gibt es selten und diese sind dann erstklassig dokumentiert. Noch ein Pluspunkt, den ich an REDAXO schätze. Also im Grunde sogar zwei.

Mit der guten REX-Doku fiel es mir leicht, die notwendige package.yml für mein erstes AddOn anzulegen und für meine Zwecke zu justieren. So entstand nach und nach die Datei- und Ordnerstruktur. Hierbei kam mir zugute, dass ich in den Monaten, die ich auf diesen Moment hinarbeitete, mein Datenbank-Design inklusive dem strategischen Konzept der Dateinamensschlüssel und Programmier-Grundsätze erarbeitet hatte.

Da ich mein KANBAN ebenfalls nach diesen Prinzipien aufgebaut habe, sind mir die Arbeitsabläufe und die Struktur der geplanten Indexierung in Fleisch und Blut übergegangen. Im Lernprozess erwies sich diese vorbereitende Phase als Vorteil, da ich beim Üben die ein oder andere Schwachstelle meiner Konzeption erkannt und entsprechend angepasst hatte. Also war viel meiner Aufgaben rund um die Konfiguration meines AddOns Fleißarbeit und Routine. Das allerdings bei höchster Konzentration.

Nach der Mittagspause analysierte ich meine Lieblings-AddOns und schaute mir an, wie sie ihre spezifischen Themen und Aufgaben lösen. Bis Montag Abend hatte ich die Grundstruktur aufgebaut und die ersten (noch leeren) Dateien angelegt. Pünktlich kurz vor 21 Uhr fuhr ich hoch zufrieden meinen Rechner runter. So konnte es weiter gehen!

Installation & Deinstallation
(PHP & MySQL, YORM)

Am Dienstag arbeitete ich mich in den Teil “Installation” eines REDAXO AddOn ein. Noch programmiere ich den Code außerhalb meiner lokalen REDAXO-Instanz – quasi alles Trockenübungen.

Es hat eine Weile gedauert, doch nach und nach verstand ich, dass sämtliche AddOns in der install.php vor allem das Anlegen der Datenbank-Tabellen steuern. Hier scheiden sich die Geister: reines PHP, pures MySQL und YORM – je nach Präferenz und Kenntnisstand der Entwickler (ja, alles Männer).

Mein AddOn baut direkt auf REDAXO YForm auf. Also vertiefte ich mich in Option 3. YORM erlaubt ein vereinfachtes, automatisiertes, bidirektionales, anwenderfreundliches Zuordnen von Objekt-Attributen zu YAML-Dateien. Erst einmal aufschlauen, was YORM überhaupt ist. Wohlwissend hatte ich am Morgen das Video der REDAXO Hour zu YORM angeschaut und meine Grundkenntnisse aufgefrischt.

YAKAMARA, die das AddOn YForm entwickelten, bauten schon zahlreiche Adaptionen für REX. In den letzten Monaten kamen weitere Code-Verbesserungen von der Community hinzu. Ich kann also aus dem Vollen schöpfen. Die Schwierigkeit ist eher, dass ich die umfassende Dokumentation verstehen und überblicken muss. Mit der AddOn-Programmierung bin ich auf einem Niveau angekommen, da sind nur Fortgeschrittene und Profis am Werk. Für mich als Anfängerin schwer und anspruchsvoll. Einer der Gründe übrigens, weswegen ich morgens mir zur Routine gemacht habe, die Doku einfach nur zu lesen. So prägt sich alles sukzessive ein. Auch wenn ich momentan noch oft in der Situation bin, dass ich denke “Moment, da habe ich doch irgendwo was dazu gelesen…”

Wo ein Installieren, da ein Deinstallieren. Hinsichtlich Deinstallation handhaben das die REDAXO AddOns je nach spezifischem Anwendungszweck unterschiedlich. Manche Entwickler bieten – neben dem Deaktivieren oder Löschen des AddOns gemäß REDAXO-Standard – an, die erzeugten Datensätze samt Tabellen explizit zu löschen oder zu erhalten. Dasselbe gilt für Module, Templates usw., die gegebenenfalls mit dem AddOn ausgeliefert wurden. Gleichzeitig prüfen sie, ob diese Daten anderweitig genutzt werden. Das halte ich für die Königsklasse der Programmierung und hoffe, das hinzubekommen. Es wird ein weiter Weg.

Heute, am Freitag, ist mein Status für die Installations-/Deinstallations-Routine: “In Arbeit”.

Tabellen-Sets
(JSON)

Am Mittwoch vertiefte ich mich in den Table-Manager von REDAXO YForm. Das ist ja einer der Bausteine für die Installationsroutine: Dem System sagen, welche Tabellen mit welchen Spalten in welcher Konfiguration (Text, Zahl, Datum, Pflichtfeld ja/nein, automatisiertes Hochzählen für die IDs der Datensätze usw.) angelegt werden sollen.

Über eine intuitiv zu bedienende Oberfläche kann ich mir als Admin im Backend von REDAXO die gewünschte Tabellenstruktur inklusive ihrer Einstellungen zusammenklicken. Falls Dich das näher interessiert, in der REDAXO Hour zu YForm erklärt Jan von YAKAMARA das AddOn (hoppla, auch schon zwei Jahre alt!).

Erneut erweist es sich als klever, das Datenbank-Design vorab und getrennt vom Programmier-Prozess zu erarbeiten. Ich habe das übrigens mit DBDesignerFork (Open Source, via SourceForge) umgesetzt. Das war 2019 das Programm, mit dem ich am besten zurechtkam.

YForm – beziehungsweise wie es damals noch hieß: xform – nutze ich seit 2013. Erster Anwendungsfall war die Anmeldemaske zum EnjoyWork Camp 2014. Das sind also schon fast zehn Jahre! Seither hat sich extrem viel getan. Vor allem mit REDAXO 5 und dem damit verbundenen Sprung von xform zu YForm sowie in den Iterationen von YForm wurden Bedienerfreundlichkeit und Funktionsumfang verbessert. Jetzt arbeite ich mit v4.0.2. Die größte Herausforderung bei YForm ist stets, dass es ein grundlegendes AddOn der Community ist. Mit jeder Iteration müssen viele andere AddOns, PlugIns und so weiter nachziehen. Aufgrund der gegenseitigen Abhängigkeiten ist es nicht einfach, ein stabiles System aufrecht zu erhalten und zu pflegen. Daher gehöre ich bezüglich YForm immer zu den “late adoptern”. Ich warte bis die Profis alle Probleme erkannt und idealerweise behoben haben. Ich bewundere die FOR-Entwickler, wie schnell sie diesbezüglich geworden sind.

Zurück zum Thema: Tabellen-Sets anlegen. Um mir für die Installationsroutine das JSON zu generieren, legte ich über den Table-Manager in meiner Instanz REX-DEV-TEST (siehe Aus der Werkstatt KW23) eine neue Tabelle an. Per Knopfdruck kann ich mir nun das JavaScript Object Notation ausgeben lassen. JSON ist ein kompaktes Datenformat in Textform, das den Datenaustausch zwischen Anwendungen ermöglicht. Kompakt ist hier wörtlich gemeint. Via REX YForm erhalte ich eine einzelne, sehr lange Zeile Code mit extrem vielen geschwungenen und einfachen Klammern, mit Simikolons so weit das Auge reicht und einer ganzen Reihe Textbausteinen mit Doppelpunkten dazwischen.

Um die strukturierten Daten meiner REDAXO-Tabelle also besser zu verstehen, und um idealerweise später nicht mehr den Umweg über die TEST-Umgebung mit Durchklicken vollziehen zu müssen, machte ich mich am Mittwoch auf die Suche nach einem JSON “Beautifier”, wie das im Fachjargon heißt. Dazu gibt es zahlreiche Online-Angebote. Ich griff mir aus der Liste der Suchtreffer www.jsonbeautifier.org.

Bis Mittwoch Abend war ich so weit, dass ich das Anlegen und Konfigurieren von Datenbank-Tabellen erarbeitet, verstanden und in einem ersten Anwenden des Gelernten umgesetzt hatte. Heureka!

Zwischenfazit
REDAXO AddOn-Entwicklung

Halten wir fest: Binnen drei Tagen beschäftigte ich mich mit YAML, PHP, MySQL, YORM und JSON. Alles für mich neue Programmiersprachen. Die geballte Ladung also, wenn auch kein Hexenwerk. Da ich mich ohne Ablenkung durch Termine und andere Aufgaben voll darauf konzentrieren konnte, lief das gut. Ich unterstützte den Intensivlernprozess dadurch, dass ich Social Media sowie Podcasts, Videos usw. zu fachfremden Themen auf ein Minimum reduzierte. Es erfüllt mich mit Stolz, dass das diese Woche so gut gelang. Ich mache große Fortschritte. Ein schönes Gefühl.

Am Donnerstag wollte ich daran anknüpfen. Im Tutorial vom Morgen war ich darauf aufmerksam geworden, wie wichtig die PHP-Version meines Programmier-Werkzeugs ist, um sauberen Quellcode zu produzieren. Damit stelle ich sicher, dass vom Software-Development-Tool Fehler ausgeworfen werden, wenn ich veralteten (oder abgekündigten) Code verwende. Wenn man sich wie ich Software-Code von allen möglichen Quellen remixt und zu einem neuen Programm zusammenfügt, ist das ein elementares Hilfsmittel zum Wahren der Qualität. Es ist zudem effizienter. Ich erhalte nicht erst Notices oder Whoops beim Aufspielen auf den Server (der ja sowohl lokal als auch online bei mir auf PHP 7.4 läuft), sondern bereits im Verlauf des Schreibprozesses.

Natürlich wusste ich das. Doch im Eifer des Tagesgeschäfts war mir das aus dem Fokus geraten. Also prüfte ich in Adobe DreamWeaver die Grundeinstellungen. Und siehe da: die Version stand auf PHP 7.1. Nach einer kurzen Ecosia-Befragung entschloss ich mich, den Weg abzukürzen. Ich öffnete das Adobe DreamWeaver Forum und recherchierte dort, ob es Aussichten auf das Upgrade gibt. Gab es nicht. Ich fragte unschuldig nach. Die Antworten ließen nicht lang auf sich warten (tolles Forum, das war mir bis dahin nicht bewusst, wie aktiv die Community ist). Und so erfuhr ich am Donnerstag früh, dass Adobe DreamWeaver nicht weiterentwickelt. Abgekündigt ist das Programm nicht. Das scheint jedoch nur eine Frage der Zeit. Bis dahin kann man (basierend auf PHP 7.1) damit arbeiten. Angesichts der Tatsache, dass PHP 7.1 seit Januar 2020 nicht mehr unterstützt wird, ein hohes (Sicherheits)Risiko.

Für mich hieß das: eine neue Software zum Programmieren suchen. Damit begann die nächste Odyssee. Womit ebenfalls klar war: An AddOn-Entwicklung war für den Tag / die Woche nicht mehr zu denken. Mit den Steinen, die uns im Weg liegen, einfach die Route anlegen, die uns zum Erfolg führt. Auf geht’s!

Inzwischen ist es Freitag Abend. Neben der Reflexion, die Du liest, einem Spaziergang mit Pause im Park, Botengängen und anderen Kleinigkeiten ist zu heute nichts weiter zu berichten. Schade, dass die Lindenblüte vorbei ist. Sie kam mir heuer deutlich kürzer als in den vergangenen Jahren vor. Die Wiese ist etwas grüner durch den Regen. Doch täuscht das nicht über die Dürre hinweg. Wir sind Zeitzeugen des Klimawandels und das tut weh.

Rückblickend auf die Woche fallen mir noch die erfrischenden und herzlichen Gespräche ein. Sie fanden spontan statt. Ich griff einfach zum Hörer und klingelte durch. Wenn es grad passte, schwatzten wir kurz oder verabredeten uns für einen späteren Zeitpunkt. Das war schön. Danke, Ihr Lieben Kusshand

Damit beschließe ich den Werkstattbericht. Danke fürs Lesen. Nun weitermachen ;-)