WordPress选项页默认字段无法保存问题求助

按照教程创建WordPress自定义选项页，为复选框字段添加了default参数并设置为true，字段代码如下：

'bhld_reusable_blocks_enabled' => array(
    'label'       => esc_html__( 'Show Reusable Blocks', 'behold-things' ),
    'type'        => 'checkbox',
    'description' => 'Enables Reusable Blocks menu in Admin area.',
    'default'     => true,
    'tab'         => 'tab-1',
),

但保存设置后，该复选框仍处于未勾选状态。完整代码分为helper文件和选项页文件两部分。

问题核心是默认值未被正确读取与应用——仅在字段定义中设置default参数无法让WordPress自动识别，需要在选项获取、渲染逻辑中主动调用默认值。

1. 修改选项获取函数
   打开helper文件，找到bhld_get_option函数，替换为以下代码，确保当选项未保存（或不存在）时，返回字段定义中的默认值：

function bhld_get_option( $option, $default = false ) {
    $options = get_option( 'bhld_theme_options' );
    // 优先返回已保存的选项值
    if ( isset( $options[$option] ) ) {
        return $options[$option];
    }
    // 若选项未保存，返回字段定义的默认值
    $fields = bhld_get_theme_options_fields();
    if ( isset( $fields[$option]['default'] ) ) {
        return $fields[$option]['default'];
    }
    // 最后返回传入的默认值兜底
    return $default;
}

2. 修正复选框渲染逻辑
   打开选项页文件，找到处理type => 'checkbox'的渲染代码块，确保使用bhld_get_option获取值，替换原有的直接读取$options数组的逻辑：

// 替换原来的$value获取方式
$value = bhld_get_option( $id );
// 渲染复选框
printf(
    '<input type="checkbox" id="%1$s" name="bhld_theme_options[%1$s]" value="1" %2$s />',
    esc_attr( $id ),
    checked( $value, true, false )
);

3. 初始化默认选项（可选）
   如果希望用户首次启用主题时，默认值直接写入数据库，可在helper文件中添加主题激活钩子：

function bhld_initialize_theme_options() {
    $options = get_option( 'bhld_theme_options' );
    if ( false === $options ) {
        $fields = bhld_get_theme_options_fields();
        $default_options = array();
        foreach ( $fields as $key => $field ) {
            if ( isset( $field['default'] ) ) {
                $default_options[$key] = $field['default'];
            }
        }
        update_option( 'bhld_theme_options', $default_options );
    }
}
add_action( 'after_switch_theme', 'bhld_initialize_theme_options' );

完成以上修改后，重新保存设置，复选框的默认勾选状态即可正常生效。

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