PHPackages                             bitbull/magento-tooso-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. bitbull/magento-tooso-search

ActiveMagento-module

bitbull/magento-tooso-search
============================

Tooso search integration for Magento

4.12.0(7y ago)172MITPHP

Since Sep 21Pushed 7y ago7 watchersCompare

[ Source](https://github.com/tooso/magento-module-tooso-search)[ Packagist](https://packagist.org/packages/bitbull/magento-tooso-search)[ RSS](/packages/bitbull-magento-tooso-search/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (1)Versions (56)Used By (0)

Tooso Search for Magento
========================

[](#tooso-search-for-magento)

[Tooso](http://tooso.ai) is a cloud-based, multi-language search tool for e-commerce.

This extension replaces the default search of Magento with a typo-tolerant, fast & relevant search experience backed by [Tooso](http://tooso.ai/Default.aspx).

Description
-----------

[](#description)

This extension replaces the default Magento search engine with one based on Tooso API. It provide the following features:

- Fulltext search for catalog products (currently advanced search is not supported)
- Scheduled indexing of catalog products
- Automatic typo correction
- Search keywords suggest

Requirements
------------

[](#requirements)

The only requirement for the module is the default Magento cronjob execution correctly configured. Something like the following is a good configuration:

```
*/5 * * * * php -f /absolute/path/to/magento/cron.sh > /dev/null 2>&1

```

This will run the Magento jobs schedule and executions every 5 minutes. *Note:* the Tooso indexing flow start every 15 minutes.

Here is some additional info on how to add cron jobs with Cpanel and Plesk, which are some of the most popular web panels:

- [CPanel - Add a cron job](https://documentation.cpanel.net/display/ALD/Cron+Jobs#CronJobs-Addacronjob)
- [Plesk - How do I set up cron jobs](https://www.interspire.com/support/kb/questions/382/How+do+I+set+up+CRON+on+my+server+using+Plesk%3F)

If you can't access your server configuration, please ask your hosting provider to configure crontab for you.

External Dependencies
---------------------

[](#external-dependencies)

[Mobile Detect](http://mobiledetect.net/)

It is placed under `lib/Bitbull/Mobile` directory, the main class file is renamed from *Mobile\_Detect* to *Detect.php*and class name is renamed to *Bitbull\_Mobile\_Detect*. This prevent compatibility issues by other modules. Mobile Detect class is globally reachable as `Bitbull_Mobile_Detect`.

Installation Instructions
-------------------------

[](#installation-instructions)

You can install the extension with following methods:

### Copying files manually

[](#copying-files-manually)

Copy all files and directories recursively from `src` directory into your document root.

### Using Composer

[](#using-composer)

If you use [Composer](https://getcomposer.org) for manage your module dependencies, you can install the module adding this repository to your `composer.json` file:

```
{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/bitbull-team/Bitbull_Tooso"
        }
    ]
}

```

Then you can add the module dependency:

```
{
    "require": {
        "magento-hackathon/magento-composer-installer": "*",
        "bitbull/magento-tooso-search": "1.0.*"
    }
}

```

Finally, you can launch the command `composer update` inside your project root directory.

Regardless the method you choose, after installation you need to clear the cache and logout from the admin panel and then login again.

Customize reindex flow
----------------------

[](#customize-reindex-flow)

By default, the catalog reindex process start every 15 minutes. This is done through the standard Magento cron framework (more info [here](http://www.webguys.de/magento-1/tuerchen-08-magento-cron-demystified)). You can customize the frequency of reindex schedule editing the file `app/code/community/Bitbull/Tooso/etc/config.xml`:

```

                    */15 * * * *

                    tooso/observer::rebuildIndex

```

you can change the value of node `` using any standard [cron expression](https://en.wikipedia.org/wiki/Cron#CRON_expression).

Module Configuration
--------------------

[](#module-configuration)

### Request your API KEY

[](#request-your-api-key)

Send an email to  to request your APIKEY

### Set your API KEY:

[](#set-your-api-key)

1. Under **API Configuration**

- Insert your API key into **API key** field
- Insert **[http://v{apiVersionWithNoDot}.api.tooso.ai](http://v%7BapiVersionWithNoDot%7D.api.tooso.ai)** into **API base url** field. The current supported version is 1, so the placeholder {apiVersionWithNoDot} should be replaced by 1.
- **Send report**: **YES** to send a report to Tooso when an API error occourred
- **Force logging**: **YES** to force logging to {{base\_dir}}/var/log/tooso\_search.log even when logging is disabled
- **Debug mode**: **Yes** to enable more verbose logging for debug purpose

2. Save configuration

- If you are in the Early Adopter phase, it's highly advisable to leave enabled **Send report** and **Force logging** configurations under **API Configuration**. This will give to the Tooso support team more information for help you troubleshoot in case of errors. **Please note:** to be able to send report to Tooso, your Magento installation need to be able to send email. [![API configuration](./docs/apiconfiguration.png)](./docs/apiconfiguration.png)

### Integrate your catalog

[](#integrate-your-catalog)

1. Access the extension configuration under System -> Configuration -> Tooso Search Engine.
2. Under **Activate Tooso** set the parameters as follow:

- Enable Search: **NO**
- Enable Indexing: **YES**
- Enable Tracking: **NO**

3. Save configuration [![Integrate your catalog](./docs/indexing.png)](./docs/indexing.png)

### Activate your Search Bar and your tracking

[](#activate-your-search-bar-and-your-tracking)

Once your catalog has been integrated with Tooso, you will get a notification from a member of Tooso’s team and you can enable the search and the tracking

1. Access the extension configuration under System -> Configuration -> Tooso Search Engine.
2. Under **Activate Tooso** set the parameters as follow:

- Enable Search: **YES**
- Enable Indexing: **YES**
- Enable Tracking: **YES**

3. Save configuration [![Seaching and Tracking](./docs/searchingtracking.png)](./docs/searchingtracking.png)

**IMPORTANT**: For any question about our early adopters program, reach out anytime to our CCO ; for technical enquiries, ping directly our CTO .

Tips & Tricks
-----------------

[](#tips--tricks)

If you are using a proxy in front of Magento, like a load balancer, an HA proxy or a Varnish instance add this configuration to Magento `local.xml` file:

```

        HTTP_X_REAL_IP]]>
        HTTP_X_FORWARDED_FOR]]>

```

this in order to identify the correct user's IP using `X-Forwarded-For` or `X-Real-IP` HTTP headers.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 80.3% 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

Every ~19 days

Recently: every ~29 days

Total

44

Last Release

2703d ago

Major Versions

1.2.0 → 2.0.02017-05-30

2.1.0 → 3.0.02017-08-08

2.1.4 → 3.1.02017-11-27

2.2.0 → 3.3.12018-01-16

3.3.1 → 4.0.02018-02-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/1eb2bc68c56f158ccf53d9ca9aaac0c3279c344771a3dc1dc98b9ae30cdf5a96?d=identicon)[bitbull](/maintainers/bitbull)

---

Top Contributors

[![daaru00](https://avatars.githubusercontent.com/u/8782994?v=4)](https://github.com/daaru00 "daaru00 (378 commits)")[![kesonno](https://avatars.githubusercontent.com/u/334884?v=4)](https://github.com/kesonno "kesonno (80 commits)")[![tooso](https://avatars.githubusercontent.com/u/19930450?v=4)](https://github.com/tooso "tooso (4 commits)")[![aleron75](https://avatars.githubusercontent.com/u/1199894?v=4)](https://github.com/aleron75 "aleron75 (3 commits)")[![fabiomelen](https://avatars.githubusercontent.com/u/13599?v=4)](https://github.com/fabiomelen "fabiomelen (2 commits)")[![bitbull01](https://avatars.githubusercontent.com/u/6303028?v=4)](https://github.com/bitbull01 "bitbull01 (2 commits)")[![jacopotagliabue](https://avatars.githubusercontent.com/u/3503170?v=4)](https://github.com/jacopotagliabue "jacopotagliabue (2 commits)")

### Embed Badge

![Health badge](/badges/bitbull-magento-tooso-search/health.svg)

```
[![Health](https://phpackages.com/badges/bitbull-magento-tooso-search/health.svg)](https://phpackages.com/packages/bitbull-magento-tooso-search)
```

###  Alternatives

[algolia/algoliasearch-magento

Algolia Search for Magento

16648.8k](/packages/algolia-algoliasearch-magento)[inviqa/magento-symfony-container

Provides Magento with an instance of a Symfony DI Container

2436.5k](/packages/inviqa-magento-symfony-container)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)