Установка модуля FilterVier_SEO
1) Распаковать архив модуля для требуемой версии Opencart и версии php.
2) через ЗАГРУЗЧИК РАСШИРЕНИЙ (Установщик дополнений OCMOD) - требуется, чтоб был установлен fix ocmod - localcopyꜛ (в папке /use_fix_ocmod/ находятся требуемы модификаторы)
> загрузить файл filter_vier_SEO_v_xxx.ocmod.zip
Для загрузки модуля предыдущих версий по FTP (ФТП) :
! Устанавливать модуль с подключением по FTP (режим передачи/обмена: Двоичный/Binary (см. скрин внизу)).2) войти в папку требуемой версии php (к примеру, php7.1-7.4)
> войти в папку `upload` и скопировать содержимое (папки) из папки `upload` в корень вашего сайта (*корень – это где находятся папки сайта: admin, catalog, image).
3) в Админке в Модулях установить/активировать модуль FilterVier_SEO_v.х.x
> войти в него (если запросит лицензионный ключ, то нажать "Активировать". При этом Модуль проверит Вашу версию Фильтра и установит соответствующий ключ лицензии).
Для быстрого старта можно выбрать/установить только основные настройки (остальные настройки можно потом настроить/подключить):
- Статус Фильтра (общий) и Статусы блоков, а так же если используете Атрибуты и Опции, то их Параметры. (Сохранить настройки).
ВАЖНО! – если используете Атрибуты, то их Значения надо будет сгруппировать – Зеленая кнопка – “Генерация text_id“ (см. пояснение ниже)
(либо использовать модуль "Attribute Text Select", тогда "Генерация text_id" не нужна).
- заполнить данные по Языкам на свой "вкус" во вкладке «Языковые данные»
- Подключите (или создайте свой) Дизайн (вкладка «Дизайн» модуля и в нём под-Вкладки: "Основной дизайн" (по умолчанию минимизирован стилями), для "Мобильных устройств", "Кнопок", "Чекбокса", "Слайдера").
(Если будете использовать блок Цены как Слайдер, то обязательно выберите для него стиль или создайте собственный).
4) Подключение модуля в Схемах/Макетах:
в Opencart → ДИЗАЙН → МАКЕТЫ/СХЕМЫ подключить данный модуль к Макетам.
Для вывода модуля на странице Категорий используется путь - product/category
На странице Производителя - product/manufacturer/info
На странице Акций - product/special
На странице Поиска - product/search
На Главной странице - common/home
(!!! у некоторых Шаблонах используются свои дополнительные Схемы/Макеты подключения).
После этого Вы можете уже видеть свой Фильтр на сайте, но работать он не будет до следующей установки.
5) в МОДИФИКАТОРЫ (Список модификаторов) обновить расширения.
Для загрузки модуля предыдущих версий по FTP (ФТП) :
5) через ЗАГРУЗЧИК РАСШИРЕНИЙ (Установщик дополнений OCMOD) загрузить файл-модификатор:для Opencart 2 - filter_vier_seo.ocmod.xml
для Opencart 3 - filter_vier_seo_3.ocmod.zip6) в МОДИФИКАТОРЫ (Список модификаторов) обновить расширения.
Всё.
В папке /use_fix_ocmod/ находятся Дополнительные (необязательные) Модификаторы. Их предназначение расписано в файле readme.txt
Некоторые пояснения.
Так как используется ocMod (модификатор), то чтоб гарантировано работал модуль, затрагиваемые модулем файлы Opencart, должны быть оригинальными (не изменялись вручную).
!!!ВНИМАНИЕ: - если используется КЕШ на сайте (в модулях, шаблоне, на Хосте), то перед настройкой дизайна Фильтра, временно их отключите и очистите его. (КЕШ в Фильтре не применяется для собственных стилей - там нечего кешировать).
Для Opencart 3 еще возможно надо будет очистить/отключить кеш в Настройках разработчика (см. скрин ниже). Так же не забывайте, что еще есть кеш самого браузера!!!
!!!ВНИМАНИЕ: - если Вы использовали на своем сайте другой Фильтр товаров (включая и Стандартный), то обязательно его отключите в админке, и удалите/отключите его модификатор (если он есть).
Так же проверьте папку /system/ - модификатор для фильтра может в ней располагаться. (Обычно в его названии присутствует часть текста filter) – Удалите данный файл или переименуйте его расширение, например, расширение .xml переименовать в ._xml Потом не забудьте заново обновить модификаторы в админке.
У некоторых Шаблонах (которые используют собственный Фильтр), в самом модификаторе Шаблона может присутствовать код для своего Фильтра. – По возможности его тоже желательно очистить (чтоб "не путался под ногами").
ВАЖНО!!! Если стили Фильтра не сохраняются (не появляется зелёное окошко "об успешном Сохранении" в админке модуля), то возможно (всё зависит от настроек Вашего сервера) для папки, где находятся стили Фильтра - /catalog/view/theme/default/ stylesheet/filter_vier/ и вложенных в неё папкам и файлам, понадобиться установить на Вашем Хосте Права Пользователя (доступа), к примеру, 755. (Бывали случаи, что и другим, подключающимся в модуле стилевым и js файлам, надо было дать Права доступа).
Перед Генерацией text_id, выберите Атрибуты, которые будут использоваться на сайте в Фильтре.
Если в Атрибутах присутствуют мульти-значения (к примеру, Цвет: Черный, Белый, Красный), то установите Делитель, который у Вас разделяет эти множественные Значения.
(! Если у Вас в Значениях есть дробные числа и в них присутствует запятая «,», то в Делитель нельзя устанавливать запятую, иначе модуль разобьет, к примеру, число 5,12 на 5 и 12).
Если в Значениях Атрибутов присутствуют html-тэги, то установите галку на htmlTags, чтоб очистить их для Фильтра.
(! на "Генерацию text_id" не влияют другие настройки, кроме тех, которые указанны выше: Атрибуты, Делитель, htmlTags)
И для справки по "Генерации text_id"
Так "исторически" сложилось, что в OpenCart текстовый атрибут – то, что в Карточке Товара (КТ) прописывается, не имеет своего индекса – идентификатора (как, например, в Опциях), и приходится группировать их (как только меняются или добавляются текстовые атрибуты в КТ). И потом уже использовать этот индекс (глупо же и не безопасно оперировать текстовыми словами в обработке информации). Можно генерировать не каждый раз после одного изменения в КТ, а после их массовых изменений.
Это еще позволяет менять язык на странице сайта без сброса фильтра.
Всю эту "черновую работу" берет на себя админка модуля, а не сам фильтр на сайте.
Важно!!! - если используете ЧПУ(SEO_URL) в параметрах фильтра, то обязательно проверить соответствие этих ЧПУ с названием параметра, так как ЧПУ-значений привязываются к id-значений, а они динамические при "Генерации text_id" и могут изменятся.
(При использовании модуля "Attribute Text Select" id-значений будут статичными и соответственно меняться не будут).
Касательно обновлений модуля.
!!! При обновлении модуля, всегда очищайте кэш браузера (по Ctrl+F5) и остальной кеш, который возможно есть у Вас на сайте в Шаблоне, в др.модулях, на Сервере/Хосте.
А для Opencart 3 еще возможно надо будет Очистить или временно Выключить кеш в настройках разработчика – Главная → Панель состояния → *
(страница Админки Opencart 3)
А также при обновлениях переСохраняйте все вкладки в модуле.
Пошаговая инструкция по обновлению Фильтра в архиве модуля - readme_update.txt
Рекомендация
по редактированию файла robots.txt
Если Вы используете ЧПУ фильтра, то дабы предотвратить человечески фактор (забыли сгенерировать ЧПУ и т.п.), добавить в robots.txt правила, закрывающие от индексации страницы результатов фильтра:
Disallow: /*attrb[
Disallow: /*manufs[
Disallow: /*prs[
Disallow: /*psp[
Disallow: /*optv[
Disallow: /*qnts[
Disallow: /*nows[
# если используете дополнительный (не обязательный) get-Фильтра, то и его пропишите:
Disallow: /*filter_vier=1
# при этом, если используете ЧПУ get-Фильтра, то и его пропишите (если это fvs):
Disallow: /*/fvs/
# если используете отдельный sitemap для FilterVier_SEO, то укажите данную карту со своим сайтом и своим ЧПУ карты (если это sitemap_fv.xml):
Sitemap: https://your_site/sitemap_fv.xml
Рекомендация
по созданию/редактированию собственных стилей и шаблона Фильтра.
Дефолтные стили и шаблон Фильтра перезаписываться при обновлении модуля!
Если Вы решили изменить вид Фильтра, с редактированием дефолтных файлов по стилю (filter_vier.css) и шаблону (filter_vier.tpl или filter_vier.twig) Фильтра, то используйте для этого новые файлы.
Для изменения рекомендую создать собственные стили и шаблон, методом копирования в ту же папку – /filter_vier/ с новым именем – new_name. Главное, чтоб имя css-файла и tpl-файла было одинаковым (к примеру, к имени добавить _my), и потом подключить новую Тему фильтра. Аналогично и для файлов Главной страницы. (! Если файл стилей для Главной страницы имеет другое название, чем у "Темы фильтра", которая указана во вкладке «Дизайн», то используются только стили, созданные в данном стилевом файле).
Их раположение:
/catalog/view/theme/default/ stylesheet/filter_vier/new_name.css
/catalog/view/theme/default/ template/module/ filter_vier/new_name.tpl
для Opencart 3:
/catalog/view/theme/default/ template/extension/ module/filter_vier/new_name.twig
!!!Если изменяются только стили, а шаблон останется тот же, то новый шаблон можно и не создавать - будет привязка к шаблону по дефолту - filter_vier (я не рекомендую создавать новый файл-шаблон, а особенно править дефолный, - старайтесь обойтись только правкой стилевого файла).
Также можно создать собственные чекбоксы по аналогии.
Их расположение:
для image-чекбоксов – /catalog/view/theme/default/ image/filter_vier/ new_name.png
для css-чекбоксов – /catalog/view/theme/default/ stylesheet/filter_vier/ select_checks/new_name.css
Для Слайдера:
/catalog/view/theme/default/ stylesheet/filter_vier/ skin_slider/new_ name.css
Для Кнопок:
/catalog/view/theme/default/ stylesheet/filter_vier/ button/new_name.css
Стиль для мобильной версии, который так же можно создать собственный, расположен по адресу –
/catalog/view/theme/default/ stylesheet/filter_vier/ mobil_versi/new_name_mobil.css
Так же можно для некоторых стилей при надобности добавлять еще и свой шаблон для кнопки, с тем же именем, который расположен по адресу –
/catalog/view/theme/default/ stylesheet/filter_vier/ html/new_name_mobil.html
!!! Не редактируйте файл user_style.css, который расположен в папке /user_style/ – это автоматически-генерируемый файл при каждом сохранении настроек модуля, в который временно записываются все стили для Фильтра со всех стилей: из подключаемого файла "Темы фильтра" в «Дизайне» модуля (по умолчанию это файл filter_vier.css) и по: Кнопкам, Слайдеру, Чекбоксам и Мобильной версии.
Все новые правила стилей можно прописать в блоке "Добавить CSS код"
FTP-клиент - FileZilla ꜛ
Настройка Режима передачи данных - Двоичный (Binary)