Downloads (конектори)

Какво следва след инсталация (важно):
1) Инсталирай конектора → 2) Добави Allowed IPs (IP allowlist на Editor.bg) → 3) По желание добави OpenAI API key → 4) Тествай от Project → Bridge.

Universal Bridge (Generic PHP) — инсталация

Пакет: `01-universal-bridge/universal_bridge_v1.2.7.zip`

1) Качване
1. Разархивирай ZIP-а
2. Качи папката `bridge/` в root на сайта (или в поддиректория)

Пример:
• `/public_html/bridge/editor_bridge.php`

2) Настройка (най-лесно)
1. Отвори: `https://YOUR-DOMAIN/bridge/install.php`
2. Попълни:
• Allowed IPs (ИП адресите на Editor.bg)
• (по избор) OpenAI API Key
3. Натисни „Запиши bridge.local.php"
4. След успешна настройка: изтрий `install.php`

3) Ако хостингът не позволява запис на файлове
Installer-ът показва готово съдържание.
1. Създай файл: `bridge/bridge.local.php`
2. Постави показаното съдържание

4) Тест
• `https://YOUR-DOMAIN/bridge/editor_bridge.php?action=ping`
• `https://YOUR-DOMAIN/bridge/editor_bridge.php?action=capabilities`

5) Ако сайтът е зад Basic Auth
Bridge работи и зад Basic Auth.
В Editor.bg въведи Basic user/pass за проекта (Project → Bridge).

Сигурност

• Няма лицензи/тайни ключове от Editor.bg и няма Secret/HMAC.
• Достъпът се контролира чрез IP allowlist (Allowed IPs).
• За тест може да се включи Disable Auth (не се препоръчва за продукция).

Препоръки:
• След настройка изтрий install.php
• bridge.local.php не трябва да е публично достъпен (в пакета има .htaccess).

WordPress конектор (плъгин) — инсталация

Пакет: `02-wordpress/wordpress_plugin_v1.5.2.zip`

1) Инсталация
1. WP Admin → Plugins → Add New → Upload Plugin
2. Качи `wordpress_plugin_v1.5.2.zip`
3. Install Now → Activate

2) Настройка на достъпа
1. WP Admin → меню „Editor Bridge"
2. Попълни:
• Allowed IPs (ИП адресите на Editor.bg), разделени със запетая
• (по избор) Disable Auth — само за тест
3. Натисни „Запази настройките"

3) OpenAI (по избор)
• Въведи OpenAI API Key (sk-...) → „Запази OpenAI ключ"
(Ключът се пази локално в сайта и не се изпраща към Editor.bg.)

4) Тест
• `https://YOUR-DOMAIN/wp-json/editor-bridge/v1/capabilities`

5) Ако WP поиска FTP при инсталация
Разархивирай ZIP-а и качи папката `editor-seo-connector/` в `wp-content/plugins/`, после активирай от Plugins.

Ново в v1.5.2:
• batch_update endpoint — публикува N страници в 1 HTTP заявка (значително по-бързо)
• Оправен mode=draft — вече не сменя post_status на публикувани страници; само mode=publish публикува
• Поддръжка на fields wrapper в batch_update (content_html, seo_title, seo_description и др.)

Ново в v1.5.1:
• resolve_object: добавен slug fallback — търси по последния URL сегмент в page/post/product
• update_content: поддържа fields wrapper (правилен payload) + режим draft/publish (post_status)
• Обратна съвместимост: стар payload с content_html на ниво root продължава да работи

Ново в v1.5.0:
• Endpoint generate_faq — генерира FAQ (въпроси и отговори) чрез OpenAI
• Връща faq_items[], faq_html (accordion) и faq_jsonld (schema.org FAQPage)

Сигурност

• Няма лицензи/тайни ключове от Editor.bg.
• Достъпът е чрез IP allowlist (Allowed IPs).
• OpenAI ключът (ако се ползва) остава локално в WP.

Препоръка: остави Disable Auth изключено.

OpenCart 2.3.x — инсталация

Пакет: `03-opencart/opencart_editorbg_bridge_v1.2.4_oc2.zip`

1) Admin → Extensions → Installer → Upload ZIP
2) Extensions → Modifications → Refresh
3) Extensions → Extensions → Modules → Editor.bg Bridge → Edit (Settings)
4) Попълни Allowed IPs → Save
5) (по желание) Въведи OpenAI API Key → Save

Тест (примерен):
• `https://YOUR-DOMAIN/index.php?route=module/editorbg_bridge&action=capabilities`

Ново в v1.2.4:
• Модулът автоматично добавя правата за своята User Group при зареждане — не е нужна ръчна намеса в "User Groups" след надграждане.

Сигурност

• Няма лицензи/тайни ключове от Editor.bg.
• Контролът е чрез Allowed IPs (IP allowlist).
• OpenAI ключът (ако се ползва) остава локално в OpenCart.

OpenCart 3.x/4.x — инсталация

Пакет: `03-opencart/opencart_editorbg_bridge_v1.2.2_oc3.zip`

1) Admin → Extensions → Installer → Upload ZIP
2) Extensions → Modifications → Refresh
3) (ако има) Dashboard → Developer Settings → Refresh
4) Extensions → Extensions → Modules → Editor.bg Bridge → Settings
5) Попълни Allowed IPs (и по желание OpenAI ключ) → Save

Тест (примерен):
• `https://YOUR-DOMAIN/index.php?route=extension/module/editorbg_bridge&action=capabilities`

Сигурност

• Няма лицензи/тайни ключове от Editor.bg.
• Контролът е чрез Allowed IPs (IP allowlist).
• OpenAI ключът (ако се ползва) остава локално в OpenCart.

Custom PHP — инсталация

Пакет: `04-custom-php/custom_php_v1.2.7.zip`

1) Разархивирай
2) Качи папката `bridge/` на сайта
3) Редактирай `bridge/bridge.local.php` (Allowed IPs, по желание OpenAI ключ)
4) Тест:
• `https://YOUR-DOMAIN/bridge/editor_bridge.php?action=capabilities`

Сигурност

• Няма лицензи/тайни ключове от Editor.bg.
• Контролът е чрез Allowed IPs (IP allowlist).
• OpenAI ключът (ако се ползва) остава локално в сайта.