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

	Supported versions
PHP	7.3, 7.4, 8.1, 8.2, 8.3, 8.4 (8.0 not supported by Magento 2)
Magento	2.3.x, 2.4.x

👨‍💻 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:

Variable	Role
`BASE_URL`	Shop hostname as seen by Docker (no `https://`).
`MAGENTO_VERSION`	Magento release to install. Adjust `PHP_VERSION` and `COMPOSER_VERSION` to match — see the compatibility matrix below.
`COMPOSER_AUTH_USERNAME`	Public key from your Magento Marketplace access key.
`COMPOSER_AUTH_PASSWORD`	Private key from the same access key.
`MYSQL_*`	Database credentials for the local shop.
`MAGENTO_ADMIN_USER` / `MAGENTO_ADMIN_PASSWORD`	Admin panel login after install.
`XDEBUG_HOST`	Docker bridge IP (`172.17.0.1` on Linux; use `host.docker.internal` on macOS).

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:

	URL
Storefront (HTTP)	`http://localhost:9012/`
Storefront (HTTPS)	`https://localhost:4012/`
Admin (HTTP)	`http://localhost:9012/admin`
Admin (HTTPS)	`https://localhost:4012/admin`

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.
Start / stop the stack: make start, make stop.
Install or upgrade the Doofinder module: make doofinder-upgrade (re-enables module and runs setup:upgrade).
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

Magento	PHP
2.4.5 – 2.4.8	8.1, 8.2, 8.3, 8.4
2.4.0 – 2.4.4	7.4, 8.1, 8.2
2.3.x	7.3, 7.4

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.

doofinder / doofinder-magento2

Maintainers

Package info

Statistics

Security