Как добавить поиск в магазин на PrestaShop

PrestaShop поставляется с базовым поисковым движком. Для простых магазинов он работает, но быстро даёт сбои: нет исправления опечаток, нет поиска по префиксу, нет обновлений в реальном времени, а ранжирование игнорирует сигналы конверсии — рейтинг продаж и маржу.

Если покупатели уходят из магазина, потому что не могут найти товар, или если доля запросов «нет результатов» превышает 10% — пора обновиться.

Это руководство проведёт вас через весь процесс добавления AACSearch в магазин PrestaShop — от установки модуля до первого живого результата поиска.

Что AACSearch добавляет в PrestaShop

Прежде чем перейти к настройке, вот что меняется после установки AACSearch:

• Мгновенные результаты при вводе — результаты появляются за 30–50 мс, пока покупатель ещё не закончил запрос
• Исправление опечаток — «iphne 15» найдёт iPhone 15; «чёрн плать» найдёт чёрные платья
• Поиск по префиксу — «беспр» совпадёт с «беспроводной», «беспроводные наушники» и т.д.
• Автоматическая синхронизация — изменения цен, новые товары и обновления остатков появляются в поиске в течение нескольких минут
• Кастомное ранжирование — сортировка по продажам, марже, остатку или любому пользовательскому полю

Встроенный поиск PrestaShop не делает ничего из этого надёжно.

Предварительные требования

• PrestaShop 8.x (7.x с частичной поддержкой)
• Аккаунт AACSearch — зарегистрироваться бесплатно
• Доступ администратора к бэк-офису PrestaShop
• Доступ по FTP или файловый менеджер (для ручной загрузки, если маркетплейс недоступен)

Шаг 1: Создайте индекс в AACSearch

Войдите в панель управления AACSearch. Нажмите Новый индекс и задайте имя products (или любое другое подходящее для вашего магазина). Индекс создаётся мгновенно — никаких настроек на этом этапе не требуется.

Шаг 2: Сгенерируйте токен коннектора

В панели AACSearch перейдите в Коннекторы на левой боковой панели. Нажмите Новый токен. Задайте ему имя (например, «PrestaShop Production») и скопируйте токен — он понадобится на шаге 3.

Держите токен в секрете. Он имеет доступ на запись к вашему индексу и никогда не должен появляться в клиентском коде или публичных репозиториях.

Шаг 3: Установите модуль AACSearch

Через маркетплейс PrestaShop (рекомендуется)

В бэк-офисе PrestaShop перейдите в Менеджер модулей → Маркетплейс и найдите «AACSearch». Нажмите Установить.

Через загрузку ZIP

Скачайте ZIP модуля из панели AACSearch (раздел Коннекторы → Скачать модуль). В бэк-офисе перейдите в Менеджер модулей → Загрузить модуль и загрузите ZIP.

После установки вы увидите страницу конфигурации AACSearch. Введите:

• Токен коннектора: вставьте токен из шага 2
• Имя индекса: введите имя индекса, созданного на шаге 1 (например, products)

Нажмите Сохранить и протестировать подключение. Вы должны увидеть зелёное сообщение об успехе с именем вашей организации и количеством документов в индексе (0 на этом этапе).

Шаг 4: Запустите первоначальную синхронизацию

На странице конфигурации модуля AACSearch нажмите Полная синхронизация. Это экспортирует весь каталог товаров — названия, описания, цены, категории, изображения, атрибуты — и отправляет данные в индекс AACSearch.

Синхронизация выполняется в фоновом режиме. Для каталога из 10 000 товаров это обычно занимает 1–3 минуты. Следить за прогрессом можно во вкладке Задачи синхронизации панели управления.

По завершении синхронизации в индексе отобразится количество документов. Проверьте это в Playground панели: найдите название товара и убедитесь, что результаты появляются.

Шаг 5: Настройте инкрементальную синхронизацию

Полная синхронизация предназначена только для первоначального заполнения. Для регулярных обновлений настройте инкрементальную синхронизацию:

В настройках модуля найдите Автоматическую синхронизацию и включите её. Интервал по умолчанию — каждые 5 минут: коннектор проверяет товары, изменённые с момента последней синхронизации, и отправляет только изменения.

Это означает: когда вы обновляете цену, добавляете новый вариант или меняете статус остатков в PrestaShop, изменение появляется в поиске в течение 5 минут. Без каких-либо ручных действий.

Шаг 6: Встройте виджет поиска

Виджет AACSearch заменяет или дополняет поисковую строку PrestaShop. Он открывает полноэкранный оверлей с мгновенными результатами поиска.

Автоматически (через хук модуля)

В конфигурации модуля включите Заменить стандартный поиск. Модуль автоматически внедряет виджет через систему хуков PrestaShop. Редактировать шаблоны не нужно.

Вручную (для кастомных тем)

Если вы предпочитаете ручную интеграцию, скопируйте сниппет виджета из панели управления AACSearch (вкладка Виджет):

<script
	src="https://app.AACSearch.com/api/widget/widget.js"
	data-index-id="YOUR_INDEX_ID"
	data-api-key="YOUR_SEARCH_KEY"
	data-locale="{language.iso_code}"
	async
></script>

Замените {language.iso_code} на переменную Smarty PrestaShop, чтобы язык виджета совпадал с языком магазина. Добавьте этот сниппет в head.tpl или footer.tpl вашей темы.

Шаг 7: Проверка в продакшне

Очистите кэш PrestaShop (Дополнительные параметры → Производительность → Очистить кэш). Откройте магазин в режиме инкогнито и протестируйте кнопку поиска.

Проверьте:

• Результаты появляются при вводе
• Исправление опечаток работает (iphne → iPhone)
• Изображения товаров отображаются в результатах
• Клик по результату ведёт на правильную страницу товара

Если результаты не появляются, сначала проверьте Playground в панели AACSearch — это поможет определить, где проблема: в индексе (данные) или в виджете (отображение).

Устранение распространённых проблем

Товары не появляются в результатах после синхронизации

Откройте Playground AACSearch и выполните тот же запрос. Если результаты там есть, проблема в конфигурации виджета (неверный API-ключ или ID индекса). Если результаты отсутствуют и в Playground, проверьте журналы задачи синхронизации на наличие ошибок.

Цены отображаются устаревшими

Инкрементальная синхронизация выполняется каждые 5 минут по умолчанию. Для ценочувствительных запросов можно сократить интервал до 1 минуты в настройках модуля. Запуск ручной инкрементальной синхронизации из панели управления принудительно выполняет немедленное обновление.

Виджет не отображается

Проверьте консоль браузера на наличие ошибок JavaScript. Распространённые причины: Политика безопасности контента блокирует скрипт виджета, или конфликтующий атрибут async. Попробуйте добавить crossorigin="anonymous" к тегу script.

Что дальше

С работающим AACSearch базовый поиск уже значительно лучше встроенного движка PrestaShop. Следующий уровень оптимизации:

• Аналитика: проверьте, какие запросы не дают результатов — это товары, которые ищут, но не находят
• Синонимы: добавьте отраслевые синонимы (например, «монитор = дисплей = экран») во вкладке «Релевантность»
• Куратуры: закрепите высокомаржинальные товары на первых позициях для коммерческих запросов

Поиск работает. Пришло время оптимизировать под конверсию.