Blöcke¶

TWtheme registriert gut vierzig eigene Blöcke. Sie liegen fast alle in der Editor-Kategorie TWtheme-Blöcke; drei Ausnahmen: die beiden Layout-Blöcke stehen unter Design, das Glossar unter Fremdwörter.

Ein Block erscheint im Editor nur, wenn das Modul aktiv ist, das ihn mitbringt. Abgeschaltete Module werden gar nicht geladen — der Block ist dann nicht registriert und Inhalte, die ihn verwenden, zeigen im Frontend nichts an. Wie viele Blöcke tatsächlich zur Auswahl stehen, hängt also vom Modulzustand ab.

Die Namen in der Spalte Block sind die Titel, die im Editor erscheinen. Sie zu suchen ist der schnellste Weg: Ein „tw" im Suchfeld des Inserters listet die Theme-Blöcke auf.

Der Block-Inserter mit dem Suchbegriff tw

Layout¶

Block	Modul	Zweck
Responsive Spalten `twtheme/responsive-columns`	`layout-blocks`	Spalten mit Spaltenzahl je Viewport, Umbruch und 12er-Raster. Für einfache Spalten reicht der Core-Block Spalten.
Responsives Raster `twtheme/responsive-grid`	`layout-blocks`	Rasterlayout mit Steuerung je Viewport. Nachfolger des früheren Gruppen-Stils Responsive Grid.

Beide speichern ihr Markup statisch im Beitrag, werden also nicht bei jedem Seitenaufruf neu gerendert. Als Kinder nehmen die Responsiven Spalten den Core-Block Spalte.

Text und Hinweise¶

Block	Modul	Zweck
TW Box `twtheme/highlight`	`highlight`	Rahmen um Inhalte, mit optionalen Listen-Icons. Standard-Icon ist ein ausgefülltes Plus.
TW Note `twtheme/note`	`note`	Hinweiskasten in vier Varianten: Info, Warnung, Gefahr, Erfolg — jeweils mit Icon.
Code Block `twtheme/code-block`	`note`	Code mit Sprachwahl und Syntaxhervorhebung über CodeMirror.
TW Icon `twtheme/icon`	`icons`	SVG-Icon aus der Icon-Bibliothek, alternativ Text in derselben Größe.

Block	Modul	Zweck
TW Megamenu `twtheme/megamenu`	`megamenu`	Mehrspaltiges Hauptmenü aus einer Menü-Position, samt der Megamenü-Felder aus dem Menü-Editor.
Klassisches Menü `twtheme/classic-menu`	`classic-menu`	Menü aus Darstellung → Menüs, nicht aus dem Navigations-Block.
TW TOC `twtheme/post-toc`	`toc`	Inhaltsverzeichnis des aktuellen Beitrags. Frei platzierbar; der Beitragstext kommt separat über Beitragsinhalt.
Post content with TOC `twtheme/post-content-toc`	`toc`	Altlast: Inhalt und Inhaltsverzeichnis in einem Block. Für Neues die beiden getrennten Blöcke verwenden.
Barrierefreiheits-Trigger `twtheme/accessibility-trigger`	`accessibility`	Öffnet das Modal für Barrierefreiheits-Einstellungen und Seitennavigation.

Beitragsdaten¶

Block	Modul	Zweck
Autor `twtheme/post-author`	`author-display`	Autorname, Portrait und Veröffentlichungsdatum des aktuellen Beitrags.
TW Inhaltstyp-Beschriftung `twtheme/post-type-label`	`website`	Beschriftung des Inhaltstyps, optional als Link auf das Archiv.

Beide brauchen einen Beitragskontext und gehören damit in Single- oder Archiv-Templates beziehungsweise in eine Abfrageschleife.

Eigene Felder ausgeben¶

Diese Blöcke lesen die Felder, die das Theme für einen Inhaltstyp definiert. Ohne konfigurierte Felder haben sie keine Datenquelle.

Block	Modul	Zweck
TW Meta `twtheme/meta`	`meta-blocks`	Gibt ein Theme-Feld oder ein WordPress-Kernfeld aus — Autor, Datum, Taxonomien und weitere.
TW Meta Repeater `twtheme/meta-repeater`	`meta-blocks`	Läuft über ein Wiederholungsfeld und rendert die inneren Blöcke je Zeile.
Meta-Repeater-Vorlage `twtheme/meta-repeater-template`	`meta-blocks`	Die Vorlage für eine Zeile. Nur innerhalb von TW Meta Repeater verwendbar.
TW Meta Conditions `twtheme/meta-conditions`	`meta-blocks`	Zeigt je nach Feldbedingung einen von zwei Blockbäumen.
Conditions branch `twtheme/meta-conditions-branch`	`meta-blocks`	Der Inhalt eines Zweigs. Nur innerhalb von TW Meta Conditions verwendbar.
TW Meta-Accordion-Einträge `twtheme/meta-accordion-items`	`meta-blocks`	Füllt ein Akkordeon aus Feldern oder Repeater-Zeilen. Muss in den Core-Block Akkordeon eingefügt werden.

Listen und Filter¶

Block	Modul	Zweck
TW Loop `twtheme/loop`	`loops-filter`	Beitragsabfrage mit Live-Vorschau, optional als wiederverwendbare Vorlage.
TW Filter `twtheme/filter`	`loops-filter`	Archivfilter mit Live-Vorschau. Lässt sich per Vorlagen-ID mit einem TW Loop verbinden.
TW Query Filter `twtheme/query-filter`	`loops-filter`	Filter für eine native Abfrageschleife, verknüpft über die `queryId`.
Mehr laden `twtheme/query-load-more`	`loops-filter`	Nachladen-Schaltfläche. Gehört in eine Abfrageschleife; eine zusätzliche Paginierungseinstellung ist nicht nötig.
Archive link `twtheme/query-archive-link`	`loops-filter`	Schaltfläche zum Inhaltstyp-Archiv, für den Paginierungsmodus Archiv-Link.
TW Loops & Filter (veraltet) `twtheme/loops-filter`	`loops-filter`	Veraltet und aus dem Inserter ausgeblendet. Nur noch für Altinhalte; ersetzt durch TW Loop und TW Filter.

Suche¶

Block	Modul	Zweck
TW Suche `twtheme/search`	`search`	Sucheinstieg, entweder als Seite oder als Vollbild-Overlay.
TW Suchergebnisse `twtheme/search-results`	`search`	Ergebnisliste über die interne Relevanzbewertung des Themes.
TW Suchtreffer `twtheme/search-match`	`search`	Einzelner Treffer mit Titel und Textausschnitt, für Karten in einer Abfrageschleife.

Das Modul search setzt loops-filter und modal voraus.

Interaktion¶

Block	Modul	Zweck
TW Tabs `twtheme/tw-tabs`	`tabs`	Barrierefreie Reiter mit bearbeitbaren Panels.
Tab `twtheme/tw-tab`	`tabs`	Ein einzelner Reiter mit Beschriftung und Inhalt. Nur innerhalb von TW Tabs.
TW Modal Trigger `twtheme/modal-trigger`	`modals`	Öffnet ein Inhalts-Modal. Bezieht sich auf einen Eintrag des Inhaltstyps Modal.

Medien und Marketing¶

Block	Modul	Zweck
TW Slider `twtheme/slider`	`slider`	Bindet einen vorhandenen Slider ein oder rendert einen Bild-Slider. Vorlagenvariablen sind in der Seitenleiste überschreibbar.
Mockup `twtheme/mockups`	`mockups`	Bildschirminhalt als Bild oder YouTube-Video in einer Geräteansicht. Layout kommt aus den Mockup-Vorlagen im Backend.
Mockup `twtheme/tw-mockup`	`mockups`	Der Blockname bis TWtheme 3.0.0, als Alias weitergeführt. Nicht im Inserter — er hält nur bestehende Inhalte am Leben.
YouTube-Playlist `twtheme/youtube-playlist`	`youtube-playlist`	YouTube-Player mit auswählbarer Videoliste.
TW Download `twtheme/download`	`download`	Download-Element aus dem Inhaltstyp Download.
TW Pricing Cards `twtheme/pricing-cards`	`pricing-cards`	Preiskarten aus einem Produkt-Inhaltstyp.
TW Social `twtheme/social`	`socialmedia`	Social-Media-Links aus den Theme-Optionen unter Website → Contact Information.
TW News Bar `twtheme/news-bar`	`news`	Geplante News-Einträge als kompakte Ankündigungsleiste.
Countdown `twtheme/event-countdown`	`news`	Countdown auf ein festes Datum oder auf das Datum eines News-Eintrags.
Foreign Words Glossary `twtheme/foreignword-glossary`	`foreignwords`	Glossarliste im responsiven Raster, optional mit Themenkarten.

Kind-Blöcke¶

Diese Blöcke lassen sich nicht frei einfügen, sondern nur innerhalb eines bestimmten Elternblocks:

Kind-Block	Gehört in
`twtheme/tw-tab`	`twtheme/tw-tabs`
`twtheme/meta-repeater-template`	`twtheme/meta-repeater`
`twtheme/meta-conditions-branch`	`twtheme/meta-conditions`
`twtheme/meta-accordion-items`	`core/accordion`
`twtheme/query-load-more`	`core/query`

Veraltete Blöcke¶

Zwei Blöcke sind ersetzt, funktionieren aber weiter, damit bestehende Inhalte nicht brechen:

Block	Ersatz
`twtheme/loops-filter`	`twtheme/loop` und `twtheme/filter`
`twtheme/post-content-toc`	`twtheme/post-toc` plus Core-Block Beitragsinhalt

Erweiterungen an Core-Blöcken¶

Neben eigenen Blöcken erweitert TWtheme Core-Blöcke um zusätzliche Optionen. Die erscheinen in der Blockseitenleiste, ohne dass ein neuer Block nötig wäre.

Core-Block	Erweiterung	Modul
Button	Icon mit Position, Farbe, Animation und eigener CSS-Klasse	`icons`
Liste	Listen-Icons mit Stil, Farbe, Größe und Höhenkorrektur	`icons`
Listenelement	Icon-Ausnahmen für einzelne Zeilen	`icons`, `highlight`
Akkordeon	Umschalt-Icon, erstes Element geöffnet, Druckoptionen, Felder als Datenquelle	`accordion`, `print`, `meta-blocks`
Abfrageschleife	Erweiterte Inhaltstyp- und Stichwortsteuerung, zusätzliche Paginierungsmodi	`loops-filter`
Breadcrumbs	Taxonomie-Tiefe, ausgeschlossene Taxonomien, manueller Pfad	`breadcrumb`
HTML, Abfrageschleife	Nachladen von Inhalten über Dynamic Content	Kern
Alle Blöcke	Sichtbarkeit je Viewport und Template-Kontext, Sticky-Verhalten	`block-visibility`
Gruppe, Spalten	Alte Raster- und Spaltenattribute, damit Inhalte aus der Zeit vor den Layout-Blöcken erhalten bleiben	`layout-blocks`

Blockstile¶

Zusätzliche Stile, die im Editor unter Stile auswählbar sind:

Block	Stil	Beschriftung
Button	`tw-text`	Text — transparenter Hintergrund, unterstrichen
Absatz, Überschrift, TW Inhaltstyp-Beschriftung	`tw-display`	Display
Absatz, Überschrift, TW Inhaltstyp-Beschriftung	`tw-lead`	Lead
Absatz, Überschrift, TW Inhaltstyp-Beschriftung	`tw-text-small`	Small
Abfrage-Paginierung	`twtheme-compact`	Compact

Der frühere Gruppen-Stil tw-responsive-grid ist entfernt; seine Aufgabe übernimmt der Block Responsives Raster.

Blockvorlagen¶

TWtheme registriert neun Vorlagen. Sie erscheinen im Editor unter Vorlagen.

Vorlage	Kategorie
Post card grid	Abfrage
Search results (Query Loop)	Abfrage
Query Loop with filter	TW Loops
Loop with filter	TW Loops
Loop: Default	TW Loops
Loop: Search	TW Loops
Loop: 404	TW Loops
News announcement landing page	TWtheme
Interview YouTube playlist	TWtheme

Die drei Loop:-Vorlagen entstehen aus den Dateien in template-parts/loops/. Legt man dort eine weitere loop-*.php ab, erscheint automatisch eine passende Vorlage.