PrestaShop: установка и настройка
Пошаговое руководство по установке модуля AACsearch в PrestaShop 8.x и автоматической синхронизации товаров.
Модуль AACsearch для PrestaShop легко интегрирует ваш каталог товаров с поиском. После установки товары автоматически синхронизируются, и виджет поиска появляется на вашей витрине.
Требования
- PrestaShop 8.x (совместим с 9.x)
- PHP 7.4 или выше
- Включённое расширение cURL в PHP
- Аккаунт на AACsearch и созданный индекс товаров
Установка модуля
Шаг 1. Скачайте модуль
Модуль находится в GitHub репозитории AACsearch. Нажмите Code → Download ZIP или склонируйте репозиторий:
git clone https://github.com/aacsearch/prestashop-module.git
cd prestashop-moduleШаг 2. Загрузите в PrestaShop
- Откройте админ-панель PrestaShop
- Перейдите в Модули → Менеджер модулей
- Нажмите Загрузить модуль
- Выберите скачанный ZIP-файл
- Нажмите Загрузить модуль
Или вручную скопируйте папку aacsearch в modules/ вашего PrestaShop и установите из Модули → Менеджер модулей → AACsearch → Установить.
Шаг 3. Откройте настройки модуля
- В Модули → Менеджер модулей найдите AACsearch
- Нажмите Настроить
Подключение и настройка
На странице настроек заполните следующие поля:
Основные настройки
| Поле | Что вводить |
|---|---|
| URL панели AACsearch | https://app.aacsearch.com (если у вас EU или RU узел — другой адрес) |
| ID организации | Найдите в панели AACsearch → Настройки → API |
| Ключ интеграции | Найдите в панели AACsearch → Поиск → Подключения → Новое подключение |
Дополнительные настройки
| Поле | Описание |
|---|---|
| Включить синхронизацию | Чекбокс. Если отмечен, товары обновляются автоматически при изменениях |
| Включить виджет | Чекбокс. Если отмечен, виджет поиска встраивается в ваш сайт |
| Язык по умолчанию | Выберите язык ваших товаров (например, Русский) |
| Размер пакета | Сколько товаров отправлять за раз (по умолчанию 200, макс 1000). Оставьте по умолчанию |
| Режим отладки | Если включить, детальные логи записываются в /var/logs/aacsearch.log |
Проверка подключения
Нажмите кнопку Проверить соединение. Модуль отправит тестовый запрос на наши серверы.
Успешное подключение: вы увидите зелёную галочку и название вашего индекса.
Ошибка: проверьте:
- ✓ Ключ интеграции скопирован без пробелов
- ✓ ID организации правильный
- ✓ На вашем сервере включен cURL
- ✓ Есть доступ в интернет
Первая синхронизация товаров
Синхронизировать все товары
Нажмите кнопку Полная синхронизация. Модуль:
- Прочитает все товары из каталога
- Отправит их пакетами на серверы AACsearch
- Товары встанут в очередь на индексирование
Сколько это займёт?
- 100–500 товаров: < 1 минуты
- 500–5000 товаров: 2–5 минут
- 5000+ товаров: 10–30 минут
Вы можете закрыть эту страницу — синхронизация продолжится в фоне.
Статус синхронизации
В панели управления AACsearch → Поиск → Синхронизация вы видите:
- ✅ Сколько товаров успешно загружено
- ⚠️ Ошибки (если есть)
- 🔄 Статус последней синхронизации
Что синхронизируется
Модуль автоматически отправляет:
- Название товара — используется в поиске и результатах
- Описание — видно в подсказке при поиске
- Категория — для фильтрации по категориям
- Цена — актуальная цена товара
- Изображение — миниатюра товара в результатах поиска
- Остаток — информация о наличии
- SKU / артикул — для идентификации товара
- Атрибуты — размер, цвет и т.д. (если настроены в PrestaShop)
Автоматическое обновление товаров
Если Включить синхронизацию отмечен, модуль автоматически обновляет товары в AACsearch когда:
✅ Создан новый товар — автоматически добавляется в поиск
✅ Обновлена цена — изменяется в поиске в течение 10 сек
✅ Изменено название — обновляется в поиске
✅ Изменен остаток — статус наличия обновляется
✅ Удален товар — удаляется из поиска
Встраивание виджета поиска
После первой синхронизации нужно встроить виджет в вашу витрину.
Способ 1: Автоматическое встраивание (рекомендуется)
Если в настройках модуля отмечено Включить виджет, модуль автоматически встраивает код в <head> вашего сайта. Ничего больше не нужно делать.
Способ 2: Ручное встраивание
Если вы хотите встроить виджет в конкретное место:
- В настройках модуля скопируйте Сниппет установки
- Откройте в PrestaShop Дизайн → Темы и найдите файл шаблона, где нужен поиск (обычно
header.tpl) - Вставьте сниппет в нужное место
Типичный сниппет выглядит так:
<div id="aac-search"></div>
<script
src="https://app.aacsearch.com/api/widget/widget.js"
data-base-url="https://app.aacsearch.com"
data-api-key="ss_search_***"
data-index-slug="products"
data-container="#aac-search">
</script>Проверка на сайте
- Откройте ваш магазин в браузере
- Найдите виджет поиска (обычно в хедере или в главном меню)
- Введите название товара (например, "красные туфли")
- Проверьте:
- Появляются ли результаты?
- Видны ли изображения и цены?
- Работают ли фильтры?
Если что-то не работает — см. раздел Помощь.
Параметры виджета
Вы можете изменить внешний вид виджета, отредактировав атрибуты data-* в коде:
| Параметр | Описание |
|---|---|
data-container | Селектор контейнера для виджета (например, #aac-search) |
data-theme | auto (светлая/тёмная в зависимости от сайта), light или dark |
data-locale | Язык: ru, en, de, es, fr |
data-placeholder | Текст в поле ввода (например, "Поиск товаров") |
Пример с параметрами:
<script
src="https://app.aacsearch.com/api/widget/widget.js"
data-base-url="https://app.aacsearch.com"
data-api-key="ss_search_***"
data-index-slug="products"
data-container="#search-box"
data-theme="dark"
data-locale="ru">
</script>Часто задаваемые вопросы
Q: Товары не появляются в поиске, хотя синхронизация показала "успешно"
A: После синхронизации товары встают в очередь на индексирование. Обычно это занимает 1–2 минуты. Подождите, затем обновите страницу и поищите товар.
Q: При синхронизации ошибка "Ключ не валиден"
A: Проверьте, что ключ скопирован без пробелов в начале/конце. Если не помогает, создайте новое подключение в панели AACsearch.
Q: Виджет не видна на сайте
A: Проверьте:
- В настройках модуля отмечено Включить виджет?
- В браузере откройте F12 → Console — нет ли ошибок?
- Контейнер
<div id="aac-search"></div>есть в вашей теме?
Q: Цена в поиске не обновилась
A: Синхронизация цены занимает несколько секунд. Попробуйте обновить страницу (Ctrl+F5).
Q: Можно ли исключить товары из поиска?
A: Да. Создайте отдельный индекс и синхронизируйте только нужные товары, или используйте фильтры в панели AACsearch для скрытия товаров (например, только в наличии).
Q: Когда я удаляю товар в PrestaShop, он удаляется из поиска?
A: Да, если включена синхронизация. Товар удалится из поиска через несколько секунд.
Помощь и поддержка
- Обзор коннекторов
- Документация по виджету
- Email: support@aacsearch.com
- Документация PrestaShop: https://docs.prestashop.com