Мультиязычные сайты

Переменные

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

ВАЖНО: Для того, чтобы переменные работали корректно, нужно задать одинаковую структуру в адресах страниц. Например, site.com/contacts/ и site.ru/contacts/.

Переменная {uri}

Например, вы хотите, чтобы при переходе с русской страницы site.ru/contacts/ открывалась такая же страница, но на английском языке site.com/contacts/.

В поле для ссылки укажите:
site.ru/{uri} для русского языка
site.com/{uri} для английского языка.

Браузер автоматически подставит адрес страницы, на которой находится посетитель
вместо переменной {uri}

Переменная {clean_uri}

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

Принцип работы переменной похож на обычную {uri}, но из адреса страницы будет вырезаны первые два символа заключенные в / (боковые слэши).

То есть значение /en/contacts/ для {uri} будет соответствовать значению /contacts/ для {clean_uri} (см. таблицу с примерами ниже).

Пример мультиязычного сайта с настроенной структурой страниц по языкам:
— Русские страницы: /, /contacts/, /about/
— Английские страницы: /en/, /en/contacts/, /en/about/
— Французские страницы: /fr/, /fr/contacts/, /fr/about/

Если для английского языка указать ссылку https://site.com/en/{clean_uri}, при переходе со страницы Контакты (/fr/contacts/ для французской версии или /contacts/ для русской), браузер вырежет первые символы /fr из адреса. И в значении переменной останется /contacts/. Это значение будет подставлено в указанную вами ссылку вместо переменной и получится адрес: https://site.com/en/contacts/

В строке браузера адрес поменяется с https://site.com/ru/contacts/ на https://site.com/en/contacts/, и визуально для посетителя поменяется только язык страницы.

Примеры значений переменных для разных страниц:

Адрес страницы	Значение переменной {uri}	Значение переменной {clean_uri}
site.com/	/	/
site.com/menu/	/menu/	/menu/
site.com/ru/menu/	/ru/menu/	/menu/
site.com/ru/pp/menu/	/ru/pp/menu/	/pp/menu/
site.com/rus/menu/	/rus/menu/	/rus/menu/

Параметр fallback

При использовании переменных может возникнуть ситуация, когда на английском сайте нет страницы с таким же адресом, как на русском сайте или наоборот. В этом случае при выборе языка откроется страница с ошибкой 404 (страница не существует).

Чтобы этого не произошло, можно указать в ссылке параметр fallback. Если добавить в ссылку перехода параметр ?fallback=/, то пользователь будет перенаправлен на страницу, которую вы укажете после ссылки.

Пример:
Для английского языка указана ссылка site.com/{uri}?fallback=/

Это означает, что при клике на английский флаг платформа будет искать на английском сайте страницу с таким же адресом, как на текущей странице сайта. Если на английском сайте страницы с таким же адресом нет, произойдет переход на / (главную страницу).