AI摘要：MyTrack 是一个为 Typecho 博客系统开发的足迹记录插件，允许用户在地图上标记旅行足迹，关联文章和图片。基于高德地图 API，提供直观的地图展示和便捷管理功能。插件售价 10 元，收入将捐赠给韩红基金会。购买后通过邮件发送订单截图以获取插件和捐款情况。插件功能包括地图展示、足迹管理、文章关联、图片展示等，支持数据导入导出和响应式设计。安装简单，使用方便，适合喜欢记录旅行足迹的用户。

MyTrack 是一个为 Typecho 博客系统开发的足迹记录插件，允许用户在地图上标记自己的旅行足迹，并关联相关的文章和图片。插件基于高德地图 API，提供了直观的地图展示和便捷的管理功能。

插件目前开启售卖，价格定为 10 元，收入款全部捐给韩红基金会，并且公布捐款情况，购买请移步到文末，购买后请把订单截图通过邮件发送到我邮件 hi@wangdaodao.com，我会在当天处理邮件，把插件及捐款情况回复在邮件中。购买前如果有疑问，也可以发邮件与我沟通，避免引起误会。

捐款证书类似这样，所以邮件中最好能附带姓名，我可以按照姓名来捐款。

我相信，购买插件的都是有爱心的朋友，所以还希望大家使用后帮忙宣传一下。

插件截图

效果请查看：https://wangdaodao.com/track.html

功能特点

• 地图展示：基于高德地图 API，支持 2D/3D 视图切换和 11 种地图主题，支持动态明暗主题配置
• 足迹管理：添加、编辑、删除足迹点，记录描述、时间、坐标等信息
• 文章关联：可以将足迹点与博客文章关联，方便读者了解旅行背景
• 图片展示：支持为每个足迹点添加多张图片（前台有灯箱效果），丰富足迹内容，
• 自动图片提取：自动从关联的文章中提取图片，无需手动添加
• 数据导入导出：支持 JSON 格式的数据导入导出
• 响应式设计：适配不同屏幕尺寸，提供良好的移动端体验
• 缓存机制：支持数据缓存，提高前台访问速度

安装说明

1. 将 MyTrack 文件夹上传到 Typecho 的 usr/plugins/ 目录
2. 在 Typecho 后台的"插件管理"页面启用 MyTrack 插件
3. 在插件设置页面配置高德地图 API 密钥
4. 根据需要调整其他设置选项

使用方法

前台展示

1. 在模板文件中添加以下代码以显示足迹地图：

   <?php MyTrack_Widget::output(); ?>

2. 您还可以根据用户的偏好或其他条件动态切换主题：

   <?php
   // 根据时间切换主题
   $hour = date('H');
   $theme = ($hour >= 18 || $hour < 6) ? 'dark' : 'normal';
   MyTrack_Widget::output($theme);
   
   // 根据用户设置切换主题
   $userTheme = isset($_COOKIE['user_map_theme']) ? $_COOKIE['user_map_theme'] : 'normal';
   MyTrack_Widget::output($userTheme);
   ?>

后台管理

1. 在 Typecho 后台的"控制台"菜单中找到"我的足迹"选项
2. 点击"添加足迹"按钮创建新的足迹点

3. 填写足迹信息：

   • 经度：使用高德地图经纬度选择工具获取
   • 纬度：使用高德地图经纬度选择工具获取
   • 地点：足迹点的地点名称
   • 文章 CID：关联的博客文章 CID，系统将自动获取文章标题和图片
   • 时间：旅行时间
   • 描述：足迹点的描述信息
   • 标签：用逗号分隔的标签列表，后续用于分类和筛选
   • 图片链接：相关图片的 URL，多个 URL 用逗号分隔
4. 保存足迹信息

数据导入导出

1. 在管理页面点击"导出JSON"按钮
2. 点击"导入"按钮，上传JSON格式文件

3. JSON格式示例：

   [
    {
   "latitude": 39.9042,
   "longitude": 116.4074,
   "location": "北京市东城区天安门广场",
   "description": "北京天安门",
   "article_cid": 1,
   "article_title": "天安门游记",
   "article_link": "https://example.com",
   "image_links": "https://example.com/image1.jpg,https://example.com/image2.jpg",
   "travel_time": "2025-10-27",
   "created_at": "2025-11-17 14:37:39",
   "updated_at": "2025-11-21 05:14:53",
   "tags": "景点,文化,历史"
    }
   ]

配置选项

在插件设置页面，您可以配置以下选项：

• 高德地图 API 密钥：必填项，用于地图展示和地理编码功能
• 默认缩放级别：控制地图的默认缩放级别（3-18）
• 默认视图模式：选择 2D 或 3D 视图模式
• 默认地图主题：选择地图的显示主题
• 显示前台足迹地图：控制是否在前台显示足迹地图
• 缓存时间（天）：设置数据缓存的有效期，单位为天，0 表示关闭缓存
• 启用点聚合功能：启用后，当地图上标记点较多时会自动聚合，提高性能和可读性
• 空内容标记点颜色：设置空内容标记点的颜色
• 有内容标记点颜色：设置有内容标记点的颜色
• 聚合标记点颜色1：设置小规模聚合标记点的颜色
• 聚合标记点颜色2：设置中等规模聚合标记点的颜色
• 聚合标记点颜色3：设置大规模聚合标记点的颜色

高德地图 API 密钥获取

1. 访问高德开放平台
2. 注册并登录账号
3. 在【应用管理-我的应用】添加KEY，添加时服务平台请选择"Web 服务"，另外最好配置一下白名单
   
4. 获取 API Key，并在插件设置中填入

地图主题

插件支持以下 11 种高德地图主题样式：

1. 标准 (normal) - 默认主题
2. 幻影黑 (dark) - 深色主题
3. 月光银 (light) - 浅色主题
4. 远山黛 (whitesmoke) - 淡灰色主题
5. 草色青 (fresh) - 清新绿色主题
6. 雅士灰 (grey) - 灰色调主题
7. 涂鸦 (graffiti) - 涂鸦风格主题
8. 马卡龙 (macaron) - 马卡龙色彩主题
9. 靛青蓝 (blue) - 蓝色调主题
10. 极夜蓝 (darkblue) - 深蓝色主题
11. 酱籽 (wine) - 酒红色主题

如果配置了主题名称，则忽略插件中的配置：

<?php
MyTrack_Widget::output('whitesmoke');
?>

插件购买前必读

目前插件在 Typecho 1.2.1，PHP 8.2 环境中验证正常。

购买后无法退款，请考虑清楚再下单，毕竟 10 块钱也是自己辛苦赚来的。插件如果在使用中遇到问题请不要着急，给我发邮件即可，邮件中写明出错情况，如果有后台日志也请在邮件中粘贴一下，我会在闲暇时间帮忙处理（最近工作比较忙），如果处理不周还请包涵。

购买请扫二维码：