ПрайсЛинк — модуль подключения для OpenCart 4.x
================================================

ВАЖНО: поддержка OpenCart 4.x в этом модуле новее и менее обкатана в бою,
чем версия для OpenCart 3.x. Схема манифеста install.json и состав колонок
таблицы oc_extension менялись между точечными релизами OC4 — если после
установки что-то не заработает как ожидается (например, установщик
отклонит install.json, или модуль не появится в списке после копирования
вручную), напишите разработчику модуля, приложив версию вашего OpenCart.

УСТАНОВКА

Вариант А — через установщик расширений (рекомендуется):

1. Заархивируйте папку extension/pricelink/ (со всем содержимым: admin/,
   catalog/, install.json) в zip-файл, либо используйте уже готовый архив,
   если он предоставлен отдельно.

2. Зайдите в панель администратора: Extensions → Installer (Расширения →
   Установщик) и загрузите zip-архив. OpenCart сам распакует его в
   extension/pricelink/ в корне сайта.

Вариант B — вручную (если доступен только FTP/файловый доступ):

1. Скопируйте папку extension/pricelink/ целиком в корень вашего сайта на
   OpenCart 4.x, рядом с другими папками в extension/ (ничего не будет
   перезаписано — все файлы модуля лежат в собственном подкаталоге
   extension/pricelink/).

Далее (оба варианта):

3. Зайдите в Extensions → Extensions (Расширения → Расширения), в
   выпадающем списке справа выберите "Modules" ("Модули"). Найдите
   "PriceLink" ("ПрайсЛинк") в списке и нажмите зелёную кнопку "Install"
   (плюсик), затем "Edit" (карандаш), чтобы открыть настройки.

4. На странице настроек модуля:
   - переключите "Статус" ("Status") в "Включен" ("Enabled");
   - скопируйте "API-ключ" ("API Token") — сгенерирован автоматически,
     можно заменить на свой;
   - сохраните.

5. В кабинете ПрайсЛинк (раздел "Магазин" / "Shop") укажите:
   - URL сайта: адрес вашего магазина (тот же, что открыт в браузере);
   - API-ключ: тот, что скопировали на шаге 4.

6. Нажмите "Загрузить товары с сайта" — если всё настроено верно, товары
   появятся в каталоге ПрайсЛинк.

ЧТО ДЕЛАЕТ МОДУЛЬ

Модуль добавляет три адреса, доступных только с корректным API-ключом
(заголовок Authorization: Bearer <ключ>). Обратите внимание: в OpenCart 4.x
маршруты для расширений включают код расширения ("pricelink") отдельным
сегментом сразу после "extension/" — в отличие от OpenCart 3.x, где такого
сегмента не было:

  GET  index.php?route=extension/pricelink/module/pricelink/ping      — проверка связи
  GET  index.php?route=extension/pricelink/module/pricelink/products  — выгрузка товаров
  POST index.php?route=extension/pricelink/module/pricelink/update    — обновление цен/остатков

Модуль ничего не меняет в магазине сам по себе — обновление цен/остатков
происходит только когда вы явно нажимаете "Применить обновление" в кабинете
ПрайсЛинк после проверки изменений.

ИЗВЕСТНЫЕ ОБЛАСТИ НЕОПРЕДЕЛЁННОСТИ (OpenCart 4.x)

- install.json: состав полей (name/code/version/author/link) — это
  добросовестная попытка соответствовать формату, который ожидает
  установщик OC4, но точная схема манифеста менялась в разных версиях
  4.x. Если установщик отклонит файл — потребуется скорректировать под
  вашу конкретную сборку.

- Таблица oc_extension: код модуля пишет колонку `extension` (код
  родительского расширения) в дополнение к `type` и `code`. Это
  соответствует структуре oc_extension в большинстве сборок OC4, но
  состав колонок тоже менялся между точечными релизами — если install()
  выдаст ошибку SQL про неизвестную колонку, потребуется адаптация под
  вашу версию.

- Количество сегментов в маршруте (extension/pricelink/module/pricelink)
  соответствует структуре официальных расширений OC4 на момент написания,
  но не проверено на реальной установке OpenCart 4.x — проверьте маршрут
  в вашей админке после установки, прежде чем полагаться на него в бою.
