Location Store – UI 模块：多门店地图 (OSM/Leaflet)
该插件添加了一个 UI 模块/短代码，用于从 mp_stores 数据表中读取数据，并使用 OpenStreetMap + Leaflet 渲染多门店地图。因此，它不需要 Google Maps API 密钥。
主要功能
真实地图渲染：展示带有多个门店标记的真实地图。
门店信息展示：显示门店名称和地址。
交互功能：点击门店卡片可聚焦地图并打开标记弹窗。
自定义图标：支持自定义标记图标（URL）及图标尺寸。
自动地理编码：如果门店记录中没有坐标，插件会通过 OSM Nominatim 对地址进行地理编码，并在浏览器中缓存结果，以便下次加载更快。
系统要求
Wpcmf CMS + Marketplace（必须包含 mp_stores 表）
PHP 8.x
无需 Google Maps 密钥 / 无需账单支付
安装步骤
将插件文件夹复制到：platform/plugins/location-store
进入 后台 → 插件，激活 Location Store。
清除缓存：
php artisan view:clear
php artisan cache:clear
使用方法
1. 通过 UI 模块使用
打开 UI 模块并选择：
Hisotech UI Blocks: Many Store Map
可配置选项：
Title (标题)：区块标题
Height (高度)：地图高度（像素），例如 520
Zoom (缩放)：地图缩放级别（默认 12）
Limit (限制)：加载门店数量（默认 100）
Store IDs (门店ID)：按 ID 过滤（例如 1,2,3），留空则显示所有
Marker Icon URL (标记图标URL)：自定义图标 URL（可选）
Marker Icon Size (图标尺寸)：图标尺寸（像素），例如 32
Show List (显示列表)：在地图下方显示门店列表（是/否）
2. 通过短代码 (Shortcode) 使用
将以下代码插入页面或文章中：

[many-store-map title="Store Locations" height="520" zoom="12" limit="100" store_ids="" marker_icon="" marker_icon_size="32" show_list="yes" ]

短代码属性说明：
title (字符串)
height (数字, px)
zoom (数字)
limit (数字)
store_ids (字符串格式如 1,2,3)
marker_icon (url)
marker_icon_size (数字)
show_list (yes/是 | no/否)
门店数据源
插件从 mp_stores 表中读取以下基础字段：
id, name, address, city, state, country
坐标优先：如果数据库中包含 latitude/longitude 或 lat/lng 字段，插件将自动使用这些坐标并跳过地理编码过程。
关于地理编码 (OSM Nominatim) 的说明
首次加载较慢：如果大量门店需要进行地理编码，首次加载可能会较慢。
浏览器缓存：结果会缓存在浏览器中，以加速后续加载。
大数据集建议：对于大型数据集（数百家以上门店），建议直接在 mp_stores 中添加经纬度，或实现服务器端缓存。
故障排除
1) 地图区域为空白/灰色
打开开发者工具 (F12) → 控制台 (Console)。
如果发现对 tile.openstreetmap.org 的瓦片请求被阻止，请检查网络或防火墙设置。
插件更新后，请清除缓存并重新加载。
2) 标记位置错误
确保门店地址完整（包含地址 + 城市 + 州/省 + 国家）。
为了获得最佳的准确性和性能，建议在数据库中存储经纬度坐标。
扩展思路
侧边栏布局：列表在右侧，地图在左侧。
区域筛选：按城市/州/国家筛选。
标记聚类：针对大量门店实现标记聚类功能。