普通视图

Marker Pro 使用教程

2025年9月15日 19:58

本文仅为插件使用帮助,插件更新内容请关注站内另一篇文章

本轮更新已接近尾声,因为加了不少功能,干脆写一篇说明书。

卸载插件会删除数据库数据,如果有自定义数据建议备份后再删除。

新版插件不再使用post_meta 存储关键数据,建议有任何危险操作先行备份数据库,避免因数据无法恢复白白浪费时间导入数据。

首次安装必须使用2.1.7及以上版本,否则无法正常创建数据表。

插件参数定义

Map BOX token 是使用mapbox 的必须条件,可在https://www.mapbox.com,获取自己的token 来使用。每月有免费5万次的调用次数,一般来说都够用了。

最小缩放和最大缩放是限制地图zoom 比例的,如果marker 是全球的,建议设置为1,如果仅为国内设置为3比较合适,另外如果只定位到城市级别,建议最大设置为13以内。

中心坐标为初始化时地图的中心位置,如果开始自适应则会根据marker 自动居中,该设置无效。

检索距离则是相关文章的参数,会自动检索距离内的相关文章,单位时千米。

目前插件可以高亮去过的国家,没有细化国内省份。

导入 / 导出

2.0 版本之后本插件和Google Maps 深度绑定,数据互通,可相互导入导出,都是傻瓜操作,这里就不介绍了。

地点管理

新版插件修改了逻辑,以前是以文章为基础,现在则是以marker 为基础,虽然文章页面提供了快捷入口,但还是建议在列表进行管理,可进行全字段管理,一些地名可能重复的原因搜索结果不准确,可增加更多关键词精准搜索结果,等数据正确后再修改名字即可。

地点里有一个类型,暂时默认为城市即可,此字段其实是为后续扩展使用,本轮更新并不会启用。

国旗展示

以下代码可显示当前文章绑定地点的国旗

<?php do_action('marker_pro_flag', get_the_ID()); ?>

插件已内置所有国家代码并自动匹配。

文章内插入地点

使用短代码

[marker id="7"]

在文章编辑页面直接提供了快捷方式,需使用经典tinymce 编辑器。

年度管理

读取的是文章发布时间,也可以在marker 处自定义时间,支持多年设置。

地图调用

方法和之前一样,不错现在支持传入参数进行设置,如果使用短代码则

[marker_pro filters=all,wish,done]

如果使用函数方式,则传参

marker_pro_init(filters='all,wish,done,plan')

仅支持all,wish,done,plan四种

因为后台可以初始状态,如果初始状态不在设置的类型中,则默认展示第一个。

相关文章

插件提供了一个云端上传的选项,开启后相关文章不再从本地获取数据,可以拉到其他用户的文章,当然其他用户也会拉到你的文章。云端程序部署在cloudflare,不保证国内用户可以正常使用。

Marker Pro 2.0

2025年9月3日 23:40

作为一款多年前的插件我推出之后就一直几乎没更新,最近有博友推出了开源版,鉴于本插件价格较为昂贵,本人直接做了个大版本更新,将体验感直接拉满。

为了提升使用体验,被迫做了破坏性更新,但提供了旧数据转换方法,可一键转换。

除了将官方SDK例行更新到最新版外,主要更新了以下内容

  • 现在单篇文章可绑定多个坐标
  • 可单独管理坐标,同时坐标支持多个设置参数
  • 在编辑文章的时候即可轻松选择已有或新建坐标
  • 坐标绑定文章之后将自动变更状态
  • 地图页面增加了更多的选项卡和数据统计面板
  • 优化了数据结构,增加了年份组和图片组输出
  • 改进了更为现代的样式
  • 优化云端相关文章逻辑,不再需要本地交换数据
  • 优化了渲染逻辑,切换缩放更加流畅

另外插件内置了一套国别系统,考虑到大部分人的旅行经历有限,本国别系统仅为尝试。

演示地址1

演示地址2

本插件的理念是深度绑定文章写作,而不是大而全的地图工具。

本次还对hugo 静态博客进行了支持,使用方法依然是只需要编辑文章markdown 文件,与插件设计理念保持一致。

演示地址

目前还在细微调整阶段,最新版本自行下载即可。

❌