TYPO3 11 + Solr：如何预选中分面选项？

方法1：前端JavaScript实现（快捷生效） #

直接在页面加载后监听Solr结果初始化事件，模拟点击目标分面选项，适合快速实现需求：

document.addEventListener('DOMContentLoaded', function() {
    // 监听EXT:solr自带的初始化完成事件
    document.addEventListener('tx_solr.initialized', function() {
        // 替换为你的分面容器类和目标选项值，比如分面字段是category，目标值是news
        const targetFacetItem = document.querySelector('.tx-solr-facet-category .tx-solr-facet-item a[data-facet-value="news"]');
        if (targetFacetItem) {
            // 触发点击自动选中并提交筛选
            targetFacetItem.click();
        }
    });
});

注意：需根据自己的前端模板调整选择器，不同模板的分面容器类可能不同。

方法2：后端修改查询参数（全局持久化） #

如果需要默认给所有用户应用该分面筛选，可通过EXT:solr的事件或Typoscript配置实现：

方案A：Typoscript配置 #

在站点Typoscript中直接添加默认筛选：

plugin.tx_solr.search.query.additionalFilters = category:"news"

方案B：PHP事件订阅器 #

通过Symfony事件修改Solr查询：

use ApacheSolrForTypo3\Solr\Event\Search\BeforeSearchQueryIsExecutedEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class DefaultFacetSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            BeforeSearchQueryIsExecutedEvent::class => 'addDefaultFacetFilter',
        ];
    }

    public function addDefaultFacetFilter(BeforeSearchQueryIsExecutedEvent $event): void
    {
        $query = $event->getQuery();
        // 添加目标分面筛选，替换为你的字段和值
        $query->addFilter('category:"news"');
        $event->setQuery($query);
    }
}

然后在扩展的Services.yaml中注册订阅器：

services:
  YourVendor\YourExtension\EventSubscriber\DefaultFacetSubscriber:
    tags:
      - name: event.subscriber

方法3：自定义分面模板（UI预显+可选取消） #

如果需要仅显示预选样式，同时允许用户手动取消，可修改EXT:solr的Fluid模板：
复制EXT:solr的Resources/Private/Templates/Facets/List.html到你的扩展模板目录，修改渲染逻辑：

<f:for each="{facet.items}" as="item">
    <f:variable name="isPreselected" value="{item.value == 'news'}"/>
    <a href="{item.url}" class="tx-solr-facet-item-link {f:if(condition: isPreselected, then: 'active')}">
        {item.label} ({item.count})
    </a>
</f:for>

再配合前端JS，若页面URL无该筛选参数则自动提交搜索。

注意事项 #

• 方法1适合临时需求，无需修改后端；方法2适合全局默认筛选；方法3适合自定义UI交互
• 需确保分面字段名和值与Solr索引中的数据完全匹配
• 多语言站点需对应处理不同语言的分面值

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