WordPress自定义分类Widget问题：勾选状态无法保存求助

我看了你的代码，问题出在复选框的字段处理逻辑上——你现在把所有分类的复选框都绑定到同一个checked字段，而且只保存单个布尔值，根本没法记录多个分类的选中状态，这就是为什么保存后勾选状态会丢失。下面是修复后的完整代码，我会逐一解释修改点：

/* CUSTOM BLOG CATEGORIES WIDGETS */
class Spr123_Categories_Widget extends WP_Widget {
    public function __construct() {
        $widget_options = array(
            'classname' => 'widget_custom_categories_widget',
            'description' => 'This is a Custom Blog Categories Widget',
        );
        parent::__construct( 'custom_categories_widget', 'Custom Categories Widget', $widget_options );
    }

    public function form( $instance ) {
        // 初始化字段，title默认空，checked默认空数组
        $title = ! empty( $instance['title'] ) ? $instance['title'] : '';
        // 这里的$name字段你没用到，可以考虑移除或者后续完善
        $name = ! empty( $instance['name'] ) ? $instance['name'] : '';
        $checked_categories = isset( $instance['checked'] ) ? (array) $instance['checked'] : array();
        
        $categories = get_categories( array(
            'orderby' => 'name',
            'parent' => 0,
            "hide_empty" => 0,
        ) );
        ?>
        <p>
            <label for="<?php echo $this->get_field_id( 'title' ); ?>">Title:</label>
            <input type="text" id="<?php echo $this->get_field_id( 'title' ); ?>" class="widefat" name="<?php echo $this->get_field_name( 'title' ); ?>" value="<?php echo esc_attr( $title ); ?>" />
        </p>
        <p>
            <label>Categories:</label>
        </p>
        <p>
            <?php foreach ( $categories as $category ) { 
                // 检查当前分类是否在已选中的数组里
                $is_checked = in_array( $category->slug, $checked_categories );
                ?>
                <input type="checkbox" class="checkbox" id="<?php echo $this->get_field_id($category->slug); ?>" 
                    name="<?php echo $this->get_field_name('checked'); ?>[]" 
                    value="<?php echo esc_attr($category->slug); ?>"
                    <?php checked( $is_checked ); ?> />
                <label for="<?php echo $this->get_field_id($category->slug); ?>"><?php _e( 'Display as NEW - ' . esc_attr( $category->name )); ?></label><br />
            <?php } ?>
        </p>
        <?php
    }

    public function update( $new_instance, $old_instance ) {
        $instance = $old_instance;
        $instance[ 'title' ] = strip_tags( $new_instance[ 'title' ] );
        // 处理name字段（如果后续不用可以删除）
        $instance[ 'name' ] = strip_tags( $new_instance[ 'name' ] );
        
        // 处理选中的分类数组：确保是数组，过滤掉无效值
        $instance[ 'checked' ] = isset( $new_instance['checked'] ) ? array_map( 'sanitize_text_field', (array) $new_instance['checked'] ) : array();
        return $instance;
    }

    public function widget( $args, $instance ) {
        $title = apply_filters( 'widget_title', $instance[ 'title' ] );
        // 这里的$category_title你没用到，后续可以改成展示分类列表
        $category_title = apply_filters( 'widget_title', $instance[ 'name' ] );
        $checked_categories = isset( $instance['checked'] ) ? (array) $instance['checked'] : array();
        
        echo $args['before_widget'] . $args['before_title'] . $title . $args['after_title'];
        
        // 示例：展示分类列表，标记选中的为New!
        $categories = get_categories( array(
            'orderby' => 'name',
            'parent' => 0,
            "hide_empty" => 0,
        ) );
        if ( !empty($categories) ) {
            echo '<ul>';
            foreach ( $categories as $category ) {
                $new_label = in_array( $category->slug, $checked_categories ) ? ' <span style="color:red;">New!</span>' : '';
                echo '<li><a href="' . get_category_link($category->term_id) . '">' . esc_html($category->name) . $new_label . '</a></li>';
            }
            echo '</ul>';
        }
        
        echo $args['after_widget'];
    }
}

function spr123_custom_categories_widget() {
    register_widget( 'Spr123_Categories_Widget' );
}
add_action( 'widgets_init', 'spr123_custom_categories_widget' );

关键修改点说明： #

• 复选框字段改为数组：把name="<?php echo $this->get_field_name('checked'); ?>"改成name="<?php echo $this->get_field_name('checked'); ?>[]"，并添加value="<?php echo esc_attr($category->slug); ?>"，这样提交的是选中分类slug的数组。
• 表单中判断选中状态：把单个布尔值$checked改成数组$checked_categories，用in_array($category->slug, $checked_categories)判断当前分类是否被选中。
• Update函数处理数组：不再用单个1/0值，而是接收并过滤数组，确保保存的是合法的分类slug数组。
• Widget前端展示优化：添加了分类列表的展示逻辑，自动给选中的分类加上New!标记，你可以根据自己的需求调整样式和布局。

这样修改后，复选框的选中状态就能正常保存和读取了，后台设置的分类也会在前端正确显示New!标记。

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