Strapi: установка и настройка

Плагин AACsearch для Strapi позволяет синхронизировать ваш контент (статьи, товары, документы) с облачным поиском. Контент обновляется в реальном времени.

Требования

• Strapi v5.x
• Node.js 18 или выше
• npm или yarn
• Аккаунт на AACsearch и созданный индекс

Установка

Шаг 1: Установите плагин через npm

В папке вашего Strapi проекта:

npm install @aacsearch/strapi-plugin

Шаг 2: Запустите Strapi

npm run build
npm run develop

Strapi автоматически выполнит инициализацию плагина.

Шаг 3: Откройте настройки плагина

1. В админ-панели Strapi перейдите в Plugins → AACsearch (левое меню)
2. Откроется страница настроек

Подключение к AACsearch

Шаг 1: Получите ключ интеграции

В панели AACsearch:

1. Перейдите в Поиск → Подключения
2. Нажмите Новое подключение
3. Скопируйте ключ (начинается с ss_connector_)

Шаг 2: Заполните настройки плагина

На странице AACsearch → Настройки заполните:

Шаг 3: Проверьте подключение

Нажмите кнопку Проверить соединение. Вы должны увидеть:

✅ "Соединение успешно"

Если ошибка:

• Проверьте, что ключ скопирован без пробелов
• Убедитесь, что есть доступ в интернет
• Попробуйте создать новый ключ

Выбор контента для синхронизации

Шаг 1: Выберите тип контента

На странице Настройки → Типы контента вы видите список всех типов контента в вашем Strapi (Pages, Products, Blog Posts и т.д.).

Шаг 2: Включите синхронизацию

Для каждого типа контента:

1. Нажмите Включить
2. Выберите или создайте индекс в AACsearch (например, "products", "pages")
3. Сопоставьте поля:
   • Title (название) — какое поле Strapi использовать (обычно title или name)
   • Description (описание) — длинное описание
   • Category (категория) — для фильтрации
   • URL — ссылка на страницу контента
   • Изображение — миниатюра

Пример сопоставления для товаров

Название товара (Strapi: name)       → Title
Описание (Strapi: description)        → Description
Цена (Strapi: price)                  → Price
Категория (Strapi: category)          → Category
Изображение (Strapi: featured_image)  → Image URL
Ссылка (Strapi: slug)                 → URL

Первая синхронизация

Запустите полную синхронизацию

На странице Переиндексация нажмите кнопку Переиндексировать всё для выбранного типа контента.

Плагин:

1. Прочитает все записи этого типа
2. Отправит их на серверы AACsearch
3. Покажет прогресс на экране

Сколько займет:

• 100 записей: < 1 минуты
• 1000 записей: 2–3 минуты
• 10000+ записей: 10–30 минут

Автоматическая синхронизация

Когда вы создаёте, редактируете или удаляете контент в Strapi, плагин автоматически синхронизирует изменения с AACsearch.

✅ Новый контент — добавляется в поиск за 2–3 секунды
✅ Отредактированный контент — обновляется в поиске
✅ Удалённый контент — удаляется из поиска

Никаких ручных шагов не требуется.

Встраивание виджета поиска

На вашем фронтенде (Next.js, React, Vue и т.д.)

Получите сниппет из настроек плагина и вставьте в HTML вашего фронтенда:

<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>

Или используйте React компонент:

import { AacsearchWidget } from '@aacsearch/react';

export default function SearchPage() {
  return (
    <AacsearchWidget
      baseUrl="https://app.aacsearch.com"
      apiKey="ss_search_***"
      indexSlug="products"
    />
  );
}

Параметры синхронизации

На странице Настройки → Дополнительно вы можете:

Часто задаваемые вопросы

Q: Синхронизация запущена, но контент не появляется в поиске
A: После синхронизации контент встает в очередь на индексирование. Обычно это занимает 1–2 минуты. Подождите и попробуйте поиск снова.

Q: При синхронизации ошибка "Ключ не валиден"
A: Проверьте:

• Ключ скопирован без пробелов
• Ключ актуален (не отозван в панели AACsearch)
• Нет опечаток в ID организации

Q: Как исключить некоторые записи из поиска?
A: Создайте отдельный индекс или используйте фильтры в панели AACsearch для скрытия записей (например, только опубликованные).

Q: Могу ли я синхронизировать разные типы контента в разные индексы?
A: Да, для каждого типа контента выберите свой индекс в настройках.

Q: Что если я удалю плагин?
A: Контент останется в AACsearch. Просто переустановите плагин и введите ключ.

Помощь и поддержка

• Обзор коннекторов
• Документация по виджету
• Email: support@aacsearch.com
• GitHub: https://github.com/aacsearch/strapi-plugin