Документация для разработчиков
Темная тема

AddCity

Класс устарел. Рекомендуется использовать методы класса Bitrix\Sale\Location.

Описание и параметры

int
CSaleLocation::AddCity(
	array arFields
);

Метод добавляет новый город с параметрами из массива arFields. Нестатический метод.

Внимание! Начиная с версии 14.10.0 метод не обновляется и обратная совместимость не поддерживается. Рекомендуется использовать методы нового ядра D7. Примеры работы с новым ядром можно увидеть здесь.

Параметры вызова

ПараметрОписание
arFields Ассоциативный массив с параметрами города должен содержать ключи:
  • NAME - название города (не зависящее от языка);
  • SHORT_NAME - сокращенное название города - аббревиатура (не зависящее от языка);
  • <код языка> - ключем является код языка, а значением ассоциативный массив вида
    array(
    	"LID" => "код языка",
    	"NAME" => "название города на этом языке",
    	"SHORT_NAME" => "сокращенное название города (аббревиатура) на этом языке"
    )
    Эта пара ключ-значение должна присутствовать для каждого языка системы.

Возвращаемые значения

Возвращается код добавленного города или false в случае ошибки.

Пример использования

<?
$arCity = array(
	"NAME" => "Kaliningrad",
	"SHORT_NAME" => "Kaliningrad",
	"ru" => array(
		"LID" => "ru",
		"NAME" => "Калининград",
		"SHORT_NAME" => "Калининград"
	),
	"en" => array(
		"LID" => "en",
		"NAME" => "Kaliningrad",
		"SHORT_NAME" => "Kaliningrad"
	)
);

$ID = CSaleLocation::AddCity($arCity);
if (IntVal($ID)<=0)
	echo "Ошибка добавления города";
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024