• 使用方法

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
  1. 注意:以上 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 晚)
  1. 提示:访问拾取坐标系统(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>'; } ?>
  1. 请把以上代码中(文章cid编码)替换为你要调用我的足迹的页面 cid 把(我的足迹页面链接)替换为“我的足迹”页面的链接。

I字段列表

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