Anmelden

Composer mit Canvas oder Drittanbieter-Theme integrieren

Composer und aktives Theme haben getrennte Verantwortlichkeiten:

  • Composer verwaltet Config Set, Site Contract, Blueprints, Validierung, Audit und Draft-only-Ausführung.
  • Das Theme verwaltet Templates, Template-Parts, Patterns, Styles, theme.json Tokens und finales Rendering.

Composer editiert keine Theme-Dateien, ein Theme aktiviert niemals stillschweigend Composer-Konfiguration.

Agent Canvas​

Agent Canvas ist eine optionale Referenzimplementierung und Startumgebung. Es liefert zusammenhängende Core-Block-Templates, Patterns und Styles sowie ein schreibgeschütztes Präsentationsmanifest zum Testen und Vorführen des vollständigen Composer-Vertragsmodells. Es ist nicht erforderlich, gehört nicht zu den Composer-Laufzeitabhängigkeiten und ersetzt weder das Theme noch die Patterns oder das Design der Agentur.

Composer kann mit einem selbstgebauten oder individuellen Theme integrieren, sofern die Site über ein klares Inhaltsmodell durch Patterns, Inhaltstypen und Composer-Konfiguration erreichbar bleibt. Das aktive Theme der Site und agenturfähige Patterns definieren das visuelle System. Das Canvas-Manifest bestätigt nur semantische Präsentations-Mappings zur Prüfung durch Composer; es enthält keine Provider-Zugangsdaten, Prompts, Laufzeit-Callbacks oder ausführbare Richtlinien.

Eine Canvas-Integration sollte in dieser Reihenfolge erfolgen:

  1. Canvas installieren und aktivieren.
  2. In Composer die Seite scannen und Canvas Theme, Templates, Patterns und Core-Blöcke bestätigen.
  3. Neuen inaktiven Config Set aus Universal Gutenberg, SmartCloud Recommended oder Detected Theme Starter erstellen oder manuell anlegen.
  4. Generierten Site Contract und jeden Blueprint prüfen, statt Preset als vollständige Übereinstimmung anzunehmen.
  5. Blueprint-Zieltemplates und Pattern-Slugs im aktiven Canvas nachweisen.
  6. Config Set validieren und explizit aktivieren.
  7. Für jede Seitentyp einen Draft-and-Preview-Test durchführen.

Halten Sie site-spezifische WP-Suite-Verträge getrennt von allgemeinen Canvas-Presets. Eine spezialisierte private Vereinbarung darf nicht zur Standardkonfiguration einer sauberen öffentlichen Canvas-Installation werden.

Drittanbieter-Block-Themes​

Composer kann mit einem Standard- oder Drittanbieter-Blocktheme ohne Canvas arbeiten. Kompatibilität basiert auf Fähigkeiten, nicht auf Marke.

Starten Sie mit bewusst kleinem Vertrag:

  1. Theme aktivieren und Theme & Providers neu scannen.
  2. Registrierte Templates, Patterns, Blöcke und theme.json Presets prüfen.
  3. Detected Theme Starter wählen, wenn ein sicheres Theme-Pattern gefunden wurde, oder mit Universal Gutenberg starten.
  4. Einfache Seitentyp definieren mit nur bestätigten Fähigkeiten.
  5. Kernblöcke und stabile Theme-Patterns gegenüber kopiertem HTML oder Inline-Styles bevorzugen.
  6. Validieren, aktivieren und Testentwurf erstellen.
  7. Vertrag erweitern erst, wenn die Vorschau bestätigt, dass der aktuelle Theme das erste Blueprint korrekt rendert.

Detected Theme Starter akzeptiert nur ein Single-Root Core-Block-Pattern, schließt dynamische Query, Navigation, Template-, HTML-, Shortcode- und versteckte Utility-Patterns aus, ergänzt nötigen H1-Contract und entfernt nicht-presets Inline-Styling aus dem erzeugten Arbeits-Pattern. Teilkompatibilität ist erwartbar. Ein Theme kann einen Standard-Seiten- und Beitrag-Blueprint unterstützen, aber nicht unbedingt einen spezialisierten Produkt- oder Architektur-Blueprint. Schwäche in der Validierung darf nicht durch Abschwächung umgangen werden; fügen Sie ein passendes Pattern/Template dem Theme hinzu oder entfernen Sie die Anforderung aus dem Arbeits-Config Set.

Pattern- und Template-Regeln​

Ein erlaubtes Pattern muss auf der aktuellen Site registriert sein und jedes verschachtelte Pattern im Pattern ebenfalls durch Blueprint erlaubt sein. Erforderliche Sequenzen sollten nur Muster enthalten, die jede gültige Entwurfsversion wirklich benötigt.

Nutzen Sie ein H1-freies Template, wenn das Inhalts-Pattern die H1 liefert. Wenn das Theme-Template den Beitragstitel rendert, fügen Sie keine zweite H1 im Content hinzu. Composer validiert den vollständigen Baum, aber Administrator muss Template/Pattern-Kombination wählen, die keine doppelten Seitentitel im finalen Rendering erzeugt.

Theme-Wechsel​

Nach Theme-Wechsel oder -Upgrade:

  1. aktiven Config Set unverändert lassen,
  2. Seite scannen,
  3. aktiven Config Set klonen,
  4. Template-, Pattern-, Block- und Preset-Referenzen im Klon aktualisieren,
  5. jeden betroffenen Blueprint validieren,
  6. repräsentative Entwürfe prüfen,
  7. Klon erst nach Review aktivieren.

Wenn alte und neue Themes verschiedene Fähigkeiten liefern, halten Sie beide Config Sets für Vergleich und Rollback vor. Ein Theme-Wechsel darf nie stillschweigend Konfiguration neu schreiben oder aktivieren.

Provider-Plugins​

Provider-Plugins registrieren ihre Inhaltstypen, zugeordneten Taxonomien, REST-sichtbaren Felder, Beziehungs-Storage und Zielverträge, Blöcke sowie provider-spezifische WordPress-Abilities. Composer verwaltet generische Feld-, Beziehungs- und steuerbare Taxonomie-Termin-Anwendungs-Workflows. Provider sollten keine eigenen Relation- oder Taxonomie-Such/Erstellungs-/Zuweisungsfähigkeiten duplizieren; der aktive Site Contract entscheidet, welche registrierten Taxonomien der generische Workflow nutzen darf. Composer delegiert nur echte provider-spezifische Komponenten- oder Geschäftsoperationen. Ein Blueprint darf Provider-Blöcke nur verlangen, wenn Plugin installiert, registriert und bereit ist. Prüfen Sie externe Dokumentation zu externem Service und Datenschutz, bevor provider-basierter Inhalt aktiviert wird.