快速入门指南

欢迎使用 Wenprise Store Maps 插件！通过本指南，您可以快速完成插件的初始配置，并在网站中嵌入交互式的线下商店和网点地图。

安装与基础配置

1. 启用插件依赖

安装此插件后，请确保系统提示所需的 WP REST Filter 插件已经一并安装并启用。由于我们的设置面板和自定义字段使用了 Carbon Fields 库，如果未满足条件，您将会在后台看到相关提示。

2. 配置百度地图 API

此插件依赖百度地图 Web 服务接口来实现地理编码和地图渲染：

1. 访问 百度地图开放平台 并登录您的百度账号。
2. 创建一个新的应用，勾选 Web服务 和 JavaScript API 的权限。
3. 获取生成的 AK (API Key)。
4. 返回 WordPress 后台，点击左侧菜单的 商店 (Store) -> 设置 (Settings)。
5. 将复制的 AK 填入 Baidu Map APP Key 输入框并保存。

3. 配置其它显示选项

在同一个设置页面，您还可以根据需要调整：

• Location type (店铺类型): 自定义网点的称呼，比如填入“服务中心”或“授权门店”。
• Show n stores per page: 每页显示的门店列表数量。
• Display type: 选择前端是以网格 (Grid) 还是列表附带地图 (List And Map) 的形式展示。

添加和管理门店数据

配置完成后，就可以开始录入店铺数据了：

1. 在后台菜单点击 商店 -> 添加新商店。
2. 填写网点标题（如：北京市朝阳区售后服务中心）。
3. 在下方的 Store information (商店信息) 面板中填写详细信息：
   • Telephone: 联系电话。
   • Website: 独立网址（若有）。
   • Opening time: 营业时间，如 周一至周日 09:00 - 18:00。
   • Store profile: 门店简介。
   • Location: 地图坐标拾取器，搜索您的地址并在地图上精确点击标记。
4. 点击 发布。

在前端展示地图

数据准备完毕后，即可将地图应用展示在网站的任意角落：

在您想要显示地图的页面、文章或支持短代码的小工具内，插入以下短代码即可：

[wprs-store-maps]

前台将自动加载相关的 JS 和 CSS，并渲染出包含了所有网点的响应式交互地图。