Импорт регионов (*Pro)

Начиная с версии 1.7.9 в настройках плагина «WT Geotargeting Pro» появилась возможность импортировать регионы из файла CSV.

Как импортировать регионы?

1. Создайте таблицу в формате CSV.
2. Заполните первую строку названиями импортируемых колонок (см. раздел «Формат CSV»).
3. Если импортируете города вместе с областями: сначала добавьте данные регионов, затем городов с указанием родительских регионов.
4. Сохраните файл в формате CSV, кодировка UTF-8, разделитель — запятая.
5. Откройте WT GeoTargeting → Импорт.
6. Выберите импортируемый файл. В поле «Кодировка файла» укажите UTF-8 или CP1251 — конвертация выполняется на отдельном шаге до загрузки данных, что повышает надёжность импорта из Excel и других источников.
7. Укажите формат: CSV.
8. При необходимости выберите кодировку и символ разделителя.
9. Выберите, как поступать при совпадении городов: Перезаписывать или Пропускать.
10. При импорте городов с областями включите опцию «Поиск существующих локаций с учётом родителя».
11. Выберите действие: Загрузить файл и импортировать.
12. Нажмите Сохранить изменения.

Формат таблицы CSV

• Кодировка: UTF-8 (или CP1251 — см. опции)
• Разделитель: запятая
• Первая строка: названия колонок

Обязательные колонки

Допустимые значения region_type и parent_type

• administrative_district — административный округ
• city — город
• region — область
• district — округ
• country — страна

Колонки для иерархии и обновления

Дополнительные колонки

• Любая другая колонка сохраняется как мета-переменная региона (например, phone, email, subdomain и любые ваши пользовательские meta-ключи). См. параметры регионов.
• Для множественных meta-значений используйте заголовок в формате meta_key,array.
• В значении такой колонки перечисляйте элементы через ; (например: value1;value2;value3).
• Код языка (например, en, de) — перевод названия региона на этот язык (Alpha-версия).

Колонка удаления

• delete / удалить — при значении 1, да, yes, удалить регион будет удалён при импорте.

Прочие колонки

Пример строки заголовков

region_id,parent_name,parent_type,region_name,region_type,status,subdomain,"custom_tags,array",delete

Как создать CSV-файл?

Создайте таблицу в Google Таблицах и скачайте: Файл → Скачать → CSV (текущий лист).

Пример таблицы: Google Sheets.

Опции импорта

Экспорт регионов

Для выгрузки откройте WT GeoTargeting → Экспорт.

Доступные настройки экспорта:

• Кодировка файла (UTF-8 / CP1251)
• CSV — разделитель ячеек
• Экспорт скрытых мета-данных — включает в CSV meta-ключи, начинающиеся с _.

Строки CSV формируются через fputcsv (корректное экранирование полей). При включённой в плагине поддержке доменов регионов в файл добавляется колонка domain.

При экспорте в CSV сохраняются:

• служебные поля (region_id, parent_name, parent_type, region_name, region_type, status);
• все meta-данные региона (post_meta) как отдельные колонки;
• для многозначных meta-полей колонка формируется как meta_key,array, а значения объединяются через ;.

Это позволяет безопасно использовать сценарий round-trip:

1. Экспортировать CSV.
2. Изменить значения (в том числе добавить новые meta-колонки).
3. Импортировать файл обратно — изменения будут применены к регионам.

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

Добавьте колонку delete или удалить. Значение в ячейке (1, да, yes, удалить) приведёт к удалению соответствующего региона при импорте.