Spintax

Content-Generierung für WordPress — Spintax-Auszeichnung, gebunden an ACF-Felder, Post-Meta und WooCommerce-Produktbeschreibungen.

Verfügbar in: WordPress.org GitHub
Projektseite →

Spintax ist ein Werkzeugkasten zur Content-Generierung für WordPress: Aus einer Vorlage wird einzigartiger, nicht duplizierter Text auf der ganzen Website. Schreiben Sie wiederverwendbare Vorlagen in Spintax-Auszeichnung und binden Sie sie über Shortcodes und PHP ein — oder an ACF-Felder, Post-Meta und WooCommerce-Produktfelder, damit jeder passende Beitrag beim Speichern, nach Zeitplan oder auf Abruf seine eigene gerenderte Variante bekommt.

Auszeichnung

  • Aufzählungen{a|b|c} wählt zufällig eine Option, auch verschachtelt
  • Permutationen[<config>a|b|c] nimmt N Elemente, mischt sie und fügt sie mit eigenen Trennzeichen zusammen
  • Variablen%var% global, im Shortcode und lokal: #set wählt bei jeder Verwendung neu, #def einmal pro Rendering
  • Bedingungen{?VAR?then|else} verzweigt nach dem Wert einer Variablen, {?!VAR?then} kehrt die Prüfung um
  • Pluralkongruenz{plural N: one|few|many} wählt die grammatisch richtige Form nach Anzahl (RU/UK/BE und SR/HR/BS dreiformig, englischer Typ zweiformig)
  • Verschachtelte Vorlagen — eine Vorlage in einer anderen über #include oder [spintax]
  • Blockkommentare/#…#/ erscheint nie in der Ausgabe

Bindungen an ACF und Post-Meta

Eine Bindung verknüpft eine Vorlage mit genau einem Zielfeld eines Beitragstyps — etwa „Beiträge → ACF: hero_subtitle“ — und das Plugin füllt dieses Feld bei jedem passenden Beitrag. Manuelle Änderungen bleiben standardmäßig erhalten und werden per Hash verfolgt; Schalter entscheiden, ob eine Bindung nur leere Felder befüllt, bei jedem Speichern neu erzeugt oder das Feld leert, wenn die Vorlage nichts liefert.

  • Bulk Apply — asynchrone Läufe in Portionen über Action Scheduler, mit synchronem „Run now“ und WP-CLI als Rückfallweg, wenn der Scheduler fehlt
  • Protokolle — pro Lauf festgehalten, was geschrieben, übersprungen oder geleert wurde
  • WP-CLIwp spintax bindings list|apply|test|export|import für den Weg von Staging nach Produktion
  • Migration — ein einmaliger Assistent für Umsteiger von nested-spintax-for-acf

WooCommerce

Auf einer einzelnen Produktseite erkennt das Plugin das aktuelle Produkt und stellt es der Vorlage als %product_name%, %product_sku%, %product_type%, %product_categories%, %product_tags% und je ein %product_attribute_<slug>% pro Attribut zur Verfügung — dieselbe Vorlage auf zwei Produkten ergibt also zwei getrennt zwischengespeicherte Varianten. Preise bleiben bewusst außen vor: Sie sind flüchtige Handelsdaten, und in der Vorlage würden sie den Render-Cache bei jeder Preisänderung entwerten.

Eine Produktfeld-Bindung geht weiter und schreibt den erzeugten Text in die Beschreibung oder Kurzbeschreibung des Produkts — mit derselben Mechanik wie ACF-Bindungen: Zeitplan, Bulk Apply, WP-CLI, Protokolle. Drei Grenzen sind Absicht: nur diese beiden Felder sind beschreibbar, manuelle Änderungen gewinnen standardmäßig, und jeder Schreibvorgang läuft über WooCommerce selbst, damit dessen Caches, Nachschlagetabellen und Speicher-Hooks stimmig bleiben. WooCommerce ist durchweg optional: ohne sie erscheinen die Variablen einfach nicht, und Produktbindungen schreiben nicht mehr.

Cache und Datenschutz

Die gerenderte Ausgabe wird über die WP Object Cache API zwischengespeichert (bereit für Redis / Memcached), auf Wunsch mit geplanter Neuerzeugung je Vorlage. Alles läuft auf Ihrem eigenen Server — keine externen Dienste, kein Tracking, keine Daten, die die Website verlassen.

Eine Syntax, fünf Maschinen

Die Syntax ist ein offener, dokumentierter Standard. Ihr Kern ist GTW-kompatibel — Aufzählungen, Permutationen, Variablen, Includes — und wurde über die Jahre um eigene Primitive erweitert: wertgetriebene Bedingungen, Pluralkongruenz, einmalig gezogene #def-Variablen. Fünf unabhängige Maschinen setzen sie gegen ein gemeinsames Testkorpus um, die vollständige Referenz steht auf spintax.net. Zum Schreiben außerhalb der WordPress-Verwaltung gibt es Spintax Studio, einen kostenlosen nativen Windows-Editor mit zweigeteilter Live-Vorschau und eingebauter Prüfung.