使用方法

A 申请秘钥

Lopwon Footprint 的使用，需要先申请百度地图开放平台提供的免费API秘钥（AK）。

1.访问百度地图开放平台（https://lbsyun.baidu.com/）注册后登陆“控制台”。
2.应用管理》我的应用》创建应用，需要实名认证！
3.除“应用类型”选择“浏览器端”外，其他可以默认。
4.完成创建后，会生成一串API秘钥（AK）。

B 部署文件

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

C 添加标签后台》管理》标签，新增标签，该标签将用于标记需要呈现在地图上的文章。

1.标签名称，填入“我的足迹”。也可以自定义，在以下（F 标记文章）时，要使用该标签。
2.标签缩略名，必须填入 footprint，乱填无效！

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

1.此编辑页面右侧的“自定义模板”里，请选择“Lopwon Footprint”。
2.此编辑页面右侧的“高级选项”，在“公开度”选择“隐藏”后，可将此页面的标题不展示在某些主题的分类菜单里。
3.此编辑页面下方的“自定义字段”，请按以下介绍新增自定义字段：

一、填入秘钥（必选项）。

1.新增自定义字段，字段名称填入 mapAPI，乱填无效，字段值填入之前获取的（AK）。

二、中心坐标（可选项）。作用是：以自定义的坐标作为地图的视窗中心，如果不创建该字段，则默认为中卫市的坐标。

1.新增自定义字段，字段名称填入 mapCenter，乱填无效，字段值填入格式为（经度,纬度）的坐标值，例116.403963,39.915119
2.提示：访问拾取坐标系统（http://api.map.baidu.com/lbsapi/getpoint/index.html）获取坐标。

三、缩放级别（可选项）。作用是：以自定义的级别作为地图的展示级别，如果不创建该字段，则默认为 5 级。

1.新增自定义字段，字段名称填入 mapZoom，乱填无效，字段值填入 3~19 的任意整数，数值越大，级别越大。

四、地图样式（可选项）。作用是：以自定义的样式作为地图的展示样式，如果不创建该字段，则使用默认。

1.访问百度地图开放平台（https://lbsyun.baidu.com/）登陆“控制台”。
2.特色服务平台》个性化地图》新建，根据喜好自定义地图，发布样式后将获取样式（ID）。
3.新增自定义字段，字段名称填入 mapStyle，乱填无效，字段值填入以上获取的（ID）。

五、类别名称（可选项）。
作用是：以自定义的名称作为地图的类别名称，如果不创建该字段，则使用默认名称。

1.新增自定义字段，字段名称填入 mapCate，乱填无效，字段值填入 6 个类别名称，并以半角逗号隔开，
格式如下：有游记,去过的,想去的,当前在,点亮的,航迹线

示例
游记,去过,想去,当前,点亮,航迹
六、标记颜色（可选项）。作用是：以自定义的颜色作为地图的标记颜色，如果不创建该字段，则使用默认颜色。

1.新增自定义字段，字段名称填入 mapColor，乱填无效，字段值填入 6 个合法的 CSS 颜色值（如：red 或 #ff0000），并以半角逗号隔开，格式如下：

    lime,cyan,pink,yellow,blue,orange
    或者（十六进制型）
    #00ff00,#00ffff,#ffc0cb,#ffff00,#0000ff,#ffa500
    或者（组合型）
    lime,#00ffff,#ffc0cb,yellow,blue,#ffa500

注意：以上 6 个颜色值按顺序依次自定义以下类别的颜色：

有游记,去过的,想去的,目前在,点亮的,航迹线

七、标记有游记（可选项）

见以下（F 标记文章）。

八、标记去过的（可选项）

见以下（E 添加内容）。

九、标记想去的（可选项）

1.新增自定义字段，字段名称填入 mapTodo，乱填无效，字段值填入以下格式内容，其中，每行一条标记信息，使用竖线 | 分隔地名和坐标值（经度,纬度）：
想去的地方|经度,纬度

示例

天安门|116.403963,39.915119
长城|116.024067,40.362639

十、标记目前在（可选项）

1.新增自定义字段，字段名称填入 mapHere，乱填无效，字段值填入以下格式内容，其中，仅限输入一条标记信息，使用竖线 | 分隔地名和坐标值（经度,纬度）：
目前所在地|经度,纬度

示例

    昆明|102.841743,24.888632

十一、标记点亮的（可选项）

1.新增自定义字段，字段名称填入 mapCity，乱填无效，字段值填入省、直辖市、地级市、或县的名称：

    广西自治区,广东省,海南省
    或者（城市型）
    南宁市,广州市,海口市
    或者（组合型）
    海南省,海口市,三亚市

注意：名称必须完全匹配，例如，使用（云南省）勿用（云南）。

提示：点亮城市的功能，使用百度地图开放平台的（JS API 地点检索）接口，个人用户有（100
次/日）的免费配额限制，超出后，该功能会暂时失效，次日恢复。

十二、标记航迹线（可选项）

1.新增自定义字段，字段名称填入 mapFly，乱填无效，字段值填入以下格式内容，其中，每行一条标记信息，使用竖线 | 分隔地名和坐标值（经度,纬度）：
地名A-地名B-地名C|地名A坐标|地名B坐标|地名C坐标

示例

    北京-杭州-台湾|116.432045,39.910683|120.129721,30.314429|121.491121,25.127053
    拉萨-昆明|91.176733,29.658734|102.837718,24.88601

十三、显示统计数（可选项）

1.新增自定义字段，字段名称填入 mapNum，乱填无效，字段值填入 yes

E 添加内容（标记去过的）
继续在此编辑页面的“内容文本框”中，严格按照以下格式要求输入内容，才能在前台正确输出。

1.原理：每行内容由“两对”半角括号 () 组成，每行内容对应输出前台的坐标点信息。
2.格式：(经度, 纬度)(简介)
3.示例：(116.403963,39.915119)(我爱北京天安门)
4.重要：这两对括号是半角括号，不是中文全角括号，其中，第二对括号中，可以使用
; 在前台输出换行，也可以使用 Html 标签和属性，如下：

    (116.403963,39.915119)(我爱北京天安门<br>天安门上太阳升)
    (116.024067,40.362639)(事件：<a href="http://www.lopwon.com">不到长城非好汉<br>时间：2023年06月13日<br>时长：宿 1 晚)

5.提示：访问拾取坐标系统（http://api.map.baidu.com/lbsapi/getpoint/index.html）获取坐标。

F 标记文章（标记有游记）
后台》管理》文章，打开或新建你需要呈现在地图上的文章，除以下提到的事项外，其余正常操作即可。

1.此编辑页面的“内容文本框”中，至少有一张图片，如果没有，则被 noPictrue.png 代替。
2.此编辑页面右侧的“标签”里，请新增“我的足迹”标签，或者是以上步骤（C 添加标签）中自定义的标签。
3.此编辑页面下方的“自定义字段”里，请新增字段。见下（G 添加坐标）。

G 添加坐标

1.访问拾取坐标系统（http://api.map.baidu.com/lbsapi/getpoint/index.html）获取坐标。
2.在需要标记文章的自定义字段里新增字段，其中，字段名称必须填入 footprint，乱填无效！字段值填入之前获取的坐标。格式为（经度,纬度），例116.403963,39.915119

H 使用技巧
1）如何默认加载卫星地图？

1.搜索文件 Lopwon_Footprint.php 查找 var map = new BMap.Map
2.将 mapType: BMAP_SATELLITE_MAP, 的注释解除即可。

2）如何把“我的足迹”页面嵌入指定页面？

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

    <?php if ($this->cid == '文章cid编码') { echo '<iframe src="我的足迹" frameborder="0" width="100%" height="300"></iframe>'; } ?>

2.请把以上代码中（文章cid编码）替换为你要调用我的足迹的页面 cid 把（我的足迹页面链接）替换为“我的足迹”页面的链接。

I字段列表

是否必填	字段名称	说明
是	mapAPI	在使用模板的独立页面创建字段，填入秘钥。
否	mapCenter	在使用模板的独立页面创建字段，自定义中心坐标。
否	mapZoom	在使用模板的独立页面创建字段，自定义缩放级别。
否	mapStyle	在使用模板的独立页面创建字段，自定义地图样式。
否	mapCate	在使用模板的独立页面创建字段，自定义类别名称。
否	mapColor	在使用模板的独立页面创建字段，自定义标记颜色。
否	mapTodo	在使用模板的独立页面创建字段，标记（想去的）。
否	mapHere	在使用模板的独立页面创建字段，标记（目前在）。
否	mapCity	在使用模板的独立页面创建字段，标记（点亮的）。
否	mapFly	在使用模板的独立页面创建字段，标记（航迹线）。
否	mapNum	在使用模板的独立页面创建字段，显示统计数。
否	无	注意：在使用模板的独立页面的内容文本框中，标记（去过的）。
否	footprint	注意：哪篇文章需要呈现在地图上，就在对应文章编辑页创建字段，标记（有游记）。

TopicsPostsDate