Документация GTranslate TDN

Доступна бесплатная настройка

Свяжитесь с нами — мы бесплатно настроим GTranslate для вас.

Обновление: теперь GTranslate можно настроить с помощью мастера настройки в личном кабинете.

1. Выберите структуру URL

С вашей подпиской можно использовать URL-адреса на поддоменах (https://es.example.com) или в подкаталогах (https://example.com/fr/). Если у вас тариф Enterprise и вы хотите разместить языковую версию на национальном домене верхнего уровня (https://example.fr), свяжитесь с нами.

Примечание: Для магазинов Shopify доступны только URL-адреса на поддоменах.

Настройка URL-адресов в подкаталогах

WordPress : Если вы используете WordPress, установите плагин GTranslate и включите опцию «Структура URL-адресов подкаталогов» на странице настроек GTranslate. Перейдите к шагу 3.

Для этого на сервере должны быть установлены PHP и Apache. Если вы используете другой веб-сервер, свяжитесь с нами.

  1. Скачать дополнение GTranslate URL и распаковать архив
  2. Откройте файл gtranslate/config.php и укажите правильный код исходного языка в параметре main_lang
  3. Загрузите папку gtranslate в корневой каталог www
  4. Откройте или создайте файл .htaccess в корневом каталоге www и добавьте в его начало следующий код:
    # gtranslate config
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /$1/$3 [R=301,L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /gtranslate/gtranslate.php?glang=$1&gurl=$2 [L,QSA]
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)$ /$1/ [R=301,L]
    
    

 

Настройка URL-адресов на поддоменах

Для создания поддоменов вам нужно всего лишь добавить записи DNS CNAME для каждого языка. Список записей CNAME вы получите в электронном письме с инструкциями после завершения заказа. После их добавления ваши переводы станут доступны через пару минут. Перейдите к шагу 2.

2. Добавьте виджет выбора языка

Скачайте и добавьте на сайт бесплатный виджет выбора языка GTranslate Free, затем выберите URL-адреса на поддоменах или в подкаталогах в зависимости от выбранной структуры.

3. Проверка настройки

Если в вашей подписке доступна функция перевода URL-адресов и вы хотите ее включить, следуйте инструкциям по включению перевода URL-адресов.

Примечание: Не выполняйте настройку подкаталогов и поддоменов одновременно.

Если возникнут трудности, свяжитесь с нами — мы поможем с настройкой.


Добавление записи CNAME

DNS — это компонент Интернета, который преобразует удобочитаемые доменные имена (например, example.com) в машиночитаемые IP-адреса (например, 192.0.32.10). Он делает это в соответствии с файлами зон DNS, которые находятся на вашем сервере и связывают доменные имена с IP-адресами.

CNAME означает «запись канонического имени». Эта запись создаёт псевдоним, по которому запрашивающий сервер продолжает поиск в DNS под другим именем.

Добавление записи может занять до 48 часов. Обычно это занимает менее 5 минут. Вы можете использовать инструмент командной строки nslookup, чтобы проверить, добавлена ​​ли запись.

После оформления заказа вы получите письмо с инструкциями и списком записей CNAME.

В этой полезной инструкции по добавлению записей CNAME описаны настройки для большинства регистраторов доменов.

Хостинг с cPanel

  1. Войдите в свою учетную запись cPanel
  2. Откройте редактор зон Simple DNS в разделе «Домены».

    альт

  3. Выберите свой домен в выпадающем списке. В разделе Add a CNAME Record укажите код языка в поле Name и имя сервера GTranslate в поле CNAME, затем нажмите кнопку Add CNAME Record.

    альт

Хостинг с Plesk

  1. Перейдите на страницу «Настройки DNS».
  2. Добавить запись

    альт

  3. Выберите тип записи CNAME.

  4. Введите доменное имя (код языка) и каноническое имя (имя сервера GTranslate) записи. Нажмите кнопку ОК, чтобы добавить запись.

  5. альт

Другие панели управления

Если вы не можете найти раздел управления DNS в панели управления хостингом, обратитесь к своему хостинг-провайдеру за инструкцией по добавлению новых DNS-записей. Они должны помочь вам, если в панели управления хостингом нет раздела для управления DNS-записями.

Включить перевод URL-адресов

WordPress : Включите опцию "Перевод URL-адресов" на странице настроек плагина GTranslate.

Shopify : Включите опцию «Перевод URL-адресов» на странице настроек приложения GTranslate.

Joomla, Drupal и другие платформы:

Чтобы включить перевод URL-адресов сайта, добавьте следующий код в элемент head на страницах сайта.

<meta name="uri-translation" content="on">

Разместите его перед остальными тегами внутри элемента head.

Редактирование переводов

Чтобы отредактировать перевод, откройте нужную языковую версию и добавьте ?language_edit=1 к URL-адресу. Если в URL-адресе уже есть ?, добавьте &language_edit=1. Например, чтобы открыть редактор на главной странице испанской версии, перейдите по адресу http://es.example.com/?language_edit=1 | http://example.com/es/?language_edit=1.

В режиме редактирования можно сразу отличить отредактированные тексты от автоматического перевода. Красный карандаш обозначает отредактированный текст, а зелёный — автоматический перевод.

С помощью значка стрелки можно редактировать переведенные URL-адреса.

Определение выбранного языка

Если для отдельных языков нужна особая логика, определите выбранный язык и используйте его в своём коде.

Текущий код выбранного языка можно найти в заголовке запроса X-GT-Lang. Если ваш сайт написан на PHP, вы можете найти его в переменной _SERVER['HTTP_X_GT_LANG'].

Перенаправление URL-адресов из подкаталогов на поддомены

Добавьте это правило перед остальными правилами в файле .htaccess.

RewriteRule ^([a-z]{2}|zh-CN|zh-TW)/(.*)$ http://$1.domain.com/$2 [R=301,L,QSA]

Включение перевода данных в формате JSON

В современных веб-приложениях данные передаются через AJAX-запросы в формате JSON. Чтобы перевести содержимое JSON и не нарушить работу приложения, нужно указать, значения каких ключей следует переводить. Допустим, нужно перевести следующие данные JSON:

{
    "name":"test",
    "description":"test description",
    "id":500,
    "months": ["January","February","March"],
    "content":"<i>Hello world</i>",
    "user": {
        "login":"test",
        "bio":"test user"
    }
}

Укажите ключи, значения которых нужно перевести, в специальном ключе gt_translate_keys внутри JSON-объекта. Например:

{
    "name":"test",
    "description":"test description",
    "id":500,
    "months": ["January","February","March"],
    "content":"<i>Hello world</i>",
    "gt_translate_keys": ["name", "description", {"key": "months", "format": "list"}, {"key": "content", "format": "html"}],
    "user": {
        "login":"test",
        "bio":"test user",
        "gt_translate_keys": [{"key": "bio", "format": "text"}]
    }
}

Как видно из примера, gt_translate_keys должен быть массивом. В нём можно указать только имя ключа, значение которого нужно перевести, или дополнительно задать формат значения. Доступные форматы: list, html и text; text используется по умолчанию, если формат не указан.

После перевода данные будут выглядеть так:

{
    "name":"тест",
    "description":"тестовое описание",
    "id":500,
    "months": ["Январь","Февраль","Март"],
    "content":"<i>Привет мир</i>",
    "user": {
        "login":"test",
        "bio":"тестовый пользователь"
    }
}

Попробуйте GTranslate бесплатно в течение 15 дней