# Troubleshooting

# The search results show duplicated records, why?

Algolia limits the amount of text that can index in a record (10K - https://www.algolia.com/doc/faq/indexing/how-do-i-reduce-the-size-of-my-records/ (opens new window)). An error is generated if the request to index the record hits the limit.

The XT Search indexer has an internal parameter to restrict the text sent to Algolia. The record can have several text fields, and the sum is not greater than 10K. Consequently, if a content item has more than 10K, the indexer splits it into several records. These records appear as duplicated search results. To solve the issue, please, configure the search records de-duplication: Indexing Long Documents and Reducing Record Size (opens new window)

# 504 Gateway Time-out

The extension requires a connection to the Algolia servers to index the records of the site. In particular, the current API opens connections to:

  • algolia.com
  • algolia.io
  • algolia.net
  • algolianet.com

If the connection to external servers is restricted, then an error such as "Gateway Time-out" or connection error is received. To solve, the issue, please, ensure that your server can open a connection to the domains listed above.

# Class 'IntlDateFormatter' not found

The PHP installed on your server doesn't have the Internationalization Functions extension. Please, ask the hosting support to enable it on your site.

# Logging Mode: Developer's swiss army knife

The Logging Mode is a key tool to check the extension inner workings. It is a handy way to check component internals, beyond a simple error message.

You can enable the logging mode to leave a track of server-side operations.

To enable the Logging mode:

  • Access the Options menu, in Components/(Extension Name) Control Panel.
  • In the System settings tab,
  • Enable the: File Logging Level (For example, 3-All)

As a result, the extension is going to generate the xt-logging.log file with all operations details into logs/ directory. Please, check the file generated in logs/xt-logging.log or administrator/logs/xt-logging.log.

Last Updated: 9/18/2023, 5:12:52 PM