- Версии Osclass
- 3.0+
- 4.0+
- 8.0+
Автономный редактор переводов PO и MO для ядра Osclass, тем и плагинов с функциями автоматического перевода с помощью ИИ.
Translations Manager for Osclass — это профессиональный автономный плагин для административной панели, позволяющий создавать, редактировать, сканировать, создавать резервные копии и поддерживать каталоги переводов gettext .po / .mo для ядра Osclass, тем и плагинов — с современным административным интерфейсом (панель управления, редактор, конфигурация, журналы, лицензия, обновления).
Лицензионный ключ:
Для просмотра скрытого содержимого Вы должны войти или зарегистрироваться.
Что вы получите
- Панель мониторинга — процент выполнения, отсутствующие строки, проблемы контроля качества, отсутствующие каталоги.
- Редактор переводов — поиск, фильтры, статистика, импорт/экспорт
- Сканирование исходного кода — создание или обновление каталогов с помощью функций PHP gettext.
- Массовое сканирование — пакетное задание из панели управления для каждого языка сайта.
- Автоматическое резервное копирование — перед сохранением восстановить данные по каталогу.
- Проверка качества — заполнители, баланс HTML, пустые строки
- Дополнительный перевод с использованием ИИ — Pollinations, Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter (предустановленные модели + пользовательский идентификатор модели)
- Память переводов + глоссарий для согласованного вывода ИИ
- Обновления лицензии — проверить, загрузить, установить, откатить.
- Безопасность — защита от CSRF-атак, режим только для суперадминистраторов, диагностика.
- Включен административный интерфейс на английском и арабском языках.
Типичный рабочий процесс
- Установите и активируйте плагин.
- Добавить языки можно в Osclass → Настройки → Языки
- Вкладка «Лицензия» → активируйте ключ покупки
- (Необязательно) Настройте поставщика ИИ и собственный ключ API.
- Открыть каталог → перевести → Сохранить (для фронтенда требуется файл .mo)
Что этот плагин НЕ делает
- Не выполняет автоматический перевод вашего сайта при установке.
- В стоимость не включены бесплатные кредиты для AI API — вам необходимо предоставить собственный ключ поставщика.
- Не заменяет проверку переводов человеком .
- Не сканирует жестко закодированные строки , не обернутые в функции gettext.
- Обновления поступают не из Osclass Market, а через сервер лицензирования поставщика.
Перевод с помощью ИИ — требуется собственный API-ключ.
Важно: пакетный перевод с использованием ИИ является необязательным. Плагин не включает ключи API для ИИ или бесплатные кредиты для ИИ. Вам потребуется:- Действующий лицензионный ключ Translations Manager (полученный при покупке Codester)
- Ваш собственный API-ключ от поставщика услуг ИИ — оплата производится самим поставщиком (Google, OpenAI, Groq, Pollinations и т. д.).
В разделе «Настройки» → «Перевод с помощью ИИ» у каждого поставщика есть панель справки со ссылками для просмотра официальных каталогов моделей и получения ключа API. Выберите рекомендуемую предустановленную модель или используйте «Пользовательский идентификатор модели…» для новых моделей, еще не включенных в список.
Полностью поддерживается ручной перевод без использования ИИ — для редактирования каталогов .po/.mo вручную не требуется ключ ИИ.
Функции
- Автономный плагин для Osclass — редактирование основных файлов не требуется.
- Полное управление каталогом — ядро, темы и плагины (.po / .mo)
- Современный адаптивный административный интерфейс — панель управления, переводы, конфигурация, журналы, лицензия, обновления.
- Умный редактор переводов — поиск, фильтры (непереведенные тексты / проблемы), статистика по каталогам.
- Сканирование исходного кода — создание или обновление каталогов с помощью функций PHP gettext.
- Массовое сканирование — пакетное задание из панели управления для каждого языка сайта.
- Импорт/экспорт — архивов .po, .mo, ZIP; копирование переводов между языками.
- Автоматическое резервное копирование — перед сохранением, настраиваемый срок хранения, восстановление одним щелчком мыши.
- Проверка качества (QA) — заполнители, баланс HTML, пустые строки
- Обзор панели управления — процент выполнения, отсутствующие каталоги, фильтры внимания.
- Дополнительный перевод с использованием ИИ — Pollinations, Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter (предустановленные модели + пользовательский идентификатор модели)
- BYO AI API ключ — кредиты ИИ не включены; вы платите поставщику напрямую.
- Память переводов — повторное использование идентичных строк в разных каталогах.
- Пользовательский глоссарий — внедряется в подсказки ИИ для обеспечения единообразия терминологии.
- Лицензионный ИИ — безопасная авторизация через сервер лицензий поставщика.
- Обновления лицензии — проверка, загрузка, установка, откат из резервной копии
- Стабильный/бета-канал обновлений — при включении в вашей лицензии.
- Безопасность — защита от CSRF-атак, режим только для суперадминистраторов, ограничения скорости запросов.
- Диагностика системы — ограничения PHP, доступные для записи пути, ZipArchive, состояние cURL.
- Двуязычный административный интерфейс — интерфейс плагина на английском и арабском языках.
Требования
Минимальные требования (установка плагина и базовое использование)
- Osclass 3.x, 4.x или 8.x — рабочая установка приложения для размещения объявлений с доступом администратора.
- PHP 7.4 или выше ( рекомендуется PHP 8.1 и выше )
- Расширение PHP cURL — необходимо для активации/проверки лицензии и дополнительных функций ИИ.
- Библиотека Gettext для PHP — входит в стандартную установку Osclass (Composer). Необходима для чтения/записи каталогов .po и .mo.
- Поддержка JSON в PHP — стандарт в современном PHP (используется AJAX-запросами административной панели).
- Папки с возможностью записи:
- oc-content/languages/(Основные каталоги)
- Папки с языковыми темами, которые вы редактируете (например, oc-content/themes/your-theme/languages/)
- Папки с языковыми плагинами, которые вы редактируете (например, oc-content/plugins/plugin-name/languages/)
- Папка плагина oc-content/plugins/translations_manager/(резервные копии и журналы)
- Современные браузеры для административной панели Osclass (Chrome, Firefox, Edge, Safari)
- Никаких изменений в ядро Osclass не допускается — не вносите oc-includes/никаких модификаций.oc-load.php
Перед переводом (настройка Osclass)
- Сначала добавьте языки вашего сайта в Osclass → Настройки → Языки — плагин не создаёт языки Osclass автоматически.
- Откройте или создайте соответствующий каталог .po, переведите его, а затем сохраните — интерфейс Osclass использует скомпилированные файлы .mo , а не только .po.
- По умолчанию доступ к этому плагину имеет только суперадминистратор (идентификатор администратора 1).
Рекомендуемые настройки сервера
- Использование HTTPS на вашем сайте (настоятельно рекомендуется для активации лицензий и обновлений).
- PHP max_input_vars — не менее 3000 для средних каталогов; рекомендуется 5000+ для больших каталогов ядра/тем (в противном случае сохранение может завершиться неудачей — диагностические сообщения отображаются в разделе «Конфигурация»).
- Для больших каталогов и пакетов ИИ рекомендуется использовать лимит памяти PHP — 128 МБ или больше.
- Разрешите исходящие HTTPS- запросы с вашего сервера (брандмауэр/прокси-сервер не должны блокировать вызовы API).
Дополнительные требования по функциям
- Обновления лицензионного плагина(проверка / загрузка / установка / откат):
- Действительный лицензионный ключ, приобретенный на этом сайте, активирован.
- Расширение PHP ZipArchive (необходимо для установки пакетов обновлений)
- Исходящий HTTPS-трафик на сервер лицензий поставщика.
- Для будущих обновлений может потребоваться более высокая минимальная версия PHP (она отображается на экране обновлений перед установкой).
- Пакетный перевод с использованием ИИ(опционально):
- Действительный лицензионный ключ, приобретенный на этом сайте, активирован.
- Вам потребуется собственный API-ключ от поставщика решений в области ИИ (Pollinations, Gemini, OpenAI, Groq, OpenRouter, Vertex AI, NVIDIA NIM и др.) — использование ИИ оплачивается поставщиком и не включено в стоимость плагина.
- PHP cURL + исходящий HTTPS-трафик к выбранному вами поставщику ИИ
- Экспорт/импорт ZIP-архивов — расширение PHP ZipArchive
Перевод с помощью ИИ — API-ключи (ВАЖНО — прочтите перед покупкой)
Этот плагин НЕ включает ключи API для ИИ, кредиты ИИ или платное использование ИИ. Интеграция с ИИ-переводом является лишь дополнительной опцией. Вам необходимо создать собственную учетную запись у поставщика ИИ и ввести свой собственный ключ API в конфигурации плагина. Все расходы на ИИ оплачиваются вами напрямую поставщиком, а не продавцом плагина.Для использования функций ИИ требуются два отдельных ключа:
- Лицензионный ключ Translations Manager — включен в стоимость покупки Codester (активация на одном сайте). Используется только для авторизации использования ИИ на вашем сайте.
- Ключ API вашего поставщика ИИ — НЕ включен . Вы должны получить его самостоятельно у поставщика, указанного ниже.
- Опыление (рекомендуемое значение по умолчанию)
- Google Gemini (ключ API Google AI Studio)
- Платформа Google Vertex AI / Agent Platform (проект GCP + ключ API или OAuth)
- NVIDIA NIM (ключ API NVIDIA с сайта build.nvidia.com)
- OpenAI
- Грок
- OpenRouter
Официальные каталоги моделей поставщиков (просмотрите их перед выбором):
- Опросы:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- Google Gemini:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- Vertex AI:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- NVIDIA NIM:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- OpenAI:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- Groq:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- OpenRouter:
Для просмотра ссылки Вы должны войти или зарегистрироваться.
- Предоставьте ключи API для ИИ или бесплатные кредиты для ИИ.
- Оплачивайте счета поставщика услуг ИИ.
- Храните свой ключ API для ИИ на внешнем сервере лицензий (ваш ключ останется на вашем сайте Osclass).
- Гарантируем высокое качество результатов работы ИИ без проверки человеком.
Доступ к сети
- Сервер лицензий — необходим для активации лицензий, проверки, авторизации ИИ и обновления плагинов.
- API поставщика ИИ — только если вы включите перевод с помощью ИИ (вы выбираете поставщика).
- Использование общего хостинга с заблокированным curlисходящим HTTPS может препятствовать работе лицензии и ИИ.
Не требуется
- Официальный аккаунт Osclass в Marketplace для обновлений плагинов (обновления доставляются через сервер лицензий поставщика).
- Редактирование основных файлов Osclass
- ZipArchive предназначен для базового ручного редактирования и сохранения файлов .po/.mo — необходим только для обновлений и работы с ZIP-архивами.
Важные примечания для покупателей
- Это инструмент для перевода в административной панели — он не переводит ваш общедоступный веб-сайт автоматически сразу после установки.
- Из исходного кода можно сканировать только строки, обернутые в функции gettext ( __(), _e(), , и т. д.)._m()
- Обычно один лицензионный ключ действителен для активации одного сайта/домена.
- Лицензионный ключ предоставляется после покупки через Codester — он не встроен в загруженный ZIP-архив.
Инструкции
1. Установка
- Скачайте ZIP-архив с Codester и распакуйте папку.translations_manager
- Загрузите его по адресу
c-content/plugins/translations_manager/ - В административной панели Osclass перейдите в раздел «Плагины».
- Найдите Менеджер переводов → нажмите Установить , затем Включить
- Откройте плагин из меню «Настройка» или «Плагины».
2. Сначала добавьте языки сайта (Osclass).
- В административной панели Osclass перейдите в «Настройки» → «Языки».
- Добавьте необходимые языки (например, арабский, французский, английский).
- Плагин управляет каталогами переводов — он не создает языки Osclass за вас.
3. Активируйте свою лицензию
- Open Translations Manager → License
- Введите лицензионный ключ, полученный после покупки (через сообщение Codester).
- Нажмите «Сохранить настройки лицензии» или «Активировать лицензию».
- Нажмите «Проверить сейчас» , чтобы убедиться, что лицензия активна на этом сайте.
4. Перевести каталог (вручную — ИИ не требуется)
- Откройте панель управления , чтобы увидеть процент выполнения и недостающие каталоги.
- Перейти к разделу «Переводы»
- Выберите: Язык + тип ( Основное ПО / Тема / Плагин )
- Нажмите «Редактировать» на нужном вам каталоге.
- Перевод строк в редакторе (поиск, фильтры: непереведенные / проблемы)
- Нажмите «Сохранить» — плагин запишет .poи скомпилирует код..mo
- Если вы используете кэширование, очистите кэш сайта, а затем проверьте внешний интерфейс.
5. Создание или обновление каталога из исходного кода.
- В редакторе каталога используйте команды «Создать из источника» или «Обновить из источника».
- Или же из панели управления запустите массовое сканирование на предмет языка сайта.
- Обнаруживаются только строки, заключенные в функции gettext ( __(), _e(), , и т. д.)._m()
- Встроенный в PHP-файлы текст без функции gettext не сканируется .
6. Дополнительно — пакетный перевод с использованием ИИ.
ВАЖНО — прочтите перед использованием ИИ:- Данный плагин НЕ включает ключи API для ИИ или бесплатные кредиты для ИИ.
- Вы должны использовать собственный API-ключ от поставщика услуг ИИ — все расходы, связанные с ИИ, оплачиваются поставщиком вам.
- Вам также потребуется действующая лицензия Translations Manager, активированная на этом сайте.
- Ваш ключ API для ИИ остается на вашем сервере — плагин проверяет разрешение только на сервере лицензий.
Как выбрать модель:
- Перейдите в раздел «Настройки» → «Перевод с использованием ИИ».
- Выберите поставщика ИИ.
- Воспользуйтесь панелью справки под выпадающим списком поставщиков — там вы найдете прямые ссылки для просмотра моделей и получения ключа API.
- Выберите рекомендуемый предустановленный параметр из выпадающего списка «Модель».
- Выбирайте только пользовательский идентификатор модели… если модели нет в списке предустановленных значений — скопируйте точный идентификатор из каталога поставщика.
- Активируйте лицензию Translations Manager (шаг 3 выше).
- Создайте учетную запись у выбранного вами поставщика ИИ и сгенерируйте ключ API.
- Перейдите в раздел «Настройки» → «Перевод с использованием ИИ».
- Включите ИИ, выберите поставщика, выберите предустановленную модель или пользовательский идентификатор.
- Вставьте свой API-ключ → нажмите «Проверить подключение к ИИ».
- Откройте каталог → используйте функцию «Перевести с помощью ИИ».
- Перед сохранением проверьте все результаты работы ИИ , особенно тексты, написанные справа налево (RTL), фирменную символику и юридические тексты.
- Нажмите «Сохранить» , чтобы записать файлы .po и .mo.
7. Резервное копирование и восстановление
- Перед каждым сохранением запускается автоматическое резервное копирование (настраивается в разделе «Конфигурация» → «Безопасность» ).
- Восстановите предыдущий снимок из панели резервного копирования редактора каталога.
- Импорт/экспорт файлов .po, .mo или ZIP с помощью инструментов редактора.
8. Обновления плагинов (лицензированные)
- Лицензия должна быть активна на этом сайте.
- Перейти в Менеджер переводов → Обновления
- Нажмите «Проверить сейчас»
- Проверьте, скачайте и установите (предварительно будет создана резервная копия).
- При необходимости можно выполнить откат из автоматических резервных копий, созданных до обновления.
9. Устранение неполадок
- Изменения не отображаются на сайте → Вы сохранили? Очистите кэш. Проверьте активный язык сайта.
- Искусственный интеллект отключен / требуется лицензия → Активируйте лицензию на вкладке «Лицензия».
- Тест ИИ не пройден → Проверьте свой собственный API-ключ, имя модели и исходящий HTTPS-трафик сервера (cURL).
- Неверная модель для поставщика услуг → Выберите предустановленный вариант из раскрывающегося списка «Модель» или используйте «Пользовательская» с идентификатором из каталога поставщиков услуг.
- Не удается сохранить большой каталог → Увеличьте количество PHP max_input_varsдо 5000+ (см. Настройки → Диагностика системы).
- Не удается установить обновление → Включите PHP ZipArchive. Проверьте права на запись в папку.
