Cart Progress Bar Документация

Установка – top

Загрузка

1. Скачайте add-on
2. Перейдите в Панель администратора > Add-ons > Управление add-ons
3. Нажмите [+], чтобы открыть окно загрузки
4. Выберите удобный для вас способ:
   • Local: ZIP-архив находится на вашем компьютере
   • Server: ZIP-архив уже загружен на сервер
   • URL: у вас есть прямая ссылка на ZIP-архив
5. После выбора ZIP-архива, соответствующего вашей версии CS-Cart, нажмите Upload & install

Активация

1. Откройте страницу настроек add-on:
   Панель администратора > Add-ons > Управление add-ons > Выберите add-on
2. Во вкладке Activation вставьте лицензионный ключ
3. Сохраните настройки и вернитесь на страницу управления add-ons
4. В строке с названием add-on нажмите Active
5. Очистите кэш: Administration > Storage > Clear cache

Убедитесь, что статус add-on — Active

Готово, add-on установлен

Настройки – top

Блок – top

Для страницы оформления заказа или любых других схем, где вы хотите отображать прогресс-бар,
добавьте блок
[TH] Cart Upsell Bar

Ограничения по локации – top

Если вы используете условия акций, зависящие от локации
(страна, регион, город и т.д.), обратите внимание на следующее:

• Add-on Maps and Geolocation должен быть
  включён и корректно настроен.
  (инструкция по настройке)
• Если add-on Maps and Geolocation отключён,
  акции с ограничениями по локации будут отображаться только
  для покупателей, которые уже указали адрес доставки.

  Адрес доставки может быть задан:

  • на странице оформления заказа
  • на странице корзины (если там рассчитывается доставка)
  • в профиле пользователя

Такое поведение является стандартным для CS-Cart и не связано с логикой add-on.
Чтобы обеспечить корректное отображение акций для всех посетителей, убедитесь,
что Maps and Geolocation включён.

Хуки и расширяемость – top

Add-on Cart Progress Bar предоставляет хук, который позволяет сторонним add-on
или кастомному коду динамически изменять или добавлять акции
до того, как они будут обработаны и отображены.

Это полезно, если вы хотите:

• Добавлять кастомные или виртуальные акции без сохранения в базе данных
• Изменять условия или бонусы существующих акций
• Интегрировать внешнюю логику (скидки, программы лояльности и т.д.)

Доступный хук

ath_cart_progress_bar_get_front_promotions

Этот хук выполняется сразу после получения списка акций
и до применения любых фильтров
(дата, сумма заказа, локация, продавец и т.д.).

Сигнатура хука

fn_set_hook(
    'ath_cart_progress_bar_get_front_promotions',
    $promotions,
    $params,
    $lang_code
);

Параметры

• $promotions — массив акций, полученных для корзины (передаётся по ссылке)
• $params — параметры выборки акций (зона, активность и т.д.)
• $lang_code — код текущего языка витрины

Пример: добавление кастомной акции

function fn_my_addon_ath_cart_progress_bar_get_front_promotions(
    &$promotions,
    $params,
    $lang_code
) {
    $promotions[] = [
        'promotion_id'         => 0,
        'company_id'           => 0,
        'ath_show_in_cart_bar' => 'Y',
        'from_date'            => 0,
        'to_date'              => 0,
        'conditions'           => [
            'conditions' => [
                [
                    'condition' => 'subtotal',
                    'operator'  => 'gte',
                    'value'     => 200
                ]
            ]
        ],
        'bonuses' => [
            [
                'bonus' => 'free_shipping'
            ]
        ],
        'ath_reward_text'      => __('free_shipping'),
        'ath_before_goal_text' => __('add_more_for_free_shipping'),
        'ath_icon_pair'        => []
    ];
}

Этот подход позволяет полностью контролировать логику расчёта и отображения акций
в прогресс-баре, не изменяя ядро add-on.

Изменение стилей

Вы можете редактировать стили во вкладке Design в настройках add-on

или

Файлы стилей add-on изменять не рекомендуется — это может привести к некорректной работе.
Если требуется переопределить или добавить стили, используйте Theme editor:

1. Перейдите в Design > Themes
2. Нажмите Visual Editor напротив активной схемы
3. В новой вкладке откроется магазин с панелью Theme editor
4. В селекторе CUSTOMIZE выберите Custom CSS
5. Добавьте необходимые стили в текстовое поле
6. Сохраните изменения кнопкой Save и закройте редактор, нажав [X]

Обновление add-on – top

Обновление выполняется через Update Center

Список изменений

2.02 (22 Dec 2025)
Добавлена поддержка ограничений акций по группам пользователей по умолчанию
Добавлен хук ath_cart_progress_bar_get_front_promotions
Исправлены текстовые плейсхолдеры
Улучшены тексты
Исправления CSS

2.01 (18 Nov 2025)
Добавлена поддержка локаций

2.00 (22 Oct 2025)
[!] Требуется переустановка add-on
Функциональность add-on теперь привязана к акциям
Добавлена поддержка add-on Direct Payments

1.01 (01 Sep 2025)
Исправлена ошибка отображения на детальной странице товара

1.00 (01 Sep 2025)
Релиз