Theme Reference

Sections

• Admin Panel — Gutenberg, admin bar, dashboard
• Security — XML-RPC, REST API, version hiding
• Extensions — Forms, SMTP, Telegram, reCAPTCHA
• WooCommerce — WooCommerce settings
• Theme Settings — Field backend, migration tools
• Search — Search configuration

Aus einem PHP-Template (Query Presets)

Erstelle ein Preset im Unter-Tab Post/Term Query Presets, gib ihm einen Query Code und ruf es im Template-Code auf:

• Posts: $q = new WP_Query(tf_get_query('your-code'));
• Terms: $terms = tf_get_term_query('your-code');
• Auto-apply: Binde ein Preset im Tab „Auto-apply“ an ein Beitragstyp- oder Taxonomie-Archiv, und es überschreibt die Hauptabfrage automatisch (über pre_get_posts) — ohne Template-Änderung.

Über HTML-Attribute (Custom Queries)

Benenne eine Abfrage im Unter-Tab Custom Queries / Term Queries und verweise dann auf dem Schleifen-Element darauf — oder schreib die Argumente direkt hinein. Nur das erste Kindelement dient als Wiederholungsvorlage.

• Benannt: <div wp-select="catalog"> … </div> (Alias: wp-query-name)
• Inline: <div wp-query="'post_type'=>'product','posts_per_page'=>8">
• Begriffsliste: <div wp-term-query="'taxonomy'=>'product_cat','parent'=>0"> · wp-term-select="name"
• WooCommerce: <div wp-product-query="get_related_products(4)">

In der Schleife — Felder

Auf Elementen innerhalb der Schleife gibst du Werte mit WordPress-Attributen oder ACF/SCF-Feld-Attributen aus:

• WordPress: wp="post-title", wp="post-image", wp="post-link", wp="term-title", wp="term-link"
• ACF / SCF: fld-text, fld-image, fld-link, fld-loop (Alternatives Format: f_text, f_image, f_loop)

Kompatibilität

Die Runtime liest drei Quellen in Prioritätsreihenfolge: TF-Presets, dann Query Master (ältere importierte Websites), dann die Abfragen des veralteten Konfigurators. Neue Presets werden immer im TF-Speicher gespeichert; vorhandene Daten funktionieren weiterhin.

Eigene Beitragstypen

Jede Zeile entspricht register_post_type(). Das Feld „Name“ ist der Beitragstyp-Schlüssel (Kleinbuchstaben Latein, keine Leerzeichen). Leg Plural-/Singular-/Menü-Bezeichnungen, ein Dashicons-Symbol, die unterstützten Funktionen (Titel, Editor, Beitragsbild, …), den Archiv-URL-Slug, REST/Gutenberg, die öffentliche Abfragbarkeit, einen „Öffentliches Archiv“-Schalter (Feed /slug/ für Service-Typen abschaltbar) fest — und optional eine „Archiv-Landingpage“, die das Archiv bearbeitbar macht (siehe Abschnitt „Archiv-Landingpages“ unten).

Eigene Taxonomien

Jede Zeile entspricht register_taxonomy(). Wähl hierarchisch (wie Kategorien) oder flach (wie Schlagwörter), verknüpfe sie mit einem oder mehreren Beitragstypen und leg Slug und REST-Sichtbarkeit fest.

Wie sie zusammenhängen

Neue Beitragstypen und Taxonomien erscheinen automatisch in den Dropdowns der Query-Presets. Permalinks werden beim Speichern aktualisiert. Templates folgen den WordPress-Konventionen: single-{type}.php, archive-{type}.php, taxonomy-{taxonomy}.php.

So funktioniert es

Platziere auf der Archivseite deines Webflow-Projekts (archive-post, archive-product, archive-{type}) Feld-Attribute AUSSERHALB der Listenschleife — also außerhalb des Elements mit wp="posts" / wp="products". Diese Felder werden in der Verwaltung automatisch an die Landingpage angehängt und auf der Archiv-URL von ihr gerendert.

• Außerhalb der Schleife funktioniert jedes Einzelwert-Feld: fld-text, fld-image, fld-link, fld-bg-image, fld-editor und der Rest der fld-*-Familie — plus wp="post-title" und wp="post-content", die Titel und Inhalt der Landingpage selbst ausgeben.
• Felder INNERHALB der Schleife behalten ihre gewohnte Bedeutung: Sie lesen jeden gelisteten Beitrag, genau wie zuvor.
• Mehrsprachige Websites lösen die Landingpage pro Sprache automatisch auf (Polylang / WPML): Jede Sprache bearbeitet ihre eigene Übersetzung der Landingpage.
• SEO: Bei Archiven eigener Beitragstypen speist die Landingpage auch Yoast — das Archiv erhält ihren SEO-Titel und eine korrekte Canonical-URL, auch auf paginierten Seiten.

Blog

Die Blog-Landingpage ist die native WordPress-„Beitragsseite“. Erstelle eine Seite (z. B. /blog/), weise sie unter Einstellungen → Lesen zu, und die außerhalb der Schleife auf dem archive-post-Template platzierten Felder hängen sich an diese Seite — keine weitere Einrichtung nötig.

WooCommerce-Katalog

Der Shop-Katalog nutzt die WooCommerce-Shop-Seite als Landingpage. Felder außerhalb der Produktschleife auf dem archive-product-Template hängen sich an die Shop-Seite und werden auf der Katalog-URL gerendert.

Eigene Beitragstypen

Ein Archiv eines eigenen Beitragstyps hat in WordPress keine native Landingpage, also fügt ThemeForge eine hinzu: Erstelle eine Seite, deren URL dem Archiv-Slug entspricht (z. B. /portfolio/ für einen Typ mit Archiv-Slug „portfolio“), und wähl sie in der Zeile dieses Beitragstyps im Theme Panel aus. Die Archiv-URL rendert weiterhin das Feed-Template, die gewählte Seite trägt seine bearbeitbaren Felder. Deklariert das Archiv-Template deines Webflow-Projekts eine Feldgruppe, erstellt (oder übernimmt) ThemeForge die Landingpage automatisch — in jeder Sprache der Website, so wie WooCommerce seine Shop-Seite anlegt.

Die gebundene Seite BESITZT die Archiv-URL: Benenne die Seite um, und das Archiv zieht mit (das Slug-Feld ist ausgeblendet, solange eine Seite gebunden ist). Ohne gebundene Seite kommt der Slug aus dem Theme Panel. Die Seite selbst wird nie direkt angezeigt — sie ist die Bearbeitungsfläche hinter dem Archiv.

Gut zu wissen

• Gruppenfelder außerhalb der Schleife (Repeater, Gruppe, Flexible Content, Galerie) werden genau wie Einzelwert-Felder von der Landingpage gelesen. Die einzige Ausnahme ist eine Gruppe mit loop-mode="0" — der Logs-Tab des Projekts markiert sie als „archive-scope-unsupported".
• Ein Feld INNERHALB einer Listenschleife gehört den gelisteten Beiträgen — deklariere es auf dem entsprechenden single-{type}-Template, damit es auf deren Bearbeitungsseiten erscheint.
• Ist keine Landingpage konfiguriert, geht nichts kaputt: Das Archiv rendert exakt wie zuvor. Die Landingpage lässt sich jederzeit ohne Neugenerierung des Themes hinzufügen.

Features

• SMTP email sending
• reCAPTCHA v3 / v2
• Telegram notifications
• Spamschutz ohne Schlüssel — auf neuen Websites aktiv
• Auto-reply
• JustValidate client-side validation
• CPT tf_form_entry — submission storage
• CSV export

Spamschutz

Funktioniert ohne Schlüssel und externe Dienste. Auf einer neuen Website ist er von Anfang an aktiv; auf einer Website, die bereits Anfragen erhält, schaltest du ihn mit „Grundlegender Spamschutz“ unter Formulare → Einstellungen ein.

• Sortiert Einsendungen aus, die ein verstecktes Fallenfeld ausfüllen, ohne das Seitenskript eintreffen, schneller gesendet werden, als ein Mensch tippen kann, mehrere Links enthalten oder das Bild-Captcha umgehen. Wie oft eine Adresse senden kann, ist begrenzt.
• Aussortierte Einsendungen werden nirgendwohin gesendet: Sie liegen 30 Tage im Spam-Ordner unter Einträge, und eine irrtümlich aussortierte lässt sich mit „Kein Spam“ zurückholen.
• Die eigenen Formulare von WordPress schützt ein separater Schalter „Spamschutz für WordPress-Formulare“, standardmäßig aktiv: Kommentare und Produktbewertungen, Registrierung und Passwort-Zurücksetzung. Ein Kommentar, den ein Bot sendet, ohne die Seite zu öffnen, wird abgelehnt und nirgends gespeichert; ein Grenzfall landet unter Kommentare → Spam; eine verdächtige Registrierung oder Zurücksetzungsanfrage wird mit der Bitte um einen neuen Versuch abgelehnt. Das Anmeldeformular und angemeldete Benutzer werden nicht geprüft.
• Das Bild-Captcha spricht die Sprache der Seite: Die Texte werden pro Sprache festgelegt, und es zeichnet nur Zeichen, die ein Besucher ohne Umschalten des Tastaturlayouts tippen kann (ukrainische, russische, lateinische Buchstaben oder Ziffern).

Gegen Bots, die gezielt einen Menschen nachahmen, hilft reCAPTCHA mit Google-Schlüsseln — sie wird in denselben Einstellungen aktiviert.

wp-field — ein Feldschlüssel, der Umbenennungen übersteht

Standardmäßig wird ein Formularfeld unter der in Webflow eingegebenen Beschriftung übertragen. Wird diese später umbenannt, passen E-Mail-Vorlage und Weiterleitungszuordnung nicht mehr — und zwar stillschweigend, denn die Anfrage kommt weiterhin an. Markiere das Feld (oder seinen Container mit der Beschriftung), und der Schlüssel hängt nicht mehr von der Beschriftung ab.

<input type="tel" wp-field="phone">

<div class="row" wp-field="phone">
  <label for="tel">Telefon</label>
  <input type="tel" id="tel">
</div>

Der Schlüssel wird beim Generieren des Themes in das Feld geschrieben; danach ist keine Konfiguration nötig. Verwende lateinische Buchstaben, Ziffern, _ und -; vom Formular-System belegte Namen werden abgelehnt und im Projektprotokoll aufgeführt. Felder, deren Name von WordPress oder WooCommerce vorgegeben ist — Kommentare, Bewertungen, Kasse — verwenden ihre eigenen Markierungen.

Zwei Engines, ein Datenformat

Standard ist Secure Custom Fields — ein kostenloses WordPress.org-Plugin, das sich selbst aktualisiert und alle ACF-PRO-Feldtypen ohne Lizenz bietet. Du bevorzugst dein eigenes lizenziertes ACF PRO? Installiere es, das Theme erkennt es automatisch.

Funktionsweise

Das Theme erkennt Polylang oder WPML automatisch und lädt die entsprechende Integration.

• Automatische Erkennung: Polylang (pll_current_language) oder WPML (ICL_SITEPRESS_VERSION)
• Sprachspezifische Speicherung: jede Sprache erhält eigene Optionswerte
• Fallback: leere Sprachfelder erben Werte von „Alle (Standard)"
• Benutzerdefinierte Flaggen: eigene Sprachflaggen aus der Mediathek hochladen

Optionen nach Sprache verwalten

Verwende die Sprachumschaltung auf der Optionsseite, um Werte für jede Sprache zu bearbeiten.

Felder automatisch übersetzen

Integrierte maschinelle Übersetzung von Feldwerten. Verfügbar in der Seitenleiste auf Bearbeitungs- und Optionsseiten.

• „Übersetzen"-Button neben jedem Textfeld
• „Alle übersetzen" in der Seitenleiste — übersetzt alle Felder auf einmal, auch versteckte Tabs und Repeater
• Link-Felder werden automatisch übersprungen (Erkennung nach Feldname und URL-Muster)
• Kein API-Schlüssel erforderlich — nutzt den kostenlosen Google Translate Endpunkt
• WYSIWYG-Felder (Rich Text) unterstützt — HTML-Struktur bleibt erhalten

• user-functions.php — Custom PHP functions
• css/user.css — Custom CSS styles
• js/user.js — Custom JavaScript

CSS-Ladereihenfolge: main.css → themeforge.css → user.css.

Import Actions

Quelle des Seitentitels

Beim Erstellen von WordPress-Seiten während des Imports wird der Seitentitel aus dem Quell-HTML in folgender Priorität übernommen:

1. <meta property="og:title"> — Open Graph
2. <title> — HTML title tag
3. Template-Name (z.B. „About" aus page-about)

Image Filename Resolution

The import system resolves image filenames using a fallback chain:

• URL-decode filename
• Strip Webflow hash prefix
• sanitize_file_name() + DB LIKE query

Sprachbezogener Import

Füg &lang=xx hinzu, um Daten für eine bestimmte Sprache zu importieren. Die Import-Metabox auf der Bearbeitungsseite erkennt die Seitensprache automatisch.

Usage

• Wraps fields into a named group
• Multiple wp-fields-group groups per page supported
• On theme-options: all groups merge into one container
• Without wp-fields-group: fields generate PHP only

Verwendung

• Auf dem <body>-Tag platzieren — standardmäßig ist der Editor auf Seitenvorlagen mit Feldern ausgeblendet
• Zusammen mit wp-fields-group verwenden, wenn die Seite sowohl benutzerdefinierte Felder als auch the_content() benötigt
• Gilt nicht für Einzelbeitragsvorlagen (single, single-product) — der Editor bleibt dort immer sichtbar

wp-menu

Simple menu rendering with Webflow-compatible markup.

wp-menu-tree

Recursive menu with custom template.

wp-menu-tpl

Explicit template markers inside wp-menu-tree.

Dieselben Felder, dieselben Daten

Ein Engine-Wechsel migriert oder überschreibt deine Inhalte nie — beide Engines lesen dieselben Feldschlüssel aus wp_postmeta / wp_options. Vorhandene ACF-Daten aus einem anderen Theme oder einer manuellen Einrichtung werden anhand des Feldnamens übernommen, unabhängig davon, welche Engine sie erstellt hat.

Vorhandene & Drittanbieter-ACF-Daten

Wenn bereits ACF- (oder SCF-)Daten vorhanden sind — von einem anderen Generator, einem früheren Theme oder einer manuellen Feldgruppe — liest das Theme sie unverändert anhand des Feldnamens. Nichts zu importieren oder zu konvertieren; die Werte erscheinen im Editor unter der jeweils aktiven Engine.

Allgemeine Hooks

WooCommerce-Hooks

Definiere diese Funktionen in custom.js. Ältere Namen mit wfp_-Präfix werden aus Kompatibilitätsgründen ebenfalls unterstützt.

Beitragsabfrage

Einrichtung in Theme-Panel → Custom Queries. Jede Abfrage enthält: Name, Beitragstyp, Beiträge pro Seite, Paginierung, Taxonomie-Filter.

Term-Abfrage

Einrichtung in Theme-Panel → Custom Term Queries. Jede Abfrage enthält: Name, Taxonomie, hide_empty, orderby, order.

Allgemein

WooCommerce