文件
xionggeshop/addons/shopro/model/Decorate.php
可乐加冰 5b2d85af5f ```
feat(shopro): 完善首页商品列表装修逻辑,支持hidden商品展示

- 在Goods控制器中添加normalizeHomeGoodsListParams方法调用,
  用于处理首页商品列表参数规范化
- 重构Decorate模型,移除未使用的DecorateContent引用
- 新增resolveHomeGoodsListContext方法,解析首页商品列表上下文
- 实现normalizeHomeGoodsListParams方法,确保关键词搜索为空时
 使用装修配置的商品ID
- 添加enrichHomeGoodsBlocks方法,丰富首页商品区块数据
- 优化extractHomeGoodsContextFromBlocks方法,从装修区块中提取
  商品上下文信息
- 修改Goods模型,在指定goods_ids时允许查询status为hidden的商品,
  确保装修中设置的隐藏商品能够正常展示
```
2026-10-02 15:14:55 +08:00

357 行
12 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace addons\shopro\model;
use think\Model;
use addons\shopro\exception\Exception;
/**
* 模板装修
*/
class Decorate extends Model
{
// 表名,不含前缀
protected $name = 'shopro_decorate';
// 自动写入时间戳字段
protected $autoWriteTimestamp = 'int';
// 定义时间戳字段名
protected $createTime = 'createtime';
protected $updateTime = 'updatetime';
protected $deleteTime = 'deletetime';
protected $hidden = ['createtime', 'updatetime', 'deletetime'];
// 追加属性
protected $append = [
];
// 获取当前平台模板装修数据
public static function getCurrentPlatformDecorate($platform = '', $id = 0)
{
$where = ['deletetime' => null];
if ($id !== 0) {
$where['id'] = $id;
}
if ($platform == 'preview') {
$decorate = self::where($where)->order('id asc')->find();
} else {
$where['status'] = 'normal';
$where['type'] = 'shop';
$decorate = self::where('find_in_set(:platform,platform)', ['platform' => $platform])->where($where)->order('id asc')->find();
}
if (!$decorate) {
new Exception('未找到模板');
}
$template = self::getDecorateContent($decorate);
return $template;
}
public static function getCustomDecorate($id)
{
$decorateContent = DecorateContent::all(['decorate_id' => $id]);
foreach ($decorateContent as &$v) {
$v['content'] = self::getDecorateContentByType($v);
}
return $decorateContent;
}
public static function asyncDecorateScreenShot($params)
{
$decorate = self::get($params['shop_id']);
if ($decorate) {
$decorate->image = $params['image'];
$decorate->save();
}
}
public static function getDecorateContent($decorate)
{
$template['home'] = []; //首页
$template['user'] = []; //个人中心
$template['tabbar'] = []; //底部菜单
$template['popup'] = []; //弹出提醒
$template['float-button'] = []; //悬浮按钮
$decorateContent = DecorateContent::all(['decorate_id' => $decorate->id]);
foreach ($decorateContent as $k => $v) {
$v['content'] = self::getDecorateContentByType($v);
$template[$v->category][] = $v;
}
if (!empty($template['home'])) {
$template['home'] = self::enrichHomeGoodsBlocks($template['home']);
}
return $template;
}
/**
* 首页「精选好酒」模块:API 侧补齐 goods_ids,避免小程序仅带 category_id 时少显示装修选中的 hidden 商品。
*
* @return array<int, string> [category_id => goods_ids]
*/
public static function resolveHomeGoodsListContext($platform = '')
{
try {
$template = self::getCurrentPlatformDecorate($platform ?: 'wxMiniProgram');
} catch (\Throwable $e) {
return ['category_id' => 0, 'goods_ids' => ''];
}
$home = $template['home'] ?? [];
if (!$home) {
return ['category_id' => 0, 'goods_ids' => ''];
}
$ctx = self::extractHomeGoodsContextFromBlocks($home);
return [
'category_id' => (int) ($ctx['category_id'] ?? 0),
'goods_ids' => (string) ($ctx['goods_ids'] ?? ''),
];
}
/**
* 与首页 sh-hot-goods 请求对齐:无筛选时用装修商品;首页分类与全部分类列表一致。
*/
public static function normalizeHomeGoodsListParams(array $params, $platform = '')
{
$keywords = trim((string) ($params['keywords'] ?? ''));
if ($keywords !== '') {
return $params;
}
if (!empty($params['goods_ids'])) {
return $params;
}
$ctx = self::resolveHomeGoodsListContext($platform);
$homeIds = trim((string) ($ctx['goods_ids'] ?? ''));
$homeCat = (int) ($ctx['category_id'] ?? 0);
if ($homeIds === '') {
return $params;
}
$categoryId = isset($params['category_id']) ? (int) $params['category_id'] : 0;
$scoped = $categoryId > 0;
if (!$scoped) {
$params['goods_ids'] = $homeIds;
unset($params['category_id']);
return $params;
}
if ($homeCat > 0 && $categoryId === $homeCat) {
$params['goods_ids'] = $homeIds;
unset($params['category_id']);
}
return $params;
}
protected static function enrichHomeGoodsBlocks(array $home)
{
$ctx = self::extractHomeGoodsContextFromBlocks($home);
if (($ctx['goods_ids'] ?? '') === '') {
return $home;
}
$targetIdx = null;
foreach ($home as $idx => $block) {
if (in_array($block['type'] ?? '', ['goods-list', 'goods-group'], true)) {
$targetIdx = $idx;
break;
}
}
if ($targetIdx === null) {
$targetIdx = self::findLastCategoryTabsIndex($home);
}
if ($targetIdx === null || $targetIdx < 0) {
return $home;
}
$content = $home[$targetIdx]['content'] ?? [];
$content['ids'] = $ctx['goods_ids'];
unset($content['id']);
$home[$targetIdx]['content'] = $content;
return $home;
}
protected static function findLastCategoryTabsIndex(array $home)
{
for ($i = count($home) - 1; $i >= 0; $i--) {
if (($home[$i]['type'] ?? '') === 'category-tabs') {
return $i;
}
}
return -1;
}
protected static function extractHomeGoodsContextFromBlocks(array $home)
{
$categoryId = 0;
foreach ($home as $block) {
$type = $block['type'] ?? '';
if (!in_array($type, ['goods-list', 'goods-group'], true)) {
continue;
}
$content = $block['content'] ?? [];
if (!empty($content['ids'])) {
return [
'category_id' => (int) ($content['id'] ?? 0),
'goods_ids' => self::normalizeGoodsIdsString($content['ids']),
];
}
if (!empty($content['id'])) {
$categoryId = (int) $content['id'];
return [
'category_id' => $categoryId,
'goods_ids' => self::goodsIdsFromCategoryId($categoryId),
];
}
}
for ($i = count($home) - 1; $i >= 0; $i--) {
if (($home[$i]['type'] ?? '') !== 'category-tabs') {
continue;
}
$content = $home[$i]['content'] ?? [];
if (!empty($content['ids'])) {
return [
'category_id' => (int) ($content['id'] ?? ($content['category_arr'][0]['id'] ?? 0)),
'goods_ids' => self::normalizeGoodsIdsString($content['ids']),
];
}
$categoryId = (int) ($content['id'] ?? ($content['category_arr'][0]['id'] ?? 0));
if ($categoryId > 0) {
return [
'category_id' => $categoryId,
'goods_ids' => self::goodsIdsFromCategoryId($categoryId),
];
}
break;
}
return ['category_id' => 0, 'goods_ids' => ''];
}
protected static function normalizeGoodsIdsString($ids)
{
$ids = is_array($ids) ? implode(',', $ids) : (string) $ids;
$parts = array_filter(array_map('intval', explode(',', $ids)));
return implode(',', array_unique($parts));
}
protected static function goodsIdsFromCategoryId($categoryId)
{
$categoryId = (int) $categoryId;
if ($categoryId <= 0) {
return '';
}
$categoryIds = Category::getCategoryIds($categoryId);
if (!$categoryIds) {
return '';
}
$query = Goods::where('status', 'in', ['up', 'hidden']);
$query->where(function ($q) use ($categoryIds) {
foreach ($categoryIds as $cid) {
$q->whereOrRaw("find_in_set($cid, category_ids)");
}
});
$ids = $query->order('weigh asc, id desc')->column('id');
return self::normalizeGoodsIdsString(implode(',', $ids));
}
public static function getDecorateContentByType($templateValue)
{
$content = json_decode($templateValue->content, true);
if (!is_array($content)) {
$content = [];
}
switch ($templateValue['type']) {
case 'search':
case 'coupons':
case 'live':
case 'seckill':
case 'groupon':
case 'wallet-card':
case 'order-card':
case 'rich-text':
case 'nav-bg':
break;
case 'banner':
case 'menu':
case 'adv':
case 'grid-list':
case 'popup':
case 'nav-list':
if (!empty($content['list']) && is_array($content['list'])) {
foreach ($content['list'] as &$l) {
$l['image'] && $l['image'] = cdnurl($l['image'], true);
}
unset($l);
$content['list'] = array_values(array_filter($content['list'], function ($item) {
return !self::isHiddenMenuItem($item);
}));
} else {
$content['list'] = [];
}
break;
case 'user':
case 'title-block':
case 'goods-list':
case 'goods-group':
case 'image-goods':
$content['image'] && $content['image'] = cdnurl($content['image'], true);
break;
case 'tabbar':
if (isset($content['style']) && $content['style'] < 3 && !empty($content['list']) && is_array($content['list'])) {
foreach ($content['list'] as &$l) {
$l['image'] && $l['image'] = cdnurl($l['image'], true);
$l['activeImage'] && $l['activeImage'] = cdnurl($l['activeImage'], true);
}
unset($l);
} elseif (!isset($content['list']) || !is_array($content['list'])) {
$content['list'] = [];
}
break;
case 'float-button':
$content['image'] = cdnurl($content['image'], true);
if (!empty($content['list']) && is_array($content['list'])) {
foreach ($content['list'] as &$l) {
if ($l['style'] == 1) {
$l['image'] && $l['image'] = cdnurl($l['image'], true);
}
$l['btnimage'] && $l['btnimage'] = cdnurl($l['btnimage'], true);
}
unset($l);
} else {
$content['list'] = [];
}
break;
}
return $content;
}
/**
* 已关闭的功能入口,不在前端展示
*/
protected static function isHiddenMenuItem($item)
{
if (!is_array($item)) {
return false;
}
$name = isset($item['name']) ? (string) $item['name'] : '';
$path = isset($item['path']) ? (string) $item['path'] : '';
$hiddenNames = ['我的报修', '门店管理', '我的拼团', '今日必拼'];
if (in_array($name, $hiddenNames, true)) {
return true;
}
$hiddenPaths = ['/pages/activity/groupon', '/pages/app/merchant', '/pages/order/after-sale/list'];
foreach ($hiddenPaths as $hiddenPath) {
if ($path && strpos($path, $hiddenPath) !== false) {
return true;
}
}
return false;
}
}