# Настройка модуля

#### Шаг 1

В ЦА сайта переходим в раздел «Модули», находим нужный модуль (1) и нажимаем кнопку «Редактировать» (2)

<div data-full-width="true"><img src="https://2369838666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mj-gwbYdQWRhuB0jULI%2Fuploads%2FC0HZTVMy7eTRBRxOHfQj%2Fimage.png?alt=media&#x26;token=08f8fa66-a193-4279-95e7-f6b9eee6e598" alt=""></div>

#### Шаг 2

Перейдите во вкладку «Настройки модуля» и укажите нужные настройки (настройки сохраняются для текущего сайта, в котором Вы находитесь)

<div data-full-width="true"><figure><img src="https://2369838666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mj-gwbYdQWRhuB0jULI%2Fuploads%2FHF7Uo8XTplak3hi9oHoU%2Fimage.png?alt=media&#x26;token=292831a6-114f-4028-8810-cf2dbbc74c9e" alt=""><figcaption></figcaption></figure></div>

* ***Сервис КЛАДР** – сервис для поиска городов*
  * &#x20;*HostCMS - справочник городов HostCMS*
  * [*DaData*](https://asmp.su/dadata) *(как получить ключ* [*подробнее*](https://support.morozovpimnev.ru/megapost/dadata)*)*
* ***Ваш токен (dadata.ru)** – обязательный если используете сервис dadata (можно получить бесплатный)*
* ***Тип**– (site|url|cookie), как система будет идентифицировать регион*&#x20;
  * *<mark style="color:yellow;">**\[site]**</mark> работа на N-количестве поддоменов (msk.site.ru, spb.site.ru и тд), для одного сайта можно создать необходимое кол-во поддоменов.*
  * *<mark style="color:yellow;">**\[url]**</mark>* *работа на одном домене N-количестве путей (site.ru/shop/ -> site.ru/msk/shop/), для одного сайта можно создать необходимое кол-во путей.*
  * *<mark style="color:yellow;">**\[cookie]**</mark>* *работа на одном домене (site.ru), такой вариант подойдет для простых сайтов, для которых достаточно смены контактных данных.*
* ***Кол-во городов в выпадающем списке при поиске** – кол-во городов в выпадающем списке при ввводе названия города в поиске*
* **Название XSL шаблона модального окна выбора/поиска города** *– Название XSL шаблона модального окна выбора/поиска города, по умолчанию «МультирегиональностьМодальноеОкно»*
* **ID типа email указанный в регионе, на который отсылать информацию о поступившем заказе** *– ID типа email указанный в регионе, на который отсылать информацию о поступившем заказе*

{% hint style="danger" %}
**\*ВНИМАНИЕ!** Type **\[url]** и **\[cookie]** не работает с функционалом **«Кэширование в статичные файлы (зеркалирование)»**
{% endhint %}

Для версии HostCMS < 6.9.8 настройки модуля вносятся как PHP-код с параметрами модуля или в файлу `/modules/multiregion/config/config.php`

{% code title="для всех сайтов" lineNumbers="true" fullWidth="true" %}

```php
<?php

return array (
	'serviceKladr' => '', // Сервис КЛАДР
	'kladrToken' => '', // Ваш токен (kladr-api)
	'dadataToken' => '', // Ваш токен (dadata.ru)
	'type' => 'url', // Тип
	'cityLimit' => 5, // Кол-во городов
	'defaultCityId' => 1, // город по умолчанию, если не удалось определить по GeoIP
	'favoriteCities' => '1,1745,173,526,339,2289,1550,2229,1888', // города фавориты в модальном окне предложенные пользователю в блоке «Например»
	'xsl' => 'МультирегиональностьМодальноеОкно', // Название XSL шаблона
	'send_order_email' => 1 // ID типа email указанный в регионе
);
```

{% endcode %}

{% code title="для сайта ID = 123" lineNumbers="true" fullWidth="true" %}

```php
<?php

return array (
	123 => array(
		'serviceKladr' => '',
		'kladrToken' => '',
		'dadataToken' => '',
		'type' => 'url',
		'cityLimit' => 5,
		'defaultCityId' => 1,
		'favoriteCities' => '1,1745,173,526,339,2289,1550,2229,1888',
		'xsl' => 'МультирегиональностьМодальноеОкно',
		'send_order_email' => 1
	)
);
```

{% endcode %}