MS: Скрыть товар
Описание
Модуль ms_custom_hide_prod автоматически управляет видимостью товаров на сайте в зависимости от наличия товара на складе и настройки "Действие при отсутствии товара в наличии" в карточке товара. Модуль автоматически изменяет статус товара (Включен/Скрыт) согласно заданному алгоритму.
Основные возможности
- Автоматическое скрытие товаров: Автоматически скрывает товары, которые отсутствуют на складе (если не включена опция подзаказа)
- Автоматическое отображение: Автоматически показывает товары при появлении количества на складе
- Массовое обновление статусов: Возможность массового обновления статусов всех товаров согласно алгоритму модуля
- Cron-интеграция: Поддержка автоматического обновления статусов через cron-задачи
- Работа с модулем Warehouses: Корректная работа с модулем складов для определения наличия товара
Как работает модуль
Модуль использует следующий алгоритм:
- Определение статуса товара (
func.php):
- Функция
fn_ms_custom_hide_prod_calc_res()определяет статус товара на основе: - Количества товара на складе (или в основных параметрах товара)
- Настройки "Действие при отсутствии товара в наличии" в карточке товара (значения "B" - подзаказ, "S" - продажа без наличия)
- Если количество > 0 ИЛИ включен подзаказ/продажа без наличия → статус "Включен" (A)
- Если количество = 0 И подзаказ/продажа без наличия НЕ включены → статус "Скрыт" (H)
- Хуки обновления (
func.php):
fn_ms_custom_hide_prod_update_product_amount()- вызывается при изменении количества товараfn_ms_custom_hide_prod_update_product_post()- вызывается при обновлении товараfn_ms_custom_hide_prod_update_product_amount_post()- вызывается после изменения количества с учетом складов
- Массовое обновление (
func.php):
fn_ms_custom_hide_prod_batch_update_statuses()- обновляет статусы всех товаров в базе данных- Поддерживает опцию пропуска товаров со статусом "Выключен" (D)
- Cron-контроллер (
controllers/backend/ms_custom_hide_prod.php):
- Режим
batch_update_cronдля автоматического обновления через cron - Использует security key для защиты доступа
- Работа со складами: Модуль интегрируется с модулем
warehousesдля определения общего количества товара на всех складах.
Где находится функциональность
- Административная панель:
- Настройки модуля с информацией об алгоритме работы
- Кнопка массового обновления статусов
- Cron-ссылка для автоматического обновления
- Автоматическая работа: Модуль работает автоматически при изменении количества товаров
Настройки модуля
- Пропускать товары со статусом Выкл (
skip_disabled_products): Если включено, модуль не будет автоматически активировать товары со статусом "Выключен" (D)
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- Работает с модулем
warehousesдля определения наличия товара на складах - Поддерживает три статуса товара: "Включен" (A), "Скрыт" (H), "Выключен" (D)
- При массовом обновлении может обрабатывать все товары или исключать выключенные (в зависимости от настройки)
- Использует security key для защиты cron-контроллера
Локализации:
- English
- Русский
Совместимость:
- 4.18.X
# Инструкция по использованию модуля MS: Скрыть товар
Установка
- Убедитесь, что модуль активирован в разделе Администрирование → Модули → Скачанные модули
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
Настройка
- Перейдите в Администрирование → Модули → Скачанные модули → MS: Скрыть товар
- Ознакомьтесь с информацией об алгоритме работы модуля:
- Модуль автоматически изменяет статус товара в зависимости от наличия и настройки "Действие при отсутствии товара в наличии"
- Товары со статусом "Скрыт" не отображаются на сайте, но остаются в системе
- Настройте параметры:
- Пропускать товары со статусом Выкл: Включите, если не хотите, чтобы модуль автоматически активировал выключенные товары при появлении количества
Использование
Для администратора
- Настройка товаров:
- При создании или редактировании товара настройте параметр "Действие при отсутствии товара в наличии":
- Подзаказ (B) или Продажа без наличия (S) - товар будет оставаться видимым даже при отсутствии на складе
- Если опция не включена - товар будет скрыт при отсутствии на складе
- Массовое обновление статусов:
- В настройках модуля нажмите кнопку "Обновить статусы всех товаров"
- Модуль проверит все товары и обновит их статусы согласно алгоритму
- Результаты будут отображены в уведомлении
- Настройка cron для автоматического обновления:
- Скопируйте cron-ссылку из настроек модуля
- Настройте cron-задачу на сервере:
`
0 2 * * * wget -q -O - "https://your-site.com/index.php?dispatch=ms_custom_hide_prod.batch_update_cron&key=YOUR_KEY" > /dev/null 2>&1
`
- Замените
YOUR_KEYна значение из настройки "cron_key" (генерируется автоматически при сохранении настроек)
Автоматическая работа
Модуль автоматически работает при:
- Изменении количества товара на складе
- Обновлении товара через административную панель
- Импорте товаров через CommerceML или другие методы
Проверка работы
- Проверка автоматического скрытия:
- Создайте товар с количеством 0
- Убедитесь, что опция "Действие при отсутствии товара в наличии" не включена
- Сохраните товар
- Проверьте, что статус товара изменился на "Скрыт"
- Убедитесь, что товар не отображается на витрине
- Проверка автоматического отображения:
- Добавьте количество товару со статусом "Скрыт"
- Сохраните товар
- Проверьте, что статус изменился на "Включен"
- Убедитесь, что товар отображается на витрине
- Проверка работы с подзаказом:
- Создайте товар с количеством 0
- Включите опцию "Подзаказ" в карточке товара
- Сохраните товар
- Убедитесь, что товар остается видимым на сайте
Устранение неполадок
- Товары не скрываются: Проверьте настройку "Действие при отсутствии товара в наличии" в карточке товара
- Статусы не обновляются автоматически: Убедитесь, что модуль активирован и хуки работают корректно
- Ошибка при массовом обновлении: Проверьте логи ошибок и убедитесь, что у пользователя базы данных есть права на обновление таблицы товаров
- Cron не работает: Проверьте security key и убедитесь, что cron-задача настроена корректно
Ключевые файлы
app/addons/ms_custom_hide_prod/addon.xml- конфигурация модуляapp/addons/ms_custom_hide_prod/func.php- функции определения статуса и массового обновленияapp/addons/ms_custom_hide_prod/controllers/backend/ms_custom_hide_prod.php- контроллер массового обновления и crondesign/backend/templates/addons/ms_custom_hide_prod/settings/batch_update.tpl- шаблон настроек массового обновления
**v1.2.3** от 16.12.2025 [+] Добавлена настройка "Пропускать товары со статусом Выкл" - позволяет исключить выключенные товары из автоматической обработки модулем **v1.2.2** от 16.12.2025 [\*] Улучшено описание модуля и таблицы условий алгоритма для лучшего понимания [\*] Добавлено пояснение статусов товара (Включен/Скрыт/Выключен) [\*] Улучшена таблица условий алгоритма с пояснениями **v1.2.1** от 16.12.2025 [!] Исправлена логика обработки товаров со статусом 'D' (выключенные) - теперь они активируются при наличии количества [!] Исправлен подсчет обновленных товаров в функции массового обновления [\*] Исправлено отображение "Подзаказ в CSCART" на "Подзаказ в CS-Cart" **v1.2.0** [+] Добавлено крон ссылки [\*] Изменены короткие теги <? на обычные <?php **v1.1.3** от 25.11.2022 [\*] Обновлено название модуля и логотип компании [+] Добавлено лицензирование и автообновление модуля **v1.1.2** от 25.11.2022 [+] Добавлена возможность работы модуля с модулем склады, то есть при покупке проверяется количество на складах ** ms_custom_hide_prod v1.1.1 от 02.11.2020 ** [\*] Исправлена ошибка, которая поялвялась при изменении количество товара в админке. ** ms_custom_hide_prod v1.1.0 от 19.10.2020 ** [+] added support out_of_stock_actions "Subscribe to notifications" [+] added en language [\*] README.md update ** ms_custom_hide_prod v1.0.5 от 14.10.2020 ** [!] fix bug warehouses ** ms_custom_hide_prod v1.0.4 от 06.10.2020 ** [!] fix bug m_update ** ms_custom_hide_prod v1.0.3 от 06.10.2020 ** [!] fix bug ** ms_custom_hide_prod v1.0.2 от 02.10.2020 ** [+] check status product on Disabled [+] added amount in warehouses ** ms_custom_hide_prod v1.0.1 от 02.10.2020 ** [-] kill bad code ** ms_custom_hide_prod v1.0.0 от 29.09.2020 ** [+] Первый выпуск *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Отзывы
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.