Z-Blog 官方文档

模块编辑页表单输出扩展 ​

通过 Filter_Plugin_Module_Edit_Response 接口，可以在 Z-BlogPHP 后台模块编辑页表单字段之后、提交按钮之前追加自定义表单内容，适用于为模块增加自定义参数（如数据来源、显示条数等）的场景。

接口信息 ​

接口参数说明
Filter_Plugin_Module_Edit_Response无模块编辑页表单字段之后输出内容

完整案例 ​

下例在模块编辑页增加一个「显示条数」输入框：

php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Module_Edit_Response', 'demoAPP_Module_Edit_Response');
}

// 显示：在模块编辑页输出输入框
function demoAPP_Module_Edit_Response()
{
    global $mod;
    $limit = isset($mod->Metas->demoapp_limit) ? $mod->Metas->demoapp_limit : '';
    echo '<p><span class="title">显示条数:</span><br />';
    echo '<input class="edit" size="40" name="meta_demoapp_limit" type="text" value="' . htmlspecialchars($limit) . '" /></p>';
}

数据保存 ​

插件不需要自己写保存代码。Z-BlogPHP 在文章、独立页面、分类、标签、用户、模块的保存流程中都会执行 FilterMeta()，自动把表单中所有 meta_ 前缀的字段写入对应对象的 Metas：字段 meta_demoapp_limit 保存后即为 $mod->Metas->demoapp_limit，前台模板中同样可通过该方式读取。

需要处理非 meta_ 前缀字段或做额外逻辑时，才需要挂载 Filter_Plugin_PostModule_Succeed 等保存接口。

注意事项 ​

  • 接口没有参数，回调函数通过 echo 输出内容，输出位置在「不自动更新内容」选项之后、提交按钮之前，被包裹在 <div id='response' class='editmod2'> 内；系统表单字段使用 <p><span class="title">...</span></p> 段落结构，插件自行输出时建议与之保持统一风格；
  • meta_ 前缀字段的值为空字符串时该 Meta 键会被自动删除，因此读取时应先用 isset() 判断键是否存在；
  • 回调中可通过 global $mod 访问当前正在编辑的模块对象；模块编辑页也用于系统内置模块和主题自带文件模块，字段对所有模块均生效；
  • 部分内置模块（如分类目录、文章归档）的编辑页会附加自身专用字段，插件字段在它们之后输出。