Чисті URL-адреси Pro модуль для PrestaShop

Найважливіші особливості та переваги

• Адреси без ID за вашими шаблонами — ви самі вирішуєте, як виглядає адреса кожного типу контенту, наприклад product/nazwa-produktu або — після ввімкнення шаблонів без префікса — навіть nazwa-produktu.html безпосередньо в кореневому каталозі магазину.
• Жодних втрат SEO при зміні адрес — постійні перенаправлення 301/308 з нативних адрес і з кожної попередньої форми адреси переносять позиції, напрацьовані в пошуковій системі, на нові URL-адреси замість створення дублікатів і помилок 404.
• Безпечне, зворотне впровадження — у магазині нічого не змінюється, доки ви самі не активуєте рушій; до цього все створюється і перевіряється у фоновому режимі, а відкат виконується так само поетапно, як і впровадження.
• Сумісність з іншими модулями без їх переробки — перевизначення класу Link забезпечує, що кожен модуль, який отримує адреси через стандартне API PrestaShop (фіди Google/Facebook, карти сайту, модулі, що працюють через cron і панель), автоматично отримує канонічні адреси.
• Автоматична обробка конфліктів назв — коли два елементи мають однакову назву, рушій сам призначає зрозумілий суфікс або батьківський шлях або — якщо ви так налаштуєте — чекає на ваше рішення; нічого не публікується навмання.
• Захист наявних підсторінок — модуль автоматично виявляє та резервує адреси, зайняті самим PrestaShop та іншими модулями (кошик, контакти, карта сайту), тож чиста адреса товару ніколи не перехопить наявну сторінку.
• Панель, зрозуміла навіть новачкові — інформаційна панель із покроковим посібником, описом біля кожної опції, описами стану на кожній вкладці та діагностичними повідомленнями, які прямо вказують, що і де натиснути, включно з кнопками виправлення в один клік.
• Архітектура fail-closed — у разі будь-якої помилки (пошкоджений реєстр, збій кешу, конфлікт з іншою модифікацією) магазин негайно повертається до нативних адрес замість того, щоб показувати клієнтам помилки.

Функціональність детально

Шаблони та побудова адрес

• Окремий шаблон адреси для кожного типу контенту (товари, категорії, сторінки CMS, категорії CMS, виробники, постачальники, вкладення) у кожній мові та магазині.
• Токени в шаблонах: дружня назва, повний шлях категорії, батьківська категорія, виробник, постачальник, артикул, префікс мови та інші — залежно від типу контенту.
• Глобальна політика шляхів: малі літери, лише символи ASCII, кінцевий слеш, обмеження довжини сегмента і всього шляху, контроль slug-ів, що складаються лише з цифр — з можливістю перевизначення для кожного шаблону.
• Шаблони без постійного префікса (адреси безпосередньо в кореневому каталозі) для PrestaShop 8.1.2 і новіших версій, завжди перевіряються попередньою перевіркою.
• Політика адрес комбінацій товару: одна спільна канонічна адреса для всіх варіантів (разом із видаленням якоря комбінації після знака #) або збереження функціонального параметра варіанта.

Поетапне впровадження та діагностика

• П’ять режимів рушія: вимкнений, лише спостереження, паралельний режим (старі адреси вже перенаправляють, магазин показує нативні посилання), активний та аварійний «активний з нативним fallback».
• Попередня перевірка (preflight), що блокує активацію до виконання всіх умов: повний реєстр, свіжа валідація, вирішені колізії, завершені завдання, коректна схема бази даних, зареєстровані hook-и, відсутність конфліктів шаблонів.
• Діагностичні повідомлення, що вказують точну причину та місце виправлення, з кнопками, які одним кліком ставлять у чергу відсутні перебудови або валідації саме для тих діапазонів, яких стосується проблема.
• Таблиця покриття, що показує для кожної мови та типу контенту, скільки елементів уже мають чисту адресу, а також звіт про цілісність реєстру.
• Захищені переходи між режимами — з активного режиму неможливо випадково перескочити до вимкненого, оминувши перевірку.

Перенаправлення, аліаси та захист SEO

• Автоматичні постійні перенаправлення нативних адрес з ID на канонічні адреси (301 або 308 на вибір), з пропуском сторінок лістингу з параметрами сортування та фільтрів.
• Історія адрес: кожна зміна канонічної адреси залишає після себе робоче перенаправлення, тож закладки, реклама та результати пошуку ніколи не ведуть у нікуди.
• Ручні та імпортовані аліаси з ціллю у вигляді об’єкта магазину, довільної URL-адреси (з політикою безпеки хостів: лише поточний магазин, список дозволених HTTPS-доменів або будь-який HTTPS) або відповіді 410/404.
• Коди відповіді для аліасів: 301, 302, 307, 308, а також 404 і 410; видалені об’єкти повертають на вибір 410 Gone (швидше вилучення з індексу) або 404.
• Перенаправлення зберігають параметри кампаній (utm_source, utm_medium, utm_campaign, utm_term, utm_content), ідентифікатори рекламних кліків (gclid, fbclid, msclkid), а також визначений список функціональних параметрів.
• Нормалізація запитів: варіанти адреси, що відрізняються регістром літер чи кінцевим слешем, перенаправляються на одну канонічну форму, без дублікатів контенту.
• Необов’язкова статистика використання перенаправлень із семплюванням — ви бачите, чи хтось і далі користується старими посиланнями.

Сумісність та інтеграції

• Перевизначення (override) класу Link: усі модулі, що використовують стандартне API адрес PrestaShop — зокрема генератори товарних фідів і карт сайту, які працюють із панелі або через cron — отримують канонічні адреси без жодних змін у своєму коді, з автоматичним поверненням до нативної адреси, коли чиста адреса недоступна.
• Публічне API для розробників: одиничне та пакетне отримання канонічних адрес (з попереднім завантаженням реєстру для генераторів карт сайту), а також hook-и, що дозволяють іншим модулям резервувати власні шляхи та реагувати на зміни маршрутів.
• Повна підтримка multistore (конфігурація, шаблони та реєстр для кожного магазину) і багатьох мов; у старіших версіях PrestaShop, де цього вимагає ядро, модуль стежить за однаковими шаблонами між мовами.
• Сумісність: PrestaShop 1.7.x–9.x, синтаксис PHP 7.0–8.5 (у межах вимог використовуваного ядра), MySQL 5.6+/MariaDB 10.x, Apache і Nginx, магазини в підкаталозі — без Composer і зовнішніх бібліотек.

Автоматизація, завдання та продуктивність

• Автоматичне оновлення: додавання, зміна назви або видалення товару, категорії чи сторінки самостійно оновлює адресу та ставить у чергу потрібні перебудови, включно із залежностями (зміна категорії оновлює товари, зміна товару — вкладення).
• Система фонових завдань: сканування, попередній перегляд (без запису), перебудова, валідація, прогрів кешу, імпорт, експорт і впорядкування — виконуються в налаштовуваних порціях, з паузою, відновленням, скасуванням і очищенням усієї черги однією кнопкою.
• Cron одним посиланням: готова до копіювання адреса з секретним токеном (розділ Cron у панелі, разом з інструкцією та рядком для crontab) автоматично обробляє чергу; накладені виклики блокуються; також доступний інтерфейс CLI.
• Фрагментований файловий кеш маршрутів (налаштовуваний розмір фрагмента та час дії) з fallback до бази даних — розв’язання адрес не навантажує базу при кожному перегляді сторінки.
• Журнал аудиту змін адрес із налаштовуваним терміном зберігання, а також автоматичне впорядкування завершених завдань і прострочених записів.
• Імпорт аліасів із файлу CSV з окремим попереднім переглядом і валідацією перед записом (до 500 рядків на файл, атомарний запис), а також експорт налаштувань, маршрутів, аліасів, резервувань, колізій і діагностики до JSON/CSV — без секретів і даних клієнтів.

Панель адміністратора та безпека

• Зрозуміла панель з інформаційною дошкою (метрики реєстру), згортаним посібником «Як почати — крок за кроком», що запам’ятовує свій стан, описом стану конфігурації на кожній вкладці та описами біля кожної опції.
• Списки шляхів, аліасів, колізій і завдань зі стандартною фільтрацією PrestaShop: мова і тип об’єкта як списки вибору, ID, шлях і slug як текстові поля, з нативною пагінацією.
• Права доступу, сумісні з профілями працівників PrestaShop (перегляд, редагування, видалення), що застосовуються в панелі та в кожній дії AJAX.
• Захист: токени та підписи адміністративних запитів, перевірка походження запитів, порівняння ключів, стійкі до атак за часом виконання, секретний операційний ключ cron для кожного магазину, жорстка нормалізація шляхів, що відхиляє керівні символи та подвійне кодування.
• Надійність: транзакційне встановлення з автоматичним відкатом і відновленням попередньої конфігурації у разі помилки, блокування деінсталяції при активному маршрутизації, постійні маркери аварії, що примушують безпечний режим після критичної помилки, а також повне очищення таблиць і конфігурації при видаленні.

Вимоги

• PrestaShop 1.7.0–9.x з увімкненими дружніми URL-адресами (Параметри магазину → Трафік і SEO).
• PHP 7.0–8.5 (версія, що підтримується використовуваним ядром PrestaShop), MySQL 5.6+ або MariaDB 10.x.
• Без додаткових залежностей: модуль не використовує Composer або зовнішні бібліотеки.