Skip to content

Configuration

Petteri Karttunen edited this page Oct 14, 2019 · 19 revisions

General

Important: If you are building the modules by yourself and cannot see the 'Liferay GSearch' or 'category.gserch' option in the System settings, you are hit by this: https://issues.liferay.com/browse/LPS-98190.

Please go through the configurations in Control Panel -> System Settings -> Liferay GSearch and see the module specific instructions in their respective project folders.

All modules have default configurations but all options requiring the custom Elasticsearch adapter are disabled by default. This impacts the most the clause configuration.

The ultimate source source of information is the source code and Elasticsearch documentation. Especially for query configuration options, please also see the Elasticsearch Query DSL documentation.

Configuration syntax is JSON and it should be noticed that the validity is not checked on configuration save. It is recommended to use some of the available online syntax checkers whenever changing the configuration. If you are having problems with configuration (portlet stops working) it's usually because of malformed JSON. Note also that field names and values are case sensitive.

You can find the default core configurations here

Configuration Variables

There are configuration template variables available to inject to the queries. For example to inject your current keywords you can use $_context.keywords_$

To see all the available variables, enable debug logging on the fi.soveltia.liferay.gsearch.core.impl.query.context

Having Difficulties?

This application is all about configuration. Configuration can be simple or very complex depending on your requirements. I've tried to provide example configuration on simple use cases but in case you are having problems, please feel free to leave a ticket. Thanks,,,