Files
WP-LIT-MCP/docs/guides/workflows.md
T
janniclas.loosenandClaude Opus 5.5 251934ce53 feat: deferred 1a items - menu_rev lock, lit_mcp_guides filter, warnings, schedule guard precision
Task 14 (rulings P17/P18, Q10):
- lit/menu-get returns menu_rev (Rev::ofMenu over id, parent, position,
  title, url, object, object_id); lit/menu-set-items requires it, refuses
  a stale one with rev_mismatch (hint: lit/menu-get) and returns the new
  menu_rev. Errors::revMismatch takes an optional message/hint.
- GuideRepository: filter lit_mcp_guides adds/overrides topics; invalid
  topic names and non-string content are ignored, files stay the default.
- lit/post-trash names front page, posts page and linking menus in the
  confirmation and as warnings; lit/menu-assign-location needs confirm
  to remove an assigned menu and names it; lit/post-schedule warns that
  a private entry becomes public; Divi hints no longer point to
  non-existing lit-divi-* tools.
- PostGuard::missedSchedule: 60 s publish window, zero GMT date falls
  back to get_gmt_from_date(post_date); post-schedule refuses dates
  within that window.
- write_failed after a clean rollback that keeps a revision/backup says
  "Die Aenderung wurde nicht gespeichert (... bleibt erhalten)" via the
  new state parameter (Errors::writeFailed / WriteFailed rolledBackState).
- wp-basis-smoke: menu_rev flow, unassign confirm, trash/menu and
  private-schedule warnings.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7
2026-09-26 04:33:15 +02:00

2.8 KiB
Raw Blame History

Abläufe

Neue Website aufsetzen

  1. lit-site-status und lit-content-types lesen.
  2. Grundeinstellungen: lit/wp-settings-get, dann lit/wp-settings-update (Titel, Untertitel, Sprache, Zeitzone, Datumsformat, Permalinks /%postname%/). previous in der Antwort enthält die alten Werte.
  3. Seiten als Entwürfe anlegen (lit-content-create), Hierarchie über parent.
  4. Startseite: Seite veröffentlichen (nach Rückfrage), dann {"settings": {"page_on_front": <ID>, "show_on_front": "page"}}.
  5. Menü: lit/menu-create (optional mit location aus lit/menu-list), Einträge mit lit/menu-set-items.
  6. Veröffentlichen erst, wenn der Nutzer es ausdrücklich möchte.

Menüs pflegen

  • lit/menu-get liefert den Baum und menu_rev (Stand des Menüs). lit/menu-set-items verlangt diese menu_rev; hat sich das Menü inzwischen geändert, kommt rev_mismatch – dann mit lit/menu-get neu lesen. Die Antwort enthält die neue menu_rev für weitere Änderungen.
  • Für größere Umbauten den Baum verändern und vollständig als items an lit/menu-set-items senden (bestehende Einträge mit id, neue ohne id). Wird der Baum unverändert zurückgeschickt, meldet das Tool „keine Änderung“ und schreibt nichts.
  • Für kleine Änderungen operations: {op: "add", item, parent_id?, position?}, {op: "move", id, parent_id?, position?}, {op: "remove", id} (Kinder eines entfernten Eintrags rücken an seine Stelle).
  • Neue Einträge ohne id: type post/taxonomy mit object_id, oder custom mit url (/pfad, #anker, http(s), mailto, tel) und title; jeweils optional children. Das Ziel eines bestehenden Eintrags lässt sich nicht ändern – dafür entfernen und neu anlegen.
  • Verlinkt werden nur für den Nutzer lesbare, veröffentlichte Inhalte und Begriffe öffentlicher Taxonomien. Private Inhalte sind immer ausgeschlossen. Entwürfe, ausstehende oder geplante Inhalte lassen sich nur mit allow_unpublished: true verlinken – WordPress zeigt den Menüpunkt sofort an, Besucher bekommen bis zur Veröffentlichung einen toten Link (die Antwort enthält dazu eine Warnung).
  • Fallen dabei Einträge weg, verlangt das Tool confirm: true; previous_items (Stand vorher) erlaubt das Zurückbauen – neu angelegte Einträge erhalten dabei eine neue id, CSS-Klassen, Linkziel und Beschreibung gehen verloren.
  • lit/menu-assign-location mit menu_id: 0 entfernt ein Menü von seiner Position (es verschwindet dann von der Website) und braucht dafür confirm: true nach Rückfrage; die Antwort nennt das entfernte Menü.

Einträge eines eigenen Inhaltstyps (Pods)

  1. lit-content-types mit post_type → Pflichtfelder, Auswahlwerte, Beziehungsziele.
  2. lit-content-create mit allen Pflichtfeldern in fields.
  3. Beziehungen über IDs (vorher mit lit-content-query suchen).