PHPackages                             nopj/flarum-ext-custom-search - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search & Filtering](/categories/search)
4. /
5. nopj/flarum-ext-custom-search

ActiveFlarum-extension[Search & Filtering](/categories/search)

nopj/flarum-ext-custom-search
=============================

Flarum custom search extension with Google/Bing selection.

v0.0.2(2mo ago)02MITTypeScript

Since Feb 28Pushed 2mo agoCompare

[ Source](https://github.com/chao2hang/flarum-ext-custom-search)[ Packagist](https://packagist.org/packages/nopj/flarum-ext-custom-search)[ RSS](/packages/nopj-flarum-ext-custom-search/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

Flarum 自定义搜索插件 (Custom Search)
==============================

[](#flarum-自定义搜索插件-custom-search)

这是一个为 Flarum 开发的搜索增强插件。它通过替换 Flarum 原生的站内搜索逻辑，允许用户直接使用外部搜索引擎（Google 或 Bing）来搜索本站内容，提升搜索体验的同时减轻了服务器的索引压力。

功能特性
----

[](#功能特性)

- **多引擎支持**：在搜索框左侧集成了一个搜索引擎选择器，用户可以在 Google 和 Bing 之间自由切换。
- **默认使用 Bing**：根据您的需求，插件初始化时默认选中 Bing 搜索引擎。
- **精准搜索范围**：搜索时会自动在关键词前添加 `site:[当前域名]` 前缀，确保搜索结果仅来自本站。
- **原生风格整合**：
    - 移除了原有的左侧放大镜图标。
    - 采用 Flarum 原生的 `Select` 组件和配色，与系统 UI 完美融合。
    - 右侧集成了搜索按钮，操作直观。
- **性能优化**：禁用了 Flarum 原生的异步搜索请求，避免在输入时产生不必要的服务器查询。

安装
--

[](#安装)

您可以直接通过 Composer 安装此插件：

```
composer require nopj/flarum-ext-custom-search:*
```

启用插件：

```
php flarum extension:enable nopj-custom-search
```

清除缓存：

```
php flarum cache:clear
```

开发与编译
-----

[](#开发与编译)

如果您需要修改插件的 JS 或 CSS，请进入 `js` 目录进行操作：

```
cd packages/flarum-ext-custom-search/js
# 安装依赖
npm install
# 开发模式（实时监听变化）
npm run dev
# 生产模式编译
npm run build
```

使用说明
----

[](#使用说明)

1. 在论坛顶部的搜索框中输入您要查找的内容。
2. （可选）点击搜索框左侧的下拉菜单，切换您偏好的搜索引擎（默认 Bing）。
3. 按下 **回车键** 或点击搜索框右侧的 **搜索按钮**。
4. 浏览器将在新标签页中打开对应搜索引擎的搜索结果页面。

开源协议
----

[](#开源协议)

本项目采用 MIT 协议开源。

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance86

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

73d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c67e2c684c4576cbf4e68917c8f5b0c56cbea1604d90a50a73b1aac286a29f74?d=identicon)[chao2hang](/maintainers/chao2hang)

---

Top Contributors

[![chao2hang](https://avatars.githubusercontent.com/u/84966417?v=4)](https://github.com/chao2hang "chao2hang (2 commits)")

### Embed Badge

![Health badge](/badges/nopj-flarum-ext-custom-search/health.svg)

```
[![Health](https://phpackages.com/badges/nopj-flarum-ext-custom-search/health.svg)](https://phpackages.com/packages/nopj-flarum-ext-custom-search)
```

###  Alternatives

[ruflin/elastica

Elasticsearch Client

2.3k50.4M203](/packages/ruflin-elastica)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[massive/search-bundle

Massive Search Bundle

721.4M13](/packages/massive-search-bundle)[outl1ne/nova-multiselect-filter

Multiselect filter for Laravel Nova.

45802.7k3](/packages/outl1ne-nova-multiselect-filter)[handcraftedinthealps/zendsearch

a general purpose text search engine written entirely in PHP 5

39921.0k35](/packages/handcraftedinthealps-zendsearch)[jjandxa/flarum-ext-chinese-search

chinese search

361.4k](/packages/jjandxa-flarum-ext-chinese-search)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)