58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 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.
|
|
|