Aller au contenu

Dennis · 14 octobre 2026

Blockstudio 7.7

Blockstudio 7.7 ajoute des routes virtuelles pour les documents sans publication WordPress, améliore les compilations de prérendu ciblées et fiabilise la modification et le rendu des blocs existants. Cette version étend aussi les vérifications de balises de bloc de PHPStan et améliore l’accessibilité des composants UI inclus.

Le flux de travail axé sur les fichiers reste le même. Les blocs sont rendus à partir de leurs modèles, et les pages stockées dans des fichiers sont modifiées par une synchronisation explicite CLI ou API. Cette version n’introduit aucune synchronisation automatique des pages lors des requêtes de visiteur ou d’administration.

En bref :

  • Routes virtuelles : diffusez une galerie de composants, un catalogue ou un autre document complet sans créer de publication ni écrire de gestionnaire de redirection personnalisé.
  • Compilations de prérendu ciblées : les compilations HTTP enregistrent les fichiers sources utilisés par chaque page, afin qu’une compilation ultérieure puisse générer uniquement les routes concernées.
  • Conservation du cache : gardez les feuilles de style retirées disponibles pour les pages en cache et inspectez ou purgez les entrées inutilisées de la table de diffusion anticipée.
  • Fiabilité de l’éditeur : les blocs sélectionnés ensemble conservent leurs propres valeurs, l’annulation et le rétablissement fonctionnent pour RichText et les champs de la barre latérale, et le contexte hérité reste associé au bon bloc.
  • Fidélité du contenu des fichiers : les listes imbriquées, les éléments de structuration, le balisage en ligne HTML, les codes courts et les attributs échappés résistent à l’analyse et au rendu.
  • Améliorations de PHPStan : les balises à préfixe, les alias, les éléments de page mappés et les variables de modèle sont vérifiés par rapport aux propres définitions du projet.
  • UI accessibles : les commandes exposent correctement leur état, les libellés activent le bon champ, et les composants de liste et de tableau utilisent une structure HTML valide.
  • Traductions : les traductions JavaScript installées sont chargées dans l’éditeur et la vue d’ensemble de l’administration, y compris pour les commandes de champ auparavant non traduites.

Routes virtuelles

Certaines pages proviennent de données plutôt que d’une publication gérée par l’éditeur. Une référence de composant, par exemple, peut avoir besoin de son propre URL et titre de document, mais d’aucune entrée dans wp_posts.

Enregistrez ce document avec Blockstudio\Virtual_Routes :

PHP
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});

La route diffuse /components/. Son rappel s’exécute dans le tampon de sortie de Blockstudio, de sorte que les blocs rendus reçoivent leurs styles, leurs scripts, les ressources UI regroupées et la sortie Tailwind via le pipeline normal. WordPress ne transforme pas la route correspondante en 404 et ne la redirige pas vers une publication.

Pour une famille d’URL, définissez prefix sur true et fournissez un rappel match. Celui-ci reçoit le chemin sous la route et renvoie la valeur dont votre moteur de rendu a besoin. Renvoyer null ou false laisse la requête à WordPress. Utilisez urls pour répertorier les chemins qu’une compilation de prérendu statique doit inclure. Une route unique sans préfixe inclut son propre chemin par défaut.

Virtual_Routes::urls() renvoie des URL absolues pour les intégrations qui assemblent un plan de site. Les documents virtuels ne sont pas automatiquement ajoutés au plan de site des publications de WordPress.

Consultez Routes virtuelles pour la documentation complète API et les options.

Des compilations de prérendu plus précises

Les compilations en mode graphe effectuées sur HTTP consignent désormais les fichiers utilisés par chaque route : le modèle WordPress, les modèles et ressources des blocs rendus, les définitions et mises en page des pages fichiers, ainsi que les dépendances ajoutées via blockstudio/render/dependencies.

Lors de la compilation suivante, build_plan() compare ces dépendances. La modification d’un modèle de bloc marque les routes qui en dépendent pour le rendu, sans reconstruire toutes les pages sans lien. Les changements de configuration partagée ont toujours un effet sur toute la compilation, et les nouvelles routes ou celles arrivées à expiration sont rendues comme auparavant.

Les changements limités à la base de données ne sont pas des dépendances de fichiers. Un déploiement qui doit récupérer une option, une publication ou une autre valeur de la base de données doit forcer une compilation ou rendre explicitement les URL concernées.

Cette version corrige également les changements d’identité de compilation lors du premier rendu, les tables de diffusion anticipée obsolètes mises en cache par l’opcode et l’exclusion d’URL valides simplement parce que leur chemin contient search ou preview. Les requêtes Markdown utilisant Accept: text/markdown contournent HTML en cache, et les réponses concernées envoient Vary: Accept.

Le prérendu statique tient désormais compte des filtres enregistrés par le thème actif pour décider s’il faut attacher ses hooks. Un thème peut désactiver cette fonctionnalité sans qu’une recherche antérieure des paramètres ne la laisse active.

Consultez Prérendu statique.

Conservation et maintenance du cache

Une page HTML en cache peut survivre à l’identité d’exécution qui a compilé sa feuille de style. cache.namespaceGrace détermine la durée de disponibilité des espaces de noms retirés après la première détection de leur retrait par le nettoyage :

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Cet exemple conserve les fichiers retirés pendant neuf jours. La valeur par défaut est d’un jour. Les espaces de noms actifs et ceux qui servent des artefacts de prérendu déployés sont protégés contre le nettoyage des éléments retirés.

La table de diffusion anticipée dispose également de commandes d’inspection et de nettoyage :

Shell
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

Ces commandes signalent et suppriment les entrées correspondant à des sites supprimés ou à des répertoires manquants. La suppression d’un site multisite supprime également ses entrées. Les documents de route manquants sont signalés séparément et n’entraînent pas la suppression de l’entrée d’un site valide tout entier.

Consultez Mise en cache pour les conseils de conservation et maintenance de la table pour les commandes.

Un éditeur plus fiable

La modification d’un bloc sélectionné avec d’autres ne met désormais à jour que ce bloc. L’enregistrement conserve le contenu, les clés, les métadonnées et les verrous propres à chaque bloc, au lieu de copier les attributs entre les blocs sélectionnés.

Les valeurs RichText résident directement dans les attributs du bloc, ce qui permet à Gutenberg de les inclure dans l’annulation et le rétablissement. Les champs de la barre latérale participent au même historique. InnerBlocks templateLock="false" est transmis sous forme de véritable booléen et déverrouille le contenu même lorsqu’une zone parente est verrouillée.

Les préchargements initiaux reçoivent l’ID et le type de la publication modifiée, afin que les modèles puissent lire les bonnes métadonnées dès le premier rendu. Des blocs enfants identiques sous des parents différents conservent un contexte hérité distinct dans les préchargements et les caches de rendu. Les changements d’attributs ou de contexte lors d’une requête initiale ne laissent plus l’aperçu en retard.

Blockstudio cesse également d’insérer des éléments marqueurs de rendu masqués entre les racines des blocs. Les sélecteurs de frères adjacents tels que .card + .card retrouvent désormais dans l’éditeur les mêmes relations entre éléments que dans l’interface publique, tandis que les rendus d’aperçu de l’éditeur et de l’inserteur restent distincts.

Stockage plus sûr des options à l’échelle du site

Les champs adossés à des options fournissent toujours des valeurs à l’échelle du site, mais l’enregistrement d’une publication n’écrit plus aveuglément toutes les copies sauvegardées de ces champs :

  • Les enregistrements à l’état de brouillon, en attente, privé ou programmé n’écrivent pas les options actives du site.
  • Les publications publiées écrivent les champs fournis qui ont changé lors de cette modification.
  • L’enregistrement du seul titre d’une ancienne copie ne rétablit pas une valeur à l’échelle du site plus récente.
  • Les champs manquants et les blocs supprimés ne suppriment pas les options existantes.
  • Un null explicite supprime une option. Les chaînes vides, false, zéro et les tableaux vides restent des valeurs valides.

C’est le principal changement de comportement à vérifier lors de la mise à niveau. Si une intégration utilisait une publication privée ou à l’état de brouillon pour mettre à jour une option active, écrivez explicitement cette option ou utilisez plutôt une publication de configuration publiée. Le stockage dans les métadonnées de publication n’est pas concerné par la restriction aux publications publiées.

Consultez Stockage pour connaître toutes les règles d’enregistrement.

Le contenu des fichiers reste intact

Le pipeline de HTML vers les blocs préserve une plus grande partie de la structure que vous avez écrite :

  • Les listes imbriquées deviennent des blocs de liste internes à leur élément parent. Les classes des listes et des éléments sont conservées ; les listes plates ordinaires gardent leur sortie précédente.
  • main, header, footer, article et aside deviennent des blocs de groupe qui préservent leur élément, au lieu d’être du HTML brut qui contourne le rendu des blocs.
  • Les paragraphes de texte enrichi mappés conservent leur balisage en ligne, les paragraphes ne contenant qu’une image sont résolus en bloc d’image mappé et les balises de codes courts conservent leur contenu.
  • Les attributs échappés sont décodés puis échappés une seule fois, y compris ceux de InnerBlocks, de RichText et de l’élément useBlockProps.
  • Les signes supérieur à l’intérieur des attributs cités de balises autofermantes sont acceptés.
  • Les attributs HTML globaux parviennent à la racine d’un bloc Blockstudio lorsque celui-ci ne les déclare pas comme champs. wp bs pages sync signale les attributs enregistrés qui ne sont pas rendus.

Les pages, motifs et modèles de l’éditeur de site adossés à Blade sont désormais rendus via Blockstudio\Blade_Renderer, avec prise en charge des versions 8 à 12 de illuminate/view. Tous les fichiers d’extension ciblant le même bloc sont enregistrés ; leur priorité, leurs champs de groupe et leurs listes de cibles respectent le schéma documenté.

Les dépendances SCSS imbriquées sont également suivies. La modification d’un partiel importé par un autre partiel change la version de la feuille de style dépendante et déclenche sa recompilation.

Améliorations de PHPStan

Le package blockstudio/phpstan installé séparément étend la validation des balises de bloc aux balises à préfixe et aux alias, aux éléments de page mappés, aux mises en page, aux blocs UI inclus et, en option, à d’autres sources PHP du projet. La résolution des espaces de noms correspond à celle de l’exécution, y compris pour les espaces contenant des traits d’union, et les attributs HTML globaux transmis sont acceptés.

Les variables de modèle de bloc telles que $a, $block et $context sont considérées comme définies par Blockstudio. Les types de champ sont conservés lors de la coalescence nulle et de isset() sous PHPStan 2.3, tandis qu’un modèle qui attribue sa propre valeur à $a conserve le type qu’il lui a attribué.

Ces changements sont disponibles dans blockstudio/phpstan 0.1.9. Mettez à jour le package séparément du plugin ; il nécessite PHPStan 2.1.47 ou une version ultérieure :

Shell
composer require --dev blockstudio/phpstan:^0.1.9

Consultez PHPStan pour la configuration et les préréglages d’analyse.

Accessibilité et traductions

Les déclencheurs UI inclus exposent leur état développé sur le bouton lui-même. Les libellés des cases à cocher, interrupteurs et boutons radio nomment leurs commandes et permettent de les activer. Les fils d’Ariane, la pagination, les menus de navigation et les tableaux n’insèrent plus d’éléments enveloppants invalides entre les listes ou les tableaux et leurs enfants.

Les boutons d’affichage du mot de passe exposent leur état activé et disposent d’une zone cliquable plus grande. Les champs acceptent autocomplete, et les champs de mot de passe acceptent un ID explicite et un libellé accessible. Les fenêtres d’affichage des carrousels peuvent recevoir le focus au clavier, et les animations des indicateurs de chargement et des squelettes respectent les préférences de réduction des animations.

L’éditeur et la vue d’ensemble de l’administration chargent les traductions JavaScript installées pour le domaine de texte blockstudio. Les menus d’attributs et les espaces réservés, les actions des fenêtres contextuelles de code, ainsi que les badges d’image et de fichier peuvent désormais être traduits. Les chaînes sans traduction restent en anglais.

Consultez la bibliothèque UI et la configuration des traductions.

Documentation et mise à niveau

La documentation ajoute des guides sur les sites de documentation, Content Sync, les modèles de l’éditeur de site, les balises de blocs, les îlots, les types de champs personnalisés, le déploiement, le prérendu, la configuration du registre, les outils d’analyse et les écrans de l’application UI. Le guide de migration ACF tient compte de l’enregistrement actuel ACF et des liaisons de blocs.

Les exemples de remplissage personnalisé utilisent désormais le filtre pris en charge à argument unique et à jeu de données nommé. La documentation sur les ressources explique l’ordre des feuilles de style du frontend et comment charger les remplacements du thème après CSS des blocs. Les installations destinées aux contributeurs utilisent le paquet public Font Awesome sans identifiants de registre.

PHP 8.2 et WordPress 6.7 restent les versions minimales requises. Les routes virtuelles et les nouvelles commandes de maintenance sont disponibles sans modifier les collections de pages existantes. Consultez ci-dessus les règles d’enregistrement des options, mettez à jour le paquet PHPStan distinct si vous l’utilisez, et continuez à lancer explicitement la synchronisation des pages comme auparavant.

7.7.1 Suivi

Le correctif 7.7.1 clarifie et sécurise les résultats de synchronisation. Une fusion par clé qui ne modifie pas un article ne crée plus de révision et ne met plus à jour son horodatage de modification. Les statuts de publication existants sont conservés, les remplacements du titre et du slug provenant des fichiers sont signalés, et les pages verrouillées ou supprimées sont nommées dans le rapport CLI. Content Sync marque les corps appartenant à Page Sync et conserve les copies existantes pour révision. Le correctif protège aussi les attributs appartenant à WordPress des conflits d’identifiants de champ et conserve les classes d’éditeur ajoutées par d’autres filtres.