0

0

Twig 入门:快速启动您的 WordPress 开发

WBOY

WBOY

发布时间:2023-09-02 08:29:01

|

889人浏览过

|

来源于php中文网

原创

现在我们了解到,twig 与 wordpress 插件 timber 一起可以帮助开发人员在开发 wordpress 主题时编写模块化代码。通过这种模块化方法,您可以分别处理 web 应用程序的逻辑层和视图层。让我们跳到稍微更技术性的内容:创建 twig 模板、将 html 转换为 twig 文件,以及如何使用 twig 模板呈现逻辑或数据。

安装木材

首先,我要安装 Timber,这是一个 WordPress 插件,有助于将 Twig 模板引擎与 WP 集成。那么,让我们开始吧。

  • 登录您的 WordPress 信息中心。
  • 转至插件 > 添加新插件
  • 搜索 Timber 插件。
  • 安装并激活插件。

安装 Timber 后,您现在可以开始将模板文件拆分为数据视图文件。

创建树枝模板

在我们开始创建 Twig 模板之前,我假设您已经进行了某种本地 WordPress 设置。对于这个特定的教程,我的设置是:

  • 本地主机 WP 安装(我使用的是 ServerPress 的 DesktopServer)。
  • 已安装并激活 Timber 插件。
  • 可选:任何基础/入门主题(我使用自己的主题,即 Neat)。

UpStatement 还构建了一个 Timber Starter 主题。

让我们开始吧。我想在主页顶部显示欢迎消息。如果没有 Twig,我该怎么办?也许,我会在 PHP 文件中包含 HTML 代码并回显欢迎消息,就像我在下面的代码示例中所做的那样。我的 index.php 文件看起来像这样。

<?php
/**
 * Homepage
 */
get_header(); ?>

    <div> <?php echo "Welcome to my blog!"; ?> </div>

<?php get_footer(); ?>

现在,我本地 WordPress 安装的主页在顶部显示一条欢迎消息。这是屏幕截图。

Twig 入门:快速启动您的 WordPress 开发

问题

这种方法的问题在于我们将数据/逻辑与视图混合在一起。该文件越复杂,维护就越困难,更不用说理解了,例如,如果您在此代码后面添加带有一些参数的 WordPress 循环,然后再进行过滤和分页。除此之外,当您最终得到一些逻辑时,HTML 中的 PHP 看起来并不好。

模块化方法

为了使其更加模块化,我们可以将主页上的内容视为块或组件的形式。默认情况下可以有两个完整的,即来自 The_Loop 的帖子和分页。现在我们想在顶部添加另一个组件,即欢迎消息,让我们为该组件创建一个 Twig 文件。

在编辑器中打开一个新的空白文件,然后复制粘贴以下代码行。

<!-- Welcome Template -->
<section class="welcome_message">
        <h2>Welcome to my website!</h2>
</section>

在主题的根目录中创建一个名为 views 的新文件夹,并使用 .twig 扩展名保存此文件。例如,我将文件保存为 welcome.twig

渲染树枝模板

Timber 为我们提供了一些有用的函数,其中之一就是渲染函数。你可以这样称呼它:

Timber::render();

该函数最多可以接受四个参数。由于这超出了本文的范围,您可以在 Timber 文档中阅读相关内容。我们可以将主题的 views 文件夹中存在的任何 Twig 文件的名称传递给此函数。

让我们在 index.php 文件中渲染欢迎消息。

<?php
/**
 * Homepage
 */
get_header();

    // Timber Render.
	Timber::render( 'welcome.twig' );

get_footer();

Timber 渲染 welcome.twig 文件,加载 HTML 并在前端显示新修改的视图层,如下所示:

Twig 入门:快速启动您的 WordPress 开发

render() 函数将 welcome.twig 作为它的参数,但只要树枝模板位于名为 views 的文件夹内,它就会自动读取该文件。

如果您想对文件夹使用自定义名称/路径,则必须提供该文件夹的路径。例如,我在主题的根目录中创建了一个 twig 文件夹,并将其添加到渲染函数的参数中。

DM运动健身减肥健身馆网站模板1.7
DM运动健身减肥健身馆网站模板1.7

DM企业建站系统运动健身减肥健身馆网站模板, DM企业建站系统。是由php+mysql开发的一套专门用于中小企业网站建设的开源cms。DM系统的理念就是组装,把模板和区块组装起来,产生不同的网站效果。可以用来快速建设一个响应式的企业网站( PC,手机,微信都可以访问)。后台操作简单,维护方便。DM企业建站系统安装步骤:第一步,先用phpmyadmin导入sql文件。 第二步:把文件放到你的本地服务

下载
<?php Timber::render('twig/welcome.twig'); ?>

官方加载顺序

Timber 将首先查看子主题,然后回退到父主题(与 WordPress 逻辑相同)。官方的加载顺序是:

  1. 用户定义的位置
  2. 调用PHP脚本的目录(但不是主题)
  3. 子主题
  4. 父主题
  5. 调用PHP脚本的目录(包括主题)

第 2 项插入到其他项之上,这样如果您在插件中使用 Timber,它将使用插件目录中的 twig 文件。

所以,现在index.php文件里面没有HTML,它正在渲染一个Twig模板。

现在让我们将一些动态数据从 index.php 发送到 welcome.twig 文件并使用 Timber 进行渲染。

通过 Timber 将数据发送到 Twig 文件

要将数据从 PHP 文件发送到 Twig 文件,您需要定义一个上下文数组。渲染函数采用一组数据来为 Twig 模板提供某种上下文。我们将该数组称为 $context,它是一个关联数组,即它占用键值对。

让我们添加一个键值对,作为动态欢迎消息,我们的 PHP 文件会将其发送到 Twig 文件。

数据文件

我的 index.php 文件现在看起来像这样。

<?php
/**
 * Homepage
 */
get_header();

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

	// Dynamic message.
	$var = 'Dynamic Message';

	// Dynamic data.
	$context['the_message'] = $var;

	// Render twig file with the give $context array.
	Timber::render( 'welcome.twig', $context );

get_footer();

因此,在 index.php 文件中,我在第 8 行定义了一个空的 $context 数组。然后,在第 11 行,我创建了一个变量 $var,其值为 'Dynamic Message'在第 14 行,我创建了一个键 the_message ,它等于 $var

在第 17 行,我使用 welcome.twig 文件调用了渲染函数,但这一次,它需要一个额外的参数,即 $context 数组。这个新参数实际上包含 Timber 将从 PHP 文件发送到 Twig 文件的数据。

因此,我们定义了上下文数组并添加了动态消息(您可以通过向其添加某种逻辑来向不同的用户显示不同的消息,例如显示当前用户的名字)。

模板文件

现在我们需要在 Twig 文件中使用此数据,即 the_message。我们可以通过在 Twig 模板中放置双括号来回显变量。例如,要在 twig 文件中回显 $var,我们可以编写 {{ var }}。这正是我所做的。

<!-- Message Template -->
<section class="message">
        <h2>{{ the_message }}</h2>
</section>

the_message 的值将打印在 h2 标签内。我知道,就是这么简单,而且代码看起来也很干净。

就是这样!保存代码,在前端查看动态欢迎信息。这是最终的屏幕截图。

Twig 入门:快速启动您的 WordPress 开发

结论

总而言之,现在您可以使用 PHP 文件来编码逻辑并向 Twig 模板提供数据,该模板包含 HTML 并在双括号内呈现 Twig 变量或函数。

这种模块化方法可以为 WordPress 主题中的每个组件生成单独的模板文件。考虑拥有一个 message.twig 组件,您可以在主题中的任何位置使用它来显示您想要的任何消息,任意次数。

这是 Twig 与 Timber 的基本实现。不过,在接下来的两篇文章中,我将介绍 Timber WordPress Cheatsheet、使用 Timber 管理图像以及在不使用疯狂步行器功能的情况下创建菜单。

如果您有任何疑问,请在下面的评论中发表或在 Twitter 上联系。您还可以在此 GitHub 存储库中查看我的主题代码。

WPS零基础入门到精通全套教程!
WPS零基础入门到精通全套教程!

全网最新最细最实用WPS零基础入门到精通全套教程!带你真正掌握WPS办公! 内含Excel基础操作、函数设计、数据透视表等

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

16

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

23

2026.03.10

Kotlin Android模块化架构与组件化开发实践
Kotlin Android模块化架构与组件化开发实践

本专题围绕 Kotlin 在 Android 应用开发中的架构实践展开,重点讲解模块化设计与组件化开发的实现思路。内容包括项目模块拆分策略、公共组件封装、依赖管理优化、路由通信机制以及大型项目的工程化管理方法。通过真实项目案例分析,帮助开发者构建结构清晰、易扩展且维护成本低的 Android 应用架构体系,提升团队协作效率与项目迭代速度。

75

2026.03.09

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

95

2026.03.06

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

218

2026.03.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

420

2026.03.04

AI安装教程大全
AI安装教程大全

2026最全AI工具安装教程专题:包含各版本AI绘图、AI视频、智能办公软件的本地化部署手册。全篇零基础友好,附带最新模型下载地址、一键安装脚本及常见报错修复方案。每日更新,收藏这一篇就够了,让AI安装不再报错!

168

2026.03.04

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

222

2026.03.03

C++高性能网络编程与Reactor模型实践
C++高性能网络编程与Reactor模型实践

本专题围绕 C++ 在高性能网络服务开发中的应用展开,深入讲解 Socket 编程、多路复用机制、Reactor 模型设计原理以及线程池协作策略。内容涵盖 epoll 实现机制、内存管理优化、连接管理策略与高并发场景下的性能调优方法。通过构建高并发网络服务器实战案例,帮助开发者掌握 C++ 在底层系统与网络通信领域的核心技术。

33

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号