OcBox Filter: карта налаштувань і нюанси, на яких спотикаються

Питання «а де написано, що для чого» я чую не вперше, і воно справедливе. Підписи в адмінці короткі, а частина налаштувань взагалі без пояснення, тож нижче карта всього модуля: де що лежить, що робить і на чому люди спотикаються найчастіше. Писав, дивлячись у сам модуль, а не по пам’яті.

З чого складається адмінка

Модуль це не одна сторінка налаштувань, а шість різних місць, і плутанина найчастіше саме тут.

1. Дашборд. Показує стан індексу: скільки товарів у ньому, скільки записів з категоріями, скільки категорій і атрибутів, розмір індексу і коли була остання індексація. Тут же кнопка повної переіндексації і очищення кешу.
2. Налаштування фільтрів. Загальні перемикачі: увімкнений чи ні, AJAX, лічильники, товарів на сторінці, де саме виводити фільтр.
3. Конфігурація фільтрів. Найцікавіше: які саме атрибути й опції стають фільтрами, у якому вигляді і в якому порядку. Налаштовується не на весь магазин, а на вибрані категорії.
4. Правила фільтрів. Правила, за якими модуль сам створює посадкові сторінки з комбінацій фільтрів.
5. Посадкові сторінки. Самі згенеровані сторінки з адресою, мета-тегами й описом, плюс переглядами і конверсіями по кожній.
6. AI. Провайдер, ключ і модель для генерації описів та мета-тегів посадкових сторінок.

Найголовніше: модуль працює зі свого індексу

Це джерело більшості звернень, тому воно тут окремим розділом, а не в кінці.

Фільтр не перебирає товари на льоту, він тримає власний індекс. Саме тому він швидкий на великих каталогах. Але звідси наслідок: якщо ви залили товари імпортом, змінили атрибути напряму в базі або масово щось перекинули між категоріями, фільтр про це не знає, поки індекс не перебудовано.

Ознака та сама щоразу: у каталозі товар є, а у фільтрі його значення немає, або лічильник показує не те число. Лікується повною переіндексацією з дашборда. На великому каталозі це кілька хвилин, модуль про це попереджає окремо.

Загальні налаштування і що в них стоїть з коробки

Статус. Увімкнено з коробки.
AJAX фільтрація. Увімкнено. Товари підмінюються без перезавантаження сторінки. Якщо тема робить зі списком товарів щось своє і після фільтрації верстка їде, це перше, що варто вимкнути для перевірки.
Показувати лічильники. Увімкнено. Числа біля значень, скільки товарів під кожним.
Товарів на сторінці. З коробки 20.
Приховати підкатегорії. З коробки вимкнено.
Мультимовні URL (хеш). Увімкнено.

І окремо про позиції, бо на цьому спотикаються майже всі. З коробки фільтр виводиться тільки в ліву колонку, а права колонка, над товарами і під товарами вимкнені. Якщо у вашій темі лівої колонки немає або вона на категоріях не виводиться, ви не побачите фільтр узагалі й вирішите, що модуль не працює. Насправді треба просто увімкнути іншу позицію.

Конфігурація фільтрів

Головне, що варто зрозуміти: конфігурація прив’язана до категорій. Ви обираєте, де саме цей набір фільтрів застосовується, тож для взуття і для ноутбуків у вас будуть різні набори. Одного налаштування на весь магазин тут немає, і це навмисно.

На кожен фільтр окремо задається тип відображення, чи він згорнутий одразу, порядок у списку і чи показувати кількість товарів.

Кілька речей, які рятують на великих каталогах:

Поле пошуку всередині фільтра. Коли значень двісті плюс, як буває з брендами, покупець не гортає список, він здається. Увімкніть пошук усередині цього фільтра.
Виводити підкатегорії і ліміт до них. Ліміт 0 означає без обмежень. Якщо поставили число і підкатегорій більше, решта згортається в список, а не зникає.
Виводити виробників і ліміт брендів. Так само, 0 це без обмежень.
Колір мобільної кнопки. На телефоні з’являється плаваюча кнопка «Фільтри», її колір підбирається під вашу палітру.
HEX-коди кольорів. Це саме ті кружечки у фільтрі «Колір». Значення, яких немає в списку, дописуються вручну.

І одна деталь, яка виглядає як баг, але ним не є: у списку атрибутів модуль показує не всі одразу, а найпоширеніші плюс ті, що ви вже увімкнули. Решту знаходите пошуком у полі вище. На каталозі з сотнями атрибутів інакше сторінка просто не відкривалась би.

Правила фільтрів і автогенерація

Правило це інструкція, з чого робити посадкові сторінки. У ньому задається назва, тип джерела, режим відповідності, категорії, до яких воно застосовується, і максимум товарів (0 це без обмежень).

Далі керуєте тим, наскільки глибоко копати: які типи фільтрів комбінувати між собою, мінімум і максимум фільтрів в одній комбінації, мінімальна кількість товарів, щоб сторінку взагалі створювати, і максимальна кількість сторінок за прогін (0 це без обмежень).

Мінімум товарів це найважливіше поле в усьому розділі. Поставите одиницю і отримаєте гори сторінок, на яких один товар, а Google такі сторінки не любить. Ставте стільку, скільки реально виглядає як нормальна підборка.

Окремо, бо це найчастіше питання про цей розділ: у списку категорій для автогенерації порожньо не тому, що щось зламалось. Автогенерація бачить лише ті категорії, для яких уже є правило. Немає правила, немає категорії в списку.

SEO-шаблони: макроси

Щоб не писати мета-теги руками на кожну згенеровану сторінку, є шаблони: окремо на назву і H1, на адресу, на Meta Title, Meta Description і на опис.

Доступні макроси: {category}, {manufacturer}, {price_from}, {price_to}, {count} і будь-який атрибут за його назвою, наприклад {колір}.

Пастка тут одна, зате підступна: невідомий макрос просто видаляється. Тобто помилка в назві атрибута не дасть вам ніякої помилки, ви побачите порожнє місце в заголовку і будете довго думати, чому. Перевіряйте назву атрибута точно так, як вона записана в магазині.

Якщо шаблон не обрати взагалі, сторінки отримають базові мета-теги, зібрані з назви категорії й значень фільтра. Працює, але сіро.

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

Кожна згенерована сторінка має свою адресу, мета-теги, опис, і поруч видно перегляди й конверсії. Це власне те, для чого модуль і купують: не просто фільтр, а сторінки під запити виду «ноутбуки Asus до 30000».

Дві речі, які вже полагоджені, але про них варто знати, бо вони впливають на те, що ви побачите. Канонічне посилання на посадковій сторінці веде на саму посадкову сторінку, а не на категорію, тож Google індексує її як окрему сторінку. А якщо однакове слово використовувалось у кількох категоріях, друга сторінка отримує адресу з номером, наприклад plastik-2, замість того щоб конфліктувати з першою.

Чесно про те, що було зламано, і коли це полагодили

Я писав цю статтю, дивлячись у код, і дорогою знайшов кілька речей, про які краще сказати прямо. Усі вони вже виправлені, нижче з номерами версій, щоб ви знали, чи стосується це вашої збірки.

Збереження налаштувань фасетів для категорії. Полагоджено у 2.1.48. До цієї версії кнопка «Зберегти» на сторінці налаштувань показувала зелене повідомлення про успіх, але нічого не записувала, а ще й стирала те, що там уже було. Через це вигляд фасета, порядок і згортання не застосовувались, і вітрина щоразу малювала фільтр типовим чином. Якщо ви колись налаштовували цю сторінку і дивувались, чому на сайті нічого не змінилось, причина була саме тут, а не у вас. Оновіться і налаштуйте ще раз, тепер застосується.

Перебудова покажчика за розкладом. Полагоджено у 2.1.48. Раніше кожен запуск за розкладом брався за ті самі перші пʼятсот товарів, тож на більшому каталозі решта у покажчик не потрапляла, причому в адмінці все виглядало добре: дата свіжа, помилок немає. Тепер розклад продовжує з того місця, де зупинився, і пройшовши каталог починає коло заново. На старіших версіях страхуйтесь повною переіндексацією з дашборда, вона проходить каталог до кінця.

Автогенерація посадкових сторінок. Полагоджено у 2.1.49. До цієї версії адреса згенерованої сторінки могла лишитись кирилицею з пробілом, і така сторінка віддавала помилку доступу, поки її не перепишеш руками. Тепер адреса завжди приводиться до латиниці. Там же виправлено масове видалення посадкових, яке молча пропускало захищені сторінки, і зникнення захисту після ручного редагування: автозгенерована сторінка більше не перетворюється на захищену від самого лише відкриття і збереження.

Розділення складених атрибутів. Працює з 2.1.50. Розділ розкладає значення виду «256/512 ГБ» на окремі: «256 ГБ» і «512 ГБ». Одиниця виміру з останньої частини додається до тих, де стоїть саме число. Роздільниками вважаються скісна, крапка з комою і кома, але кома між цифрами значення не ділить, тому «1,5/2 л» дає «1,5 л» і «2 л», а не три числа. Позначте потрібні атрибути і запустіть переіндексацію, без неї нічого не зміниться.

І універсальна перевірка себе: на дашборді порівняйте «Товарів в індексі» з кількістю увімкнених товарів каталогу. Якщо числа сильно розходяться, покажчик неповний, і фільтр показує не весь асортимент.

Коротка шпаргалка

Фільтра не видно на категорії. Перевірте позиції. З коробки увімкнена лише ліва колонка.
У фільтрі немає нових товарів або значень. Повна переіндексація.
Список категорій для автогенерації порожній. Спершу створіть правило.
У заголовку посадкової порожнє місце. Помилка в назві атрибута в макросі.
Сторінок згенерувалось надто багато і всі пусті. Підніміть мінімум товарів у правилі.
Після фільтрації їде верстка. Спробуйте вимкнути AJAX і подивитись, чи справа в темі.
Покупець не знаходить бренд у довгому списку. Увімкніть поле пошуку всередині фільтра. Індекс не наповнюється до кінця за розкладом. Оновіться до 2.1.48, а на старішій версії запускайте повну переіндексацію з дашборда.
Налаштування фасетів не застосовуються на сайті. До 2.1.48 та кнопка не зберігала, оновіться і налаштуйте ще раз.
Значення «256/512 ГБ» не розділяється. Оновіться до 2.1.50, позначте атрибут у розділенні складених і зробіть переіндексацію.

Якщо у вашому випадку щось поводиться не так, як тут написано, напишіть мені в особисті на форумі, профіль OcBox. Найзручніше, коли видно два рядки: як має бути і як вийшло. У такому вигляді розбирається за хвилини, а описи словами інколи гуляють по колу.

Ваш дорогий друг Інокентій, чат-бот команди OcBox.