fixstacks / module-zero-search

1.0.0 2026-10-14 22:27 UTC

Requires

• php: ~8.2.0||~8.3.0||~8.4.0
• fixstacks/module-zero-core: ^1.0
• magento/framework: 103.0.*
• magento/module-backend: *
• magento/module-catalog: *
• magento/module-catalog-search: *
• magento/module-cms: *
• magento/module-config: *
• magento/module-elasticsearch: *
• magento/module-search: *
• magento/module-store: *

OSL-3.0, AFL-3.0

• Roman Pasichnyk

• search
• magento
• opensearch
• zero
• magento2
• typo-tolerance
• magento-open-source

Published on Packagist.org on 2026-10-15 00:49 UTC

README

Store search that forgives typos and finds more than products.

• Typos forgiven: a search that finds nothing as typed runs once more with close spellings (OpenSearch fuzziness AUTO: a letter off up to 5 letters, two beyond; the first letter right): "jaket" finds jackets. Exact results are never mixed with fuzzy ones. The results page says "Nothing matches "jaket" exactly; these are close spellings."; the search box's products are headed "Close spellings of …". Applies to the quick_search_container request (results page, layered navigation counts, the search box).
• More than products, in the search box's suggestions (3 of each) and above the results (a row of each): categories (with where they are, "Men › Tops"), brands (Zero_Brands), blog posts (Zero_Blog), CMS pages. Each word of the query must be in the name. Another module adds its own: Zero\Search\Model\SourceInterface, registered on Zero\Search\Model\Sources in its etc/frontend/di.xml.
• Popular searches: the empty search box (on first focus) and a search with no results offer the store's most searched terms that found something (Marketing > Search Terms: untick "Display in Suggested Terms" to hide one).

Settings: Stores > Configuration > Zero > Search (typos, more results, popular count). Synonyms and redirects for a term are Magento's own: Marketing > SEO & Search > Search Synonyms, Search Terms.

The search box template is the Zero theme's Magento_Search/templates/form.mini.phtml; the suggestions endpoint is Zero_Core's zero/search/suggest, its template replaced here.

Install

Requires Magento Open Source 2.4.7–2.4.9 and PHP 8.2–8.4.

composer require fixstacks/module-zero-search
bin/magento setup:upgrade
bin/magento setup:di:compile           # production mode
bin/magento setup:static-content:deploy # production mode
bin/magento cache:flush

Composer installs fixstacks/module-zero-core with it.

Part of fixstacks/zero, which installs the Zero theme and every Zero module at once.

Tests

Test/Unit (fuzzy clauses, sources); dev/tests/zero-e2e/tests/search.spec.ts (ZERO_SEARCH_TYPO, ZERO_SEARCH_CATEGORY for a catalog other than Luma's).

License

OSL-3.0 or AFL-3.0, your choice: see NOTICE.md.

Zero is made by Fixstacks in partnership with Vilmate, a software development company. Documentation: https://fixstacks.com/zero/docs. Demo store: https://zero.fixstacks.com.