- Published on
Synonyms with Search API
- Christophe Jossart
Here is a really simple way to handle synonyms (or extra keywords) using Search API out of the box with a database server and no custom code involved.
We want to do a full text search based on synonyms that does not appear on the frontend.
These ones should be set from the Tags vocabulary.
The method should be flexible regarding translations, available for content editors and easily generalizable.
- Article node type with Tags term reference
- The Tags vocabulary have a Synonym plain text field with unlimited number of values
Add a synonym field to the Tags vocabulary
So we end up with something like this for the Tags term
and this for the Article node
Install Search API with Database Search Defaults, it provides a fully working configuration with no other backend needed than the DB. The only requirement for this demo is to start with a vanilla Drupal setup or an existing one that still contains the Article, Tags and Comments configuration.
composer require drupal/search_api drush en search_api_db_defaults -y
Add a new Taxonomy term view mode of Search index (/admin/structure/display-modes/view)
Enable it for the Tags vocabulary (/admin/structure/taxonomy/manage/tags/overview/display) and configure it
Render it on the Article Search index display that is already configured by Search API (/admin/structure/types/manage/article/display/search_index).
The Default search index from the Database Search Defaults module is already configured to make use of this display. This can be checked with /admin/config/search/search-api/index/default_index/fields (edit Rendered item).
Re-index the content (/admin/config/search/search-api/index/default_index)
Head to /search/content and type a keyword that is not displayed on the frontend.
This setup is site building based, backend agnostic and can be used for simple use cases.
If you are looking after a module that supports the synonyms.txt format used by Solr, you may have a look at the Search API Synonym module. It also supports a plugin system that allows to export / import other formats.