Z-Blog 官方文档

标签管理页表格列扩展 ​

通过 Filter_Plugin_Admin_TagMng_Table 接口，可以逐行处理标签管理页列表表格，既可以新增整列，也可以直接在系统已有的操作列中追加自定义按钮。该接口自 Z-BlogPHP 1.5.1 起提供。

接口信息 ​

接口参数说明
Filter_Plugin_Admin_TagMng_TableTag &$tag, arr &$tabletds, arr &$tableths标签管理页表格每行数据组装完成后触发

完整案例 ​

下例不新增列，而是在每个标签行的「操作」单元格中追加一个「合并」按钮，把标签 ID 带给插件的合并处理页：

php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_TagMng_Table', 'demoAPP_TagMng_Table');
}

function demoAPP_TagMng_Table(&$tag, &$tabletds, &$tableths)
{
    global $zbp;

    // 只改行、不动表头，因此不需要向 $tableths 添加内容
    // 末元素是 '</tr>'，倒数第二个元素就是「操作」单元格
    $cellIndex = count($tabletds) - 2;

    $mergeUrl = $zbp->host . 'zb_users/plugin/demoAPP/main.php?act=merge&id=' . $tag->ID;

    $tabletds[$cellIndex] .= '&nbsp;&nbsp;&nbsp;&nbsp;'
        . '<a href="' . $mergeUrl . '" title="合并标签">'
        . '<i class="icon-puzzle-fill"></i></a>';
}

参数说明 ​

参数类型说明
$tagTag当前行对应的标签对象（引用传入）
$tabletdsarray当前行的 HTML 片段数组，首元素为 <tr>，末元素为 </tr>，倒数第二个元素是操作列单元格
$tablethsarray表头 HTML 片段数组，末元素为 </tr>；仅修改现有列时无需改动

注意事项 ​

  • 接口位于列表的 foreach 循环内，每输出一个标签就触发一次；
  • 三个参数均按引用传递，回调签名中的 & 不能省略；接口只采集回调对数组的修改，回调的返回值不会被使用；
  • 在操作列追加的按钮如果只是打开插件页面，直接拼接链接即可；一旦点击后会修改或删除数据，链接必须通过 BuildSafeCmdURL() 生成以携带 CSRF Token；
  • 图标类名来自系统后台的 icon.css，与系统自带编辑、删除按钮使用同一套图标字体。