В Task Scheduler есть несколько готовых задач. Выберите их в списке «Модуль» в форме задачи. Задачи других модулей Ka (например, импорта) появляются в том же списке, когда эти модули установлены.
| Модуль | Операция | Назначение |
|---|---|---|
| download_file | Скачать файл по FTP, Скачать файл по HTTP URL | Скачать файл в магазин, при необходимости распаковать его и запустить другую задачу |
| request_url | Запросить URL страницы | Открывать URL по расписанию |
| refresh_currencies | Обновить валюты (стандартная процедура Opencart) | Обновить курсы валют из источника, выбранного в OpenCart |
| update_currencies | Загрузить курсы валют | Обновить курсы валют по данным Европейского центрального банка |
| send_log | Отправить журнал ошибок администратору | Отправлять новые записи журнала ошибок на email магазина |
| sample_task, test_multi_step | - | Тестовые задачи |
Скачать файл (FTP или HTTP)
Скачивает файл и сохраняет его в папке магазина.
Параметры «Скачать файл по FTP»:
- URL FTP-сервера (обязательно): только хост, например
ftp.mysite.com. Не добавляйте протокол или порт. - Имя пользователя FTP (обязательно) и пароль FTP.
- Путь к файлу на FTP-сервере (обязательно), например
/my_files/data.csv.
Параметры «Скачать файл по HTTP URL»:
- HTTP URL (обязательно), например
http://www.example.com/downloads/stock.csv. Перенаправления выполняются. - Имя пользователя WebAuth и пароль WebAuth: необязательно, для URL, защищённых HTTP-авторизацией.
Общие параметры:
- Относительный путь к скачанному файлу (внутри папки магазина) (обязательно), например
downloaded/file.csv. Путь отсчитывается от корня магазина (папки сadmin/,catalog/иsystem/). Недостающие папки создаются. Существующий файл заменяется. Пути с..или ведущие за пределы папки магазина не принимаются. - Распаковать zip-файл: «Распаковать архив» извлекает zip-архив в папку скачанного файла.
- Вызвать задачу при успешном завершении: в списке показаны созданные вами задачи импорта (задачи с операцией импорта модуля импорта Ka). Выбранная задача запускается сразу после скачивания.
Пример: каждую ночь скачивать прайс-лист поставщика и импортировать его с помощью CSV Product Import.
- В CSV Product Import сохраните профиль импорта, который импортирует файл
downloaded/stock.csv. - Создайте задачу с модулем csv_product_import, операцией «Импорт» и этим профилем в поле «Профиль импорта». Снимите «Активна», если импорт должен запускаться только после скачивания: вызванная задача запускается, даже если она не активна.
- Создайте задачу download_file, «Скачать файл по HTTP URL», с URL поставщика, тем же путём
downloaded/stock.csvи задачей импорта в поле «Вызвать задачу при успешном завершении». Запланируйте её на каждый день в 02:00.
Результат (размер файла, успех или ошибка) показывается на странице статистики задачи.
Запросить URL страницы
Открывает URL из поля «URL страницы» GET-запросом, например чтобы запустить создание фида или другой скрипт, которому нужны регулярные вызовы. В статистике показывается размер страницы в байтах или ошибка.
Курсы валют
«Обновить валюты (стандартная процедура Opencart)» запускает стандартное обновление курсов OpenCart:
- В OpenCart 3.0.4.0 и новее используется источник курсов валют, выбранный в Система > Настройки > Локализация (например, ECB или Fixer, включённые в Расширения > Расширения > Курсы валют).
- В более старых версиях OpenCart 3.0.x стандартная процедура использует сервис Yahoo, который больше не работает. Там используйте «Загрузить курсы валют».
- В статистике показываются коды обновлённых валют или примечание:
- «Источник курсов валют не выбран в настройках магазина (Система > Настройки > Локализация).»
- «Источник курсов валют "..." не установлен или отключён в Расширения > Курсы валют.»
- «OpenCart до версии 3.0.4.0 запрашивает курсы у сервиса Yahoo, который больше не работает. Используйте задачу update_currencies (Европейский центральный банк).»
- «Обновление валют вернуло ошибку.»
«Загрузить курсы валют» самостоятельно считывает ежедневные курсы Европейского центрального банка (ЕЦБ):
- Работает во всех версиях OpenCart 3.0.x и не зависит от настройки источника курсов валют.
- Обновляются только валюты, которые есть и в магазине, и в фиде ЕЦБ. Курсы пересчитываются в валюту магазина по умолчанию.
- Записывает курсы ЕЦБ поверх курсов из любого другого источника. Не используйте её вместе с другим источником курсов.
- ЕЦБ не публикует курсы российского рубля (RUB) с марта 2022 года. Если валюты магазина по умолчанию нет в фиде ЕЦБ (например, RUB), задача сообщает «Primary currency was not found in rates» и ничего не меняет.
- ЕЦБ публикует новые курсы раз в рабочий день, около 16:00 CET. Достаточно запускать задачу раз в день.
Отправить журнал ошибок администратору
Отправляет журнал ошибок OpenCart на email магазина (или на ADMIN_EMAIL, если эта константа определена в admin/config.php), если журнал изменился за последние 24 часа. После отправки файл журнала переименовывается с добавлением даты (например, error.log.2026-10-29), поэтому следующее письмо содержит только новые записи. В статистике показывается «Новых записей нет» или «Файл отправлен.» с размером файла.
Как самостоятельно прочитать журнал ошибок, см. «Как увидеть расширенную информацию об ошибке».
Тестовые задачи
- sample_task завершается сразу и сообщает пример результата. Используйте её, чтобы проверить, что вызовы cron работают.
- test_multi_step выполняет 5 шагов по 5 секунд. Используйте её, чтобы проверить, что многошаговые задачи корректно продолжаются на вашем сервере.
Эти задачи ничего не меняют в магазине. Они также служат примерами кода для разработчиков, см. «Для разработчиков».
