PHPackages                             professional-wiki/wikibase-faceted-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 &amp; Filtering](/categories/search)
4. /
5. professional-wiki/wikibase-faceted-search

ActiveMediawiki-extension[Search &amp; Filtering](/categories/search)

professional-wiki/wikibase-faceted-search
=========================================

Enhances MediaWiki's search with faceted search capabilities. Filter results based on instance type or statement values

1.0.1(5mo ago)66332[20 issues](https://github.com/ProfessionalWiki/WikibaseFacetedSearch/issues)[3 PRs](https://github.com/ProfessionalWiki/WikibaseFacetedSearch/pulls)GPL-2.0-or-laterPHPPHP &gt;=8.1CI failing

Since Dec 6Pushed 3mo ago6 watchersCompare

[ Source](https://github.com/ProfessionalWiki/WikibaseFacetedSearch)[ Packagist](https://packagist.org/packages/professional-wiki/wikibase-faceted-search)[ Docs](https://professional.wiki/en/extension/wikibase-faceted-search)[ RSS](/packages/professional-wiki-wikibase-faceted-search/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (7)Versions (9)Used By (0)

Wikibase Faceted Search
=======================

[](#wikibase-faceted-search)

[![GitHub Workflow Status](https://camo.githubusercontent.com/1442e4f24ab48ff9ea9d6fbaf0be8a5d0434df2f3038ccc3770b6aacb25c1a00/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f50726f66657373696f6e616c57696b692f57696b6962617365466163657465645365617263682f63692e796d6c3f6272616e63683d6d6173746572)](https://github.com/ProfessionalWiki/WikibaseFacetedSearch/actions?query=workflow%3ACI)[![codecov](https://camo.githubusercontent.com/db474610ba927e34af32057f79ed364da592144e211d10d48b875ad5a9627772/68747470733a2f2f636f6465636f762e696f2f67682f50726f66657373696f6e616c57696b692f57696b6962617365466163657465645365617263682f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/ProfessionalWiki/WikibaseFacetedSearch)[![Latest Stable Version](https://camo.githubusercontent.com/7c3db10d485bc77993dac8e4f028cee675a6281485ac9c8039f4581fbdc98e54/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f77696b69626173652d666163657465642d7365617263682f762f737461626c65)](https://packagist.org/packages/professional-wiki/wikibase-faceted-search)[![Download count](https://camo.githubusercontent.com/eb8b980479456a9029302121551e661bf76af72a562a2ec85713b58af0c33df8/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f77696b69626173652d666163657465642d7365617263682f646f776e6c6f616473)](https://packagist.org/packages/professional-wiki/wikibase-faceted-search)[![License](https://camo.githubusercontent.com/071350580ac5a515231e284050f1c30cc60e05d6e09c568a9a1913ebb04f5dcc/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f77696b69626173652d666163657465642d7365617263682f6c6963656e7365)](LICENSE)

Wikibase Faceted Search enhances MediaWiki's search with faceted search capabilities. Filter results based on instance type or statement values.

- [Introduction to the extension](https://professional.wiki/en/extension/wikibase-faceted-search#Overview)
- [Usage documentation](https://professional.wiki/en/extension/wikibase-faceted-search#Usage)
- [Installation](https://professional.wiki/en/extension/wikibase-faceted-search#Installation)
- [Configuration](https://professional.wiki/en/extension/wikibase-faceted-search#Configuration)
- [Development](#development)
- [Release notes](#release-notes)

Get professional support for this extension via [Professional Wiki](https://professional.wiki), its creators and maintainers. We provide [MediaWiki Development](https://professional.wiki/en/mediawiki-development), [MediaWiki Hosting](https://pro.wiki), and [MediaWiki Consulting](https://professional.wiki/en/mediawiki-consulting-services) services.

Demo
----

[](#demo)

Quickly get an idea about what this extension does by checking out the [demo video](https://www.youtube.com/watch?v=CxKWpTQBrqk)or [MaRDI Portal search](https://portal.mardi4nfdi.de/wiki/Special:Search).

Development
-----------

[](#development)

Run `composer install` in `extensions/WikibaseFacetedSearch/` to make the code quality tools available.

### Running Tests and CI Checks

[](#running-tests-and-ci-checks)

You can use the `Makefile` by running make commands in the `WikibaseFacetedSearch` directory.

Commands to run in a MediaWiki environment/container:

- `make` or `make ci`: Run everything
- `make test`: Run all PHP tests
- `make phpunit --filter FooBar`: run only PHPUnit tests with FooBar in their name
- `make cs`: Run PHP style checks and static analysis
- `make phpcs`: Run PHP style checks
- `make stan`: Run PHP static analysis
- `make stan-baseline`: Update the PHPStan baseline file (which contains errors we wish to ignore)

Commands that use Docker:

- `make jest` Run JS tests
- `make lint` Lint JS, CSS, and i18n files
- `make js` Run all JS checks

Release Notes
-------------

[](#release-notes)

### Version 1.0.1 - 2025-12-05

[](#version-101---2025-12-05)

- Updated translations

### Version 1.0.0 - 2025-06-10

[](#version-100---2025-06-10)

- Added tab and sidebar-based facet UI to `Special:Search`
- Added range facets for numerical and date values
- Added list facets with available values listed by occurrence counts
- Added special support for values of type Wikibase Item to list facets
- Added support for "any of", "all of", "no value", "any value" to list facets
- Added a mobile version of the facet UI
- Added comprehensive Elasticsearch indexing of Wikibase values
- Added support for attaching indexed Wikibase values to a normal wiki page for combined full-text and structured queries
- Added on-wiki configuration UI at `MediaWiki:WikibaseFacetedSearch`
- Compatibility with MediaWiki 1.43 up to (at least) 1.44
- Compatibility with PHP 8.1 up to (at least) 8.4

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance56

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~178 days

Total

2

Last Release

164d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/451bd4039d530fed8f9c3da91bfa519233a397d2182cdfdcad700f6cfea19b7f?d=identicon)[Jeroen De Dauw](/maintainers/Jeroen%20De%20Dauw)

![](https://avatars.githubusercontent.com/u/1104078?v=4)[Karsten Hoffmeyer](/maintainers/kghbln)[@kghbln](https://github.com/kghbln)

---

Top Contributors

[![JeroenDeDauw](https://avatars.githubusercontent.com/u/146040?v=4)](https://github.com/JeroenDeDauw "JeroenDeDauw (112 commits)")[![malberts](https://avatars.githubusercontent.com/u/1428594?v=4)](https://github.com/malberts "malberts (85 commits)")[![alistair3149](https://avatars.githubusercontent.com/u/9260542?v=4)](https://github.com/alistair3149 "alistair3149 (79 commits)")[![translatewiki](https://avatars.githubusercontent.com/u/24829418?v=4)](https://github.com/translatewiki "translatewiki (30 commits)")[![kghbln](https://avatars.githubusercontent.com/u/1104078?v=4)](https://github.com/kghbln "kghbln (1 commits)")

---

Tags

elasticsearchfaceted-searchmediawikimediawiki-extensionwikibasewikibase-extensionsearchelasticsearchmediawikiqueryfaceted searchwikibasecirrussearchhaswbstatement

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/professional-wiki-wikibase-faceted-search/health.svg)

```
[![Health](https://phpackages.com/badges/professional-wiki-wikibase-faceted-search/health.svg)](https://phpackages.com/packages/professional-wiki-wikibase-faceted-search)
```

###  Alternatives

[elasticsearch/elasticsearch

PHP Client for Elasticsearch

5.3k178.3M943](/packages/elasticsearch-elasticsearch)[10up/elasticpress

Supercharge WordPress with Elasticsearch.

1.3k374.3k6](/packages/10up-elasticpress)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15224.3M65](/packages/opensearch-project-opensearch-php)[jeroen-g/explorer

Next-gen Elasticsearch driver for Laravel Scout.

397612.3k](/packages/jeroen-g-explorer)[netgen/query-translator

Query Translator is a search query translator with AST representation

2042.0M6](/packages/netgen-query-translator)[jolicode/elastically

Opinionated Elastica based framework to bootstrap PHP and Elasticsearch implementations.

2571.7M1](/packages/jolicode-elastically)

PHPackages © 2026

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