README

Transform your Magento 2 search into a conversion machine. Join thousands of merchants using AI-powered search to increase sales and improve customer experience.

🚀 Get Started for Free | 🖥️ Live Demo | 📖 Full Documentation

Why Doofinder?

Doofinder turns your basic search bar into an advanced discovery engine. Using AI-powered searchandising and recommendations, we drive measurable gains in conversion and product discovery.

Key Features

• AI Assistant — A smart shopping guide that helps customers find products through natural conversation.
• AI Smart Search — Understands intent and handles typos or synonyms effortlessly.
• Searchandising — Boost, hide, or pin products to run targeted campaigns.
• Personalized Recommendations — Intelligent cross-selling based on real customer behavior.
• Visual Search — Let your shoppers find products using images.
• Auto-Indexing — Your catalog stays in sync automatically as you scale.

🛠 Installation & Quick Start

From Adobe Marketplace Install Doofinder from the Adobe Commerce Marketplace directly from your Magento admin, or via Composer:

composer require doofinder/doofinder-magento2
bin/magento setup:upgrade

From GitHub (latest release) Download the latest release zip and install it as a local Composer package, or copy directly into app/code/Doofinder/Feed.

Then Complete setup using our step-by-step installation guide.

Requirements

👨‍💻 Development & Maintainer Guide

This repository is optimized for local development using a Makefile and Docker.

.env sits at the repo root and powers both your Docker stack and the generated module files (what doofinder-configure pulls from templates/). It ships with sensible defaults — set your BASE_URL, Magento version, and Composer auth credentials, then make init. Optional overrides go in .env.local, which loads on top of .env.

Note

make doofinder-configure regenerates Doofinder/Feed/etc/config.xml and Doofinder/Feed/Helper/Constants.php from templates/. Many other targets depend on it — do not commit those files with non-production values.

Environment and shop access

The root .env lists all variables with comments. For the dev stack, these are the ones you usually touch first:

Default access (Docker dev stack): After make init, the stack runs on the ports defined in docker-compose.yml (default mapping: 9012 → HTTP, 4012 → HTTPS). With the default BASE_URL=localhost from .env:

Admin login is MAGENTO_ADMIN_USER / MAGENTO_ADMIN_PASSWORD from .env (defaults: admin / admin123).

Use cases:

• First-time setup: Run make init to build images, install Magento, and start containers. Use make init-with-data to also load sample data.
• Install the Doofinder module: after make init, follow the installation guide. Alternatively, use make doofinder-upgrade from the CLI.
• Start / stop the stack: make start, make stop.
• Uninstall the module: make doofinder-uninstall.
• Reinstall the module: make doofinder-reinstall.
• DB snapshot: make db-backup (optionally make db-backup prefix=_name). Restore with make db-restore file=backup.sql.gz.
• Code quality check: make consistency (runs PHP Code Sniffer inside Docker with the Magento2 standard).
• Shell in the web container: make dev-console.
• Start from scratch: Run make clean to drop Docker volumes and ./app; type DELETE when prompted, then run make init for a fresh Magento.
• Debug with Xdebug: The stack enables Xdebug via XDEBUG_CONFIG in docker-compose.yml. Set XDEBUG_HOST and XDEBUG_KEY in .env or .env.local, configure your IDE to listen for connections, and browse the shop.
• Varnish: Included but commented out in docker-compose.yml. Uncomment to enable; remember to comment the 9012:80 port in the web container. See Configure the Commerce application to use Varnish.

Compatibility Matrix

PHP 8.0 is not supported by Magento 2. PHP versions below 7.4 are not recommended.

Support & Contributing

• Need Help? Visit our Support Portal.
• Found a Bug? Please contact Doofinder Support.
• Want to contribute? PRs are welcome! Before pushing, make sure PHP Code Sniffer passes — use make consistency or run composer install && vendor/bin/phpcs directly (requires PHP >= 8.3).

If you find this plugin useful, please give us a ⭐ to support the project!

Try Doofinder / Learn more

Ready to improve your store search? Get started with Doofinder for Magento 2.