Troubleshooting

This section describes the most common issues that customers report and how they can be resolved:

note

Please, make sure that you're using the latest version of the extension. Otherwise, please update it to the latest version.

Display Search Recommendations

Enable Search Recommendations is now a part of Magento's core functionality, and this option was removed from the module configurations.

You can find related Magento configurations via Stores -> Settings -> Configuration -> Catalog -> Catalog -> Catalog Search -> Enable Search Recommendations.

---

After enabling fallback search and entering too many words, search fails

Possible cause: too small a max_execution_time PHP parameter, which is not enough to complete requests with the large number of words.

There are two possible solutions:

1. Increase max_execution_time parameter either in .htaccess, or directly in php.ini.

2. Use default Magento settings to adjust search parameters. They are located at Stores -> Configuration -> Catalog -> Catalog Search and consist of two options:

   • Minimal Query Length - defines minimal quantity of words in search request (1 for default).
   • Maximum Query Length - defines maximal quantity of words in search request (128 by default).

Typically, it is enough to decrease the latter parameter until the search works correctly.

---

Aheadworks blog search doesn`t return results

To resolve the issues, follow these steps:

1. Find and open the following file: Aheadworks/Blog/Block/Post.php

2. Find public function getSocialIconsHtml() and find this line: $block = $this->getLayout()->createBlock

3. Place this code before

   $socialIconsBlock = !empty($this->getSocialIconsBlock())?$this->getSocialIconsBlock():'Aheadworks\Blog\Block\Sharethis';

4. Replace $this->getSocialIconsBlock() after createBlock with $socialIconsBlock

   You should get your code to look like

   $socialIconsBlock = !empty($this->getSocialIconsBlock())?$this->getSocialIconsBlock():'Aheadworks\Blog\Block\Sharethis'`; `$block = $this->getLayout()->createBlock( $socialIconsBlock,...

---

If Autocomplete and/or Search Results is too slow

Possible causes and solutions:

1. Search Engine settings

   How to Check

   Navigate to Search engine configuration section. If the option Search engine type is set to MYSQL, this is the probable cause.

   How to Resolve

   If you have Mirasvit MYSQL Search Module version below 1.0.23, upgrade it to latest version, as it contains significant improvements that speed up the built-in search engine.

   Set Enable fast mode to Yes in the Autocomplete base configuration

   If this does not help, consider the recommendation from the next option.

2. Large quantity of products

   How to Check

   Navigate to Catalog -> Products section. If you have more than 14k records there, this is the probably cause.

   How to Resolve

   Replace Build-In engine to External Sphinx engine in option Search engine type in the Search engine configuration section.

   Search Sphinx should be installed first and then connected to your store.

3. High-load Cron tasks

   How to Check

   Install Cron Scheduler for M2.

   Navigate to System -> Cron Scheduler by KiwiCommerce -> All cron jobs section and System -> Cron Scheduler by KiwiCommerce -> Cron job schedule timeline. Check there execution time and results of cron tasks. If some of them are stuck or executed for too long period, this is the probably cause.

   How to Resolve

   Disable or reconfigure all cron tasks, which are stuck or taking too much time.

---

Each search page shows "The page you requested was not found"

If you see the error on each search page:

   The page you requested was not found, but we have searched for relevant content

This issue may occur if a certain page contains resources (JS, CSS, images) that return a 404 error.

To prevent this issue, you can disable the Redirect 404 pages to search results at Redirection rules section