WordPress插件多值设置：实现分类折扣的高级管理

// 定义设置字段
add_settings_field(
    'cat_slug',        // ID
    'Category Slug',   // 标题
    'cat_slug_render', // 渲染回调函数
    'slug-configuration', // 页面
    'configuration'    // 区块
);

/**
 * 渲染分类Slug和折扣输入字段
 */
function cat_slug_render() {
    // 获取当前保存的选项，如果不存在则返回空数组
    $options = get_option( 'slug-configuration', array() );

    // 注意：这里的 'cat_slug' 现在是一个数组
    // 如果是新增模式，通常value留空。如果是编辑模式，需要决定显示哪个值。
    // 这里我们演示如何显示第一个已保存的值作为示例。
    $current_value = '';
    if ( isset( $options['cat_slug'] ) && is_array( $options['cat_slug'] ) && !empty( $options['cat_slug'] ) ) {
        // 假设我们想显示第一个已保存的值
        $current_value = $options['cat_slug'][0];
        // 如果想显示最后一个，可以使用 $options['cat_slug'][array_key_last($options['cat_slug'])]
    }

    ?>
    <input type='text' 
           size="50" 
           name='slug-configuration[cat_slug][]' 
           value='<?php echo esc_html( $current_value ); ?>' 
           placeholder="输入分类Slug和折扣，每次提交新增一条记录">
    <?php
}

// 注册设置，并指定消毒回调函数
register_setting(
    'slug-configuration', // 选项组
    'slug-configuration', // 选项名称
    'slug_configuration_sanitize' // 消毒回调函数
);

/**
 * 消毒回调函数，处理多值输入
 * @param array $input 提交的原始输入数据
 * @return array 消毒后的数据
 */
function slug_configuration_sanitize( $input ) {
    $new_input = array();

    // 假设我们只关心 cat_slug 字段
    if ( isset( $input['cat_slug'] ) && is_array( $input['cat_slug'] ) ) {
        $sanitized_slugs = array();
        foreach ( $input['cat_slug'] as $slug_value ) {
            // 对每个分类slug进行消毒，例如移除HTML标签，确保是有效的slug格式
            $sanitized_slugs[] = sanitize_text_field( $slug_value ); 
            // 如果需要更复杂的验证（如正则表达式），可以在这里实现
        }
        // 将新的消毒后的slugs添加到新的输入数组中
        $new_input['cat_slug'] = array_filter( $sanitized_slugs ); // 移除空值
    }

    // 如果还有其他设置字段，也在这里进行消毒处理
    // ...

    return $new_input;
}

/**
 * 示例：如何在插件或主题中获取并使用保存的分类折扣数据
 */
function display_category_discounts() {
    // 获取保存的整个配置选项
    $options = get_option( 'slug-configuration', array() );

    // 提取分类slugs数组，如果不存在则默认为空数组
    $category_slugs = $options['cat_slug'] ?? array();

    if ( ! empty( $category_slugs ) ) {
        echo '<h3>已配置的分类折扣：</h3>';
        echo '<ul>';
        foreach ( $category_slugs as $slug ) {
            // 在这里你可以根据 $slug 执行你的业务逻辑
            // 例如，假设 $slug 包含了分类ID和折扣百分比，你需要解析它
            // 为了简化，这里只展示了如何显示保存的文本
            echo '<li>' . esc_html( $slug ) . '</li>';
        }
        echo '</ul>';
    } else {
        echo '<p>目前没有配置任何分类折扣。</p>';
    }
}

// 可以在适当的位置调用此函数来显示数据，例如在管理页面或前端
// add_action( 'admin_notices', 'display_category_discounts' );