用户编辑页表单输出扩展
通过 Filter_Plugin_Member_Edit_Response 接口,可以在 Z-BlogPHP 后台用户编辑页表单字段之后追加自定义表单内容,适用于为用户增加自定义资料字段(如手机号、微信号等)的场景。
接口信息
| 接口 | 参数 | 说明 |
|---|---|---|
Filter_Plugin_Member_Edit_Response | 无 | 用户编辑页表单字段之后输出内容 |
完整案例
下例在用户编辑页增加一个「手机号」输入框:
php
<?php
RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");
function ActivePlugin_demoAPP()
{
Add_Filter_Plugin('Filter_Plugin_Member_Edit_Response', 'demoAPP_Member_Edit_Response');
}
// 显示:在用户编辑页输出输入框
function demoAPP_Member_Edit_Response()
{
global $member;
$mobile = isset($member->Metas->demoapp_mobile) ? $member->Metas->demoapp_mobile : '';
echo '<p><span class="title">手机号:</span><br />';
echo '<input class="edit" size="40" name="meta_demoapp_mobile" type="text" value="' . htmlspecialchars($mobile) . '" /></p>';
}数据保存
插件不需要自己写保存代码。Z-BlogPHP 在文章、独立页面、分类、标签、用户、模块的保存流程中都会执行 FilterMeta(),自动把表单中所有 meta_ 前缀的字段写入对应对象的 Metas:字段 meta_demoapp_mobile 保存后即为 $member->Metas->demoapp_mobile,前台模板中同样可通过该方式读取。
需要处理非 meta_ 前缀字段或做额外逻辑时,才需要挂载 Filter_Plugin_PostMember_Succeed 等保存接口。
注意事项
- 接口没有参数,回调函数通过
echo输出内容,输出位置在模板选择字段之后、默认头像和提交按钮之前,被包裹在<div id='response' class='editmod2'>内;系统表单字段使用<p><span class="title">...</span></p>段落结构,插件自行输出时建议与之保持统一风格; meta_前缀字段的值为空字符串时该 Meta 键会被自动删除,因此读取时应先用isset()判断键是否存在;- 回调中可通过
global $member访问当前正在编辑的用户对象,新建用户时ID为 0;用户编辑页也用于管理员编辑其他用户,字段对所有用户生效; - 如需在用户管理列表中展示该字段,可配合「用户管理页表格列扩展」接口。