Регионы

Регион в Cheffy — это российский город с собственной настройкой витрины: поддомен, координаты, ключи Яндекс Карт, канал продаж по умолчанию, зоны доставки и SEO-шаблоны.

В Cheffy регион — это не страна и не группа стран, а российский город со своей настройкой витрины. Создавая регион, вы заводите город (например, Анапу или Краснодар) с поддоменом, координатами центра, ключами Яндекс Карт, каналом продаж по умолчанию и зонами доставки. Витрина по поддомену сама подхватывает нужную конфигурацию — отдельно настраивать сайт под каждый город не требуется.

Зачем нужны регионы-города

Один регион — один город. Покупатель заходит на поддомен города (например, anapa.cheffy.ru), и витрина по этому поддомену находит регион, загружает ключи Яндекса для карты и автоподсказок адреса, открывает канал продаж по умолчанию и применяет SEO-шаблоны. Когда покупатель указывает адрес, его координаты определяют зону доставки (цена, срок, порог бесплатной доставки) и доступные точки самовывоза. Администратор настраивает город прямо в админке — и витрина настраивается сама.

Где находится

Откройте Настройки → Регионы. Здесь отображается список созданных городов; кнопка Создать заводит новый регион, а на странице региона расположены виджеты «Конфигурация региона» и SEO.

Создание региона-города

Откройте форму создания

На странице Регионы нажмите Создать.

Задайте название и валюту

В поле Название введите название города — например, Анапа. В поле Валюта выберите Российский рубль (RUB ₽). Валюта должна быть предварительно добавлена в настройках магазина.

Сохраните регион

Нажмите Сохранить. Город появится в списке. После этого откройте его, чтобы заполнить виджет «Конфигурация региона» — именно там задаётся вся настройка витрины.

Конфигурация региона

На странице города расположен виджет «Конфигурация региона». Заполненные здесь значения сохраняются в метаданных региона и используются витриной. Заполните поля и нажмите Сохранить.

Поле формы	Что задаёт	Пример
Название города (Кириллица)	Отображаемое название города на витрине и в SEO-шаблонах.	`Анапа`
Поддомен (anapa, krasnodar)	Поддомен витрины, по которому определяется регион.	`anapa`
Координаты центра города	Точка, на которую центрируется карта при открытии витрины («широта, долгота»).	`44.8951, 37.3162`
Код страны (aq)	Двухбуквенный код страны.	`RU`
Канал продаж по умолчанию	Канал, с которого витрина открывается до того, как покупатель выбрал адрес.	`Анапа — доставка`
Локации доставки для региона	Чекбоксы складских локаций; зоны доставки подтягиваются автоматически.	Склад «Анапа-центр»
Yandex Maps API Key	Ключ для геокодирования и отображения карты.	—
Yandex Suggest API Key	Ключ для автоподсказок адреса при оформлении заказа.	—
Ссылка на KML файл зон доставки Яндекс Карт	KML-файл с границами зон доставки, нарисованными в Яндекс Картах.	—

Поддомен — ключ ко всему

Поддомен (CITY_DOMAIN) — это связующее звено между адресом витрины и регионом. Когда покупатель открывает krasnodar.cheffy.ru, витрина ищет регион с поддоменом krasnodar, и из его конфигурации берёт ключи Яндекса, канал продаж по умолчанию и SEO-шаблоны. Поддомен должен совпадать с настройкой DNS витрины.

Скриншот · вставить позже

Что снять:

Виджет «Конфигурация региона» на странице города «Анапа» в Cheffy: поля «Название города (Кириллица)» = «Анапа», «Поддомен (anapa, krasnodar)» = «anapa», «Координаты центра города» = «44.8951, 37.3162», «Код страны (aq)» = «RU», выпадающий список «Канал продаж по умолчанию», блок чекбоксов «Локации доставки для региона», поля «Yandex Maps API Key», «Yandex Suggest API Key» и «Ссылка на KML файл зон доставки Яндекс Карт». Внизу кнопка «Сохранить».

Зоны доставки и точки самовывоза

Зоны доставки не задаются вручную в админке — они подтягиваются автоматически из KML-файла и локаций доставки, выбранных в конфигурации региона. Когда покупатель указывает адрес, витрина:

по Yandex Suggest API Key подсказывает адрес при вводе;
по Yandex Maps API Key определяет координаты адреса (геокодирование);
сопоставляет координаты с зонами из KML-файла и определяет цену доставки, срок и порог бесплатной доставки;
показывает доступные точки самовывоза по выбранным локациям доставки.

Где рисуются зоны

Границы зон доставки рисуются в конструкторе Яндекс Карт и выгружаются в виде KML-файла, ссылку на который вы указываете в конфигурации региона. Складские локации и способы доставки настраиваются в разделе Склады и доставка.

SEO-шаблоны региона

Отдельный виджет SEO на странице города задаёт шаблоны метатегов для витрины этого города. Это таблица из трёх строк (типы страниц) и трёх столбцов (метаполя):

Страница	Title	Description	H1
Главная	Доставка продуктов в [city_name]	Закажите продукты с доставкой в [city_name]	Продукты в [city_name]
Категория	[category_name] в [city_name]	[category_name] с доставкой по [city_name]	[category_name]
Товар	[product_name] — купить в [city_name]	[product_name] с доставкой в [city_name]	[product_name]

В шаблонах используются переменные [city_name], [category_name] и [product_name] — витрина подставляет в них название города, категории и товара. Шаблоны сохраняются в метаданных региона (seo_templates).

Скриншот · вставить позже

Что снять:

Виджет «SEO» на странице города «Краснодар»: таблица из трёх строк («Главная», «Категория», «Товар») и трёх столбцов («Title», «Description», «H1») с шаблонами, содержащими переменные [city_name], [category_name], [product_name]. Внизу кнопка «Сохранить».

Как витрина подхватывает регион

Поддомен → регион

Покупатель открывает anapa.cheffy.ru. Витрина по поддомену anapa находит соответствующий регион (поле Поддомен).

Загрузка конфигурации

Из конфигурации региона витрина берёт ключи Яндекс Карт, канал продаж по умолчанию и SEO-шаблоны. Карта центрируется по координатам центра города.

Адрес покупателя → зона доставки

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

Изменение и удаление региона

Чтобы изменить настройку города, откройте регион, отредактируйте виджеты «Конфигурация региона» или SEO и нажмите Сохранить. Название и валюту региона можно изменить через меню (три точки) → Изменить.

Удаление региона необратимо

Удаление региона нельзя отменить. Вместе с городом перестаёт работать его витрина по поддомену: пропадают ключи Яндекса, канал по умолчанию, зоны доставки и SEO-шаблоны. Удаляйте регион только если полностью прекращаете продажи в этом городе.