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

#### Шаг 1

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

<div data-full-width="true"><img src="/files/qdOX7fInmXZnUHzLXihu" alt=""></div>

#### Шаг 2

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

<div data-full-width="true"><figure><img src="/files/Hcq4W1iB4g35hcvsUNW0" alt=""><figcaption></figcaption></figure></div>

* ***Сервис КЛАДР** – сервис для поиска городов*
  * &#x20;*HostCMS - справочник городов HostCMS*
  * [*DaData*](https://asmp.su/dadata) *(как получить ключ* [*подробнее*](/megapost/dadata.md)*)*
* ***Ваш токен (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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.morozovpimnev.ru/multiregion/nastroika-modulya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.