Документація Journal 3 SEO Addon

Загальна інформація про Journal3 SEO Filter

Модуль не є самостійним фільтром, а лише доповнює функціонал стандартного фільтру в шаблоні Journal 3. Модуль сумісний з Journal 3.1 та Journal 3.0.x на Opencart 3.0.x та 2.3.

Модуль НЕ сумісний з новим шаблоном Journal 3.2 та НЕ сумісний з Opencart 4.

В документації використовуються скріншоти і приклади зі стандартного інтерфейсу Opencart 3 англійською мовою.

Документація актуальна для Journal 3 SEO Filter версії 1.6.

Демо

Налаштування модуля
Логін: demo
Пароль: demo

Установка Journal3 SEO Filter

1. Завантажте інсталяційний пакет відповідно до версії Opencart: oc2.3 або 3.0.x.   Скріншот
2. Увійдіть в адмін-панель вашого сайту, перейдіть до розділу установки модулів та установіть отриманий *.ocmod.zip.  Скріншот
3. Оновіть кеш модифікаторів.   Скріншот
4. В Opencart 3 додатково очистіть кеш twig   Скріншот
5. Перейдіть до списку модулів Extensions -> Modules та активуйте Journal3 SEO Filter.  Скріншот
6. Перейдіть в налаштування модуля Journal3 SEO Filter та введіть дані для активації ліцензії: місце купівлі модуля та номер замовлення.   Скріншот

Оновлення Journal3 SEO Filter

1. Зробіть резервну копію сайту.
2. Виконайте кроки 1-4 Установки модуля.
3. Перейдіть в налаштування модуля та збережіть налаштування.

Інтерфейс та розділи модуля Journal3 SEO Filter

Інтерфейс модуля для зручності розділено на окремі розділи. Посилання на розділи виводяться в загальному меню Journal 3 та у навігаційному меню справа вгорі.   Скріншот

• Setting – основні налаштування модуля;
• SEO Slugs – керування seo url окремих сутностей (атрибути, опції тощо);
• Landing pages – керування посадковими сторінками фільтра;
• Sitemap – керування модулем мапи сайту, яка містить посилання на посадкові сторінки;
• Crosslinking – керування модулем перелінкування.

Налаштування Journal3 SEO Filter

Основні

1. Status – включає або відключає модуль.
2. Filter root slug – частина url, яка розділяє адресу основної сторінки та параметри фільтра. Має бути унікальною.
3. Links in filter. Journal 3 використовує ajax-запити для отримання товарів і замінює вміст сторінки отриманими результатами. Ця опція дозволяє замінити стандартний алгоритм звичайними посиланнями на сторінки фільтрів.   Скріншот
   Опція має такі варіанти:
   • Disabled – відключено, використовується стандартний алгоритм.
   • Landing pages only – посилання виводиться тільки для параметрів, які ведуть до посадкової сторінки, для всіх інших застосовується стандартний алгоритм.
   • All – всі фільтри виводяться у вигляді посилань. Цей варіант має додаткові налаштування Nofollow non-landing - опція дозволяє налаштувати глибину індексації сторінок фільтра, які не є посадковими. Це буде корисно, якщо є багато можливих комбінацій фільтрів. Опція Nofollow non-landing має два параметри:
     • Number of filter groups – максимальна кількість груп фільтрів в url, при якій дозволено індексування сторінки. Наприклад, якщо Number of filter groups = 2, то сторінка https://site.com/clothes/filter-root/color-red/size-s/ (2 групи: color, size) дозволена для індексування, а сторінка https://site.com/clothes/filter-root/color-red/size-s/brand-adidas/ (3 групи: color, size, brand) - не дозволена, цьому посиланню буде установлено атрибут rel=”nofollow”.
     • Number of filter items – максимальна кількість параметрів в одній групі фільтра, за якої дозволено індексування. Наприклад, якщо Number of filter items = 3, то сторінка https://site.com/clothes/filter-root/color-red~green~blue/ (3 параметри: red, green, blue) – дозволена для індексування, а сторінка https://site.com/clothes/filter-root/color-red~green~blue~yellow/ (4 параметри: red, green, blue, yellow) – не дозволена і матиме атрибут rel=”nofollow”

4. Meta tag Robots for nofollow links – вміст мета-тегу robots на сторінках, яким присвоєно атрибут rel=”nofollow”. Заповнюється відповідно до специфікації Google https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag
   Приклад значення поля: noindex, nofollow – означає «не індексувати сторінку та непереходити за посиланнями на сторінці».
5. Meta tag Robots for landings and dofollow links – вміст мета-тегу robots на сторінках, індексація яких дозволена. Приклад значення поля: index, follow – означає «індексувати сторінку а переходити за посиланнями на сторінці»

Мета-теги

У цій вкладці ви можете налаштувати генерацію мета-тегів на сторінках фільтру, які не є посадковими, за допомогою шорт-кодів. Для кожного типу сторінки потрібно налаштовувати мета-теги окремо. Основна інформація про шорткоди описана безпосередньо у цьому розділі налаштувань. За допомогою шорт-кодів можна також унікалізувати мета-теги для кращого сприйняття пошуковими системами.
Наприклад, вміст поля на зразок «Купуйте {page_name} {filters} у магазині {store_name}. У продажу {product_total} товарів – сторінка {page}» буде виводитись як «Купуйте Смартфони Apple Модель Iphone 14, Iphone 15 у магазині МегаШоп. У продажу 28 товарів – сторінка 1».

SEO Slugs

SEO Slug – це фрагмент url, який присвоєно конкретній сутності або її значенню. Із seo-слагів формується кінцева адреса сторінки. Налаштування seo-слагів відбувається в окремому розділі. Кожен seo-слаг має бути унікальним. Після установки модуля вам необхідно згенерувати слаги. На жаль, поки що автоматична генерація слагів при створенні атрибутів, опцій тощо не підтримується, однак цей функціонал обов’язково з’явиться у наступних версіях.   Скріншот

Розглянемо елементи інтерфейсу:

1. Generate slugs – тут ви можете запустити генерацію слагів
   • Empty – тільки порожні (наприклад, нові атрибути, опції тощо).
   • Owerwrite all – перезаписати все. Всі слаги будуть згенеровані заново.
   • Run – запустити генерування.
   • Clear all – видалити всі згенеровані слаги.

Генерування слагів відбувається за допомогою Slugify. Для більшості мов підтримується автоматична транслітерація.

2. Common SEO slugs – тут ви можете переглянути та відредагувати слаги. Розглянемо колонки:
   • Code/Value – значення або внутрішній код, який використовується фільтром для ідентифікації сутності.
   • Name – назва сутності або значення
   • SEO Slug – згенеровані слаги для кожної мови. Клікніть на значення, щоб відредагувати його. Поле редагування містить дві кнопки:
     • Згенерувати – натисніть, щоб згенерувати слаг.
     • Зберегти – натисніть, щоб зберегти зміни.
   • Action – доступно дві дії:
     • Open children – відкрити список значень цієї сутності.
     • Exclude – виключити сутність і всі її значення з редагування. Рекомендується виключити всі сутності, які не використовуються для фільтрації

3. Excluded entities – список виключених сутностей, тут ви можете їх знову включити. Після включення згенеруйте слаги для порожніх значень.

Посадкові сторінки

Для важливих сторінок фільтра рекомендується створити посадкові сторінки з оптимізованими мета-тегами та описом. Інтерфейс керування посадковими сторінками складається із:

1. Списку посадкових сторінок, де ви можете створити, відредагувати, видалити або переглянути потрібну сторінку. Також доступні функції сортування та фільтрації списку.  Скріншот
2. Форми створення/редагування посадкової сторінки.   Скріншот
   Розглянемо поля форми редагування:
   • URL. Скопіюйте у це поле частину адреси сторінки, яка йде після URL сайту. Наприклад, є сторінка https://site.com/desktops/filter-root/brand_hewlett-packard/availability_in-stock - фільтр за бренодом та наявністю у категорії Скопіювати потрібно частину desktops/filter-root/brand_hewlett-packard/availability_in-stock. Зверніть увагу: в багатомовних сайтах адреса буде різною, потрібно для кожної мови скопіювати правильну версію частини url. Префікс мови в url копіювати не треба. Наприклад, ця ж сама сторінка українською: https://site.com/uk/desktopy/filter-root/vyrobnyk_hewlett-packard/nayavnist_in-stock - скопіювати потрібно desktopy/filter-root/vyrobnyk_hewlett-packard/nayavnist_in-stock.
   • Alias. Альтернативна (можливо, коротка) адреса посадкової сторінки. Наприклад hpdesk. Тоді сторінка https://site.com/desktops/filter-root/brand_hewlett-packard/availability_in-stock буде доступна за короткою адресою https://site.com/hpdesk, в посиланнях фільтра фігуруватиме саме ця коротка адреса. Alias може бути однаковий для різних мов.
   • Sort Order. Порядок сортування посадкових у списку в адмінці.
   • Status. Включити/відключити посадкову сторінку.
   • Name, Description, H1, Meta tag Title, Meta tag Description, Meta tag Keywords – звичні поля, які не потребують пояснення.
3. Як вивести опис посадкової сторінки, якщо тип сторінки не підтримує виведення опису? Розглянемо на прикладі фільтру на сторінці акцій. Наприклад, є сторінка https://site.com/specials/filter-root/brand-apple - фільтр акцій по бренду Apple. Створимо для неї посадкову сторінку https://site.com/specials-apple.
   Однак опис на сторінці не буде виведений, оскільки сторінка product/special не має механізму виведення опису. Отже, як вивести опис:
   • Перейдіть у розділ Journal -> Modules -> Blocks і додайте новий модуль. Налаштуйте його параметри за потреби.   Скріншот
   • Додайте новий блок і у розділі Block Content вкажіть Content Type = Descripiton (Auto Layout). Збережіть модуль.   Скріншот
   • Перейдіть у розділ Journal -> Layouts і відкрийте макет сторінки
   • Розмістіть створений модуль у бажаній позиції та збережіть макет.   Скріншот
   • Тепер на посадковій сторінці https://site.com/specials-apple відображається опис.   Скріншот

Мапа сайту

Функціонал мапи сайту реалізовано окремим модулем типу feed. Мапа сайту містить url створених посадкових сторінок.

Як налаштувати:

1. Перейдіть до розділу Extension -> Feeds та активуйте Journal3 SEO Filter Sitemap.   Скріншот
2. Перейдіть до налаштувань модуля:
   • Status – включіть модуль.
   • Add / at the end of URL – якщо включено, сторінки фільтра у мапі сайту будуть закінчуватися /. Узгодьте це налаштування з налаштуваннями SEO модулів сайту.
   • Data Feed URL – пряме посилання на мапу сайту. Однак Google з виликою вірогідністю не прийме URL такого формату. Вам необхідно внести невеликі зміни до файлу .htaccess. Додайте в ньому таку стрічку:
     RewriteRule ^landing.xml index.php?extension/feed/journal3_seo_filter_sitemap [L]
     Тепер мапа сайту буде доступна за адресою https://site.com/landing.xml - відправте цю адресу в консолі

Модуль перелінкування

Модуль перелінкування призначений для виведення перехресних посилань між посадковими сторінками. Модуль не виводить посилання сторінки на саму себе. Можливі два варіанти:

1. Related – модуль виводить тільки посадкові сторінки, пов’язані з батьківською сторінкою. Наприклад, на сторінці https://site.com/specials/filter-root/brand-apple будуть виводитися всі посадкові сторінки, Keyword яких починається на brand-apple
2. All – модуль виводить всі існуючі посадкові сторінки.

Як налаштувати та вивести модуль Journal3 SEO Filter Crosslink:

1. Перейдіть у розділ Extensions -> Modules та активуйте модуль Journal3 SEO Filter Crosslink.   Скріншот
2. Налаштуйте модуль.   Скріншот
   Інтерфейс модуля містить такі поля:
   • Status – включає чи відключає виведення посилань.
   • Limit – максимальна кількість посилань у блоці.
   • Sort Order – порядок сортування посилань.
   • Controller – шлях до методу, який відповідає за виведення посилань (не редагується, можна тільки скопіювати).
3. Перейдіть у розділ Journal -> Modules -> Blocks і створіть новий блок. Налаштуйте його параметри за потреби. Оскільки модуль Journal3 SEO Filter Crosslink виводить посилання простим списком, рекомендується створити окремі налаштування типографії і вказати їх у Blocks Styles.
4. Додайте новий блок і у розділі Block Content вкажіть:
   • Content Type = Dynamic;
   • Controller Path = значення поля Controller.   Скріншот

5. Перейдіть у розділ Journal -> Layouts і розмістіть модуль на потрібному макеті.

Скріншоти Journal3 SEO Filter