Lopwon Footprint 使用文档

2022-02-13


版本型号:Lopwon Footprint
适用程序:Typecho
皮肤类型:页面模板
模板作者:Lopwon
作者博客:Lopwon.com
发布页面:Lopwon.com/lopwon-footprint.html
官方演示:Lopwon Footprint演绎版
网友案例:(留言申请)
#Young Yet Blog

演绎版是在 Lopwon Footprint 基础上对功能的简化定制,仅限于有声地图。

我要使用:电邮 lopwon@qq.com


模板说明

Lopwon Footprint 是独立页面的自定义模板(非主题)。主要依托百度地图开放平台,通过在已发布的文章中,添加使用自定义字段和标签,选择性的把想要标记的文章呈现在地图上(没有标记的文章不会出现在地图上),实现“我的足迹”效果,同时,还可以新增和标记分类(去过的、想去的、目前在),也可以显示航迹线和点亮城市功能,且支持电脑端和移动端显示。

另有 ZBlog php 版本(等同于旧版 Lopwon Footprint v1.0),查看


模板更新

2023年09月09日 发布 Lopwon Footprint v2.0 新增标记分类(去过的、想去的、目前在);新增航迹线;新增点亮功能等,修正已知问题。

2022年02月14日 发布 Lopwon Footprint

使用方法

A 申请秘钥

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

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

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

3. 除“应用类型”选择“浏览器端”外,其他可以默认。

4. 完成创建后,会生成一串API秘钥(AK)。

B 部署文件

1. 将文件 Lopwon_Footprint.php 上传至目录 usr/themes 中的你的主题文件夹里。如:你的主题文件夹是 default,那么就上传至 usr/themes/default 里。

B 添加标签

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

1. 标签名称,填入“我的足迹”。也可以自定义,在以下(D 标记文章)时,要使用该标签。

2. 标签缩略名,必须填入 footprint,乱填无效!

C 配置页面

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

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

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

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

、标记有游记(可选项)

见以下(E 标记文章)。

、标记去过的(可选项)

见以下(D 添加内容)。

标记想去的(可选项)

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

D 添加内容(标记去过的)

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

1. 原理:每行内容由“两对”半角括号 () 组成,每行内容对应输出前台的坐标点信息。

2. 格式:(经度, 纬度)(简介)

3. 示例:(116.403963,39.915119)(我爱北京天安门)

4. 重要:这两对括号是半角括号,不是中文全角括号,其中,第二对括号中,可以使用 <br> 在前台输出换行,也可以使用 Html 标签和属性,如下:

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

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

E 标记文章(标记有游记)

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

1. 此编辑页面的“内容文本框”中,至少有一张图片,如果没有,则被 noPictrue.png 代替。

2. 此编辑页面右侧的“标签”里,请新增“我的足迹”标签,或者是以上步骤(B 添加标签)中自定义的标签。

3. 此编辑页面下方的“自定义字段”里,请新增字段。见下(F 添加坐标)。

F 添加坐标

1. 访问拾取坐标系统(http://api.map.baidu.com/lbsapi/getpoint/index.html)获取坐标。

2. 在需要标记文章的自定义字段里新增字段,其中,字段名称必须填入 footprint,乱填无效!字段值填入之前获取的坐标。格式为(经度,纬度),例116.403963,39.915119

G 使用技巧

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 把(我的足迹页面链接)替换为“我的足迹”页面的链接。

G 字段列表

是否必填

字段名称

  • mapAPI
  • mapCenter
  • mapZoom
  • mapStyle
  • mapCate
  • mapColor
  • mapTodo
  • mapHere
  • mapCity
  • mapFly
  • mapNum
  • footprint

说明

  • 在使用模板的独立页面创建字段,填入秘钥,查看 配置方法
  • 在使用模板的独立页面创建字段,自定义中心坐标,查看 配置方法
  • 在使用模板的独立页面创建字段,自定义缩放级别,查看 配置方法
  • 在使用模板的独立页面创建字段,自定义地图样式,查看 配置方法
  • 在使用模板的独立页面创建字段,自定义标记颜色,查看 配置方法
  • 在使用模板的独立页面创建字段,自定义类别名称,查看 配置方法
  • 在使用模板的独立页面创建字段,标记(想去的),查看 配置方法
  • 在使用模板的独立页面创建字段,标记(目前在),查看 配置方法
  • 在使用模板的独立页面创建字段,标记(点亮的),查看 配置方法
  • 在使用模板的独立页面创建字段,标记(航迹线),查看 配置方法
  • 在使用模板的独立页面创建字段,显示统计数,查看 配置方法
  • 注意:在使用模板的独立页面的内容文本框中,标记(去过的),查看 配置方法
  • 注意:在需要呈现在地图上的文章页面创建字段,标记(有游记),查看 配置方法
Store

34 条评论

  1. 点儿 21

    感觉又错过一个亿

    1. Lopwon Lopwon 博主
      @ 点儿

      哈哈,下次来早

      1. 点儿 21
        @ Lopwon

        看到不能错过,已下手

        1. Lopwon Lopwon 博主
          @ 点儿

          已发送。

  2. 雨停之後 3

    啊,来晚了么。

    1. Lopwon Lopwon 博主
      @ 雨停之後

      还有一个名额。

      1. 雨停之後 3
        @ Lopwon

        好的,我申请下呀?

        1. Lopwon Lopwon 博主
          @ 雨停之後

          已发送。

  3. S Seven 1

    主题有商业版的吗?

    1. Lopwon Lopwon 博主
      @ Seven

      测试完后本月内发布正式版,付费使用。

  4. g gzhhy 1

    申请测试,本人20多年的程序员

    1. Lopwon Lopwon 博主
      @ gzhhy

      已发送。

  5. 随望淡思 小伙伴34

    我博客也有一个类似的足迹地图,不过手工做的,简陋!也不具备通用性,没想到博主居然做成了Typecho插件,牛

    1. Lopwon Lopwon 博主
      @ 随望淡思

      哈哈,发现最后效果和你的差不多,只是实现的方法可能不太一样。

  6. 寻梦xunm 18

    留言申请

    1. Lopwon Lopwon 博主
      @ 寻梦xunm

      已发送。

准备下山 准备下山
Snapic Plus v5
使用 Lopwon POP 实现