Maison >interface Web >tutoriel HTML >Démarrez le développement WordPress avec Twig : blocs et imbrication

Démarrez le développement WordPress avec Twig : blocs et imbrication

PHPzoriginal: 2023-08-31 18:29:06667parcourir

Dans mon article précédent, j'ai abordé l'intégration du moteur de modèles Twig avec WordPress via Timber et la manière dont les développeurs peuvent envoyer des données de fichiers PHP vers des fichiers Twig. Discutons de la façon de créer un modèle de base à l'aide de Twig, des avantages de cette technique DRY et de la feuille de triche WordPress Timber-Twig.

Créez un modèle de base dans Twig

Twig suit le principe DRY (Don’t Repeat Yourself). L'une des fonctionnalités les plus importantes de Twig réside dans les modèles de base avec imbrication et héritage multiple. Alors que la plupart des gens utilisent les inclusions PHP de manière linéaire, vous pouvez créer des niveaux illimités de blocs imbriqués pour contrôler spécifiquement vos modèles de page.

Considérez votre modèle de base comme un modèle parent contenant plusieurs blocs. Un modèle enfant peut étendre le modèle parent et modifier n'importe quel bloc ou blocs qu'il contient sans réécrire le code, ce qui est similaire dans les deux modèles.

Jetons un coup d'œil à l'exemple de modèle parent ou de base, le code du fichier base.twig 文件。您可以将其与其他 Twig 模板一起放置在视图文件夹中。您可以在任何 Twig 模板中调用此文件，并将其用作该特定 Twig 文件的父模板。键入以下代码行以创建 views 文件夹。此基本模板将为您的 WordPress 主题提供基本结构。这是一个简单的 base.twig.

{# Base Template: base.twig #}

{% block html_head_container %}

    {% include 'header.twig' %}

{% endblock %}

	<body class="{{body_class}}">

		<div class="wrapper">

			{% block content %}

			    <!-- Add your main content here. -->
			    <p>SORRY! No content found!</p>

			{% endblock %}

		</div>
		<!-- /.wrapper -->

	{% include "footer.twig" %}

	</body>

</html>

Commentaires de

Twig : `{# 基本模板：base.twig #}`

Vous pouvez écrire des commentaires dans Twig en utilisant la syntaxe {# comment here #}. Pour commenter certaines lignes d'un modèle, utilisez la syntaxe de commentaire {# ... #}. Ceci est utile pour déboguer ou ajouter des informations à d’autres concepteurs de modèles ou à vous-même. Vous pouvez trouver le commentaire à la ligne 1.

Bloquer : `{% block html_head_container %}` `{% endblock %}`

Toute l'idée de Twig and Timber tourne autour de l'approche de codage modulaire dans WordPress. J'ai beaucoup écrit sur l'idée de gérer les données dans Twig sous forme de composants ou de blocs.

Les blocs sont utilisés pour l'héritage, agissant à la fois comme espaces réservés et comme remplacements. Ils sont documentés en détail dans la documentation des balises d'extension.

{% block add_block_name_here %} 阻止此处的内容 { % endblock % }

Dans le code écrit ci-dessus, vous pouvez trouver un bloc nommé html_head_container 的块，它跨越第 3 行到第 7 行。扩展此 base.twig 基本模板的任何模板都可以继承同一块的内容或修改它以添加其他内容。还有另一个名为 content {% block content %} qui s'étend de la ligne 13 à la ligne 18.

De même, le concept de création de blocs a été encore élargi et vous pouvez également créer des niveaux illimités de blocs imbriqués. C’est le véritable principe DRY.

Contient la phrase : `{% include "header.twig" %}`

Les modèles Twig peuvent contenir d'autres modèles Twig, tout comme nous le faisons en PHP. Ce fichier base.twig sera un wrapper universel incomplet sans ses fichiers base.twig 文件将是一个通用包装器，如果没有它的页眉和页脚文件，它是不完整的。因此，语法 {% include "file.twig" %}header

. Par conséquent, la syntaxe {% include "file.twig" %} nous aidera à inclure deux modèles Twig différents : { % include "header.twig" %}
Modèle d'en-tête {% include "footer.twig" %} Ligne 5.

Modèle de pied de page (

Ligne 23.

Modèle de base étendu

base.twig 文件作为父模板，并将内容块留空。该块可以在任何会修改它的自定义 Twig 文件中使用，并且基本模板的其余部分将按原样继承。例如，让我们创建一个 single.twig 文件，该文件将扩展 base.twig 模板并修改 content

Nous avons créé un bloc single.twig 文件。在第 3 行，该模板扩展为 base.twig 作为其父模板或基本模板。 extends.

{# Single Template: `single.twig` #}

{% extends "base.twig" %}

{% block content %}

    <div class="single_content">
        <h1>{{ post.title }}</h1>
        <p>{{ post.get_content }}</p>
    </div>

{% endblock %}

Ce code montre que les balises header 和 footer 相关的所有详细信息均继承自 base.twig 文件，该文件是父模板，而 content personnalisées peuvent être utilisées pour étendre un modèle à partir d'un autre modèle.

Ici, le bloc avec

sera remplacé par le titre et le contenu du message. Est-ce amusant ?

Aide-mémoire WordPress de Wood🎜 🎜Les développeurs de Timber ont veillé à ce qu'il complète WordPress de toutes les manières possibles, du noyau à l'utilisateur final. Bien que la syntaxe de conversion des fonctions WordPress dans Timber soit quelque peu différente, elle est bien documentée. A la fin de cet article, je partagerai une liste de quelques transformations des fonctions WordPress et de leurs équivalents Timber. Passons en revue. 🎜

简要回顾！

在我的上一篇文章中，我创建了一条欢迎消息，该消息仅通过演示网站主页上的 PHP 字符串填充。其代码可以在 GitHub 上的分支中找到。让我们再次重复此过程，但使用不同且更具技术性的方法。

现在，我将显示相同的欢迎消息，但这次是通过创建一个填充在主页上的新页面。

检索 Twig 中的 WordPress 函数

创建一个标题为“欢迎来到我的博客！”的新页面。并在点击发布按钮之前在其中添加一些内容。

Démarrez le développement WordPress avec Twig : blocs et imbrication

现在让我们在主页上显示这个欢迎页面的内容。为此，请再次转到 index.php 文件并添加以下代码行。

<?php
/**
 * Homepage
 */

// Context array.
$context = array();

// Add the page ID which is 4 in my case.
$context[ 'welcome_page' ] = Timber::get_post( 4 );

// Timber render().
Timber::render( 'welcome.twig', $context );

在这里，我添加了一个 $context 数组，在其中添加了一个元素 welcome_page 然后使用 get_post() 函数来获取我刚刚创建的页面。为此，我提交了页面 ID，在本例中为 4。

在 welcome.twig 文件中，让我们查看 print_r 元素 welcome_page 并看看我们得到了什么数据。我的welcome.twig 文件目前看起来像这样。

{# Message Template: `welcome.twig` #}
<section class="message">
        <pre class="brush:php;toolbar:false">
            <code>{{ welcome_page | print_r }}</code>

我可以确认 $context 数组中的这个元素现在有一个 ID 为 4 的特定页面的 TimberPost 对象。

Démarrez le développement WordPress avec Twig : blocs et imbrication

从这里我们可以获得所有可以在前端显示的属性。例如，我只想显示页面标题和内容。所以现在我的 welcome.twig 文件如下所示：

{# Message Template: `welcome.twig` #}
<section class="message">
        <h2>{{ welcome_page.title }}</h2>
        <p>{{ welcome_page.content }}</p>
</section>

主页上有我们需要的信息。

Démarrez le développement WordPress avec Twig : blocs et imbrication

WordPress 备忘单

正如我之前所说，Timber 为您提供了一些 WordPress 函数的便捷转换。这些功能可以帮助您获取与以下内容相关的信息：

博客
身体课程
页眉/页脚

`get_context()` 函数

有一个 Timber::get_context() 函数，用于检索开发人员希望在整个网站的前端显示的网站信息负载。文档是这样解释的：

这将返回一个对象，其中包含我们在整个站点中需要的许多常见内容。像你的 nav、wp_head 和 wp_footer 这样的东西你每次都会想要开始（即使你稍后覆盖它们）。您可以执行 $context = Timber::get_context(); print_r( $context ); 查看内部内容或打开 timber.php 自行检查。

<?php $context = Timber::get_context(); ?>

不仅如此，您还可以通过方便的过滤器将您自己的自定义数据添加到此函数中。

<?php

/**
 * Custom Context
 *
 * Context data for Timber::get_context() function.
 *
 * @since 1.0.0
 */
function add_to_context( $data ) {
    $data['foo'] = 'bar';
	$data['stuff'] = 'I am a value set in your functions.php file';
	$data['notes'] = 'These values are available everytime you call Timber::get_context();';
	$data['menu'] = new TimberMenu();
	return $data;
}
add_filter( 'timber_context', 'add_to_context' );

您可以在下面找到更多与此类似的转换，这些转换可以与 Timber 一起使用。

博客信息

blog_info('charset') => {{ site.charset }}
blog_info('描述') => {{ site.description }}
blog_info('站点名称') => {{ site.name }}
blog_info('url') => {{ site.url }}

身体等级

implode(' ', get_body_class()) =>

主题

get_template_directory_uri() => {{ theme.link }} （用于父主题）
get_template_directory_uri() => {{ theme.parent.link }} （用于子主题）
get_stylesheet_directory_uri() => {{ theme.link }}
get_template_directory() => {{ theme.parent.path }}
get_stylesheet_directory() => {{ theme.path }}

wp_函数

wp_head() => {{ wp_head }}
wp_footer() => {{ wp_footer }}

让我们从博客信息开始尝试一些功能。将 foo 写入 {{ site.name }}。

前端将显示这样的站点标题：

Démarrez le développement WordPress avec Twig : blocs et imbrication

Timber 还具有一些函数转换，可以通过 TimberPost( )。在解释这个函数的用法之前，我们先列出与其相关的函数转换。

发布

the_content() => {{ post.content }}
the_permalink() => {{ post.permalink }}
the_title() => {{ post.title }}
get_the_tags() => {{ post.tags }}

用法

在 single.php 文件中使用此代码。

<?php
$context = Timber::get_context();
$context[ 'post' ] = new TimberPost(); 
Timber::render( 'welcome.twig', $context );
?>

现在让我们测试 Twig 文件中的 {{ post.title }} 函数。

<section class="single_post">
        <h2>{{ post.title }}</h2>        
</section>

保存，前端会显示这样的帖子标题：

Démarrez le développement WordPress avec Twig : blocs et imbrication

轮到你了！

今天，您在构建 WordPress 主题时见证了 Timber 和 Twig 的 DRY 原则的实际实施。阅读本教程并尝试实现它，如果您有任何问题，请告诉我。您可以在此 GitHub 存储库的 WP Cheatsheet 分支中找到完整的代码。

在下一篇也是上一篇文章中，我将讨论如何在基于 Twig 的 WordPress 模板中处理图像和菜单。在此之前，请在 Twitter 上与我联系以获取您问题的答案，或在此处发布问题。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

php include 继承多重继承 WordPress

Déclaration：

Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn

Article précédent：Créer un groupe d'options en HTMLArticle suivant：Créer un groupe d'options en HTML

Articles Liés

Voir plus

Démarrez le développement WordPress avec Twig : blocs et imbrication

Créez un modèle de base dans Twig

Twig : {# 基本模板：base.twig #}

Bloquer : {% block html_head_container %} {% endblock %}

Contient la phrase : {% include "header.twig" %}

Ligne 23.

Ici, le bloc avec

简要回顾！

检索 Twig 中的 WordPress 函数

WordPress 备忘单

get_context() 函数

博客信息

身体等级

主题

wp_函数

发布

用法

轮到你了！

Articles Liés

Twig : `{# 基本模板：base.twig #}`

Bloquer : `{% block html_head_container %}` `{% endblock %}`

Contient la phrase : `{% include "header.twig" %}`

`get_context()` 函数