一为导航热榜页面空白的解决方法：免费JSON热榜接口配置指南

//ionews.top/api/get.php?rule_id=100000&key=xxxx

{"state":0,"title":"iotheme","subtitle":"续期",
 "data":[{"title":"服务状态不可用！","hot":"¥98"}]}

https://uapis.cn/api/v1/misc/hotboard?type=weibo

{
  "type": "weibo",
  "update_time": "2026-10-06T10:36:05.868Z",
  "list": [
    {"index":1, "title":"热搜词", "url":"https://s.weibo.com/...", "hot_value":"1435288", "extra":{}}
  ]
}

baidu 36kr juejin bilibili xiaohongshu history sspai weibo zhihu huxiu
smzdm qq-news douyin kuaishou ithome toutiao tieba hupu v2ex acfun
csdn sina thepaper weread nodeseek hellogithub coolapk 51cto jianshu ifanr

36kr、smzdm、qq-news、ithome、toutiao、v2ex、thepaper、51cto、jianshu、ifanr、coolapk

https://你的站点/wp-admin/admin-ajax.php?action=get_hot_data&type=json&id=1

{"state":1,"title":"微博热搜榜","subtitle":"热度","type":"hot",
 "data":[{"index":1,"title":"...","link":"...","hot":"..."}]}

热榜-fix.php?key=你的随机串&step=probe   ← 只检测，不改动任何数据
热榜-fix.php?key=你的随机串&step=run     ← 检测 + 写入 + 端到端验证
热榜-fix.php?key=你的随机串&step=run&self=1  ← 写入后自动删除本文件

/**
 * OneNav 热榜免费源批量配置脚本
 *
 * 放到：wp-content/themes/你的主题目录/
 * 用法：
 *   检测（不改动）： 热榜-fix.php?key=xxx&step=probe
 *   写入配置：      热榜-fix.php?key=xxx&step=run
 *   写入后自毁：    热榜-fix.php?key=xxx&step=run&self=1
 *
 * ⚠️ 用完必须删除本文件
 */

/* 1) 换成你自己的随机串（别用原文，也别外传） */
$KEY = 'put-your-own-random-string-here';

/* 2) 主题目录 → 站点根目录，层级不对就自己调 */
require dirname(__FILE__) . '/../../../wp-load.php';

if (!isset($_GET['key']) || !hash_equals($KEY, (string) $_GET['key'])) {
    http_response_code(403);
    exit('403');
}
/* 兜底：确保主题的解析函数已加载 */
if (!function_exists('io_get_free_hot_data') || !function_exists('get_json_hot_data')) {
    require get_theme_file_path('/inc/hot-search.php');
}
if (!function_exists('io_get_free_hot_data') || !function_exists('get_json_hot_data')) {
    exit('主题热榜函数加载失败');
}
@set_time_limit(600);
header('Content-Type: text/html; charset=utf-8;');

$UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36';

/**
 * 3) 卡片方案：一行一张卡，顺序 = 页面卡片顺序 = 热榜ID（从 1 开始）
 *    n     卡片标题（会覆盖页面上的名字）
 *    t     接口的平台 type
 *    hot   热度节点，该平台没有热度就填 ''
 *    link  链接节点，没链接就填 'title' 配合 lr 兜底
 *    lr    链接补全模板（%s% 会被 link 的值替换），没有就填 ''
 *    keep  true=保留原卡片名与图标，false=用上面的 n 改名并换默认图标
 */
$PLAN = array(
    array('n' => '百度热点',      't' => 'baidu',       'hot' => 'hot_value', 'link' => 'url', 'lr' => '', 'keep' => true),
    array('n' => '36氪人气榜',    't' => '36kr',        'hot' => '',          'link' => 'url', 'lr' => '', 'keep' => true),
    array('n' => '微博热搜榜',    't' => 'weibo',       'hot' => 'hot_value', 'link' => 'url', 'lr' => '', 'keep' => true),
    array('n' => '知乎热榜',      't' => 'zhihu',       'hot' => 'hot_value', 'link' => 'url', 'lr' => '', 'keep' => true),
    array('n' => '历史上的今天',   't' => 'history',     'hot' => '',          'link' => 'title', 'lr' => 'https://www.baidu.com/s?wd=%s%', 'keep' => true),
    // ... 按需继续加，最多 30 行
);

/* ========== 以下不用改 ========== */

function hnf_sources($plan)
{
    $out = array();
    foreach ($plan as $p) {
        $out[] = array(
            'name'         => $p['n'],
            'subtitle'     => $p['hot'] ? '热度' : '',
            'url'          => 'https://uapis.cn/api/v1/misc/hotboard?type=' . $p['t'],
            'datas'        => 'list',
            'title'        => 'title',
            'link'         => $p['link'],
            'hot'          => $p['hot'],
            'link_regular' => $p['lr'],
            'cache'        => 60,
            'request_type' => 'get',
        );
    }
    return $out;
}

/* 用主题自己的解析管线试跑，保证写进去一定能跑通 */
function hnf_probe($src, $ua)
{
    $r = wp_remote_get($src['url'], array('timeout' => 20, 'redirection' => 5, 'headers' => array('User-Agent' => $ua)));
    if (is_wp_error($r)) {
        return array(false, 0, $r->get_error_message());
    }
    if ((int) wp_remote_retrieve_response_code($r) !== 200) {
        return array(false, 0, 'HTTP ' . wp_remote_retrieve_response_code($r));
    }
    $json = json_decode(wp_remote_retrieve_body($r), true);
    if (!is_array($json)) {
        return array(false, 0, '返回不是 JSON');
    }
    $rows = io_get_free_hot_data($json, $src['datas']);
    if (!is_array($rows) || !$rows) {
        return array(false, 0, '数据节点 ' . $src['datas'] . ' 取不到');
    }
    $res = get_json_hot_data($rows, $src);
    if (empty($res['state']) || empty($res['data'])) {
        return array(false, 0, '格式化为空');
    }
    return array(true, count($res['data']), $res['data'][0]['title']);
}

$step    = isset($_GET['step']) ? (string) $_GET['step'] : 'probe';
$sources = hnf_sources($PLAN);

echo '
热榜免费源配置
';

/* ---- 步骤1：探测 ---- */
echo '
步骤1 探测（走主题自己的解析代码）
';
echo '';
foreach ($PLAN as $i => $p) {
    list($ok, $num, $msg) = hnf_probe($sources[$i], $UA);
    printf(
        '',
        $i + 1,
        htmlspecialchars($p['n'], ENT_QUOTES, 'UTF-8'),
        htmlspecialchars($p['t'], ENT_QUOTES, 'UTF-8'),
        $ok ? '可用' : '' . htmlspecialchars($msg, ENT_QUOTES, 'UTF-8') . '',
        $ok ? $num : '-',
        htmlspecialchars(mb_substr((string) $msg, 0, 40, 'UTF-8'), ENT_QUOTES, 'UTF-8')
    );
}
echo '
#
卡片
类型
状态
条数
首条
%d
%s
%s
%s
%s
%s
';

if ($step === 'probe') {
    echo '
仅检测，未改动。确认后访问：热榜-fix.php?key=' . htmlspecialchars($KEY, ENT_QUOTES, 'UTF-8')
        . '&step=run
';
    exit;
}

/* ---- 步骤2：写入 ---- */
$theme = get_option('io_get_option');
if (!is_array($theme)) {
    $theme = array();
}
$cards = (isset($theme['hot_home_list']) && is_array($theme['hot_home_list'])) ? $theme['hot_home_list'] : array();
if (!$cards && function_exists('all_topnew_list')) {
    $cards = all_topnew_list();
}

/* 备份原配置（改坏了照它还原） */
echo '
原配置备份（先复制保存）：
'</span><br><span class="line">    . htmlspecialchars(wp_json_encode($cards, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT), ENT_QUOTES, 'UTF-8')</span><br><span class="line">    . '';

/* 写 JSON 源 */
$hot = get_option('io_hot_search_list');
if (!is_array($hot)) {
    $hot = array();
}
$hot['json_list'] = $sources;
if (!isset($hot['rss_list']) || !is_array($hot['rss_list'])) {
    $hot['rss_list'] = array();
}
update_option('io_hot_search_list', $hot);

/* 写卡片：类型→json，热榜ID→序号 */
$ico  = get_theme_file_uri('/assets/images/hot_ico.png');
$n    = 0;
foreach ($cards as $i => $card) {
    if (!isset($PLAN[$i])) {
        break;
    }
    $card['hot_type'] = 'json';
    $card['rule_id']  = (string) ($i + 1);
    if (empty($PLAN[$i]['keep'])) {
        $card['name']        = $PLAN[$i]['n'];