WP-LIT-MCP/docs/guides/divi-attrs.md

Divi-Einstellungen (Vollform)

Jedes Divi-5-Modul speichert seine Einstellungen unter Attributpfaden, z. B.

• title.innerContent – Text der Überschrift,
• title.decoration.font.font – Schrift der Überschrift (Farbe, Größe, Ebene headingLevel),
• button.innerContent – Beschriftung und Link eines Buttons (text, linkUrl, linkTarget),
• module.decoration.background – Hintergrund, module.decoration.spacing – Innen-/Außenabstand,
• module.meta.adminLabel – Admin-Label im Divi-Builder.

Der Wert eines Pfads ist eine Zuordnung Breakpoint → Zustand → Wert:

{ "desktop": { "value": { "color": "#1a1a1a", "headingLevel": "h2" }, "hover": { "color": "#000000" } },
  "phone":   { "value": { "size": "28px" } } }

Breakpoints: desktop, tablet, phone (je nach Website auch tabletWide, phoneWide, widescreen, ultraWide); Zustände: value, hover, sticky.

Setzen

In attrs (bei lit-divi-insert je Knoten, bei lit-divi-update je Änderung) steht Pfad → Wert je Breakpoint. Kurz: {"desktop": "#1a1a1a", "phone": "…"} bzw. bei Objektwerten {"desktop": {"size": "28px"}}; Hover und Sticky: {"hover": {…}} bzw. {"desktop": {"value": {…}, "hover": {…}}}. Nur die genannten Breakpoints werden ersetzt, der Rest bleibt; null entfernt einen Pfad, Breakpoint oder Zustand:

{ "id": "s0.r0.c1.m0",
  "attrs": { "title.decoration.font.font": { "desktop": { "color": "{{color:heading}}" },
                                            "phone": { "size": "28px" } },
             "module.decoration.spacing": null } }

Ein Objektwert ersetzt den bisherigen Wert dieses Breakpoints ganz (Unterschlüssel werden nicht zusammengeführt): z. B. bei module.decoration.sizing einer Spalte flexType immer mitschicken (siehe divi-shortform).

Unbekannte Pfade → Fehler invalid_attr_path mit Vorschlägen unter fields. Texte werden bereinigt (HTML nur, wo Divi Rich-Text erwartet; Links ohne javascript:). $variable-Verweise werden geparst, geprüft und vom Plugin neu erzeugt (siehe divi-placeholders). Eigenes HTML, CSS, HTML-Attribute, Interaktionen und die Lottie-Quelle (…decoration.attributes, …decoration.interactions, …advanced.html, …css…, lottie.innerContent) nur mit dem Recht unfiltered_html, sonst „nur im Divi-Builder“ – Interaktionen können im Browser beliebige HTML-Attribute und Cookies setzen, die Lottie-Quelle lädt eine Animation von einer fremden Adresse, die Code ausführen kann. Dieselbe Grenze gilt beim Kopieren und Einfügen gespeicherter Knoten (siehe divi-library). Unberührte Teile der Seite bleiben byte-identisch; Ausnahme: Divi selbst normalisiert Seiten mit eigenen HTML-/Attribut-Feldern beim Speichern – nur wenn die Seite noch nicht in Divis eigener gespeicherter Form vorliegt (z. B. importierter oder direkt in die Datenbank geschriebener Inhalt); über den Divi-Builder oder LIT MCP gespeicherte Seiten betrifft das praktisch nie (Warnung in der Antwort, neue tree_rev gilt).

Pfade finden

• lit-divi-catalog ohne module listet alle Module dieser Website; mit module (z. B. "heading") alle gültigen Pfade dieses Moduls auf dieser Website (live aus Divi) und die Kurzform-Felder mit ihrem Pfad. path_kinds nennt die Feldart eines Pfads (text, richtext, code, url, image, color, enum, onoff, number, list, icon), soweit aus den Divi-Metadaten ableitbar. Bei einem zusammengesetzten Pfad (ein oder mehrere benannte Unterfelder unter einem Pfad, z. B. buttonOne.innerContent mit text und linkUrl) ist der Eintrag stattdessen eine Zuordnung Unterfeld → Feldart ({"text": "text", "linkUrl": "url"}), soweit für die einzelnen Unterfelder ableitbar; fehlende Pfade oder Unterfelder gelten als unbekannt, statt eine Feldart zu raten.
• Ergebnisform ohne module: {"modules": [{"name": "divi/heading", "title": "Heading", "category": "module", "children": [], "shortform": true}, …], "notes": […]}; mit module: {"module": {"name": "divi/heading", "title": …, "children": […], "item_type": null, "shortform": {"text": {"path": "title.innerContent", …}}, "paths": […], "path_kinds": {…}}, "notes": […]}.
• lit-divi-node-get zeigt die gesetzten Werte eines vorhandenen Knotens in genau dieser Form (attrs).
• Schrift-Gruppen liegen eine Ebene tiefer: …decoration.font.font, …decoration.bodyFont.body.font, …decoration.headingFont.h2.font, module.advanced.text.text.
• Werte wie $variable({…})$ sind Verweise auf globale Farben, Variablen oder dynamische Inhalte – nicht durch feste Werte ersetzen (siehe divi-design-system).