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. 防腐剂 9

    大佬你好,我是在22年10月购买的,想升级一下,可以发个升级版给我吗?

    1. Lopwon Lopwon 博主
      @ 防腐剂

      已发送。

  2. 防腐剂 9

    已付款。

    1. Lopwon Lopwon 博主
      @ 防腐剂

      已发送。

  3. K Kanyikan 3

    已购买

    1. Lopwon Lopwon 博主
      @ Kanyikan

      已发送。

  4. c chenmo 16

    已买 不知道有没有QQ群之类的可以交流?

    1. Lopwon Lopwon 博主
      @ chenmo

      已发送。使用中如有问题,可以电邮或留言反馈。

  5. 小杨生活志 5

    这是 Z-BlogPHP 官方文档 docs.zblogcn.com/php/

    1. Lopwon Lopwon 博主
      @ 小杨生活志

      Lopwon Footprint for ZBlog 演示地址 http://snapic.cn/****/ZBlog/?id=5

      1. 小杨生活志 5
        @ Lopwon

        上架应用市场 我去购买

      2. 小杨生活志 5
        @ Lopwon

        太厉害了吧

    2. Lopwon Lopwon 博主
      @ 小杨生活志

      改天研究下。

  6. 小杨生活志 5

    挺好玩的 不过我网站用的是Zblog的 有Zblog的插件吗

    1. Lopwon Lopwon 博主
      @ 小杨生活志

      如果ZBlog支持添加自定义字段,应该可以修改代码适配。

      1. 小杨生活志 5
        @ Lopwon

        可以看看吗 如果能做的话 愿意付费修改

  7. 康露依 4

    可以增加支付宝的付款方式吗?
    微信不能截图扫码支付

    1. Lopwon Lopwon 博主
      @ 康露依

      看到付款了,模板已发送。

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