Intégrer Composer avec Canvas ou un thème tiers

Composer et le thème actif ont des responsabilités distinctes :

• Composer possède le Config Set, le Site Contract, les Blueprints, la validation, l'audit et l'exécution en mode brouillon uniquement.
• Le thème possède les modèles, parties de modèle, patterns, styles, jetons theme.json et le rendu final.

Composer ne modifie jamais les fichiers du thème et un thème n'active jamais la configuration Composer en silence.

Agent Canvas​

Agent Canvas est une implémentation de référence et un environnement de départ facultatifs. Il fournit un ensemble cohérent de modèles, patterns, styles et un manifeste de présentation en lecture seule basé sur les blocs principaux pour tester et démontrer le modèle de contrat complet de Composer. Il n'est pas requis, ne fait pas partie de la chaîne de dépendances d'exécution de Composer et ne remplace ni le thème, ni les patterns, ni le processus de conception d'une agence.

Composer peut s'intégrer à un thème construit par une agence ou personnalisé tant que le site expose un contrat de contenu clair via ses patterns, ses types de contenu et sa configuration Composer. Le thème actif du site et les patterns approuvés par l'agence définissent le système visuel. Un manifeste Canvas ne fait que confirmer des mappages de présentation sémantiques que Composer peut inspecter ; il ne doit contenir ni identifiants de fournisseur, ni invites, ni rappels d'exécution, ni politique exécutable.

Une configuration Canvas doit suivre cet ordre :

1. Installez et activez Canvas.
2. Dans Composer, rescanner le site et confirmer le thème Canvas, les modèles, les patterns et les blocs principaux.
3. Créez un nouveau Config Set inactif à partir de Universal Gutenberg, SmartCloud Recommended ou Detected Theme Starter, ou créez-en un manuellement.
4. Examinez le Site Contract généré et chaque Blueprint au lieu de supposer que le préréglage correspond au site.
5. Confirmez que les modèles cibles Blueprint et les slugs de pattern existent dans la version Canvas active.
6. Validez puis activez explicitement le Config Set.
7. Lancez un test de brouillon et d'aperçu pour chaque type de page avant de l'utiliser dans un workflow normal.

Conservez séparés les contrats WP Suite spécifiques au site et les préréglages Canvas généraux. Un contrat privé spécialisé ne doit pas devenir la configuration par défaut d'une installation Canvas publique propre.

Thèmes bloc tiers​

Composer peut fonctionner avec un thème bloc Gutenberg standard ou tiers sans Canvas. La compatibilité est fondée sur les capacités, pas sur la marque.

Commencez avec un contrat délibérément restreint :

1. Activez le thème choisi et rescannez Theme & providers.
2. Inspectez ses modèles, patterns, blocs et préréglages theme.json enregistrés.
3. Choisissez Detected Theme Starter lorsque Composer trouve un pattern de thème sûr, ou commencez avec Universal Gutenberg.
4. Définissez un type de page simple en n'utilisant que les capacités confirmées.
5. Préférez les blocs principaux et les patterns de thème stables au HTML copié ou aux styles en ligne.
6. Validez, activez et créez un brouillon de test.
7. Élargissez le contrat seulement après que l'aperçu a prouvé que le thème actuel rend correctement le premier Blueprint.

Detected Theme Starter n'accepte qu'un pattern de thème à racine unique et à blocs principaux, exclut les patterns dynamiques, de navigation, de modèle, HTML, shortcode et utilitaires cachés, ajoute le contrat H1 requis et supprime du pattern de travail généré les styles inline non liés à un préréglage. Un support partiel est attendu. Un thème peut prendre en charge un Blueprint standard de page et d'article mais pas une disposition spécialisée de produit ou d'architecture. N'affaiblissez pas la validation pour masquer une capacité manquante ; ajoutez plutôt au thème le pattern ou le modèle approprié, ou retirez cette exigence du Config Set de travail.

Règles de pattern et de modèle​

Un pattern autorisé doit être enregistré sur le site actuel et chaque bloc imbriqué dans ce pattern doit lui aussi être autorisé par le Blueprint. Les séquences requises ne doivent contenir que les patterns dont tout brouillon valide a réellement besoin.

Utilisez un modèle sans titre lorsque le pattern de contenu fournit le H1. Si le modèle du thème affiche le titre de l'article, n'ajoutez pas un second H1 dans le contenu. Composer valide l'arbre assemblé complet, mais l'administrateur doit choisir une combinaison modèle/pattern qui évite les titres de page dupliqués dans le rendu final.

Changements de thème​

Après avoir changé ou mis à niveau un thème :

1. laissez le Config Set actuellement actif inchangé,
2. rescanner le site,
3. clonez le Config Set actif,
4. mettez à jour dans le clone les références aux modèles, patterns, blocs et préréglages,
5. validez chaque Blueprint affecté,
6. prévisualisez des brouillons représentatifs,
7. activez le clone uniquement après revue.

Si l'ancien thème et le nouveau exposent des capacités différentes, conservez les deux Config Sets pour comparaison et rollback. Un changement de thème ne doit jamais réécrire ni activer la configuration en silence.

Plugins fournisseurs​

Les plugins fournisseurs enregistrent leurs types de contenu, taxonomies associées, champs visibles via REST, stockage des relations et contrat de cible, blocs et abilities métier spécifiques au fournisseur. Composer gère l'exécution générique des champs, relations et termes de taxonomie gouvernés. Les fournisseurs ne doivent pas dupliquer les abilities de recherche/création/affectation de relation ou de taxonomie de Composer ; le Site Contract actif décide quelles taxonomies déjà enregistrées le workflow générique peut utiliser. Composer ne délègue que les opérations de composants ou métiers réellement spécifiques au fournisseur. Un Blueprint peut exiger un bloc de fournisseur uniquement lorsque le plugin est installé, enregistré et prêt. Examinez la documentation externe propre au fournisseur sur les services et la confidentialité avant d'activer du contenu adossé à un fournisseur.