Agile Store Locator 门店定位地图 WordPress 插件[更至v5.2.4]

核心定位

Agile Store Locator 是一款专注于本地门店查询的 WordPress 付费插件，基于 Google Maps API V3 构建，适用于连锁门店、优惠促销、房产租售、餐饮预订、招聘信息等多种本地生活服务场景。管理员可在后台集中管理门店标记、分类体系与搜索分析数据，前台访客则通过地图交互快速定位附近门店。

主要功能

地图与界面

• 提供 5 种前端主题，并支持多种布局组合（含列表视图、手风琴折叠视图）
• 手风琴模板可按国家、省份、城市、门店逐级展开
• 支持全屏宽度地图、固定全屏地图等多种尺寸模式
• 可选 Google 地图底图类型：路线图、卫星图、混合图、地形图

门店数据管理

• 后台仪表盘展示标记数量、门店总数、分类统计及搜索趋势
• 分析图表呈现用户热搜词、热门门店、热门地区排名
• 支持批量导入/导出 Excel 表格，含全部字段
• 一键复制门店信息，节省录入时间
• 支持按门店 ID、名称、地址、城市、电话、邮箱等多维度搜索

搜索与筛选

• 地址搜索支持自动平移定位，限制特定国家/地区
• 支持按分类、距离、名称、城市等多条件复合筛选
• 距离单位可选英里或公里，时间格式支持 12/24 小时制
• 开启地理定位时自动提示用户共享位置

标记与可视化

• 为每个分类单独指定标记图标，切换分类标记与默认标记
• 启用标记聚合（Marker Clustering）优化大量标记下的加载性能
• 支持在地图上绘制多边形、矩形、圆形叠加层
• 引入 Snazzy Maps 样式方案自定义地图外观
• 支持 Google 高级标记与标记动画效果
• 在地图上绘制圆形/多边形高亮目标区域

时间与营业信息

• 支持为每个门店单独设置每日营业时段
• 显示各门店距当前位置的距离

高级功能

• 支持 Google 图层：实时交通、公交换乘、骑行路线
• 移动端点击门店可调用 Google Maps App 调起导航
• 地图可置顶于列表之上，或列表置顶于地图之上（移动端适配）
• 提供 100+ 管理后台配置项

适用场景

• 连锁门店查询：多品牌、多城市门店网络快速落地
• 房产租售展示：将房源按出售/出租/精选分类叠加于地图
• 优惠信息聚合：专门 Deals 模板呈现促销地图
• 餐饮/酒店落地页：支持营业时间、联系方式、位置导航完整闭环

基础地图与门店管理（2016 年 7—8 月）

插件发布初期，重点补齐门店定位的核心功能集。7 月中旬新增 Google Maps API Key 配置选项，解决了部分站点因 API 密钥缺失导致地图无法加载的问题；同步支持 RTL 布局与多语言翻译，方便阿拉伯语等右向左语言站点使用。地图展示方面，提供了全宽地图、显示/隐藏门店列表等灵活布局选项；时间管理支持为每周七天分别设置独立营业时段，并加入 24 小时制时间格式。 门店数据管理方面，支持 Excel 导入时附带 Logo 图片、门店复制（Duplicate Store）以及通过 search_2 参数发起二次搜索。地图交互层面，可叠加图层与图形、在点击门店时自定义缩放级别、设置最小/最大缩放范围（MinZoom/MaxZoom），并为地图标记添加聚合（Cluster）功能。 8 月完成与 Visual Composer 的兼容修复，并引入一组新标记图标。

后台管理与数据导入（2016 年 9 月—2017 年 4 月）

9 月后台正式引入仪表盘与数据分析模块，新增「搜索热门」与「浏览热门」门店统计。2017 年初开始将插件能力延伸至垂直场景，发布 Deal Maps（优惠地图）与 Real Estate Maps（房产地图）专用版本。 2 月为管理后台添加用户帮助文档；4 月完成一项关键优化——移除管理员后台的 jQuery UI 依赖，降低与主题或其他插件的冲突概率，同时修复了古腾堡编辑器的兼容问题。

Logo、UI 与搜索体验升级（2017 年 4—8 月）

4 月底至 5 月初，插件进行了一轮较大幅度 UI 升级：新增 Logo 管理器（支持上传自定义品牌标识）、修复管理后台标记排序错误、将界面字体图标从 Glyphicons 切换至更具通用性的方案，并上线「查找最近门店」功能。 5 月中旬进一步优化全高（Full Height）模式，支持按分类点击筛选，默认分类与默认地图区域/语言设置也一并加入后台。 8 月初完成 Bootstrap 版本更新（至 Bootstrap 4），同步优化了 qTranslate 多语言插件兼容性，引入自定义搜索按钮类型、按 Logo 排序门店、自定义门店列表顺序、按门店 ID 排序等功能，并新增「固定半径」参数 Fixed_Radius 用于限定搜索范围。

移动端与多维度筛选（2017 年 9 月—2018 年）

9 月将操作按钮移至列表左侧、导入/导出功能支持批量更新门店数据，并支持在移动 App 中直接打开 Google 地图。 11 月完成移动端全面优化：链接默认改为 target="_blank"、支持按分类限定搜索范围、多选门店营业日期、全天营业开关、以及更精细的时间段配置（单独设置开始/结束时间）。 2018 年持续完善细节：限制列表展示门店数量、平滑地图移动（Pan）动画、自定义缩放级别、设置默认地图中心点与标记、为 Logo / 分类图标 / 标记图标分别限制宽高尺寸。5 月新增门店分类重置选项与按城市/州名搜索（Beta），并在地图 API 调用出错时主动推送通知。6 月针对已有坐标缺失的门店支持单独补全经纬度、移除页面中其他 Google Maps 脚本避免冲突、同步修复折叠布局中的冲突问题。7 月上线「搜索半径圆」可视化功能。

WordPress 主流版本兼容（2018 年 12 月—2019 年 5 月）

12 月通过 WordPress 5.0 兼容性测试；次年 3 月完成 Admin 界面全面升级至 Bootstrap 4，同步优化 MySQL 查询性能。4 月进一步完善数据库索引（MySQL INDEXES），并支持通过 URL 直接导入门店图片。5 月确认兼容 WordPress 5.2。

搜索部件与高级功能（2019 年—2020 年）

2020 年 4 月新增移动端列表上置布局选项，门店定位搜索部件 [ASL_SEARCH] 可独立挂载使用；同月支持在后台为门店添加自定义字段。8 月确认兼容 WordPress 5.5；9 月新增一套店铺定位器模板并支持按分类排序。 12 月迎来较大幅度更新：新增两个配套模板、集成路线规划（Direction）服务 URL、清理冗余 CSS、提供独立的门店详情页，并确认兼容 WordPress 5.6。

API 稳定与缓存优化（2021 年）

2021 年 1 月支持通过 https://your-url.com/?feed=stores 访问 XML 数据源，并新增按分类绑定门店区域选项。2 月将地理定位能力集成进搜索部件。 5 月对列表布局进行全面增强：加入距离滑动控制器、加载时默认隐藏列表（搜索清除后同样隐藏）、支持在列表中展示品牌信息。同月新增地图 API 异常时的错误提示，并推出在线标记生成器工具（Marker Generator Tool），新增 maxboundzoom 属性用于限制边界缩放。 5 月底至 7 月进一步优化：支持通过 URL hash 高亮指定门店（如 /store-locator/#54）、启用快速缓存、支持复制每日营业时间、移除 WordPress 5.7 中废弃的警告提示（不再产生重复 Logo）。7 月新增搜索边界框（Boundary Box）与门店列表打印功能，确认兼容 WordPress 5.8。

高级交互与模板定制（2021 年 10 月—2022 年 2 月）

10 月起 Cron 任务目录迁移至 /public/cron，并调整门店编辑页面 URL。12 月在分类折叠模板中新增筛选标记选项，增强「补全缺失坐标」功能的易用性，修复了「相同营业时段」按钮逻辑，新增 clickredirect="website" 参数实现点击标记直接跳转至门店网站。 2022 年 1 月将底层 JS 库升级至最新版 Underscore.js，门店详情页支持 maplayout 属性，并新增折线（Polyline）绘制能力。1 月底确认兼容 WordPress 5.9，完成 ASL 设置后台全新改版，修复列表模板数据分析问题，并将产品字段更名为「专科特长（Specialities）」。 2 月在定制（Customization）模块中支持直接修改模板文件，新增国家/州/城市三级地址下拉联动，模板 3（Template 3）加入地址下拉与方向模式选择（支持 driving、bicycling、walking、transit 等出行方式）。

地图与定位能力升级

地图显示与交互优化

• 新增隐藏缩放按钮选项
• 优化无列表时的地图性能表现
• Template 4 新增自动滚动至地图功能
• Detail 页面隐藏营业时间选项
• 地图模态框支持设置坐标
• 支持最新 Google Advanced Markers（HTML Markers 动画效果）

地理定位与坐标处理

• 集成 GEOJS.IO 库实现 IP 基础地理定位
• 坐标无效时显示错误提示
• 缩放按钮文字可自定义修改

模板与界面定制

模板系统更新

• Template 0/1/2/3 重构为更优 UI/UX
• 从 Bootstrap 3 升级至 Bootstrap 4+
• 新增 Template 4 时间状态显示与导航按钮
• Template 5 全新改版
• 新增 Store Cards 卡片样式

定制器功能扩展

• 集成颜色与字体定制器（Color & Font Customizer）
• List 模板自定义器（List Template UI Customizer）
• List 模板 4 Store Page 微件扩展支持字段属性
• Tab 筛选器与分类手风琴过滤器
• 按分类顺序排序（基于分类 ID）
• 分类手风琴交互改进

数据管理与导入导出

CSV 导入增强

• 支持 KML 文件导入
• 导入时新增操作前后钩子
• CSV 文件新增 delete_id 列用于删除门店
• 导入文件列表支持排序
• 修复分类导入问题

数据导出与分析

• 仪表盘页面优化
• 新增导出分析数据功能
• 替换分析图表
• 支持简单/专家视图切换

第三方集成

页面构建器集成

• Elementor 短代码构建器
• Gutenberg 短代码构建器
• Elementor Store Grid 微件
• Elementor Store Detail Slug 方法更新
• Visual Composer Grid 微件

表单与电商集成

• Contact Form 7 线索集成（CF7 Lead Manager）
• WooCommerce 多门店插件集成（Multi-Store Addons）
• Store Manager 仪表盘支持
• Rank Math Store Detail 页面兼容
• Yoast Stores Site Map 集成

多语言与合规

多语言支持

• 多语言店铺数据导入支持
• WPML 支持 Store Detail 页面
• Polylang 兼容支持
• 多语言环境下多下拉框问题修复

GDPR 与无障碍合规

• 移除额外 Google 字体加载（符合 GDPR）
• 移除 Roboto 字体加载
• 实现完全 GDPR 合规
• ADA 无障碍功能支持

安全与注册功能

注册与权限

• CSRF 安全机制添加
• 注册邮箱完整表单支持
• 通知标签页文字更新
• 门店审批链接发送邮件功能

搜索与筛选增强

• 自定义筛选器搜索
• 门店名称搜索优化
• 按筛选应用后仅显示门店选项
• 添加筛选后删除全部筛选选项
• 单一品牌选择问题修复
• JS 钩子 before_search 新增

其他功能更新

• WordPress 6.0 ~ 6.4 各版本兼容适配
• PHP 8.1 / 8.2 兼容支持
• WebP 文件支持（门店 Logo）
• 列表页默认显示社交媒体图标
• 新增品牌与特殊下拉框选项
• 分组营业时间支持
• 北爱尔兰国家支持
• 门店详情页 Meta 标签支持
• Store Detail Slug 支持更多参数
• 字段选择器禁用选项

核心功能迭代：搜索与筛选

门店搜索能力升级

自 4.10 版本起，搜索功能持续强化。数据库搜索（searchtitle=”1″）支持按门店名称查找，并新增地理编码兜底机制——当数据库未命中时自动尝试坐标定位。4.11 版本进一步支持排除城市、州、邮编进行精准搜索，引入 ignoreprioritywithdistance 和 distancevaluefull 等属性控制搜索行为。5.1.3 版本集成了 Google 全新 Place API 与 Route API，搜索准确性大幅提升。

筛选与排序优化

排序逻辑支持按距离排序（Sort By Bound），多门店场景下新增 AND 筛选器用于子分类联动。4.11.12 引入 Recaptcha 验证支持（ASL_FORM），4.11.15 新增分支选项（Branches）与标记点功能，方便管理多分支门店。

列表与模板体系

目前已支持 Template 0–6 共七套模板，其中 Template 5 采用手风琴式子分类展示，Template 6 处于 Beta 阶段。Template 4（Grid）新增滚动字段（Scroll_field），Template 3 支持单属性选择。列表模板（List 2）自 4.10.7 加入，对移动端 iPad/iOS 兼容性持续修复。

页面与详情定制

门店详情页

门店详情页自 4.10 起陆续支持：时段换行显示、AM/PM 多语言翻译、非营业日隐藏、地图字段嵌入（field=”map”）、方向链接包含街道信息（Template 1）。5.1.8 新增砖蔷画廊（Masonry Gallery），详情页支持站点徽章（badge）展示。

注册与表单

门店注册表单支持营业时间字段、标签翻译、自定义颜色标签，并可通过 CSS 自定义样式。4.10.12 在表单中集成 Toaster 通知，5.1.6 优化了 CTA 事件与表单调整逻辑。

第三方集成与兼容性

表单与 SEO 插件

• WPForms：全面集成，支持 CTA 按钮事件、文本字段传递、信息框按钮触发
• SEOPress：4.11.10 起兼容，修复搜索组件按钮颜色属性
• CMPLZ：4.11.4 添加兼容性支持
• WPML / PolyLang：持续优化翻译标签、FR 语言包及 CSS 修复

其他插件与平台

• Multi-Store Addons for WooCommerce：全面兼容（4.11.3/4.11.13），支持多门店联动
• WooCommerce：数据导入支持排除重复项（Import avoid duplicate），导出支持子分类
• Apple Maps：新增方向链接属性（apple_maps direction attribute）
• Google Tag Manager（GTM）：5.0.8 起扩展事件追踪支持

性能与架构演进

地图加载优化

Google Maps 库自 4.11 版本起改为异步加载（Async Loading），通过回调方式初始化，并引入 disable_scroll / offset 参数控制交互行为。5.0.1 起支持异步脚本加载以降低阻塞。

数据库与后端

• 5.0.1：后端迁移至 Bootstrap 5
• 5.1.4：升级 moment.js 依赖库

编辑器与富文本

5.2.2 版本 TinyMCE 编辑器实现重大改进：保留绝对/相对链接不重写为 ../、集成 WordPress 编辑器初始化与媒体按钮支持、自定义字段富文本 HTML 允许 img 标签、安全过滤增强。

站点地图与 URL 管理

固定链接与 slug

4.10.10 改善拉丁语系 Slug 生成逻辑；4.11 起支持斜杠（/）用于标签名称。门店详情页文档标题（Document Title）自 4.10.12 起支持独立配置。

WordPress 核心兼容

配置迁移与数据管理

导入导出

• 自 4.10 起支持配置导入/导出
• CSV 上传器（4.10.3 修复，5.0.7 修复）
• 导出支持子分类（4.10.7）
• CSV 文件导出自 5.1.8 起持续优化

批量编辑与升级

区域兜底门店（Region fallback stores）通过 regionfallbackstores 属性实现，当搜索无结果时自动按输入匹配兜底。

门店营业时间管理能力升级

本次更新聚焦于门店营业时间标签的全面增强，同时修复了后台管理界面中时钟图标的显示问题。

按天独立配置营业标签

新版在「添加/编辑门店」表单和「批量编辑门店」界面中，均新增了按天设置营业时间标签的功能。管理员可分别为每一天配置「营业中」「休息中」「24 小时营业」等多种状态标签，使顾客在前台查看门店信息时一目了然。

前台展示逻辑优化

前端营业时间渲染逻辑同步升级：当天标签现已在时段之后显示，即使某天仅配置标签而无具体时段（如公休日标记为「休息中」），也能正确呈现对应状态。

状态值渲染修复

此前，状态值 1（24 小时营业）和 0（歇业）两个特殊值的标签渲染存在错误，已在本次更新中修正，确保这两类关键状态在前台准确展示。

后台时钟图标显示修复

此前在添加/编辑门店及批量编辑门店的时间设置界面中，时钟图标存在尺寸异常或被裁剪的问题，现已修复。 原文功能关联：本更新还为模板 7新增了城市/州级链接支持（通过 queryredirecturl 参数），并为模板 4（网格视图）加入了 listgroupby 分组能力。