Lopwon Unlock 使用文档

版本型号：Lopwon Unlock
适用程序：Typecho
皮肤类型：页面模板
模板作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/lopwon-unlock.html
许可方式：MIT
官方演示：Lopwon Unlock

模板说明

模板 Lopwon Unlock 的作用是：依托高德地图开放平台，在地图上点亮标记去过的城市，类似于高德地图 APP 的（点亮城市），最深支持点亮区、县层级（默认市一级）的行政区范围，模板 Lopwon Unlock 可以作为我的旅行足迹，也可以作为单个旅行行程使用。

制作由来。在对模板 Lopwon Footprint 进行升级时，发现百度地图开放平台的（JS API 地点检索）接口，可以实现点亮城市的功能，可惜个人用户只有（100 次/日）的免费配额，鸡肋！遂把目光放在高德地图：每日有 5000 次的免费调用量，慷慨！

模板更新

2023年09月10日 发布 Lopwon Unlock

使用方法

A 申请秘钥

Lopwon Unlock 的使用，需要先申请高德地图开放平台提供的免费API秘钥（Key）。

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

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

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

4. 完成创建后，会生成一串API秘钥（Key）。

B 部署文件

1. 将文件 Lopwon_Unlock.php 上传至目录 usr/themes 中的你的主题文件夹里。

C 配置页面

后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。

1. 此编辑页面右侧的“自定义模板”里，请选择“Lopwon Unlock”。

2. 此编辑页面右侧的“高级选项”，在“公开度”选择“隐藏”后，可将此页面的标题不展示在某些主题的分类菜单里。

3. 此编辑页面下方的“自定义字段”，新增自定义字段，字段名称填入 mapAPI，乱填无效，字段值填入之前获取的（Key）。

D 添加内容

在此编辑页面的“内容文本框”中，严格按照以下格式要求输入内容，才能在前台正确输出。

1. 原理：每行内容对应输出（点亮）前台的一个行政区范围。

2. 格式：纯数字的行政区 adcode 编码 + 其他备注信息（可选）

3. 示例

    500000 重庆
    520111 贵阳市花溪区
    530100 昆明市
    530400
    530700

4. 重要：每行内容中，只允许 adcode 编码是纯数字，其他备注信息请勿使用任何数字形式的字符串。

5. 提示：下载官方行政区编码对照表 https://a.amap.com/lbs/static/file/AMap_adcode_citycode.xlsx.zip

F 使用技巧

1）自定义行政区数据层级。

1. 模板 Lopwon Unlock 默认的行政区数据层级是（市一级），即点亮的最小行政区范围是：市一级（如：昆明市）

2. 如果想细分最小行政区范围为：区/县层级（如：昆明市盘龙区、或昆明市石林县），如下操作：

① 打开文件 Lopwon_Unlock.php 搜索找到 depth 将数值 1 替换为 2

② 提示：如此设置后，如果点亮的行政区数量庞大时，将会影响操控的流畅度，出现卡顿现象。

2）如何把“点亮城市”页面嵌入指定页面？

1. 把以下代码添加至主题文章文件 post.php 的适当位置（如：文末）：

    <?php if ($this->cid == '文章cid编码') { echo '<iframe src="点亮城市页面链接" frameborder="0" width="100%" height="300"></iframe>'; } ?>

2. 请把以上代码中（文章cid编码）替换为你要调用"点亮城市"的页面 cid 把（点亮城市页面链接）替换为“点亮城市”页面的链接。