MS: Избранные компании

Описание

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

Основные возможности

• Белый список компаний: Возможность добавления компаний в избранное (белый список)
• Черный список компаний: Возможность добавления компаний в черный список (стоп-лист)
• Фильтрация товаров: Автоматическое скрытие товаров компаний из черного списка на различных страницах
• Сортировка по избранным: Возможность сортировки товаров по избранным компаниям
• Интеграция с избранным: Добавление вкладок "Продавцы" и "Черный список" на страницу избранного
• Кнопки лайков/дизлайков: Кнопки для добавления компаний в белый или черный список на страницах компаний и товаров

Как работает модуль

Модуль использует следующие механизмы:

1. База данных (func.php): При установке модуль создает таблицу ms_favorite_companies:

• user_id - ID пользователя
• company_id - ID компании
• ms_like - статус: 'Y' (лайк/белый список), 'D' (дизлайк/черный список), 'N' (нет)

1. Функции работы с компаниями (func.php):

• fn_ms_favorite_companies_add_company() - добавляет компанию в белый или черный список
• fn_ms_favorite_companies_clear_companies() - очищает список компаний (белый или черный)
• fn_ms_favorite_companies_get_favorite_companies() - получает список избранных компаний
• fn_ms_favorite_companies_get_companies_products() - получает товары избранных компаний
• fn_ms_favorite_companies_get_company_like() - получает статус компании (лайк/дизлайк) для текущего пользователя

1. Хуки (hooks.func.php):

• fn_ms_favorite_companies_get_companies() - добавляет информацию о статусе компании (лайк/дизлайк) в данные компаний
• fn_ms_favorite_companies_get_products() - фильтрует товары по белому и черному спискам компаний
• fn_ms_favorite_companies_delete_company() - удаляет компанию из списков при удалении компании
• fn_ms_favorite_companies_post_delete_user() - удаляет записи при удалении пользователя

1. Контроллеры:

• controllers/frontend/ms_favorite_companies.php - обрабатывает добавление компаний в списки (режим add) и очистку списков (режим clear)
• controllers/frontend/companies.post.php - обрабатывает отображение компаний
• controllers/frontend/products.post.php - обрабатывает отображение товаров с учетом фильтрации
• controllers/frontend/wishlist.pre.php - добавляет вкладки компаний в избранное

1. JavaScript (js/addons/ms_favorite_companies/func.js):

• Обрабатывает клики по кнопкам лайков/дизлайков
• Отправляет AJAX-запросы для добавления компаний в списки
• Обновляет интерфейс после добавления компании

1. Шаблоны:

• Кнопки лайков/дизлайков на страницах компаний и товаров
• Вкладки "Продавцы" и "Черный список" на странице избранного
• Отображение списка компаний в избранном

Где находится функциональность

• Витрина:
• Кнопки лайков/дизлайков на страницах компаний
• Кнопки лайков/дизлайков на страницах товаров (если включено)
• Страница избранного с вкладками "Товары", "Продавцы", "Черный список"
• Автоматическая фильтрация товаров по черному списку на различных страницах

Настройки модуля

• Отображать в карточке товара (show_in_cart): Отображать кнопки лайков/дизлайков на странице товара
• Отображать на странице товаров компании (show_in_company_products): Отображать кнопки на странице товаров компании
• Отображать на странице компании (show_in_company): Отображать кнопки на странице компании
• Отображать на странице все компании (show_in_companies): Отображать кнопки на странице списка всех компаний
• Включить стоплист компаний (stop_list_enable): Включить функциональность черного списка
• Включить сортировку товаров по избранным компаниям (white_list_sorting_enable): Сортировать товары избранных компаний первыми
• Фильтровать на странице избранное (filter_at_wishlist): Скрывать товары компаний из черного списка на странице избранного
• Фильтровать товары на странице категорий (filter_at_categories): Скрывать товары компаний из черного списка на странице категорий
• Фильтровать товары при поиске (filter_at_search): Скрывать товары компаний из черного списка при поиске
• Фильтровать товары на странице продавца (filter_at_company_view): Скрывать товары компаний из черного списка на странице продавца

Технические детали

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• При установке создает таблицу ms_favorite_companies для хранения списков компаний
• Работает только для авторизованных пользователей
• Интегрируется со страницей избранного (wishlist) для отображения вкладок компаний
• Автоматически фильтрует товары по черному списку на различных страницах сайта