如何在PrestaShop 1.6的AdminCustomersController中用createTemplate添加客户列表新选项

嘿，我注意到你正在尝试给PrestaShop的客户列表添加一个自定义操作按钮——不过直接修改核心的AdminCustomersControllerCore控制器可不是长久之计哦，PrestaShop版本更新时这些核心文件会被完全覆盖，你的自定义代码也就丢了。我来帮你梳理正确的实现方式，同时完善你当前的测试思路：

1. 别碰核心文件！用模块重写才是正道 #

直接修改\controllers\admin\AdminCustomersController.php只能临时测试，升级必丢。PrestaShop提供了模块重写机制，能安全扩展核心功能，不会被升级影响。

2. 在自定义模块中重写控制器 #

先在你的模块目录下创建这个文件结构：

你的模块名/
├── controllers/
│   └── admin/
│       └── AdminCustomersController.php

然后在这个重写的控制器里写代码（我把你说的“核查”对应成verify，你可以根据实际需求调整命名）：

class AdminCustomersController extends AdminCustomersControllerCore
{
    // 重写列表渲染方法，添加自定义操作列
    public function renderList()
    {
        // 保留原有默认操作：查看、编辑、删除
        $this->addRowAction('view');
        $this->addRowAction('edit');
        $this->addRowAction('delete');
        // 添加你的自定义“核查”操作
        $this->addRowAction('verify');
        
        return parent::renderList();
    }

    // 渲染“核查”按钮的链接
    public function displayVerifyLink($token = null, $id, $name = null)
    {
        // 加载模块内的自定义模板
        $tpl = $this->createTemplate(_PS_MODULE_DIR_ . $this->module->name . '/views/templates/admin/list_action_verify.tpl');
        
        // 给模板传递必要变量：链接地址、操作名称、客户ID
        $tpl->assign([
            'href' => $this->context->link->getAdminLink('AdminCustomers', true) . '&id_customer=' . (int)$id . '&action=verify&token=' . $this->token,
            'action' => $this->trans('Verify', [], 'Admin.Actions'),
            'id' => $id
        ]);
        
        return $tpl->fetch();
    }

    // 处理“核查”操作的请求逻辑
    public function initContent()
    {
        // 判断是否是核查操作请求
        if (Tools::getValue('action') == 'verify' && Tools::getValue('id_customer')) {
            $id_customer = (int)Tools::getValue('id_customer');
            // 这里写你的核查逻辑，比如更新客户状态、记录操作日志等
            // 举个例子：标记客户为已核查（你可以换成自己的自定义字段）
            $customer = new Customer($id_customer);
            if ($customer->id) {
                $customer->active = 1; 
                $customer->save();
                
                $this->confirmations[] = $this->trans('Customer verified successfully!', [], 'Admin.Notifications.Success');
            } else {
                $this->errors[] = $this->trans('Customer not found!', [], 'Admin.Notifications.Error');
            }
        }
        
        parent::initContent();
    }
}

3. 制作按钮的模板文件 #

在模块目录下创建模板文件views/templates/admin/list_action_verify.tpl，写按钮的HTML结构：

<a class="btn btn-default tooltip-link" href="{$href}" title="{$action}">
    <i class="icon-check"></i> {$action}
</a>

4. 在模块主文件注册重写 #

打开你的模块主文件（比如你的模块名.php），添加注册和卸载重写的方法：

public function install()
{
    return parent::install() && $this->registerOverride('AdminCustomersController');
}

public function registerOverride($controller)
{
    $source = _PS_MODULE_DIR_ . $this->name . '/controllers/admin/' . $controller . '.php';
    $target = _PS_CONTROLLER_DIR_ . 'admin/' . $controller . '.php';
    return copy($source, $target);
}

public function uninstall()
{
    $overrideFile = _PS_CONTROLLER_DIR_ . 'admin/AdminCustomersController.php';
    if (file_exists($overrideFile)) {
        unlink($overrideFile);
    }
    return parent::uninstall();
}

关于你当前测试代码的补充 #

如果只是临时测试，你可以把displayEraseLink方法补全，同时在控制器的renderList里添加这个操作：

// 先在renderList里添加这行
$this->addRowAction('erase');

// 然后完善displayEraseLink方法
public function displayEraseLink($token = null, $id, $name = null) {
    $tpl = $this->createTemplate(_PS_MODULE_DIR_ . $this->module->name.'/views/templates/admin/list_action_erase.tpl');
    // 必须给模板传变量，不然按钮没法正常工作
    $tpl->assign([
        'href' => $this->context->link->getAdminLink('AdminCustomers', true) . '&id_customer=' . (int)$id . '&action=erase&token=' . $this->token,
        'action' => $this->trans('Erase', [], 'Admin.Actions'),
        'id' => $id
    ]);
    return $tpl->fetch();
}

内容的提问来源于stack exchange，提问作者Adam Kowalski