diff --git a/docs/guides/divi-placeholders.md b/docs/guides/divi-placeholders.md index b18ebb1..3564fd6 100644 --- a/docs/guides/divi-placeholders.md +++ b/docs/guides/divi-placeholders.md @@ -96,7 +96,20 @@ Regeln und Fehlermeldungen: unterstützten Schleife (ACF-Wiederholungsfeld oder leere Art) nennt die Meldung statt des Typs die rohe Abfrageart der Schleife; in solchen Schleifen ist jede `loop_*`-Option abgelehnt. 4. Die Feld-Optionen (`loop_*_meta_key_manual_custom_field`) gibt es nur in der Vollform; für den Schlüssel gelten - dieselben Regeln wie bei `{{field:}}` (kein Schlüssel mit `_` am Anfang). + dieselben Regeln wie bei `{{field:}}` (kein Schlüssel mit `_` am Anfang). Beide Einstellungen sind + nötig: `select_loop_meta_key` muss genau `loop__meta_key_manual_custom_field_value` sein (`` = `post`, + `term` oder `user`), dann liest Divi den Feldnamen aus `loop_meta_key`. Fehlt `select_loop_meta_key` oder hat es + einen anderen Wert, bleibt die Ausgabe in Beitrags- und Term-Schleifen leer. Beispiel für das Pods-Feld `telefon` + in einer Beitrags-Schleife: + + ```json + { "type": "text", "content": "$variable({\"type\":\"content\",\"value\":{\"name\":\"loop_post_meta_key_manual_custom_field\",\"settings\":{\"before\":\"\",\"after\":\"\",\"select_loop_meta_key\":\"loop_post_meta_key_manual_custom_field_value\",\"loop_meta_key\":\"telefon\"}}})$" } + ``` + + Divi liest das Feld als Post-Meta. Pods-Felder mit Speicherung „meta“ (Standard bei Beitragstypen) funktionieren, + Beziehungs- und Dateifelder zeigen nur IDs. Bei Pods mit Tabellen-Speicherung bleibt die Ausgabe immer leer; + `lit/divi-dynamic-sources` mit `post_type` meldet das als „Pods mit Tabellen-Speicherung – Divi liest nur + Post-Meta“. Bleibt ein Feld leer, zuerst das prüfen, dann das Format. 5. Vor dem Setzen lesen: `lit/divi-dynamic-sources` mit `post_type`, `post_id` und `node` (Pfad-ID des Moduls aus `lit-divi-outline`) nennt zusätzlich die `loop_*`-Optionen, die zur Schleife dieses Knotens passen; liegt der Knoten in keiner Schleife, kommt stattdessen der Hinweis „kein Schleifen-Kontext“. Ohne `post_id` und `node`