first commit

README.md

@@ -0,0 +1,57 @@
+# YML → CSV (open endpoint for WP All Import)
+
+Генерирует CSV из Prom.ua YML-фида по открытому эндпоинту. Строит `category_path` для иерархии категорий и конвертирует цену из PLN в UAH (НБУ или вручную).
+
+## Установка
+
+1. Создай папку `wp-content/plugins/yml2csv/`.
+2. Сохрани файл плагина как `wp-content/plugins/yml2csv/yml2csv.php`.
+3. Активируй плагин в админке WordPress.
+
+## Эндпоинт
+
+`GET /?yml2csv=1&src=...&target_cur=UAH[&rate=...][&margin=...][&precision=...]`
+
+**Параметры:**
+
+* `src` — URL YML-фида (обязательный).
+* `target_cur` — целевая валюта. Автоконверсия реализована для `UAH` при исходном `PLN`.
+* `rate` — фиксированный курс PLN→UAH. Если задан, НБУ не вызывается.
+* `margin` — множитель наценки (например, `1.07` = +7%). По умолчанию `1.0`.
+* `precision` — знаков после запятой для финальной цены. По умолчанию `2`.
+
+## Примеры
+
+```text
+https://example.com/?yml2csv=1&src=http://127.0.0.1/feeds/prom_feed.yml&target_cur=UAH
+https://example.com/?yml2csv=1&src=http://127.0.0.1/feeds/prom_feed.yml&target_cur=UAH&rate=9.25
+https://example.com/?yml2csv=1&src=http://127.0.0.1/feeds/prom_feed.yml&target_cur=UAH&margin=1.07&precision=0
+```
+
+## Формат CSV
+
+Колонки:
+
+```
+sku, title, description,
+price, currency,           // конечные значения для WooCommerce
+price_src, currency_src,  // исходные значения из фида
+stock,
+category_path, category_name, category_id,
+image_urls                 // через запятую
+```
+
+## Маппинг в WP All Import
+
+* Title → `title`
+* Content → `description`
+* Images → `image_urls` (comma-separated)
+* Regular Price → `price`
+* SKU → `sku`
+* Categories → включить «hierarchical (parent/child)» и указать поле `category_path`
+* (опц.) сохранить `price_src` / `currency_src` как метаполя
+
+## Лицензия
+
+MIT.
+