如何将WordPress选项页的PHP值传入仪表盘小工具函数？

嘿，很高兴帮你搞定这个问题！既然你已经有了能用的自定义选项页，接下来咱们把那些配置动态整合到仪表盘小工具里，还能支持用户添加多个Feed小工具，一步到位。下面是具体的实现思路和代码：

1. 先整理选项页的Feed配置 #

首先，咱们要把选项页里分散的feed_label_0、feed_url_1这类字段，整理成每个Feed对应的完整配置数组，这样后续处理起来更方便：

// 在初始化阶段获取并整理Feed配置
function custom_feeds_init() {
    global $feeds_config;
    // 获取选项页保存的所有设置
    $dashboard_feeds_options = get_option('dashboard_feeds_option_name', array());
    $feeds_config = array();
    
    $index = 0;
    // 循环遍历所有Feed配置（假设选项页是重复字段，索引从0开始）
    while (isset($dashboard_feeds_options["feed_label_{$index}"]) && isset($dashboard_feeds_options["feed_url_{$index}"])) {
        // 清理和验证输入，确保安全性
        $label = sanitize_text_field($dashboard_feeds_options["feed_label_{$index}"]);
        $url = esc_url_raw($dashboard_feeds_options["feed_url_{$index}"]);
        // 文章数默认设为10，避免空值
        $num_articles = isset($dashboard_feeds_options["number_of_articles_{$index}"]) ? absint($dashboard_feeds_options["number_of_articles_{$index}"]) : 10;
        
        // 只有当标签和URL都不为空时，才加入配置数组
        if (!empty($label) && !empty($url)) {
            $feeds_config[] = array(
                'label' => $label,
                'url' => $url,
                'num_articles' => $num_articles
            );
        }
        $index++;
    }
}
add_action('init', 'custom_feeds_init');

2. 动态注册仪表盘小工具 #

接下来，咱们用整理好的配置数组，为每个Feed自动注册一个仪表盘小工具。每个小工具的ID和标题都会用选项里的内容，确保唯一性和个性化：

// 注册仪表盘小工具
add_action('wp_dashboard_setup', 'custom_feeds_dashboard_add_widgets');
function custom_feeds_dashboard_add_widgets() {
    global $feeds_config;
    
    // 如果没有配置任何Feed，直接返回
    if (empty($feeds_config)) {
        return;
    }
    
    // 循环每个Feed配置，注册对应的小工具
    foreach ($feeds_config as $feed) {
        // 生成唯一的小工具ID，用Feed标签的slug形式避免冲突
        $widget_id = 'dw_dashboard_widget_feed_' . sanitize_title($feed['label']);
        
        wp_add_dashboard_widget(
            $widget_id,
            __($feed['label'], 'dw'), // 小工具标题用选项里的Feed Label
            'custom_feed_dashboard_widget_handler', // 小工具内容的处理函数
            null, // 不需要配置回调的话留空
            $feed // 把当前Feed的配置传给处理函数
        );
    }
}

3. 通用的Feed小工具处理函数 #

最后，写一个通用的处理函数，接收每个Feed的配置，生成Feed内容，同时保留你之前加的target="_blank"功能，还加了容错提示：

// 处理每个Feed小工具的内容输出
function custom_feed_dashboard_widget_handler($feed) {
    // 构造WordPress内置Feed输出需要的数组格式
    $feeds = array(
        array(
            'url' => $feed['url'],
            'items' => $feed['num_articles'],
            'show_summary' => 1,
            'show_author' => 0,
            'show_date' => 1,
        ),
    );
    
    // 用输出缓冲捕获内置函数的输出，方便修改链接属性
    ob_start();
    wp_dashboard_primary_output('custom_feed_widget_' . sanitize_title($feed['label']), $feeds);
    $buffer = ob_get_clean();
    
    // 给所有Feed链接添加新窗口打开属性
    $result = str_replace("<a class='rsswidget'", "<a class='rsswidget' target='_blank'", $buffer);
    
    // 如果Feed加载失败或者没有内容，显示友好提示
    if (empty($result)) {
        echo '<p>' . __('无法加载该Feed，请检查URL是否正确。', 'dw') . '</p>';
    } else {
        echo $result;
    }
}

这样做的好处 #

• 完全动态：用户在选项页添加多少组Feed配置，就会自动生成多少个仪表盘小工具，不需要手动修改代码。
• 安全规范：用了WordPress的安全函数清理输入，避免XSS等安全问题。
• 容错处理：空配置会被跳过，Feed加载失败会显示提示，提升用户体验。
• 可扩展性：如果以后要加更多选项（比如是否显示摘要、作者），只需要在配置整理和处理函数里添加对应字段就行。

把这些代码替换掉你之前写的硬编码The Onion的部分，然后在选项页添加新的Feed配置，刷新仪表盘就能看到对应的小工具啦！

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