3.9 KiB
3.9 KiB
Goods.php 票务模板替换修改
⚡ 核心原则:怎么快怎么来。改核心文件是允许的。 适用范围:ShopXO v6.8.0,文件:
app/index/controller/Goods.php
修改位置
文件:{SHOPXO_ROOT}/app/index/controller/Goods.php
方法:Index()(商品详情页主方法)
位置:在 return MyView(); 之前插入判断逻辑
修改内容
1. 在方法开头加载票务插件数据(可选,用于传递 venue_data 给模板)
在 $assign 数组构建部分(约 line 110-130),在 MyViewAssign($assign); 之前加入:
// === VR票务插件:注入票务数据到模板 ===
// 票务商品(item_type=ticket 或 venue_data 非空)注入座位图数据
if (!empty($goods['venue_data']) || (isset($goods['item_type']) && $goods['item_type'] == 'ticket')) {
// 加载 vr_seat_templates 中的座位图配置
$category_id = $goods['category_id'] ?? 0;
if ($category_id > 0) {
$seat_template = Db::name('plugins_vr_seat_templates')
->where('category_id', $category_id)
->where('status', 1)
->find();
if (!empty($seat_template)) {
$assign['vr_seat_template'] = $seat_template;
$assign['vr_is_ticket_goods'] = 1;
}
}
}
// === VR票务插件 END ===
2. 在 return MyView(); 之前加入模板判断(约 line 437-440)
找到:
// 商品详情
$assign = array_merge($assign, GetGoodsDetails($goods_id, $params));
MyViewAssign($assign);
return MyView();
替换为:
// 商品详情
$assign = array_merge($assign, GetGoodsDetails($goods_id, $params));
MyViewAssign($assign);
// === VR票务插件:票务商品使用独立模板 ===
// 判断依据:venue_data 非空 或 item_type == 'ticket'
$is_ticket = false;
if (!empty($assign['goods']['venue_data']) || !empty($assign['goods']['item_type'])) {
$is_ticket = ($assign['goods']['item_type'] ?? '') === 'ticket'
|| !empty($assign['goods']['venue_data']);
}
if (!empty($is_ticket) && !empty($assign['vr_is_ticket_goods'])) {
return MyView('/goods/ticket_detail');
}
// === VR票务插件 END ===
return MyView();
新建票务模板文件
路径:{SHOPXO_ROOT}/app/index/view/default/goods/ticket_detail.html
参考 app/index/view/default/goods/detail.html,重写以下部分:
- 隐藏标准规格选择器(
.goods-detail-spec) - 隐藏原价/现价区域(
.goods-detail-panel-price) - 隐藏购物车/立即购买按钮(
.goods-detail-buy-nav) - 注入票务选座 UI(使用
$vr_seat_template.seat_map数据) - 保留商品相册、商品详情 tab、商品参数 tab
升级 ShopXO 后的重应用步骤
当升级 ShopXO 后,此修改需要重新应用:
- 下载新版本 ShopXO
- 对比旧版本
app/index/controller/Goods.php和新版本,找到return MyView();的位置 - 重新应用上述修改
- 模板文件
ticket_detail.html不受影响(独立文件)
建议:将此修改内容写入 docs/GOODS_PHP_MODIFICATION.md,升级前对照检查。
为什么不只用 Hook?
Hook 方案(plugins_view_goods_detail_base_sku_top 注入)的缺点:
- 仍需加载完整标准模板(CSS/JS 全部加载)
- 需要 CSS 选择器隐藏标准元素(脆弱,ShopXO 升级后选择器可能失效)
- 注入位置固定,不够灵活
改 Goods.php 方案的优点:
- 1 行判断,模板完全自控
- 零无用 CSS/JS 加载
- 性能更好
备选方案:纯 Hook(ShopXO 升级时不需重应用)
如果不修改 Goods.php,可用 Hook 方案(但需接受上述缺点):
// config.json hook 注册
"hook": {
"plugins_view_goods_detail_base_sku_top": [
"\\app\\plugins\\vr_ticket\\view\\Goods::InjectTicketUI"
],
"plugins_service_goods_data": [
"\\app\\plugins\\vr_ticket\\service\\GoodsService::InjectVenueData"
]
}