Инсталация

Изисквания

PHP 8.3+
Magento 2 / Mage-OS с работещ cron
Достъп до Composer хранилището repo.webcode.bg (предоставя се при закупуване през Webcode)

Webcode_Sync е ядро — само по себе си не синхронизира с конкретен доставчик. Инсталира се заедно с поне един сателитен модул Webcode_Sync* (напр. webcode/module-sync-microinvest).

Инсталиране през Composer

composer require webcode/module-sync
bin/magento module:enable Webcode_Sync
bin/magento setup:upgrade
bin/magento setup:di:compile      # при production режим
bin/magento cache:clean

Обикновено ще добавите и конкретен доставчик в същата стъпка, напр.:

composer require webcode/module-sync-microinvest
bin/magento setup:upgrade

Зависимости (webcode/module-branding → webcode/module-base, webcode/module-category-tree) се теглят автоматично от Composer.

Cron

Синхронизацията разчита изцяло на Magento cron. Уверете се, че cron работи:

bin/magento cron:install
crontab -l | grep magento

Ядрото регистрира собствена cron група webcode_sync_products, която върви в отделен процес — виж Употреба → Cron задачи.

Индексери

Синхронизацията записва големи обеми продуктови данни. Ако индексерите са в режим „Update on Save“, всеки запис ще задейства преиндексиране и ще забави процеса драстично. Препоръчва се „Update by Schedule“:

bin/magento indexer:set-mode schedule

CLI командите за синхронизация показват предупреждение, ако засекат индексер в режим „Update on Save“ (Webcode\Sync\Console\IndexerModeNotice).

Проверка

bin/magento module:status Webcode_Sync
bin/magento webcode:sync:fetch --help

Ако командата webcode:sync:fetch се показва, ядрото е активно. Следваща стъпка — Конфигурация.