WP Manifestindependent plugin directory
manifest / content / footprint-map

足迹地图 WP RegistryMedium-severity findings · 1 findingOpen the reportB

A powerful WordPress plugin built to help users seamlessly record and showcase their travel footprints on an interactive map.

by Frank Loong · github.com/frank-loong/footprint-map · website

★ 5stars
29release downloads
≈10active sites
v1.2.3latest · 1 year ago

Install

Download Footprint-Map-v1.2.3.zip From the v1.2.3 release on GitHub, Jul 24, 2025

Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/frank-loong/footprint-map/releases/download/v1.2.3/Footprint-Map-v1.2.3.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/frank-loong/footprint-map ↗

足迹地图 WordPress 插件

一个功能强大的 WordPress 插件，旨在帮助用户在地图上优雅地记录和展示其旅行足迹。本项目主要由 AI 编程助手 Cursor 驱动开发。插件支持中国地图和世界地图两种视图，提供丰富的城市管理功能和美观的界面展示。

功能特性

🗺️ 地图展示

  • 双视图支持：中国地图（行政区划）和世界地图（全球视图）
  • 智能标签避让：自动计算标签位置，避免重叠
  • 响应式设计：适配各种屏幕尺寸
  • 高德地图集成：基于高德地图 API，提供流畅的交互体验

🏙️ 城市管理

  • 智能搜索：输入城市名称自动搜索匹配，支持中英文
  • 批量操作：支持 JSON 格式导入导出城市数据
  • 时间段记录：支持单日访问和访问时间段记录
  • 标签系统：为城市添加自定义标签，便于分类管理
  • 图片展示：支持多张图片，自动排列为网格布局

📸 图片功能

  • 多图支持：单张图片或多张图片（逗号分隔 URL）
  • 智能布局：根据图片数量自动调整网格排列
  • 全屏查看：点击图片可全屏查看，支持键盘导航
  • 响应式显示：图片自动适应卡片大小

💾 数据管理

  • WebDAV 备份：支持 WebDAV 服务器自动备份和恢复
  • JSON 导入导出：完整的数据备份和迁移功能
  • 实时同步：数据变更实时保存和同步

🎨 界面设计

  • 现代化 UI：简洁美观的界面设计
  • Toast 消息：优雅的消息提示系统
  • 分页显示：大量城市数据的分页管理
  • 搜索筛选：快速查找和筛选城市

Demo

Footprint Map Demo

Admin Screenshots / 后台截图

安装要求

  • WordPress: 5.0 或更高版本
  • PHP: 7.4 或更高版本
  • 浏览器: 支持现代 JavaScript 的浏览器（Chrome、Firefox、Safari、Edge 等）
  • 网络: 需要访问高德地图 API 和 WebDAV 服务器（可选）
  • 高德地图 API Key: 免费申请，用于地图服务

安装步骤

方法一：WordPress 后台安装（推荐）

  1. 在 WordPress 后台进入 "插件" → "安装插件"
  2. 点击 "上传插件" 按钮
  3. 选择下载的插件 zip 压缩包文件
  4. 点击 "立即安装"
  5. 安装完成后点击 "启用插件"

方法二：手动安装

  1. 下载插件文件到 wp-content/plugins 目录
  2. 在 WordPress 后台启用插件

配置说明

高德地图配置

  1. 访问 高德开放平台
  2. 注册账号并创建应用
  3. 获取 API Key 和安全密钥
  4. 在插件设置中填入相应信息

WebDAV 备份配置（可选）

  • 服务器地址：WebDAV 服务器 URL
  • 用户名密码：WebDAV 账号信息
  • 备份目录：指定备份文件存储目录

使用方法

添加城市

  1. 在管理界面点击 "添加城市"
  2. 输入城市名称，系统会自动搜索匹配
  3. 选择城市后自动填充编码和坐标
  4. 设置访问日期、标签、描述等信息
  5. 可选：添加图片 URL（支持多张，逗号分隔）
  6. 点击保存

地图展示

使用短代码 [footprint_map] 在页面中显示地图。

数据备份

  • 自动备份：配置 WebDAV 后自动备份
  • 手动导出：导出 JSON 格式数据文件
  • 数据恢复：从备份文件或 JSON 文件恢复

数据格式

城市数据结构

{
  "name": "城市名称",
  "adcode": "城市编码",
  "center": "经度,纬度",
  "opacity": 8,
  "tags": "标签1,标签2",
  "image": "图片URL1,图片URL2",
  "date_start": "2023-01-01",
  "date_end": "2023-01-05",
  "is_date_range": true,
  "desc": "描述内容"
}

图片 URL 格式

  • 单张图片：https://example.com/image.jpg
  • 多张图片：https://example.com/image1.jpg,https://example.com/image2.jpg

自定义样式

插件提供丰富的 CSS 类名，支持自定义样式：

/* 信息窗口样式 */
.city-info { }
.city-name { }
.city-tags { }
.city-description { }
.city-images { }

/* 图片网格样式 */
.city-image { }
.image-modal { }

/* 标签样式 */
.tag { }

常见问题

Q: 地图无法显示？ A: 请检查高德地图 API Key 配置是否正确，确保网络连接正常。

Q: 城市搜索无结果？ A: 插件内置了中国大陆、港澳台、海外地区数据，确保输入的城市名称正确。

Q: 图片无法显示？ A: 检查图片 URL 是否可访问，建议使用 HTTPS 链接。

Q: WebDAV 备份失败？ A: 检查 WebDAV 服务器配置，确保目录有写入权限。

技术支持与反馈

请注意： 这个项目是我在 AI 编程助手 Cursor 的帮助下开发和维护，作为一名科技爱好者，独立解决复杂技术问题的能力有限。因此，如果您遇到问题，我非常鼓励您也尝试利用AI工具来寻找解决方案，这本身也是一种有趣的探索！尽管如此，我依然会关注您提出的Issue，并尽力而为。

如果您在使用中遇到任何问题，或有任何改进建议，请通过以下方式联系：

参考文献

许可证

本插件采用 GPL v3 许可证。

致谢

  • 本项目的开发得到了 AI 编程助手 Cursor 的巨大帮助，它显著提升了开发效率和代码质量。
  • 感谢 高德开放平台 提供强大的地图服务。
  • 感谢 WordPress 社区提供了一个卓越的平台。
  • 感谢所有为本项目提供反馈和建议的用户。

项目结构

footprint-map/
├── footprint-map.php              # 主插件文件
├── uninstall.php                  # 卸载清理文件
├── README.md                      # 说明文档
├── CHANGELOG.md                   # 更新日志
├── assets/
│   ├── js/
│   │   ├── footprint-map.js       # 前端地图功能
│   │   └── footprint-map-admin.js # 管理界面功能
│   ├── css/
│   │   ├── footprint-map.css      # 前端样式
│   │   └── footprint-map-admin.css # 管理界面样式
│   └── data/
│       ├── China-Mainland.json    # 中国大陆城市数据
│       ├── China-HongKong.json    # 香港地区数据
│       ├── China-Macau.json       # 澳门地区数据
│       ├── China-Taiwan.json      # 台湾地区数据
│       └── Global-Overseas.json   # 海外国家数据
└── languages/
    └── footprint-map-zh_CN.po     # 中文语言文件

让每一次旅行都留下美好的足迹回忆

Star History

Star History Chart

Releases

3 releases. Each count is every asset in that release; expand a row for the breakdown.

Tag
Published
Assets
Downloads
v1.2.3 latest
Jul 24, 2025 1 year ago
Footprint-Map-v1.2.3.zip
17
v1.2.2
Jun 29, 2025 1 year ago
footprint-map.zip
7
v1.2.1
Jun 22, 2025 1 year ago
Footprint-Map-v1.2.1.zip
5

Active-site estimate ≈10 comes from the median of recent superseded releases. Method.

B grade

Security

足迹地图 1.2.3 · audited by WP Registry

Medium-severity findings.

1 medium
Audited release
1.2.3
Findings
1
Worst severity
medium
Content hash
96ccab3a9462b8e7fded91d3…

Findings

  • medium Stored XSS via unsanitized city JSON import and WebDAV restore

    xss_stored

    ajax_save_city / ajax_update_city sanitize name/adcode/tags with sanitize_text_field, desc with wp_kses_post, and image URLs with esc_url_raw. ajax_import_json does not: it json_decodes POST json (wp_unslash only) and appends each object onto footprint_map_cities. ajax_restore_webdav does the same with the WebDAV file body. get_cities_data() later feeds that option to every front-end page via wp_localize_script. footprint-map.js generateModernDescription returns city.desc verbatim when it includes the plugin's city-info wrapper, and AMap.InfoWindow uses that string as HTML content (event handlers in innerHTML run). Admin city-list rendering builds DOM with jQuery from unescaped city.name/adcode/tags, and editCity calls jQuery.html(city.desc). An administrator who imports a third-party 'city pack' JSON (or restores a tampered WebDAV backup) therefore stores markup that executes for all visitors of [footprint_map] and in wp-admin. Requires manage_options plus the admin nonce; not reachable by Subscriber.

    footprint-map.php:1204-1231

    Recommendation

    Sanitize imported and restored cities with the same rules as ajax_save_city (sanitize_text_field on name/adcode/tags/center, wp_kses_post on desc, esc_url_raw on each image URL, allowlist date/opacity). Reject objects missing required keys. In admin JS, build city-list nodes with textContent/jQuery .text() rather than interpolating fields into HTML strings; do not pass desc through jQuery.html() unless it has already been kses'd.

WP Registry hashes the installable build and reports on that exact bytes-for-bytes copy. Embargoed findings are withheld until they are disclosed, so a clean verdict means nothing public is outstanding. WP Manifest does not audit code itself.

Full report on WP Registry →