Персонализация языковых (lang) фраз

Небольшое введение: Фразы, используемые в шаблоне могут быть динамическими и работать из информационных блоков: как правило, это названия свойств или отдельных блоков, либо работать из обособленных lang файлов, о которых и пойдет речь в данной статье. Lang файлы создаются отдельными файлами и затем подключаются в шаблонах компонентов в нужных местах. Грубо говоря, отдельная Lang фраза это некий макрос, который подставляет заданную фразу в предусмотренное для этого место в самом шаблоне.

В решении Deluxe начиная с версии 5.3 появилась возможность переопределения/персонализации языковых фраз (любых надписей, которые работают из Lang файлов). Например, Вы можете переименовать кнопку "Каталог товаров" или "В корзину" и любые другие надписи.

При установке решения после 15 августа 2023 г. инструкция актуальна с пункта 3

Как персонализировать языковые фразы

1. Обновить решение до версии 5.3

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

2. Создать директории в файловой системе (если их нет)

При обновлении или новой установке нужные директории загружаются автоматически, но если ее нет, то в корне сайта нужно создать путь /lang/ru/lang.php .Если данный путь у Вас есть, переходите к пункту 3 данной статьи.

• В системе администрирования зайти : контент - структура сайта - файлы и папки.
• В корне сайта добавить папку с названием "lang"

• В форме создания папки ввести название и убрать флажок "Создать индексную страницу раздела"

• Внутри папки lang создать папку ru (также при создании убрать флажок "Создать индексную страницу раздела" )
• Создать файл lang.php (в контентной области все удалить)

3. Внесение lang фраз в файл

• Открыть файл в режиме редактирования как php

• Внести нужные lang фразы для переопределения, по формату, как указано ниже

<?php
	$MESS["LANG_CODE"] = "Надпись для переопределения";

• Базовые коды фраз, как правило, расположены в шаблонах и компонентах, в которых используются и вызываются через GetMessage. По коду lang фразы, часто можно понять, за что она отвечает. Пример конструкции выглядит следующим образом:

<?=GetMessage("AVAILABLE");?>

• Если Вы хотите найти все lang фразы определенного компонента, для этого в файловой системе внутри шаблона нужного компонента найдите папку lang/ru далее файл template.php. В нем хранятся используемые в компоненте фразы

Например, все языковые фразы для карточек товара, элементов каталога, быстрого просмотра расположены по пути: /bitrix/components/dresscode/catalog.item/templates и далее внутри определенного шаблона lang/ru/template.php

Обратите внимание, что для некоторых фразы, например "в наличии" требуется переопределить не один lang, а несколько. Это сделано для того, чтобы оставить возможность писать разные фразы на разных страницах сайта. Например в каталоге "в наличии", а а карточке товара "Товар в наличии".

Наиболее часто изменяемые lang фразы

В решении Deluxe есть ряд фраз, которые персонализируют чаще, чем обычно, возможно в списке ниже Вы найдете нужные Вам фразы для персонализации:

Фразы каталога и карточки товара

$MESS["DRESS_CATALOG"] = "Каталог товаров";
	$MESS["ADDCART_LABEL"] = "В корзину";
	$MESS["FASTBACK_LABEL"] = "Купить в 1 клик";
	$MESS["AVAILABLE"] = "В наличии";
	$MESS["NO_AVAILABLE"] = "Недоступно";
	$MESS["NOAVAILABLE"] = "Недоступно";
	$MESS["CATALOG_NO_AVAILABLE"] = "Недоступно";
	$MESS["ON_ORDER"] = "Под заказ";
	$MESS["CATALOG_ART_LABEL"] = "Артикул: ";
	$MESS["CATALOG_ELEMENT_ACCEESSORIES"] = "Аксессуары";
	$MESS["CATALOG_ELEMENT_SIMILAR"] = "Похожие товары";
	$MESS["CATALOG_ELEMENT_AVAILABILITY"] = "Наличие";
	$MESS["SUBSCRIBE_LABEL"] = "Подписаться";
	$MESS["CHEAPER_LABEL"] = "Нашли дешевле";
	$MESS["REQUEST_PRICE_LABEL"] = "Цена по запросу";
	$MESS["REQUEST_PRICE_BUTTON_LABEL"] = "Запросить цену";

Фразы торговых предложений

$MESS["ELEMENT_SKU_OFFERS_TABLE_QUANTITY"] = "Наличие";
	$MESS["ELEMENT_SKU_OFFERS_TABLE_BASKET"] = "В корзину";

Фразы быстрого поиска

$MESS["SEARCH_TEXT"] = "Введите текст для поиска";
	$MESS["SEARCH_HEADING"] = "Результаты поиска";
	$MESS["SEARCH_ALL_RESULT"] = "Смотреть все результаты";
	$MESS["SEARCH_ERROR_FOR_EMPTY_RESULT"] = "По вашему поисковому запросу ничего не найдено";

Фразы быстрого просмотра

$MESS["FAST_VIEW_ADDCART_LABEL"] = "В корзину";
	$MESS["FAST_VIEW_FASTBACK_LABEL"] = "Купить в 1 клик";
	$MESS["FAST_VIEW_AVAILABLE"] = "В наличии";
	$MESS["FAST_VIEW_NOAVAILABLE"] = "Недоступно";
	$MESS["FAST_VIEW_NO_AVAILABLE"] = "Недоступно";
	$MESS["FAST_VIEW_ON_ORDER"] = "Под заказ";
	$MESS["FAST_VIEW_REQUEST_PRICE_LABEL"] = "Цена по запросу";
	$MESS["FAST_VIEW_REQUEST_PRICE_BUTTON_LABEL"] = "Запросить цену";