Google 评论
一款适用于 Wpcmf CMS 的专业 Google 评论插件，以精美的轮播界面展示 Google 商家评论。该插件采用响应式布局，并提供丰富的自定义选项，完美契合现代评论插件的设计风格。

要求
Bottle 核心 7.5.0 或更高版本。
PHP 8.2 或更高版本。
安装
通过管理面板安装
进入管理面板，点击“插件”选项卡。点击“添加新插件”按钮，找到FOB Google Reviews插件，然后点击“安装”按钮。

手动安装
从此处下载插件Wpcmf Marketplace。
解压缩下载的文件，并将解压缩后的文件夹上传到该platform/plugins目录。
进入“管理” > “插件”，然后点击“启用”按钮。
特征
精美设计：与现代 Google 评论设计相匹配的专业小部件
响应式轮播图：支持触摸/滑动操作的自动播放轮播图
移动响应式：根据屏幕尺寸自动调整为 1 到 4 列。
高度可配置：丰富的自定义设置。
智能缓存：通过可配置的缓存持续时间减少 API 调用次数
产品级设置：为每个产品覆盖地点 ID
多语言：支持 42 种语言
无障碍功能：支持 ARIA 标签和键盘导航
主题无关：适用于所有 Wpcmf 主题
多种显示类型：可选择轮播图、网格或列表布局
双源模式：使用 Google API 或手动数据库评论
用法
审查源模式
该插件支持两种显示评论的模式：

1. 手动模式（默认）
评论存储在数据库中
对评论内容拥有完全控制权
无 API 费用
无外部依赖
可通过管理面板或种子服务器轻松管理
使用场景：当您想要完全控制评论、没有 Google API 访问权限或想要筛选特定评论时。

设置：

前往“设置” > “Google 评论”
选择“手动（数据库）”作为审核来源
手动添加评论或运行种子程序
2. Google API 模式
从 Google 我的商家获取真实评价
自动更新
显示真实客户评价
需要 Google Places API 密钥
使用场景：当您想自动显示真实的 Google 评论时。

设置：

获取 Google API 密钥（见下文）
前往“设置” > “Google 评论”
选择“Google API”作为审核来源
输入 API 密钥和地点 ID
Google API 入门
1. 获取 Google API 密钥
前往Google Cloud Console
创建新项目或选择现有项目
启用Google Places API
从“凭据”部分创建 API 密钥
（可选）将 API 密钥限制为仅限 Places API 使用
2. 获取地点 ID
方法一：使用地点 ID 查找器

访问Google 地点 ID 查找器
搜索您的企业
复制地点 ID
方法二：使用谷歌地图

打开谷歌地图
搜索您的企业
地点 ID 位于 URL 之后!1s，或者使用“分享”按钮。
配置
配置全局设置
前往“设置” > “Google 评价”进行配置：

评论来源

选择手动（数据库）模式或 Google API 模式。
API 设置（仅限 API 模式）

Google API 密钥：您的 Google Places API 密钥
默认地点 ID：您的 Google 商家地点 ID
企业名称：覆盖企业名称（可选）
显示设置

显示类型：选择轮播图、网格或列表
最多显示评论数：显示的评论数量（1-20）
最低评分：按最低星级（0-5星）筛选评论
轮播图设置（仅限轮播图模式）

启用自动播放：自动切换轮播图
自动播放速度：幻灯片之间的间隔时间（1000-30000毫秒）
网格设置（仅限网格模式）

每行评论数：每行显示的评论数量（1-4）
能见度

在产品页面显示：显示在产品详情页面上
显示“查看所有评论”按钮：链接至 Google 评论页面
表现

自动刷新评论：自动刷新缓存数据
缓存时长：评论缓存的时长（5-1440分钟）
外貌

小部件标题：小部件的自定义标题
显示评分摘要：显示总体评分和数量
显示作者头像：显示审稿人的个人资料图片
显示作者姓名：显示审稿人姓名
显示评论日期：显示评论发布时间
显示星级评分：显示星级评分
评论文本长度：要显示的最大字符数
显示“阅读更多”链接：显示已截断评论的链接
每个产品配置
编辑任何产品
滚动到Google 评论元框
启用此产品的 Google 评论
（可选）添加自定义地点 ID 以显示不同地点的评价
使用短代码
您可以使用简码将 Google 评论小部件放置在您网站的任何位置。

在页面内容（可视化编辑器）中：

编辑任意页面
点击编辑器中的“短代码”按钮。
从列表中选择Google 评论
（可选）添加自定义标题
插入短代码
手动短代码：

在刀片模板中：

{!! Shortcode::compile('

') !!}
PHP 代码：

echo do_shortcode('

');
管理手动审核
使用手动模式时，评论会存储在google_reviews_data表格中。

通过管理面板
在管理菜单中，转到“Google 评论” > “评论” 。
点击“创建评论”添加新评论
填写评论详情（作者姓名、评分、评论内容等）
设置显示顺序（数字较小的先显示）
保存评论
通过 Seeder
运行种子程序以创建示例评论：

php artisan db:seed --class="FriendsOfWpcmf\\GoogleReviews\\Database\\Seeders\\GoogleReviewsSeeder"
通过 Laravel Tinker
php artisan tinker
FriendsOfWpcmf\GoogleReviews\Models\GoogleReviewData::create([
   'author_name' => 'Jane Smith',
   'rating' => 5,
   'text' => 'Excellent service and quality!',
   'review_date' => now()->subWeeks(2),
   'is_active' => true,
   'order' => 1
]);
小部件功能
标题部分
谷歌标志
企业名称
总体评分（星级）
评论总数
“由 Google 提供支持”归属
复习卡
评论者头像（如果没有照片，则使用初始气泡）
审阅者姓名
星级评定
相对时间（“2周前”）
评论文本中包含“阅读更多”字样，方便查看长篇评论。
轮播导航
上一页/下一页按钮
点状指示器
支持移动设备上的触摸/滑动操作
键盘导航
自动播放，鼠标悬停时暂停。
响应式布局
移动设备（< 768像素）：1张卡片
平板电脑（768像素 - 1023像素）：2张卡片
桌面（1024像素 - 1279像素）：3张卡片
大型桌面（≥ 1280像素）：4张卡片