diff --git a/docs/guides/divi-placeholders.md b/docs/guides/divi-placeholders.md index 2c35368..11800a9 100644 --- a/docs/guides/divi-placeholders.md +++ b/docs/guides/divi-placeholders.md @@ -80,7 +80,11 @@ Regeln und Fehlermeldungen: 1. Der Schleifen-Kontext ergibt sich aus der Seite: das Modul selbst oder das nächste Element über ihm, dessen Schleife eingeschaltet ist (Desktop-Einstellung „Schleife ein“). Bei verschachtelten Schleifen gilt die innerste - für alles darunter, egal welcher Art. + für alle Optionen außer den Feld-Optionen (`loop_*_meta_key_manual_custom_field`): Die müssen zur Art **jeder** + eingeschalteten Schleife in der Kette passen, denn eine leere innere Schleife übergibt den Inhalt an die äußere, + und die liest das Feld beim Objekt mit der ID ihres eigenen Eintrags. Ein Beitrags-Feld in einer Beitrags-Schleife + innerhalb einer Term-Schleife ist deshalb abgelehnt. Die Abfrageart liest das Werkzeug wie Divi (Kleinschreibung, + nur `a-z 0-9 _ -`; `terms` zählt als Terme, `users` als Benutzer). 2. Ohne Schleife lehnt das Werkzeug jeden `loop_*`-Inhalt ab: `Schleifen-Inhalt "loop_post_date" braucht eine Divi-Schleife in diesem Modul oder einem übergeordneten Element (Abschnitt, Zeile, Spalte, Gruppe).` Dann das Modul in das Schleifen-Element setzen (`parent` = die Spalte bzw. das Element mit der Schleife) oder den @@ -89,7 +93,7 @@ Regeln und Fehlermeldungen: (Typ: Terme).` (Typ: Beiträge, Terme, Benutzer oder Menü). Eine Option der passenden Art wählen. Das ist eine Sicherheitsgrenze, kein Schönheitsfehler: Divi liest die Feld-Optionen in einer Term-, Benutzer- oder Menü-Schleife sonst bei dem Objekt mit derselben ID und gäbe fremde Daten aus. Nie umgehen. Bei einer nicht - unterstützten Schleife (ACF-Wiederholungsfeld, Alias oder leere Art) nennt die Meldung statt des Typs die rohe + 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). @@ -98,10 +102,10 @@ Regeln und Fehlermeldungen: Knoten in keiner Schleife, kommt stattdessen der Hinweis „kein Schleifen-Kontext“. Ohne `post_id` und `node` liefert das Werkzeug wie bisher keine Schleifen-Optionen. 6. `lit-divi-move` erlaubt das Verschieben von Schleifen-Inhalt aus der Schleife heraus oder in eine Schleife - anderer Art (Divi lässt es zu), antwortet aber mit einer Warnung: der Inhalt zeigt dort nichts oder falsche - Daten. Warnung dem Nutzer nennen, Modul zurückschieben oder den Inhalt neu setzen. -7. `lit-divi-update` warnt ebenso, wenn ein Update die Art der Schleife eines Elements ändert oder die Schleife - ausschaltet (Art wird „keine“) und darunter unveränderte Schleifen-Inhalte stehen. + anderer Art oder unter eine äußere Schleife anderer Art (Divi lässt es zu), antwortet aber mit einer Warnung: der + Inhalt zeigt dort nichts oder falsche Daten (bei einer nicht unterstützten Schleife: Daten eines anderen Objekts). Warnung dem Nutzer nennen, Modul zurückschieben oder den Inhalt neu setzen. +7. `lit-divi-update` warnt ebenso, wenn ein Update die Art der Schleife eines Elements oder einer äußeren Schleife + ändert oder die Schleife ausschaltet (Art wird „keine“) und darunter unveränderte Schleifen-Inhalte stehen. 8. `lit-divi-insert` lehnt einen Aufruf ab, in dem irgendwo ein neues Element mit eigener Schleife und irgendwo Schleifen-Inhalt vorkommt (die Schleife gilt erst nach dem Speichern): erst das Element mit Schleife einfügen, dann die Inhalte mit `parent` = dieses Element in einem zweiten Aufruf.