Drupal主题系统:模板文件、函数与变量的深度解析
1. 模板文件基础
在Drupal中,有许多变量可以添加到 page.tpl.php
和其他模板文件中。在开始操作之前,建议浏览Drupal安装目录下的主题文件夹,了解现有主题中变量的使用方式。
不同主题的模板文件数量有所不同,有些主题有各种各样的模板文件,而有些主题可能只有 page.tpl.php
。那么,如何知道可以创建哪些Drupal能够识别的模板文件呢?模板文件的创建有哪些命名约定呢?
page.tpl.php
是所有模板文件的基础,它为网站提供了整体的页面布局。其他模板文件会插入到 page.tpl.php
中,如下图所示:
graph LR
A[page.tpl.php] --> B[block.tpl.php]
A --> C[node.tpl.php]
在页面构建过程中,主题系统会自动将 block.tpl.php
和 node.tpl.php
插入到 page.tpl.php
中。例如,在之前创建自定义 page.tpl.php
文件时, $content
变量包含了 node.tpl.php
调用的输出, $left
变量包含了