Smart Search for OpenCart — product search with typos, codes and live suggestions

Smart Search for OpenCart makes a shop’s search work the way shoppers actually use it. They type with typos (“ноутбак” instead of “ноутбук”), mix Ukrainian and Russian (“телевизор samsung”), enter a model the way it is printed on the box — with spaces and dashes (“PH 9845/4-10”) — or type in the wrong keyboard layout altogether. The standard OpenCart search looks for an exact piece of text in the name, so all of these queries end on an empty page, and the shopper leaves for a competitor.

Smart Search builds its own index in the shop database — no external service, no monthly fee — and finds products by the name in every shop language, by model and codes, categories and manufacturers, allowing for typos, word endings and different spellings. Under your theme’s standard search field live suggestions appear with photo and price, and the core OpenCart results page shows the best matches first. No core files are changed. One licence, three builds: OpenCart 4.x, 3.x and 2.3.

What the buyer sees

• Suggestions while typing. After two characters products appear under the search field with photo, price (with specials and the customer group price) and the highlighted word; above them categories with match counts, below — “All results (N)”.
• Correction without questions. If the query has a typo, the shopper sees “Showing results for ноутбук” — and results straight away, not an empty page advising “try another word”.
• Keyboard. Arrows move through the suggestions, Enter on a highlighted item opens it, Enter with nothing highlighted opens the results page, Escape closes the list without clearing the text.
• Mobile. At 375 and 320 px the suggestion list fits the screen.

The results page is the core OpenCart search page of your theme: the same design, sorting by price or name, the category filter, pagination. Only order and completeness change: exact matches in the name first, then by code, category and manufacturer, and out-of-stock products at the end (or hidden, if you choose).

What the admin gets

Extensions → Modules → Smart Search, four tabs: “Settings”, “Index and test”, “What shoppers search for” and “Licence”.

• Settings. Rank the results page, out-of-stock products last or hidden, typo strictness (lenient / strict / exact words only), number of products in the suggestions, how many characters before suggestions start, what to show (photo, price, model, categories), the CSS selector of the search fields.
• What is searched. Always — the name in every shop language, the model and codes. With switches — categories and manufacturers; in Pro — tags, attributes, option values and descriptions. Change the set and the index rebuilds itself with a progress bar while search keeps working.
• Index and test. How many products, words and codes are indexed, how many changes are queued, when the last build ran and how long it took, and a “Rebuild the index” button.
• Tester. Type like a shopper — with typos, in the other language, a code with spaces — and see what they get, in what order and in how many milliseconds.
• Cron (optional). A URL with a secret key for the hosting cron — useful if an import changes products directly in the database.

Pro: keyboard layout, transliteration, synonyms, statistics

• Wrong keyboard layout. “yjen,er” finds “ноутбук”, “тщеуищщл” finds “notebook”. The shopper did not notice the keyboard was on the other language — the shop did.
• Transliteration. “noutbuk” finds “ноутбук”, “самсунг” finds “Samsung”, “дайсон” finds “Dyson”.
• Synonyms. Groups (“ноутбук, лептоп, laptop” — any word finds the others) and one-way (“айфон => iphone”); a starter list of popular brands is filled in.
• More fields. Tags, attributes (colour, size, material), option values and the first 5,000 characters of the description — weighted lower than the name.
• What shoppers search for. The most frequent queries of the last 30 days and the queries that found nothing: products people want to buy from you, or synonyms that are missing. No personal data; searches from a browser with the admin open are not counted.

How it works — step by step

1. After installation the module builds the index: it splits names, codes, categories and manufacturers into words, folds different spellings into one, keeps word endings separately and stores trigrams of every word for typo lookup. It builds in steps of 250 products.
2. The shopper types in the theme’s search field — the module’s script asks the module’s own route for suggestions, and it answers from the index in milliseconds.
3. Every word of the query is looked up exactly, as a prefix and — if not found — with typos; codes are compared without spaces, dashes and dots. Pro adds the layout fix, transliteration and synonyms.
4. Products get scores: a match in the name weighs more than in a category or the description, a full match more than a partial one; out-of-stock products go last.
5. On the search page the module hands OpenCart the list of found products in relevance order, and OpenCart itself computes everything else — prices, sorting, the category filter, pagination.
6. Nothing found, or the index is still being built — the standard OpenCart search takes over, so the shopper never sees an error.

How much it costs

Pro costs UAH 990, a single payment, lifetime licence. No yearly payments. One licence for one domain covers all three builds — OpenCart 4.x, 3.x and 2.3. Moving the shop to another domain? Click “Release licence” on the “Licence” tab of the old shop and activate the key on the new one.

Trial first, then pay. The free 7-day Pro trial starts with a button on the “Licence” tab, one trial per shop. After the trial the index rebuilds itself without the Pro fields and the base search keeps working.

Under the hood

• No core edits, no OCMOD. The results page works through before/after events of the OpenCart product model on the search route: the module adds a condition with the found products and a relevance order to the core query. Customer group prices, specials, sorting, the category filter and pagination therefore stay core.
• Own index in the cc_srch_* tables: documents, words, postings, trigrams, codes, a change queue. A full build rewrites the index in place, so search keeps working during a rebuild.
• Updates without delay. Admin events on saving and deleting a product, category, manufacturer and option; changes to more than 50 products go through the queue. An order only updates the in-stock flag. Once an hour there is a safety check by the product’s modification date.
• Text normalisation is the same as in our Smart Search for WooCommerce: the same light stemmer, the same rules for і/и/ы, є/е/э, apostrophes and Cyrillic look-alikes of Latin letters in codes.
• Smart Filter compatibility. For other modules the search text stays a “search”, so Smart Filter for OpenCart narrows exactly the Smart Search results.
• Removal. Uninstalling removes the events, the cron task, the index tables and the settings — the shop is back on the standard search. The licence key goes with the settings: activate it again after reinstalling.

How to install

1. OpenCart 4: Extensions → Installer → upload cc_search.ocmod.zip (keep the file name) and click “Install”. OpenCart 3: Extensions → Installer → cc_search-oc3.ocmod.zip. OpenCart 2.3: the 2.3 installer does not copy files without FTP configured, so upload the contents of the upload/ folder from cc_search-oc2.ocmod.zip to the shop root with your hosting file manager — no FTP setup in OpenCart needed.
2. Extensions → Extensions → Modules → Smart Search → “Install”, then “Edit”.
3. The index starts building at once — wait for “The index is ready” (seconds for a few thousand products).
4. “Index and test” tab: type a query with a typo or a code with spaces into the tester to see what a shopper gets.
5. Open the storefront and start typing in the search field — suggestions appear under it.
6. For Pro: paste the licence key from the email after payment, or start the 7-day trial on the “Licence” tab. On 3.x and 2.3, optionally add the cron URL from the “Index and test” tab to your hosting cron.