Плагін призначений для синхронізації даних об'єктів нерухомості із зовнішнього API та управління цими об'єктами через адміністративний інтерфейс WordPress. Включає автоматичну та ручну синхронізацію даних, створення кастомного типу записів, налаштування параметрів відображення, управління медіафайлами та інтеграцію з Elementor.
Основний функціонал
Синхронізація об'єктів із зовнішнім API
Імпорт даних об'єктів нерухомості з API.
Облік обмежень API (максимум 25 об'єктів за один запит).
Оновлення лише змінених даних (аналіз часових міток update_time).
Видалення неактуальних об'єктів (проданих або знятих із продажу).
Підтримка двох режимів синхронізації:
Автоматична (за розкладом: 3/6/12/24/48 годин).
Ручна (через адміністративний інтерфейс).
Облік поля Seller: імпортуються лише об'єкти від приватних осіб.
Управління об'єктами нерухомості
Створення кастомного типу записів Re-Sel Object.
Ручне додавання об'єктів через інтерфейс WordPress Admin.
Поля для введення даних об'єкта:
Спальні (Bedrooms).
Ванні кімнати (Bathrooms).
Площа (Square Area).
Продавець (Seller Type): приватна особа/забудовник.
Тип об'єкта (Object Type): квартира/вілла.
Назва житлового комплексу.
Район (District) як таксономія.
Геолокація (Address Map).
Опис об'єкта (Description).
Ціна (Price) та валюта (Currency).
Галерея зображень.
Усі дані мають підтримувати локалізацію через Loco Translate.
Галерея зображень
Імпорт фотографій із API.
Збереження зображень у бібліотеці WordPress Media.
Можливість додавання/видалення зображень вручну.
Налаштування плагіна
Введення API-ключа.
Встановлення інтервалу автоматичної синхронізації (3/6/12/24/48 годин).
Кнопки:
Ручна синхронізація.
Очищення бази об'єктів.
Повідомлення:
Успішний імпорт.
Помилки синхронізації.
Шаблони відображення об'єктів
Шаблон для сторінок об'єктів (single-resel_object.php).
Підтримка кастомних полів для використання в Elementor.
Виведення всіх параметрів об'єкта на фронтенді.
Документація по API
Основний ключ API
Для взаємодії використовується параметр token.
Основні ендпоінти API
Отримання списку активних об'єктів
HTTP-метод: GET
URL:
vbnet
Копировать код
https://сайт-донор/api/index.php?token={KeyAPI}&action=get-objects-list&seller={SellerId}
Параметри:
KeyAPI (обов'язковий): ключ API.
action (обов'язковий): get-objects-list.
seller (необов'язковий): фільтр за типом продавця:
0 – приватна особа (інвестор).
1 – забудовник.
Приклад відповіді:
json
Копировать код
[
{
"article": "1978",
"update_time": 1693505612,
"update_time_price": 1693505620,
"update_time_description": 1693505630,
"update_time_photo": 1693505640
}
]
Отримання базових даних об'єкта
HTTP-метод: GET
URL:
css
Копировать код
https://сайт-донор/api/index.php?token={KeyAPI}&action=get-object&article={ArticleId}
Параметри:
KeyAPI (обов'язковий): ключ API.
action (обов'язковий): get-object.
article (обов'язковий): артикул об'єкта.
Приймаються проп