悦·Location — WordPress 评论 IP 归属地插件

张三   📍 中国 · 广东 · 深圳
评论内容...

John   🌐 United States · California · Los Angeles
Comment content...

yue-location/
├── yue-location.php       插件主文件（含核心查询类、主插件类、全局函数）
├── ip2region_v4.xdb       IPv4 离线数据库（ip2region xdb 格式）
├── ip2region_v6.xdb       IPv6 离线数据库（ip2region xdb 格式）
└── README.md              本说明文档

yue-location.php
├── YueLocation_Searcher_Util   工具类（IP解析、字节读取、头部加载）
├── YueLocation_Searcher        xdb 搜索器（支持向量索引缓存、文件流两种模式）
├── Yue_Location                插件主类（WordPress 集成、设置管理、钩子注册）
│   ├── init()                  注册所有 WordPress 钩子
│   ├── query_location()        核心查询方法（返回结构化数组）
│   ├── format_location()       格式化归属地为 HTML 文本
│   ├── filter_comment_author() 前台评论钩子回调
│   ├── save_post_location()    文章发布者定位保存
│   └── render_settings_page() 后台设置页面渲染
└── 全局函数
    ├── Yue_get_location()
    ├── the_Yue_location()
    ├── Yue_get_location_raw()
    ├── Yue_get_location_by_comment()
    ├── Yue_get_post_location()
    └── the_Yue_post_location()

// 示例
$html = Yue_get_location( '202.96.134.133' );
// 返回：<span class="yue-location"><svg ...></svg>中国 · 广东 · 深圳</span>

the_Yue_location( get_comment_author_IP() );

[
    'country'  => '中国',    // 国家名称
    'province' => '广东省',  // 省份名称
    'city'     => '深圳市',  // 城市名称
    'isp'      => '电信',    // ISP/运营商
    'iso'      => 'CN',      // ISO Alpha-2 国家代码
    'is_v6'    => false,     // 是否为 IPv6 地址
]

echo Yue_get_location_by_comment( get_comment() );
echo Yue_get_location_by_comment( 42 ); // 通过评论 ID

echo Yue_get_post_location();       // 当前文章
echo Yue_get_post_location( 123 );  // 指定文章 ID

the_Yue_post_location(); // 在模板中直接输出

<div class="comment-author">
    <?php comment_author(); ?>
    <?php if ( function_exists( 'the_Yue_location' ) ) : ?>
        <?php the_Yue_location( get_comment_author_IP() ); ?>
    <?php endif; ?>
</div>

<?php if ( function_exists( 'Yue_get_location_raw' ) ) : ?>
    <?php
    $loc = Yue_get_location_raw( get_comment_author_IP() );
    if ( $loc ) {
        $parts = array_filter( [
            $loc['country'],
            $loc['province'],
            $loc['city'],
        ] );
        echo '<span class="my-location">' . esc_html( implode( ' · ', $parts ) ) . '</span>';
    }
    ?>
<?php endif; ?>

<?php if ( function_exists( 'Yue_get_location_by_comment' ) ) : ?>
    <?php echo Yue_get_location_by_comment( get_comment() ); ?>
<?php endif; ?>

<div class="entry-meta">
    <span class="posted-on"><?php the_date(); ?></span>
    <span class="comments-link"><?php comments_popup_link(); ?></span>
    <?php if ( function_exists( 'the_Yue_post_location' ) ) : ?>
        <?php the_Yue_post_location(); ?>
    <?php endif; ?>
</div>

<?php
// 读取完整预存数据
$data = get_post_meta( get_the_ID(), '_Yue_location_data', true );
if ( $data ) {
    echo '发布 IP：' . esc_html( $data['ip'] );
    echo '国家：'   . esc_html( $data['location']['country'] );
    echo '发布于：' . esc_html( $data['saved_at'] );
}

// 仅读取格式化文本
$text = get_post_meta( get_the_ID(), '_Yue_location_text', true );
if ( $text ) {
    echo '发布于 ' . esc_html( $text );
}
?>

<?php if ( function_exists( 'Yue_get_location' ) ) : ?>
    <?php
    // 查询当前访问者 IP
    $visitor_ip = $_SERVER['REMOTE_ADDR'];
    echo Yue_get_location( $visitor_ip );

    // 查询指定 IP
    echo Yue_get_location( '8.8.8.8' );
    ?>
<?php endif; ?>

/* 修改归属地文字颜色 */
.yue-location {
    color: #888;
    font-size: 0.85em;
}

/* 修改图标颜色 */
.yue-icon {
    color: #c8655e;
    opacity: 0.8;
}

/* 修改 IPv6 徽章样式 */
.yue-ipv6-badge {
    background: #e3f2fd;
    color: #1565c0;
}

/* 文章 meta 归属地样式 */
.yue-post-location-meta {
    background: #fff5f4;
    border-color: #c8655e;
    color: #c8655e;
}

国家|省份|城市|ISP|ISO-Alpha2代码

用户访问页面
    │
    ├─ 前台评论显示
    │   └─ get_comment_author 过滤器触发
    │       └─ 读取评论 IP → 自动判断 IPv4/v6
    │           └─ 加载对应 .xdb 数据库（向量索引缓存）
    │               └─ 二分查找定位 → 解析归属地字段
    │                   └─ 按配置格式化 → 输出 HTML
    │
    └─ 文章发布者定位
        └─ save_post 钩子触发（首次发布时）
            └─ 获取发布者 IP
                └─ 查询归属地 → 写入 post_meta
                    └─ 写入文章标签（📍前缀）
                        └─ 前台读取 post_meta 缓存展示