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

Какво следва след инсталация (важно):
1) За нова WordPress, OpenCart 3 или OpenCart 4 връзка избери съответния подписан Editor Connector по-долу. → 2) В Editor.bg отвори проекта → Bridge → Universal Connector и създай еднократен connection token. → 3) Постави token-а в модула и изпълни Connect/handshake. → 4) Свържи Google Analytics и Search Console отделно и провери общия анализ на страниците.
OpenAI API ключ не е нужен за свързването и събирането на данни. Custom PHP SDK изисква интеграция от разработчик; не е автоматичен модул за всяка CMS. Legacy пакетите остават по-долу със собствените си инструкции и различен начин на достъп. Инструкции за продуктов фийд.

1) WordPress Admin → Plugins → Add New → Upload Plugin.
2) Качи ZIP-а и активирай Editor SEO Connector.
3) В Editor.bg отвори проекта → Universal Connector и генерирай еднократен token.
4) В WordPress → Editor.bg постави token-а и натисни Connect.
5) Провери автоматичния capability audit.

Token-ът е еднократен и не се съхранява. Постоянната връзка използва HMAC-SHA256, timestamp и nonce защита.

1) OpenCart Admin → Extensions → Installer → Upload.
2) Качи OCMOD ZIP-а.
3) Extensions → Extensions → Modules → Editor.bg Connector → Install.
4) В Editor.bg генерирай еднократен token и го постави в модула.
5) Натисни Connect и провери self-check/capability audit.

Credential-ът се пази криптирано с OpenCart encryption key. Връзката използва HMAC-SHA256, timestamp и nonce защита.

1) OpenCart Admin → Extensions → Installer → Upload.
2) Качи файла с точно име editorbg.ocmod.zip.
3) Extensions → Extensions → Modules → Editor.bg Connector → Install.
4) В Editor.bg генерирай еднократен token и го постави в модула.
5) Натисни Connect и провери diagnostics/capability audit.

Credential-ът се записва само при налично силно криптиране. Връзката използва HMAC-SHA256, timestamp и nonce защита.

1) Разархивирай SDK-а извън публично достъпна папка, когато приложението го позволява.
2) Реализирай PlatformAdapterInterface върху native product/cart/order логиката.
3) В Editor.bg генерирай еднократен token и изпълни ConnectorInstaller.
4) Съхрани върнатия secret криптирано извън web root.
5) Провери handshake, bounded queue и normalized test events преди production pilot.

Google credentials не се записват в сайта. SDK подписва заявките с HMAC-SHA256 и изисква криптирано application-owned credential storage.

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

Пакет: `01-universal-bridge/universal_connector_v1.6.3.zip`

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

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

2) Настройка (най-лесно)
1. Отвори: `https://YOUR-DOMAIN/bridge/install.php`
2. Попълни:
• Allowed IPs = `109.104.214.3`
• (по избор) 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`

Сигурност

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

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

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

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

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

2) Настройка на достъпа
1. WP Admin → меню „Editor Bridge"
2. Попълни:
• Allowed IPs = `109.104.214.3`
• (по избор) 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.

Сигурност

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

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

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

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

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

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

Сигурност

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

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

Пакет: `03-opencart/opencart3_plugin_v1.6.2.ocmod.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 = `109.104.214.3` (и по желание OpenAI ключ) → Save

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

Сигурност

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

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

Пакет: `03-opencart/opencart4_plugin_v1.6.2.ocmod.zip`

1) Admin → Extensions → Installer → Upload ZIP
2) Extensions → Extension List → Modules → Editor.bg Bridge → Install → Edit
3) Попълни Allowed IPs = `109.104.214.3` (и по желание OpenAI ключ) → Save

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

Сигурност

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

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

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

1) Разархивирай
2) Качи папката `bridge/` в root-а на сайта
3) Редактирай `bridge/bridge.local.php` (Allowed IPs = `109.104.214.3`, по желание OpenAI ключ)
4) Ако хостингът не позволява автоматичен запис:
• дай права за запис на папката `bridge/`
• или попълни `bridge/bridge.local.php` ръчно
5) Тест:
• `https://YOUR-DOMAIN/bridge/editor_bridge.php?action=capabilities`
6) В Editor.bg използвай endpoint URL:
• `https://YOUR-DOMAIN/bridge/editor_bridge.php`

Сигурност

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

Editor.bg Universal CMS Connector v2 — инсталация

Пакет: `04-custom-php/editorbg_universal_cms_connector_v2.0.0.zip`

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

2) Настройка
1. Отвори: `https://YOUR-DOMAIN/__editorbg_connector__/install.php`
2. Попълни:
• Root path на сайта
• Auth режим = `IP allowlist`
• Allowed IPs = `109.104.214.3`
• DB достъп
• OpenAI API key (по избор)
3. Запиши конфигурацията

3) Guided setup
1. Отвори: `https://YOUR-DOMAIN/__editorbg_connector__/admin/index.php`
2. Пусни: CMS detection, DB discovery, Mapping
3. Потвърди mapping profile

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

Сигурност

• OpenAI ключът остава локално в сайта.
• Достъпът се контролира чрез IP allowlist (Allowed IPs = `109.104.214.3`).
• Admin UI ползва локална парола и CSRF защита.
• Няма automatic write без preview и потвърждение.