Виджет перевода выделенного текста через GigaChat добавляет на страницу компактную всплывающую панель. Пользователь выделяет фрагмент текста, нажимает кнопку рядом с курсором и получает перевод или короткое пояснение без перехода во внешний переводчик.
Для каких страниц подходит
Виджет полезен для документации, образовательных материалов, блогов, каталогов, справочных разделов и внутренних порталов, где встречаются английские термины, технические описания, фрагменты кода или смешанный русский и английский текст.
Что умеет виджет
- определяет выделенный пользователем текст на странице;
- показывает панель рядом с выделением;
- отправляет фрагмент в GigaChat через серверный endpoint;
- возвращает перевод или смысловое пояснение;
- не требует от пользователя копировать текст в отдельное окно.
Как работает интеграция
Пакет подключает JavaScript и CSS на страницу, а серверная часть принимает запросы к GigaChat. API-ключ хранится на стороне проекта, а не в браузере. Такой подход подходит для сайтов, где нужно дать посетителю быстрый перевод, но не раскрывать секретные настройки.
Что входит в поставку
В архив входят PHP endpoint, клиентский скрипт, стили, пример подключения и шаблон локальной конфигурации. Виджет можно разместить в отдельном каталоге проекта и подключить к нужным страницам.
Ограничения
Качество результата зависит от выбранной модели, контекста фразы и ограничений API. Виджет не заменяет профессиональный перевод технической документации, договоров и юридически значимых текстов.
Технические требования
- PHP-проект с возможностью разместить endpoint;
- ключ GigaChat и доступ к внешним запросам с сервера;
- подключение JS и CSS на нужных страницах;
- проверка лимитов API и обработки ошибок.
FAQ
Где хранится ключ GigaChat?
В локальной конфигурации на сервере. В браузер ключ не передаётся.
Можно ли использовать виджет на обычном PHP-сайте?
Да. Пакет не требует Laravel или конкретной CMS.
Перевод работает только с английским?
Базовый сценарий рассчитан на RU/EN, но фактические возможности зависят от настроек запроса к GigaChat.
Что увидит пользователь при ошибке API?
Виджет должен показать понятное сообщение, а не ломать страницу. Конкретный текст можно адаптировать под проект.
