PHPackages silverstripe/silverstripe-discoverer - 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. silverstripe/silverstripe-discoverer ActiveSilverstripe-vendormodule[Search & Filtering](/categories/search) silverstripe/silverstripe-discoverer ==================================== Service agnostic abstraction of search querying requirements 3.0.1(6mo ago)24.0k↓20.8%1[4 issues](https://github.com/silverstripeltd/silverstripe-discoverer/issues)4BSD-3-ClausePHPPHP ^8.3CI passing Since Jul 28Pushed 6mo ago9 watchersCompare [ Source](https://github.com/silverstripeltd/silverstripe-discoverer)[ Packagist](https://packagist.org/packages/silverstripe/silverstripe-discoverer)[ Docs](https://github.com/silverstripeltd/silverstripe-discoverer)[ RSS](/packages/silverstripe-silverstripe-discoverer/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (16)Used By (4) 🧭 Silverstripe Discoverer: Search and querying module for Silverstripe CMS ========================================================================== [](#-silverstripe-discoverer-search-and-querying-module-for-silverstripe-cms) - [Purpose](#purpose) - [Delivery](#delivery) - [Installation](#installation) - [Feature support](#feature-support) - [Getting started](#getting-started) - [Simple usage](docs/simple-usage.md) - [Detailed result handling](docs/detailed-result-handling.md) - [Detailed querying](docs/detailed-querying.md) - [Available service integration modules](#available-service-integration-modules) Purpose ------- [](#purpose) To provide you (a Silverstripe developer) with interfaces for search querying that **do not change**, even when you switch between different search service providers (EG: Elastic, Algolia, Silverstripe Search). Delivery -------- [](#delivery) To deliver on our purpose, the way that you perform filtering, faceting, and certainly the way that you display results, is very likely going to change. We hope that the learning curve is reasonable, and that the majority of developer interactions with this code is intuative (once you understand the mentality behind it). You will **not** be able to perform any sort of "raw filtering" or "raw querying" with service specific formats, as that would not meet the purpose of this module - which is to use a common interface that will allow you to easily switch between services. Installation ------------ [](#installation) **Note:** this module does not function without an [integration module](#available-service-integration-modules) If you want to install this module for developing your own integration module, then you can install it with: ``` composer require "silverstripe/silverstripe-discoverer" ``` If you are planning to search through a page and controller, then you might also want to consider using [Silverstripe Discoverer > Search UI](https://github.com/silverstripeltd/silverstripe-discoverer-search-ui) Feature support --------------- [](#feature-support) Whether or not certain features are supported **by this module**. Noting that different search providers often do things in different ways, and often have different levels of support for features. This module attempts to provide a level of functionality that is commonly supported by many different services. FeatureModule supportFuture module supportRationaleFiltersYesYesYou should (hopefully) be able to achieve any sort of nested filtering that you require.FacetsPartialPartialFacet support differs hugely between search services. Current thinking is to try and limit what sort of Facet integrations we support (EG: no Geolocation) in the hopes that if you switch services in the future, you won't lose functionality.Multi-searchNoIf desiredNot supported by many search services. It wouldn't be unreasonable effort to add this functionality though. Plugin modules for services without mult-search could manually perform 2 searches and combine the results.Query suggestions (aka auto-complete)YesYesQuery suggestions and Spelling suggestions are the same feature for some services, but a different feature for others. Discoverer treats them as different features with a common goal (providing some form of "suggestion")Spelling suggestions (aka "did you mean")YesYesQuery suggestions and Spelling suggestions are the same feature for some services, but a different feature for others. Discoverer treats them as different features with a common goal (providing some form of "suggestion")Click through loggingYesYesSupported in Elastic App Search, but not supported by many other Search Services (including Elasticsearch). This feature in particular is an example of the "silent treatment" that might be applied when a feature disappears between service providers.Getting started --------------- [](#getting-started) - Querying, filtering, faceting, etc, will now all be performed through interfaces that are provided by this module. There is no ability to perform (eg) "raw filtering", or "raw faceting", where you pass data that is in a specific format for a specific search service provider. This would break the purpose of this module, since if your search service provided changed, then your "raw filtering" would also likely break. - This module does not assume that your search Documents relate to a `DataObject`, as such, it is recommended that your search Documents contain all of the data required for you to build out search results without needing to query the application for any additional information. - When you perform a search, you will receive a `Result` object that includes a `PaginatedList` of `Record` objects. The `Record` objects will contain any/all information that you requested during your query, and this is how you will output info into your template. - Fields within your `Record` objects will match the fields in your search index, but be converted to PascalCase, with abbreviations presented as (eg) `Id`, `Url`, etc. You can read more about this under [Field convensions](docs/field-convensions.md). Additional documentation can also be found below: - [Simple usage](docs/simple-usage.md) - Provides some basic code samples. - Includes *a bit* more detail on how `Results` and `Records` work. - [Detailed result handling](docs/detailed-result-handling.md) - Lots more information about `Results`, `Records`, pagination, analytics. - [Detailed querying](docs/detailed-querying.md) - Lots more information about filters, facets, sorts, and (hopefully) everything else you need to know to perform whatever sort of search you require. Protected field names --------------------- [](#protected-field-names) You're **mostly** free to use any field names you would like when configuring your data sources, however, there are 2 methods provided in our `Record` class that will effectively override any field that is made available under: - `AnalyticsData` - `DecoratedLink` Available service integration modules ------------------------------------- [](#available-service-integration-modules) - [Silverstripe Discoverer > Elastic Enterprise Search](https://github.com/silverstripeltd/silverstripe-discoverer-elastic-enterprise) - [Silverstripe Discoverer > Silverstripe Search](https://github.com/silverstripeltd/silverstripe-discoverer-bifrost) ### Health Score 42 — FairBetter than 90% of packages Maintenance48 Moderate activity, may be stable Popularity26 Limited adoption so far Community24 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 82.4% 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 ~43 days Recently: every ~50 days Total 12 Last Release 186d ago Major Versions 1.2.0 → 2.0.02024-11-06 1.x-dev → 2.1.12025-09-04 2.1.1 → 3.0.02025-10-20 PHP version history (2 changes)1.0.0PHP ^8.1 3.0.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/afbb3dcc9ef29c1a6eedd6addcae5fce9ab1271915a85a4c349301b71237368d?d=identicon)[silverstripe-machine01](/maintainers/silverstripe-machine01) --- Top Contributors [![chrispenny](https://avatars.githubusercontent.com/u/505788?v=4)](https://github.com/chrispenny "chrispenny (61 commits)")[![blueo](https://avatars.githubusercontent.com/u/948122?v=4)](https://github.com/blueo "blueo (7 commits)")[![Cambis](https://avatars.githubusercontent.com/u/12287346?v=4)](https://github.com/Cambis "Cambis (2 commits)")[![alex-dna](https://avatars.githubusercontent.com/u/6982515?v=4)](https://github.com/alex-dna "alex-dna (1 commits)")[![amolswnz](https://avatars.githubusercontent.com/u/20012807?v=4)](https://github.com/amolswnz "amolswnz (1 commits)")[![mateusz](https://avatars.githubusercontent.com/u/118653?v=4)](https://github.com/mateusz "mateusz (1 commits)")[![vinstah](https://avatars.githubusercontent.com/u/4538082?v=4)](https://github.com/vinstah "vinstah (1 commits)") --- Tags searchsilverstripequeryfilterfilteringSilverstripe-CMSsearchingquerying ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/silverstripe-silverstripe-discoverer/health.svg) ``` [![Health](https://phpackages.com/badges/silverstripe-silverstripe-discoverer/health.svg)](https://phpackages.com/packages/silverstripe-silverstripe-discoverer) ``` ### Alternatives [mongerinc/search-request Represent complex search queries and convert them to and from JSON 252.1k](/packages/mongerinc-search-request)[silverstripe/solr Solr integration for SilverStripe. Note that this is NOT related to the silverstripe/fulltext package. 1914.0k](/packages/silverstripe-solr)[silverstripe-terraformers/gridfield-rich-filter-header Rich filter header component for GridField 1325.7k1](/packages/silverstripe-terraformers-gridfield-rich-filter-header) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)