首先创建插件类文件MyTagPlugin.php并继承PluginController,在构造函数中用addMethod注册标签名与方法名的映射,接着定义myTagFunction方法处理逻辑并解析$params参数,最后在模板中通过调用,系统将自动执行对应逻辑并输出结果。

Pboot插件自定义标签的创建方法_Pboot插件标签语法的编写规则  第1张

如果您希望在PbootCMS中扩展功能,通过自定义插件标签实现数据调用或逻辑处理,但系统默认标签无法满足需求,则需要按照特定语法创建自定义标签。以下是具体操作步骤:

本文运行环境:联想ThinkPad X1 Carbon,Windows 11

一、创建自定义插件类文件

在PbootCMS中,所有插件均位于 /apps/plugin/controller/ 目录下,每个插件对应一个PHP类文件。新建插件需在此目录中创建新的PHP类,并继承系统PluginController基类,用于注册和解析自定义标签。

1、进入项目根目录下的 /apps/plugin/controller/ 文件夹。

2、创建一个新的PHP文件,例如命名为 MyTagPlugin.php

3、在文件中定义类 MyTagPlugin,并继承 PluginController 类。

4、确保类中包含构造函数,并调用父类构造函数以完成初始化。

二、注册自定义标签名称

注册标签名称是让模板引擎识别您所定义的标签的关键步骤。通过在插件类中使用addMethod方法将自定义方法绑定到指定标签名,使模板中可通过该标签调用功能。

1、在插件类的构造函数中使用 $this->addMethod('mytag', 'myTagFunction'); 进行注册。

2、其中 'mytag' 是您希望在模板中使用的标签名称,如

3、'myTagFunction' 是类中实际处理逻辑的方法名,必须存在且为public类型。

三、编写标签处理逻辑方法

标签的实际功能由对应的处理方法实现。该方法负责接收参数、执行业务逻辑(如数据库查询、数据格式化等),并返回可供模板输出的内容。

1、在插件类中定义名为 myTagFunction 的公共方法。

2、方法可接收两个参数:$params(标签传入的参数数组)和 $content(标签内部内容,用于嵌套场景)。

3、在方法体内编写所需逻辑,例如从数据库读取文章列表、计算数值或拼接HTML片段。

4、最终使用 return 输出结果字符串,此内容将替换模板中的标签位置。

四、定义标签参数解析规则

为了提升标签灵活性,支持动态参数传递,需在方法内对$params数组进行解析,提取用户在模板标签中设置的键值对,如 limit='5' 或 type='news'。

1、在处理方法中使用 isset($params['limit']) ? $params['limit'] : 10; 获取参数默认值。

2、可支持多个常用参数,如分页数量、分类编码、排序方式等。

3、将提取的参数用于数据库查询条件或其他逻辑控制,增强标签实用性。

五、在模板中调用自定义标签

完成插件开发后,可在前端模板文件中直接使用注册的标签名称插入动态内容。模板引擎会自动解析并执行对应插件逻辑。

1、打开任意.html模板文件,如 index.html

2、插入标签语法:

3、保存文件并刷新前台页面,查看是否正确输出预期内容。

4、若未生效,请检查插件路径、类名、方法注册及缓存设置,必要时清除系统缓存。