🎯 Цель:
- Реализовать клиентскую часть модуля для 1С-Битрикс, включающую:
- Встраивание форм в публичную часть сайта
- Вызов внешнего API
- Отображение результатов на странице
- Оформление в виде Bitrix-модуля (с установкой, удалением, настройками)
- Установить модуль в битрикс шаблон по умолчанию и опубликовать сайт на мой домен / сервер
- Помочь с публикацией модуля в магазин модулей битрикс
🧩 Обязанности фрилансера:
🔧 1. Реализация Bitrix-модуля (структура)
Создать модуль по стандарту Bitrix:
Структура в /local/modules/ai.search/
install/index.php – установка и удаление
include.php, class.php, языковые файлы
Модуль должен:
Создавать публичную страницу /ai-search/ или /search/ai/
Подключать стили, JS и HTML-форму на этой странице
Иметь интерфейс в админке для настройки (см. ниже)
🧩 2. Интеграция предоставленных HTML-форм поиска
Вставить предоставленные формы (поиск по тексту и изображению) в шаблон страницы модуля.
Обеспечить отправку запросов:
Текст: POST на внешний API /search/text (query)
Изображение: POST на API /search/image (file/base64)
🔌 3. Связь с внешним API (AJAX)
Использовать fetch() или BX.ajax для отправки запросов.
Отображать результаты поиска в виде карточек товаров (можно взять за основу bitrix:catalog.section).
Обработать:
Ошибки (сетевые, пустые ответы)
Лоадер / индикатор загрузки
Сброс формы
🛠️ 4. Интерфейс настройки в админке
В административной части модуля (/bitrix/admin/ai_search_settings.php) добавить настройки:
API URL (по умолчанию:
)
API-ключ (строка)
Выбор: включить/отключить модуль
Статическая страница или блок в шапке
Сохранять настройки в COption::SetOptionString
🖼️ 5. Отображение результатов поиска
Выводить список товаров (название, изображение, цена, ссылка)
Стиль – адаптивный, соответствующий текущему шаблону Bitrix-сайта
Желательно использовать flex/grid
Возможность повторного поиска без перезагрузки страницы
💼 Результат работы
Полностью рабочий Bitrix-модуль:
Устанавливается и удаляется через административную панель
Создаёт страницу с формой поиска
Делает запросы к API и показывает результаты
Архив .tar.gz для установки модуля
Документация по установке и настройке (1 страница)
Комментарии в коде, разделение логики JS и PHP
🧾 Что предоставляет заказчик:
- Готовая HTML-верстка формы поиска (текст + изображение)
- Примеры API-запросов/ответов
- Ссылки на существующие компоненты (если нужно использовать готовые карточки)
🧠 Требования к навыкам фрилансера:
Опыт создания Bitrix-модулей
Отличное знание JavaScript и AJAX
Умение работать с шаблонами Bitrix
Понимание клиент-серверного взаимодействия
Навыки работы с Git (желательно)
⏱ Сроки:
Оценочный срок выполнения: 5-7 рабочих дней после передачи форм и API-документации.