Lopwon Footprint 使用文档

版本型号：Lopwon Footprint
适用程序：Typecho
皮肤类型：页面模板
模板作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/lopwon-footprint.html
官方演示：Lopwon Footprint，演绎版

  演绎版是在 Lopwon Footprint 基础上对功能的简化定制，音频播放不属于  Lopwon Footprint 内置功能，请知悉。

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

模板说明

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

模板更新

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 中的你的主题文件夹里。

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

2. 注意：以上 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. 重要：这两对括号是半角括号，不是中文全角括号，其中，第二对括号中，可以使用 <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）获取坐标。

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 说明 在使用模板的独立页面创建字段，填入秘钥。 在使用模板的独立页面创建字段，自定义中心坐标。 在使用模板的独立页面创建字段，自定义缩放级别。 在使用模板的独立页面创建字段，自定义地图样式。 在使用模板的独立页面创建字段，自定义类别名称。 在使用模板的独立页面创建字段，自定义标记颜色。 在使用模板的独立页面创建字段，标记（想去的）。 在使用模板的独立页面创建字段，标记（目前在）。 在使用模板的独立页面创建字段，标记（点亮的）。 在使用模板的独立页面创建字段，标记（航迹线）。 在使用模板的独立页面创建字段，显示统计数。 注意：在使用模板的独立页面的内容文本框中，标记（去过的）。 注意：哪篇文章需要呈现在地图上，就在对应文章编辑页创建字段，标记（有游记）。