Terms-Query-Block

Der Block „Begriffsabfrage“ zeigt eine Liste oder ein Raster mit Begriffen aus einer Taxonomie an (z. B. Kategorien, Schlagwörter oder benutzerdefinierte Taxonomien). Er ist besonders nützlich in Vorlagen (z. B. einem „Kategorien“-Index oder einer Verzeichnisseite), auf denen Sie Begriffe auflisten und das Erscheinungsbild jedes Begriffs gestalten möchten.

Anforderungen

• WordPress 6.9 oder höher.
• Ein Block-Theme zum Bearbeiten von Vorlagen im Website-Editor.
• Die anzuzeigende Taxonomie muss öffentlich und im Editor verfügbar sein (show_in_rest aktiviert).

Aufbau des Blocks „Begriffsabfrage“

Der Blockinspektor bietet einen schnellen Überblick über die Struktur des Begriffsabfrage-Blocks. Jeder Teil ermöglicht den Zugriff auf unterschiedliche Einstellungen:

• Begriffsabfrage: Abfrageparameter konfigurieren.
• Begriffsvorlage: Auswählen, wie der Inhalt angezeigt wird – als Liste oder Raster.
• Begriffsname: Den Namen des Begriffs anzeigen.
• Begriffsbeschreibung: Die Beschreibung des Begriffs anzeigen.
• Begriffsanzahl: Die Anzahl der Ergebnisse für jeden Begriff anzeigen.

Den Block „Begriffsabfrage“ zu einer Vorlage hinzufügen

1. Gehen Sie zu „Design“ > „Editor“.
2. Öffnen Sie die Vorlage, in der die Begriffe erscheinen sollen (z. B. eine benutzerdefinierte Vorlage „Kategorien“).
3. Platzieren Sie den Cursor an der gewünschten Stelle.
4. Öffnen Sie die Block-Inserter-Schaltfläche (+), suchen Sie nach „Begriffsabfrage“ und wählen Sie sie aus.

Blockkonfiguration

Nach dem Hinzufügen des Begriffsabfrage-Blocks werden zwei Optionen angezeigt:

Diese Varianten bieten zwei unterschiedliche Layoutoptionen:

• Name: Zeigt nur den Namen des Begriffs an.
• Name & Anzahl: Zeigt den Namen und die Anzahl der Elemente in diesem Begriff an.

Das Erscheinungsbild anpassen

Es gibt zahlreiche Möglichkeiten, den Begriffsabfrage-Block anzupassen, unter anderem weil er aus verschachtelten Blöcken besteht, die Sie neu anordnen, hinzufügen und mehr können. Wenn Sie einen Block im Begriffsabfrage-Block anpassen, werden die Änderungen auf alle Blöcke desselben Typs angewendet. Beim Anpassen dieses Blocks kann es hilfreich sein, die Listenansicht in der oberen Werkzeugleiste zu verwenden. Hier sind einige Ideen für den Einstieg:

• Sie können die Breite verschiedener Aspekte des Begriffsabfrage-Blocks ändern.
• Sie können die Ausrichtung von Blöcken innerhalb des Begriffsabfrage-Blocks ändern.
• Sie können die Blöcke nach Ihren Vorstellungen neu anordnen, indem Sie sie per Drag-and-drop verschieben oder die Verschiebe-Steuerelemente verwenden.
• Sie können die Anzahl der aufgelisteten Begriffe ändern, indem Sie den Begriffsabfrage-Block auswählen und die Option „Maximale Anzahl der Begriffe“ in den Blockeinstellungen anpassen.
• Sie können für die verschachtelten Blöcke verschiedene Farboptionen festlegen.
• Sie können ändern, wie die Anzahl der Begriffe angezeigt wird, indem Sie den Block Begriffsanzahl auswählen und das Format in der Block-Werkzeugleiste ändern.
• Sie können die Beschreibung des Begriffs anzeigen, indem Sie den Block Begriffsbeschreibung auswählen und die Stile nach Bedarf anpassen.

Block-Werkzeugleiste

Um die Block-Werkzeugleiste anzuzeigen, klicken Sie auf den Block. Die Werkzeugleiste wird daraufhin eingeblendet. Jeder Block verfügt über eigene Symbole in der Werkzeugleiste und blockspezifische Bedienelemente, mit denen Sie den Block direkt im Editor bearbeiten können. Der Begriffsabfrage-Block bietet folgende Optionen:

• Umwandeln in.
• Ausrichtung: keine, breite Breite, volle Breite.
• Verschieben/ziehen, um die Position in der Vorlage zu ändern.
• Weitere Optionen (duplizieren, sperren, entfernen usw.).

Umwandeln in

Klicken Sie auf die Schaltfläche „Umwandeln“, um den Abfrageschleife-Block in einen „Gruppen“- oder „Spalten“-Block umzuwandeln.  

Ziehen-Symbol

Um den Block per Drag-and-drop an eine neue Position zu verschieben, klicken und halten Sie das Rechteck aus Punkten und ziehen Sie es anschließend an die neue Position. Die blaue Trennlinie zeigt an, wo der Block platziert wird. Lassen Sie die linke Maustaste los, sobald Sie die gewünschte Position gefunden haben.

Pfeile zum Verschieben

Mit den Pfeilsymbolen nach oben und unten können Sie den Block auf der Seite nach oben oder unten verschieben.

Detaillierte Anweisungen zum Verschieben eines Blocks innerhalb des Editors finden Sie hier

Ausrichtung

Verwenden Sie das Werkzeug zum Ändern der Ausrichtung, um den Begriffsschleifen-Block auszurichten. Wählen Sie eine der folgenden Optionen:

• Keine – Belässt den Block in seiner aktuellen Größe.
• Breite Breite – Vergrößert die Breite des Blocks über die Inhaltsbreite hinaus.
• Volle Breite – Dehnt den Block über die gesamte Bildschirmbreite aus.

Die Ausrichtungseinstellungen „Breite Breite“ und „Volle Breite“ müssen von Ihrem WordPress-Theme aktiviert werden. 

Listenansicht (Standard)

Zeigt Ihre Begriffe als gestapelte Liste an. Wählen Sie zum Bearbeiten den Block „Begriffsvorlage“ aus.

Rasteransicht

Zeigt Ihre Begriffe in einer Rasteransicht an. Wählen Sie zum Bearbeiten den Block „Begriffsvorlage“ aus.

Optionen

Die Schaltfläche „Optionen“ in der Block-Werkzeugleiste bietet weitere Funktionen zum Anpassen des Blocks. 

Lesen Sie mehr über diese und weitere Einstellungen.

Blockeinstellungen

Innere Blöcke verwenden die Inhaltsbreite

Mit dieser Option können Sie die Einstellungen für Ausrichtung, Inhalt und breite Breite für alle verschachtelten Blöcke innerhalb des Abfrageschleife-Blocks konfigurieren.

Sortieren nach

• Name: A > Z
• Name: Z > A
• Anzahl: absteigend
• Anzahl: aufsteigend

Ausgewählte Begriffe

Mit dieser Option können Sie bestimmte Taxonomien auswählen, die angezeigt werden sollen. Suchen Sie einfach nach den gewünschten Begriffen und wählen Sie sie zum Hinzufügen aus.

Leere Begriffe anzeigen

Mit dieser Option können Sie Begriffe anzeigen, auch wenn sie leer sind. Diese Option ist standardmäßig deaktiviert.

Verschachtelte Begriffe anzeigen

Mit dieser Option können Sie verschachtelte Begriffe anzeigen. Diese Option ist standardmäßig deaktiviert.

Maximale Anzahl der Begriffe

Mit dieser Option können Sie die Anzahl der anzuzeigenden Begriffe begrenzen. Um alle Begriffe anzuzeigen, verwenden Sie 0 (null).

Erweiterte Einstellungen

Im Tab „Erweitert“ können Sie Ihrem Block eine CSS-Klasse hinzufügen, um benutzerdefiniertes CSS zu schreiben und den Block nach Ihren Vorstellungen zu gestalten. Außerdem können Sie ein HTML-Element zuweisen.

Demo

Tipps

• Verwenden Sie „Liste“ für hierarchische Taxonomien und „Raster“, um viele Begriffe schnell zu überblicken.
• Halten Sie den Begriffsnamen prominent und fügen Sie auf Landingpages eine Begriffsbeschreibung als Kontext hinzu.
• Verwenden Sie „Leere ausblenden“, um leere Archive zu vermeiden und die Liste relevant zu halten.
• Speichern Sie einen konfigurierten Abschnitt mit einer Begriffsabfrage als Muster, um ihn in mehreren Vorlagen wiederzuverwenden.

Häufig gestellte Fragen

Kann ich nur Begriffe der obersten Ebene anzeigen?

• Ja. Lassen Sie „Übergeordnet“ leer und deaktivieren Sie „Unterbegriffe einschließen“.

Kann ich eine benutzerdefinierte Taxonomie anzeigen?

• Ja, sofern sie öffentlich ist und für die Anzeige im Editor registriert wurde (show_in_rest true).

Kann ich den Begriffsnamen mit seinem Archiv verknüpfen?

• Der Begriffsname wird normalerweise standardmäßig mit dem Begriffsarchiv verknüpft. Zusätzliche Verknüpfungen (z. B. die Begriffsanzahl) können Sie in den Blockeinstellungen steuern.