如何在WordPress自定义小部件中保存wp_dropdown_categories的选择？

我来帮你搞定这个问题！用wp_dropdown_categories做小部件的分类下拉确实省心，毕竟它自带层级分类处理，但保存环节很容易踩细节坑，尤其是update()函数的处理逻辑。先给你拆解关键问题，再给你正确的代码示例：

常见错误点 #

你推测问题在update()里是对的，但通常和form()里的字段命名也有关系：

• 下拉菜单的name属性没遵循WordPress小部件的标准命名规范，导致提交的数据无法被小部件识别
• update()里没有正确接收、验证并返回分类字段的值

正确的form()和update()实现 #

1. 表单渲染函数（form()） #

这里要确保下拉菜单的name和selected参数设置正确：

public function form($instance) {
    // 获取已保存的分类ID，默认值设为0（对应"选择一个分类"选项）
    $selected_category = isset($instance['selected_category']) ? absint($instance['selected_category']) : 0;

    // 配置wp_dropdown_categories的参数
    $dropdown_args = array(
        'show_option_all' => __('选择一个分类', 'your-text-domain'),
        'selected'        => $selected_category,
        'name'            => $this->get_field_name('selected_category'), // 核心！必须用这个函数生成name
        'id'              => $this->get_field_id('selected_category'),
        'class'           => 'widefat',
        'taxonomy'        => 'category',
        'hierarchical'    => true, // 保留分类层级，这也是你想用内置函数的原因
        'hide_empty'      => false, // 可选：是否隐藏空分类，根据需求调整
    );
    ?>
    <p>
        <label for="<?php echo esc_attr($this->get_field_id('selected_category')); ?>">
            <?php _e('选择要展示的分类:', 'your-text-domain'); ?>
        </label>
        <?php wp_dropdown_categories($dropdown_args); ?>
    </p>
    <?php
}

2. 数据更新函数（update()） #

这里要正确处理提交的分类ID，做好安全验证：

public function update($new_instance, $old_instance) {
    $instance = $old_instance;
    
    // 验证并保存分类ID：确保是整数，避免恶意数据
    $instance['selected_category'] = isset($new_instance['selected_category']) 
        ? absint($new_instance['selected_category']) 
        : 0;

    // 如果你不想保存"选择一个分类"的状态，可以加个判断清空值
    // if ($instance['selected_category'] === 0) {
    //     $instance['selected_category'] = '';
    // }

    return $instance;
}

关键细节解释 #

• name属性的重要性：$this->get_field_name('selected_category')会生成类似widget_your_widget_id[selected_category]的命名，这是WordPress小部件识别表单字段的标准格式，没有它，提交的数据根本到不了update()函数里。
• 数据验证：用absint()把提交的值转成正整数，既符合分类ID的类型，也能过滤掉不安全的内容。
• 选中状态回显：form()里的selected参数绑定$instance['selected_category']，这样编辑小部件时能自动显示之前选中的分类。

如果你的小部件还有其他字段，只需要在update()里用同样的逻辑处理即可。这样修改后，分类下拉的选择应该就能正常保存啦！

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