Magento 2 Observer实现商品分类/搜索隐藏且保留访问URL需求咨询

核心思路 #

避开直接修改商品visibility属性（会导致404），通过自定义属性+插件/事件拦截的方式，在分类列表、搜索结果中过滤目标商品，但保留商品详情页的正常访问权限。

具体实现步骤 #

1. 准备自定义属性

先创建一个下拉类型的自定义属性（例如命名为hide_from_catalog），设置选项为「是/否」，默认值为「否」，并确保该属性在产品编辑页面可见，可被设置。

2. 通过插件拦截集合加载

编写两个插件，分别拦截分类列表和搜索结果的产品集合，过滤掉hide_from_catalog设为「是」的商品。

分类列表拦截插件

<?php
namespace Vendor\Module\Plugin\Catalog\Model\ResourceModel\Product;

use Magento\Catalog\Model\ResourceModel\Product\Collection as ProductCollection;
use Magento\Framework\App\RequestInterface;

class CollectionPlugin
{
    protected $request;

    public function __construct(RequestInterface $request)
    {
        $this->request = $request;
    }

    public function afterAddCategoryFilter(ProductCollection $subject, $result)
    {
        // 仅在分类列表页面生效，不影响商品详情页加载
        if ($this->request->getFullActionName() == 'catalog_category_view') {
            $subject->addAttributeToFilter('hide_from_catalog', ['neq' => 1]);
        }
        return $result;
    }
}

搜索结果拦截插件

<?php
namespace Vendor\Module\Plugin\CatalogSearch\Model\ResourceModel\Fulltext;

use Magento\CatalogSearch\Model\ResourceModel\Fulltext\Collection as FulltextCollection;
use Magento\Framework\App\RequestInterface;

class CollectionPlugin
{
    protected $request;

    public function __construct(RequestInterface $request)
    {
        $this->request = $request;
    }

    public function beforeLoad(FulltextCollection $subject, $printQuery = false, $logQuery = false)
    {
        // 仅在搜索结果页面生效
        if ($this->request->getFullActionName() == 'catalogsearch_result_index') {
            $subject->addAttributeToFilter('hide_from_catalog', ['neq' => 1]);
        }
        return [$printQuery, $logQuery];
    }
}

注册插件

在模块的etc/di.xml中添加插件注册配置：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Catalog\Model\ResourceModel\Product\Collection">
        <plugin name="vendor_module_catalog_product_collection" type="Vendor\Module\Plugin\Catalog\Model\ResourceModel\Product\CollectionPlugin" sortOrder="10"/>
    </type>
    <type name="Magento\CatalogSearch\Model\ResourceModel\Fulltext\Collection">
        <plugin name="vendor_module_catalogsearch_fulltext_collection" type="Vendor\Module\Plugin\CatalogSearch\Model\ResourceModel\Fulltext\CollectionPlugin" sortOrder="10"/>
    </type>
</config>

3. 额外注意事项

• 确保目标商品的status属性为「启用」，禁用状态的商品会直接返回404。
• 保持商品的visibility属性为「目录，搜索」，避免Magento默认过滤逻辑影响详情页访问。
• 修改属性或插件后，刷新分类、搜索及页面缓存，确保规则生效。

验证效果 #

• 访问分类列表页，hide_from_catalog设为「是」的商品不会显示
• 搜索目标商品名称，结果中不会出现该商品
• 直接输入商品URL，可正常打开商品详情页

内容的提问来源于stack exchange，提问作者ramazan