调用模板
您正在阅读旧版文档,新版文档已迁移至 [https://document.pescms.com]
目录
创建好模板后,我们还需要调用它们。否则他们一直被冷落,没准那天它们会疯。调用模版的方法只能在控制器中使用。PESCMS提供了 display() 和 layout两个方法。
display
参数 | 说明 | 备注 |
---|---|---|
$themeFile | 调用模板的名称。为空时,则调用 控制器名称_方法.php 的模板(参数不带.php后缀)。 | 非必填 |
要显示模板,我们只要调用diplay()方法:
<?php ...某个控制器... public function index(){ $this->display(); }
当不带任何参数的时候,diplay() 会在对应组的模板中寻找 控制器_方法.php 的模板文件。当寻找失败后,会返回找不到模板的提示。反之若带了参数,那么他就会寻找对应名称的模板。
layout
参数 | 说明 | 备注 |
---|---|---|
$themeFile | 模板名称 为空时,则调用 控制器名称_方法.php 的模板(参数不带.php后缀)。 | 必填 |
$layout | 布局模板文件名称 | 默认调用 layout.php(参数不带.php后缀) | / |
在编写模板过程,单纯使用diplay()调用模板,难免会经常重复引入页眉,页脚,侧栏等重复的代码。当出现这个情况时,应该使用layout() 方法。在调用layout之前,您需要在对应的组模板目录下创建一个名为layout.php的模板文件(若您起名其他,那么在调用layout方法时,需要带上第二个参数进行声明)。并在layout文件中写入如下代码:
<?php $this->header(); ?> <!--此处表示加载页眉--> <?php include $file; ?> <!--此处表示加载对应的模板: 控制器_方法.php 此行为必须。layout显示的页面为空白页 --> <?php $this->footer(); ?> <!--此处表示加载页脚-->
上面的为PESCMS通常的写法。header() 和 footer() 方法为加载页眉页脚的方法。后面将作介绍。具体的布局形式,请自行依据实际的项目进行调整。
header已移除
本方法于2.8核心版本移出
参数 | 说明 | 备注 |
---|---|---|
$theme | 页眉名称,不填写默认寻找header.php文件。(参数不带.php后缀) | 非必填 |
header() 方法,顾名思义就是调用页眉。本方法用在模板文件中。调用方法非常简单,在任何模板找到您想引入页面的地方:
<?php $this->header();?>
footer已移除
本方法于2.8核心版本移出
参数 | 说明 | 备注 |
---|---|---|
$theme | 页眉名称,不填写默认寻找footer.php文件。(参数不带.php后缀) | 非必填 |
footer() 方法和header()方法一样。再次不作说明了。