Lopwon IP Loc 使用文档

08月29日

demo-lopwon-iploc.jpg

版本型号：Lopwon IP Loc
适用程序：Typecho
皮肤类型：插件
插件作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/attachment/3784/
许可方式：自用插件，不做分享。

插件说明

插件 Lopwon IP Loc 的作用是：使用百度地图、高德地图、腾讯地图提供的免费 IP 定位服务，在前台和后台同时显示评论者的 IP 属地。

相较于之前制作的 Lopwon IP 插件，插件 Lopwon IP Loc 使用了缓存功能，及新增机制，如下：

1. 一键生成所有评论 IP 所对应的属地名称，并存储为缓存文件，减少 API 请求；

2. 对于新评论 IP 则使用实时 API 请求，并将数据追加到缓存文件中；

3. 当前 API 服务商的每日配额到顶后，自动切换为下一位服务商，无需手动操作，当然，也可以指定哪家服务商；

4. 可以自定义无需显示 IP 属地的评论者，比如博主自己；

5. 可自选前端、后端显示 IP 属地。
插件更新

**2024年08月29日** 发布 Lopwon IP Loc
使用方法

A 部署插件

1. 将压缩包里的文件夹 LopwonIPloc 及其内部的所有文件，上传至目录 usr/plugins 中。

2. 后台》控制台》插件，找到 Lopwon IP Loc 并启用。

B 调用插件

一、默认情况：

1. 打开文件 var/Widget/Comments/Archive.php 搜索找到 threadedCommentsCallback 评论回调函数，在适当位置（如：第 350 行的 </a> 之后，即评论时间之后）添加如下代码：


    <?php $this->location(); // Lopwon IP Loc ?>

二、特殊情况：

1. 某些主题会对评论列表使用 threadedComments 进行自定义，此时，需要在其函数体内适当位置添加以上代码，注意匹配参数 $this

2. 例如：你的主题使用 threadedComments($aaa, $b) 对评论列表进行自定义时，则调用插件的代码为：


    <?php $aaa->location(); // Lopwon IP Loc ?>

C 申请秘钥

Lopwon IP Loc 的使用，需要先申请地图开放平台提供的免费API秘钥。

一、百度地图：

1. 访问百度地图开放平台（https://lbsyun.baidu.com/）注册后登陆“控制台”。

2. 应用管理》我的应用》创建应用，需要实名认证！

3. 除“应用类型”选择“服务端”，和“IP白名单”填入 0.0.0.0/0 外，其他可以默认。

4. 完成创建后，会生成一串API秘钥（AK），将其填入插件设置里的（百度地图 API 秘钥 AK）中。

二、高德地图

1. 访问高德地图开放平台（https://lbs.amap.com/）注册后登陆“控制台”。

2. 应用管理》我的应用》创建新应用》添加Key，需要实名认证！

3. 除“服务平台”选择“Web服务”外，其他可以默认。

4. 完成创建后，会生成一串API秘钥（Key），将其填入插件设置里的（高德地图 API 秘钥 Key）中。

三、腾讯地图

1. 访问腾讯地图开放平台（https://lbs.qq.com/）注册后登陆“控制台”。

2. 应用管理》我的应用》创建应用》添加Key，需要实名认证！

3. 除“启用产品”勾选“WebServiceAPI”外，其他可以默认。

4. 完成创建后，会生成一串API秘钥（Key），将其填入插件设置里的（腾讯地图 API 秘钥 Key）中。

D 配置插件

后台》控制台》插件，找到 Lopwon IP Loc 并设置，依喜好设置即可。

E 使用技巧

1. 待补充……
store