Homes Overseas XML Export — это премиальный плагин для WordPress (Houzez), который автоматически создает XML-фид ваших объектов недвижимости в формате, идеально совместимом с крупнейшим русскоязычным каталогом зарубежной недвижимости HomesOverseas.ru.
Для модераторов и админов
Отладка и тестирование
Проверка отдельных объектов и диагностика проблем
Настройки
Настройка маркера экспорта и глобальных параметров
Сопоставление типов
Сопоставьте типы недвижимости с ID HomesOverseas
Сопоставление городов
Сопоставьте города из вашего сайта с ID регионов HomesOverseas
Панель управления
Enterprise версия 5.0 — управление экспортом объектов на HomesOverseas
Отладка и тестирование
Проверка отдельных объектов и диагностика проблем
Что исправлено
-
Добавлены все недостающие функции:
-
homes_enterprise_types_page()— страница сопоставления типов -
homes_enterprise_features_page()— страница сопоставления удобств -
homes_enterprise_labels_page()— страница сопоставления меток -
homes_enterprise_debug_page()— страница отладки
-
-
Добавлена функция
homes_enterprise_check_property()— детальная проверка объекта -
Убран дублирующийся код — теперь все страницы имеют полную реализацию
-
/* ROOMS */$rooms = get_post_meta($id, ‘fave_property_rooms’, true);if ($rooms && $rooms > 0) {$xml[] = «<rooms>» . (int)$rooms . «</rooms>»;}
Поддержка перевода
-
Text Domain:
homes-export -
Domain Path:
/languages -
Файл
.potдля локализации
Для PRO (Плагин + Код)
Один клик...
Homes Overseas XML Export — это премиальный плагин для WordPress (Houzez), который автоматически создает XML-фид ваших объектов недвижимости в формате, идеально совместимом с крупнейшим русскоязычным каталогом зарубежной недвижимости HomesOverseas.ru.
Ключевые возможности
Полная совместимость с Houses.overseas форматом
Плагин генерирует XML, который проходит валидацию на официальном чекере https://www.homesoverseas.ru/xml/check.php
Автоматическое преобразование всех полей Houzez
| Поле HomesOverseas | Откуда берется в Houzez |
|---|---|
| region (город) | property_city + fave_property_location |
| realty_type | property_type |
| options | property_feature |
| price | fave_property_price |
| size_house | fave_property_size |
| size_land | fave_property_land_area |
| bedrooms | fave_property_rooms |
| year | fave_property_year |
| distance_sea | кастомное поле расстояния до моря |
| level | этаж |
| levels | этажность дома |
| not_ready_year | fave_completion_date |
| photos | Все изображения объекта + галерея |
Встроенные карты соответствия
-
Города Болгарии → ID HomesOverseas (более 300+ городов и курортов)
-
Типы недвижимости (апартаменты, дома, участки и т.д.)
-
Удобства и характеристики (бассейн, парковка, лифт, вид на море и др.)
-
Метки рынка (первичный/вторичный)
Режим отладки (PRO функция)
-
Отключает строгие проверки полей
-
Показывает, какие данные не найдены
-
Удобно для настройки и тестирования
Интеллектуальная обработка данных
-
Автоматическая конвертация цен (€, пробелы, запятые)
-
Перевод метров в километры для расстояния до моря
-
Валидация года постройки (только корректные годы)
-
Обрезка заголовков до 60 символов
-
Обрезка описаний до 150 символов (аннотация)
Гибкая фильтрация объектов
-
Экспорт только объектов с меткой homesoverseas
-
Возможность выборочного включения в фид
Технические характеристики
| Характеристика | Значение |
|---|---|
| Версия | 3.4 |
| Требования | WordPress 5.0+, Houzez тема/фреймворк |
| PHP | 7.4+ |
| Кодировка | UTF-8 |
| Формат выдачи | XML |
| URL экспорта | https://вашсайт.ру/homesoverseas.xml |
| Поддержка кириллицы | Да (CDATA обертки) |
| SEO-оптимизация | Заголовки и описания обрезаются корректно |
Пример вывода XML
<object> <objectid>123</objectid> <type>sale</type> <market>primary</market> <title><ru>Шикарные апартаменты в Солнечном Береге</ru></title> <price><sale>125000</sale></price> <region>35</region> <realty_type>16</realty_type> <size_house>85</size_house> <bedrooms>2</bedrooms> <year>2022</year> <distance_sea>0.35</distance_sea> <photos> <photo>https://вашсайт/photo1.jpg</photo> <photo>https://вашсайт/photo2.jpg</photo> </photos> </object>
Как это работает?
-
Устанавливаете плагин
-
Активируете нужные объекты через метку «homesoverseas»
-
Переходите по ссылке
https://вашсайт.ru/homesoverseas.xml -
Копируете URL и добавляете в личный кабинет HomesOverseas
-
Система автоматически забирает ваши объекты ежедневно
Как включать/выключать DEBUG режим в плагине
В плагине есть всего ОДНА строка для управления дебагом:
define('HOMES_XML_DEBUG', true); // Включен DEBUG режим
define('HOMES_XML_DEBUG', false); // Выключен DEBUG режим (PRODUCTION)
В самом начале файла плагина, сразу после комментария с названием:
<?php /** * Plugin Name: Homes XML Export (Houzez Debug Full v3) * Plugin URI: * Description: Export properties to XML format for Homes Overseas * Version: 3.4 * Author: Your Name */ define('HOMES_XML_DEBUG', true); // 👈 вот здесь!
DEBUG режим (true)
| Что происходит | Результат |
|---|---|
| Проверки полей | ОТКЛЮЧЕНЫ — экспортируются все объекты |
| Отсутствие region, year и др. | Объект ВСЁ РАВНО экспортируется |
| Отладочные теги | Добавляются в XML (<debug_mode>, <debug_images>, <debug_taxonomy> и т.д.) |
| Объектов в экспорте | 5 (для быстрого тестирования) |
| Когда использовать | Настройка, отладка, тестирование |
PRODUCTION режим (false)
| Что происходит | Результат |
|---|---|
| Проверки полей | ВКЛЮЧЕНЫ — экспортируются только валидные объекты |
| Отсутствие всех обязательных полей | Объект ПРОПУСКАЕТСЯ |
| Отладочные теги | ПОЛНОСТЬЮ ОТСУТСТВУЮТ |
| Объектов в экспорте | ВСЕ (аналог -1) |
| Когда использовать | Работающий сайт, отправка фида в HomesOverseas |
-
Откройте файл плагина
-
Через админку: Плагины → Редактор → выберите нужный плагин
-
Через FTP:
/wp-content/plugins/название_папки/файл.php
-
-
Найдите строку
define('HOMES_XML_DEBUG', ...) -
Измените значение:
-
На
true= DEBUG режим -
На
false= PRODUCTION режим
-
-
Сохраните файл
-
Сбросьте кэш (если есть плагин кэширования)
Как проверить, что режим включен?
Откройте в браузере https://вашсайт.com/homesoverseas.xml
В DEBUG режиме увидите:
<meta> <debug_mode>enabled</debug_mode> <debug_note>Проверки полей ОТКЛЮЧЕНЫ, экспорт выполняется принудительно</debug_note> <total_objects>5</total_objects> </meta>
В PRODUCTION режиме этих тегов НЕ будет.
⚠️ Важное замечание
На живом (production) сайте всегда должно быть:
define('HOMES_XML_DEBUG', false);
Иначе:
-
В XML будет много «мусора» (отладочных тегов)
-
Валидатор HomesOverseas может выдать ошибки
-
Могут экспортироваться «битые» объекты без данных
| Ситуация | DEBUG режим |
|---|---|
| Настройка плагина | ✅ Включить (true) |
| Поиск проблем с полями | ✅ Включить (true) |
| Тестирование на тестовом сайте | ✅ Включить (true) |
| Реальный экспорт на HomesOverseas | ❌ Выключить (false) |
| Боевой сервер с клиентами | ❌ Выключить (false) |
Инструкция
1. О плагине
2. Установка
3. Первоначальная настройка
4. Настройка маркера экспорта
5. Сопоставление городов (сity mapping)
6. Сопоставление типов недвижимости (type mapping)
7. Сопоставление удобств (feature mapping)
8. Сопоставление меток рынка (label mapping)
9. Режим отладки (debug mode)
10. Проверка отдельных объектов
11. Экспорт и получение xml
12. Добавление …
