Entwickeln¶
Dieser Bereich ist für alle, die TWtheme erweitern.
Die eine Regel
Projektspezifisches gehört ins Child-Theme, nie in den Parent.
Der Maßstab: Ein Child muss ein Parent-Update ohne manuelle Eingriffe überstehen. Jede Änderung am Parent bricht dieses Versprechen, weil sie beim nächsten Update verloren geht.
Die Verträge¶
Diese drei Seiten zuerst. Sie legen fest, wie erweitert wird — alles Weitere baut darauf auf.
-
Child-Theme
Die Rangfolge beim Anpassen, und die zwei Stolpersteine, die beim ersten Mal verlässlich Zeit kosten. -
Modul-Vertrag
Wie ein Modul aufgebaut ist, wie es geladen wird und welche Regeln zwischen Modulen gelten. -
CSS-Architektur
Das Schichtenmodell, und warum eine Farbe nie im Stylesheet steht.
Die Feld-Engine¶
TWtheme nutzt kein Advanced Custom Fields, sondern eine eigene Engine. Ein einmal definiertes Feld ist überall verfügbar: im Backend, als Block, als Shortcode und im Code.
-
Überblick
Wie die Engine aufgebaut ist. -
Felder
Feldtypen und ihre Definition. -
Inhaltstypen anlegen
Eigene Inhaltstypen und Taxonomien mit Feldern. -
Optionsseiten
Eigene Einstellungsseiten und Reiter. -
Feld-Shortcodes
Wie aus einem Feld automatisch ein Shortcode wird. -
Post Meta
Feldwerte im Code auslesen.
Erweitern¶
-
Eigenes Modul
Ein Modul anlegen, das sich sauber abschalten lässt. -
Eigener Block
Einen Block registrieren — oder besser einen Core-Block erweitern. -
Templates überschreiben
Templates und Parts im Child ersetzen, und wie sich der Site-Editor dazu verhält. -
Dynamic Content
Inhalte per AJAX nachladen. -
Posts by Taxonomy
Beiträge nach Taxonomie gruppiert laden.
Werkzeuge¶
-
Entwicklungsumgebung
Die lokale Umgebung einrichten. -
Build-Kette
Wie aus den Quellen die Assets entstehen. -
Qualität prüfen
Die Prüfläufe und was sie abfangen. -
Übersetzungen
Textdomain, Dateien, Ablauf. -
Release-Pakete
Pakete bauen und Versionen anheben.
Der Reflex, der Fehler vermeidet¶
Module sind zur Laufzeit abschaltbar. Ein ungeprüfter Aufruf über Modulgrenzen ist deshalb ein Fatal Error, kein theoretisches Risiko:
Für sechs häufig genutzte Funktionen gibt es Stubs, die auch ohne Modul antworten — welche das sind, steht unter Template-Funktionen.
Nachschlagen¶
-
Hooks und Filter
Alle Erweiterungspunkte. -
Template-Funktionen
Die öffentlichen Funktionen mit Signatur. -
Design-Tokens
Die stabilen Slugs. -
Referenz
Blöcke, Module, Shortcodes, Templates, Optionen.