PHPackages empiricompany/openmage-search - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Search & Filtering](/categories/search) 4. / 5. empiricompany/openmage-search ActiveMagento-module[Search & Filtering](/categories/search) empiricompany/openmage-search ============================= Advanced search module for OpenMage using Typesense 1.0.0(1y ago)71272[1 PRs](https://github.com/empiricompany/openmage-search/pulls)MITCSSPHP >=7.4 Since Apr 18Pushed 3mo ago1 watchersCompare [ Source](https://github.com/empiricompany/openmage-search)[ Packagist](https://packagist.org/packages/empiricompany/openmage-search)[ RSS](/packages/empiricompany-openmage-search/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (2)Versions (4)Used By (0) TypeSense Search for OpenMage ============================= [](#typesense-search-for-openmage) Advanced search module for OpenMage using Typesense as search engine and instantsearch.js for frontend. Overview -------- [](#overview) [![instantsearch](https://private-user-images.githubusercontent.com/5071467/435198025-919c8179-c37c-49b1-bcfb-ed2979fdf93c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU1MTMyMjEsIm5iZiI6MTc3NTUxMjkyMSwicGF0aCI6Ii81MDcxNDY3LzQzNTE5ODAyNS05MTljODE3OS1jMzdjLTQ5YjEtYmNmYi1lZDI5NzlmZGY5M2MucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwNiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDZUMjIwMjAxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9OWI4ZDRkM2ZlMjJiMTQzODViZGIxY2RjNWY1MTE5YTE3MDFjMmI0MjA4OWMyNDE4MTA2MDMzNThkYzk3OWY2MSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.dL_5_dlTDriuN7bUMVso_BKs3yKeP8ta7sstsKZ85kY)](https://private-user-images.githubusercontent.com/5071467/435198025-919c8179-c37c-49b1-bcfb-ed2979fdf93c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU1MTMyMjEsIm5iZiI6MTc3NTUxMjkyMSwicGF0aCI6Ii81MDcxNDY3LzQzNTE5ODAyNS05MTljODE3OS1jMzdjLTQ5YjEtYmNmYi1lZDI5NzlmZGY5M2MucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwNiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDZUMjIwMjAxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9OWI4ZDRkM2ZlMjJiMTQzODViZGIxY2RjNWY1MTE5YTE3MDFjMmI0MjA4OWMyNDE4MTA2MDMzNThkYzk3OWY2MSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.dL_5_dlTDriuN7bUMVso_BKs3yKeP8ta7sstsKZ85kY) MM Search is a module that replaces the default search engine in OpenMage with Typesense, a fast and typo-tolerant search engine. This module provides: - Instant search with autocomplete - Faceted search - Typo tolerance - Fast and relevant search results - Easy configuration Requirements ------------ [](#requirements) - OpenMage LTS 19.x or higher - PHP 7.4 or higher - Typesense server (self-hosted or cloud) ### docker-compose.yml example for self-host a TypeSense instance with a dashboard [](#docker-composeyml-example-for-self-host-a-typesense-instance-with-a-dashboard) ``` services: typesense: image: typesense/typesense:27.1 ports: - "8108:8108" environment: TYPESENSE_DATA_DIR: /data TYPESENSE_API_KEY: S3CR3T TYPESENSE_API_ALLOW_ORIGINS: "*" healthcheck: test: ["CMD-SHELL", "exit 0"] interval: 5s timeout: 5s retries: 20 volumes: - typesense-data:/data typesense-dashboard: image: bfritscher/typesense-dashboard ports: - "5002:80" # Puoi cambiare la porta se necessario environment: TYPESENSE_API_URL: "http://typesense:8108" TYPESENSE_API_KEY: "S3CR3T" depends_on: - typesense restart: always volumes: typesense-data: ``` Installation ------------ [](#installation) ### Via Composer [](#via-composer) ``` composer require empiricompany/openmage-search ``` This will automatically install the latest stable version of the module. Configuration ------------- [](#configuration) 1. Go to System > Configuration > MM Search 2. Enable the module 3. Configure the Typesense connection settings: - Admin API Key - Search-Only API Key - Host - Port - Protocol - Path - Collection Name 4. Save the configuration Indexing -------- [](#indexing) This module completely replaces the default search engine in OpenMage with Typesense. When products are indexed, they are automatically added to Typesense. To rebuild the index: 1. Go to System > Index Management 2. Select "Catalog Search Index" 3. Choose "Reindex Data" from the actions dropdown 4. Click "Submit" Features -------- [](#features) ### Instant Search [](#instant-search) The module replaces the default search box with an instantsearch.js interface that shows results as you type. ### Faceted Search [](#faceted-search) Users can filter search results by: - Categories - Manufacturers - Price range and other attributes with "Use In Search Results Layered Navigation": Yes ### Typo Tolerance [](#typo-tolerance) Typesense's typo tolerance ensures that users find what they're looking for even if they make typos. Customization ------------- [](#customization) ### Templates [](#templates) You can customize the search interface by modifying the following templates: - `app/design/frontend/base/default/template/mm/search/instantsearch.phtml` ### CSS [](#css) You can customize the appearance by modifying the CSS files: - `skin/frontend/base/default/css/mm_search/instantsearch.css` ### JavaScript [](#javascript) You can customize the behavior by modifying the JavaScript file: - `skin/frontend/base/default/js/mm_search/instantsearch-custom.js` Troubleshooting --------------- [](#troubleshooting) ### Common Issues [](#common-issues) 1. **Connection Failed**: Make sure your Typesense server is running and accessible from your OpenMage server. 2. **No Results**: Check if the products are properly indexed in Typesense. Try rebuilding the Catalog Search Index. 3. **JavaScript Errors**: Check the browser console for any JavaScript errors. License ------- [](#license) This module is licensed under the MIT License. ### Health Score 35 — LowBetter than 80% of packages Maintenance66 Regular maintenance activity Popularity17 Limited adoption so far Community9 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 388d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/989c24c6fc40f9eaad6a600dfbe7fe545f571f4eb17e820075e1a2c41e8f6b78?d=identicon)[empiricompany](/maintainers/empiricompany) --- Top Contributors [![empiricompany](https://avatars.githubusercontent.com/u/5071467?v=4)](https://github.com/empiricompany "empiricompany (10 commits)") --- Tags instantsearchopenmagetypesense ### Embed Badge ![Health badge](/badges/empiricompany-openmage-search/health.svg) ``` [![Health](https://phpackages.com/badges/empiricompany-openmage-search/health.svg)](https://phpackages.com/packages/empiricompany-openmage-search) ``` ### Alternatives [ruflin/elastica Elasticsearch Client 2.3k50.4M203](/packages/ruflin-elastica)[opensearch-project/opensearch-php PHP Client for OpenSearch 15024.3M65](/packages/opensearch-project-opensearch-php)[typesense/laravel-scout-typesense-driver Laravel Scout Driver for Typesense 144637.2k3](/packages/typesense-laravel-scout-typesense-driver)[algolia/algoliasearch-magento Algolia Search for Magento 16648.8k](/packages/algolia-algoliasearch-magento) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)