我的足迹 (版本号：1.1.7)- emlog插件

前端截图

后台设置截图

文章编辑发布截图

一、插件用途

足迹地图用于把旅行、探店、摄影、生活记录等内容集中展示在一张独立地图上。访客可以缩放地图、查看图片点位、打开地点详情并跳转到关联文章，让普通文章形成可探索的地理足迹。

二、全部功能

1. 独立全屏地图页面

   • 前台以独立全屏页面展示，不受博客正文版式限制。
   • 默认访问地址：/?plugin=xiaoli_footprint。
   • 开启伪静态后也可访问：/plugin/xiaoli_footprint。
   • 自动绕过主题 PJAX，确保地图所需脚本和样式完整加载。
   • 控制栏带“博客首页”按钮，可直接返回站点首页。

2. 地图浏览功能

   • 支持标准地图和卫星地图切换。
   • 可单独开启路网图层与实时路况图层。
   • 支持鼠标滚轮、双击、拖动、键盘及加减按钮缩放。
   • 显示随缩放级别变化的比例尺。
   • 地图支持 3D 视角、建筑和地点标签。
   • 可在后台设置地图初始中心点和初始缩放等级（3—18）。

3. 足迹点位展示

   • 每条足迹显示为地图标记，有图片时直接显示缩略图，无图片时显示默认标记。
   • 地图低缩放级别下，距离约 10 公里以内的多个足迹会自动聚合，避免点位拥挤。
   • 点击聚合数字可自动放大并展开附近足迹。
   • 点击单个足迹后自动拉近地图并打开详情卡。
   • 详情卡可展示名称、分类、到访时间、地址、图片、描述和关联文章入口。
   • 图片失效时会自动隐藏或退回默认标记，避免破坏页面布局。

4. 后台可视化新增足迹

   • 支持搜索城市、景点、酒店或详细地址。
   • 可从搜索结果中直接选中位置。
   • 可直接点击地图选点。
   • 标记支持拖动微调位置。
   • 支持浏览器“使用当前位置”快速定位。
   • 选址后自动回填地址、经度和纬度，无需手工查询坐标。
   • 地图不可用时可展开“手动输入坐标”作为备用方式。

5. 足迹信息字段

   • 名称：足迹或地点名称。
   • 地址：地图选址后可自动填写，也可修改。
   • 分类：例如旅行、探店、摄影、生活记录等。
   • 到访时间：记录实际到访日期和时间。
   • 经度、纬度：由地图自动填写，也支持手动输入。
   • 图片 URL：作为地图点位缩略图和详情卡封面。
   • 描述：补充地点故事、行程或感受。
   • 文章 URL：点击详情卡后跳转到关联内容。
   • 排序：数值越小越靠前；数值相同时优先显示到访时间较新的记录。

6. 足迹列表管理

   • 后台集中显示全部足迹及总数。
   • 列表展示名称、分类、坐标、到访时间和排序值。
   • 点击“编辑”可重新修改全部字段和地图位置。
   • 点击“删除”并确认后可移除对应足迹。
   • 手工新增的足迹与文章自动生成的足迹都可以继续编辑。

7. 写文章时一键加入足迹

   • 文章编辑器下方提供“将这篇文章加入足迹地图”开关。
   • 勾选后可通过地点搜索、地图点击或当前位置完成选址。
   • 发布文章时自动创建对应足迹。
   • 编辑已绑定文章时，原足迹会自动载入并可重新选址。
   • 再次保存已绑定文章时自动更新同一条足迹，不会重复创建。
   • 自动获取文章标题作为足迹名称。
   • 自动获取文章分类作为足迹分类；没有分类时使用“未分类”。
   • 优先获取文章封面；没有封面时自动提取正文第一张图片。
   • 自动提取文章摘要；没有摘要时从正文生成描述，最多保留约 300 字。
   • 自动绑定当前文章的访问地址。
   • 自动使用文章发布时间作为到访时间。
   • 删除文章时，与该文章绑定的足迹会同步删除。

注意：编辑已绑定文章时，仅取消勾选不会自动删除现有足迹。如需移除，请到插件“足迹列表”中点击删除；删除整篇文章则会同步删除绑定足迹。