Nouvelle API d'enregistrement des modèles de plugins dans WordPress 6.7

Depuis l'introduction des thèmes de blocs, les développeurs de thèmes ont pu créer des modèles de blocs personnalisés. Toutefois, cette possibilité est limitée aux thèmes et les plugins ne peuvent pas enregistrer directement leurs propres modèles. Afin d'obtenir une fonctionnalité similaire, les plugins doivent recourir à des méthodes complexes, y compris l'accrochage de plusieurs filtres PHP, la création manuelle de modèles de blocs.WP_Block_Templateet reproduire la logique interne de WordPress.

WordPress 6.7 Une nouvelle API a été introduite qui simplifiera grandement le processus d'enregistrement par les plugins de leurs propres modèles de blocs. Pour ce faire, deux nouvelles fonctionnalités ont été introduites :register_block_template()Utilisé pour enregistrer les modèles de blocs et lesunregister_block_template()Utilisé pour désenregistrer les modèles de blocs.

register_block_template( string $template_name, $args = array() )Accepte deux paramètres qui définissent comment le modèle est enregistré :

• $emplate_nameNom du modèle : Nom du modèle sous la forme plugin_uri//nom_du_modèle (notez que cela nécessite un double //).
• $args: tableau de paramètres utilisés pour définir le modèle :
  • titre: Titre internationalisé du modèle.
  • description: Une description internationalisée du modèle.
  • contenuLe contenu par défaut du modèle lorsqu'il est rendu dans l'éditeur ou dans le front-end (bloc de balisage).
  • post_typesLes modèles d'articles : une série d'éléments de type article qui peuvent être mis à la disposition des utilisateurs en tant que modèles personnalisés pour chaque article.

Par exemple, le plugin peut enregistrer des modèles à l'aide de l'extrait de code suivant :

register_block_template( 'devblog-plugin-templates//my-template', [
    'title' => __('Example', 'devblog-plugin-templates' ), [ 'description' => __('Un exemple de modèle de bloc provenant d'un plugin.
    'description' => __('Un exemple de modèle de bloc d'un plugin.', 'devblog-plugin-templates' ),
    'content' => '
        <!-- wp:template-part {"slug":"header","area":"header","tagName":"header"} /-->
        <!-- wp:group {"tagName":"main"} -->
        <main class="wp-block-group">
            <!-- wp:group {"layout":{"type":"constrained"}} -->
            <div class="wp-block-group">
                <!-- wp:paragraph -->
                <p>Il s'agit d'un modèle enregistré dans un plugin.</p>
                <!-- /wp:paragraph -->
            </div>
            <!-- /wp:group -->
        </main>
        <!-- /wp:group -->
        <!-- wp:template-part {"slug":"footer","area":"footer","tagName":"footer"} /-->'

Une fois enregistré, ce modèle apparaîtra avec tous les autres modèles dans l'éditeur de site :

Et, si vous le souhaitez, l'enregistrement peut être annulé ultérieurement à l'aide de la commande suivante :

	unregister_block_template( 'devblog-plugin-templates//my-template' )

Le plugin peut également remplacer des modèles dans la hiérarchie des modèles de WordPress, comme les pages d'archives pour les types d'articles personnalisés ou les pages d'auteurs spécifiques.

Les modèles du thème sont prioritaires sur les modèles enregistrés par les plugins, ce qui permet au thème de remplacer des modèles de plugins spécifiques comme s'il s'agissait de modèles WordPress.

Actuellement, cette API est limitée aux modèles de blocs et ne permet pas l'enregistrement de sections de modèles de blocs.

Contactez nous
Vous n'arrivez pas à lire le tutoriel ? Contactez-nous pour une réponse gratuite ! Aide gratuite pour les sites personnels et les sites de petites entreprises !	Service clientèle WeChat
① Tel : 020-2206-9892
② QQ咨询：1025174874
(iii) Courriel : info@361sale.com
④ Horaires de travail : du lundi au vendredi, de 9h30 à 18h30, jours fériés.