Clean URLs для phpBB 3.3.x

Clean URLs — це безкоштовне розширення phpBB від ButtonPusher, яке замінює довгі стандартні URL phpBB на короткі, стабільні та зручні для читання адреси.

Розширення робить URL компактними, зберігаючи при цьому звичайну функціональність phpBB. Замість довгих рядків запитів на кшталт viewtopic.php?f=5&t=123 Clean URLs створює прості адреси на основі ID.

Підтримка та обговорення на phpBB.com: тема розширення Clean URLs.

Можливості

• Короткі URL для тем, форумів, повідомлень, профілів користувачів, списків учасників, сторінок пошуку та сторінок користувачів онлайн.
• Стабільні URL на основі ID, які не залежать від назв тем або форумів.
• Чисті URL пагінації для тем, форумів, списків учасників та інших підтримуваних сторінок.
• Сторінка налаштувань у Панелі адміністратора.
• Налаштовувані шаблони URL для підтримуваних маршрутів.
• Підтримка заповнювачів, таких як [ID], [START] і [CHAR].
• Налаштовуваний формат URL тем, наприклад t[ID] або topic[ID].
• Налаштовуваний формат URL форумів, наприклад forum-[ID] або f[ID].
• Налаштовуваний формат прямих URL повідомлень, наприклад p[ID] або post[ID].
• Вибір між прямими URL повідомлень і SEO-дружніми посиланнями на повідомлення через тему.
• Оптимізоване формування SEO-дружніх посилань на повідомлення зі зменшеним навантаженням на базу даних.
• Динамічні правила переписування Apache/LiteSpeed і nginx, що генеруються на основі поточних налаштувань URL.
• Можливість скидання до стандартних налаштувань у Панелі адміністратора.
• Чисті посилання в HTML, що генерується phpBB.
• Підтримка прямих посилань на повідомлення та якорів повідомлень.
• Чисті URL у розташуваннях sitemap.
• Перенаправлення зі стандартних підтримуваних URL phpBB.
• Збереження ID сесій та необхідних параметрів запиту там, де це потрібно.
• Працює з phpBB, встановленим як у корені домену, так і в підкаталозі, наприклад /forum/.
• Не потребує змін основних файлів phpBB.
• Підтримка Apache, LiteSpeed і nginx.
• У комплекті кілька мовних пакетів.

Скріншот

Приклади URL

За стандартних налаштувань Clean URLs використовує компактні маршрути, наприклад:

• /t123 – тема
• /t123-20 – тема з пагінацією
• /forum-5 – форум
• /forum-5-25 – форум з пагінацією
• /p456 – прямий URL повідомлення
• /memberlist-50 – список учасників з пагінацією
• /memberlist-a – список учасників, відфільтрований за першою літерою
• /profile-17 – профіль користувача
• /team – сторінка команди
• /newposts – пошук нових повідомлень
• /unanswered – теми без відповідей
• /activetopics – активні теми
• /viewonline – користувачі онлайн
• /login – сторінка входу
• /register – сторінка реєстрації

Посилання на конкретне повідомлення може використовувати прямий URL, наприклад /p456#p456, або, якщо увімкнено режим SEO-дружніх посилань на повідомлення, URL через тему, наприклад /t123#p456.

Шаблони URL можна змінювати в Панелі адміністратора. Наприклад, t[ID] можна змінити на topic[ID], а p[ID] — на post[ID].

Вимоги

• phpBB 3.3.x
• PHP 7.2 або новіший
• Apache або LiteSpeed з mod_rewrite, або nginx
• Дозвіл на редагування .htaccess або конфігурації сервера nginx

Встановлення

1. Завантажте архів розширення.
2. Розпакуйте його у вашу інсталяцію phpBB так, щоб файли розширення знаходилися тут:
   ext/buttonpusher/cleanurls/
3. Для Apache або LiteSpeed відкрийте файл:
   ext/buttonpusher/cleanurls/docs/apache-rules.txt
   
   Ті самі правила переписування Apache/LiteSpeed також доступні на сторінці налаштувань Clean URLs у Панелі адміністратора.
4. Скопіюйте правила переписування у файл .htaccess вашої інсталяції phpBB одразу після рядка:
   RewriteEngine on
5. Якщо phpBB встановлено в підкаталозі, наприклад /forum/, редагуйте файл .htaccess саме в цьому каталозі phpBB.
6. Для nginx використовуйте правила переписування nginx, що входять до комплекту розширення, або скопіюйте їх зі сторінки налаштувань Clean URLs у Панелі адміністратора.
7. Збережіть конфігурацію вебсервера.
8. Відкрийте Панель адміністратора phpBB.
9. Перейдіть до Налаштування → Керування розширеннями.
10. Знайдіть Clean URLs і натисніть Увімкнути.
11. Відкрийте сторінку налаштувань Clean URLs у Панелі адміністратора.
12. Перевірте шаблони URL і режим посилань на повідомлення.
13. Якщо ви змінюєте будь-які шаблони URL відносно стандартних значень, скопіюйте нові правила Apache/LiteSpeed або nginx зі сторінки налаштувань Clean URLs і відповідно оновіть конфігурацію сервера.
14. Очистіть кеш phpBB.

Apache і LiteSpeed

Для Apache і LiteSpeed стандартні правила переписування знаходяться у файлі:

ext/buttonpusher/cleanurls/docs/apache-rules.txt

Ті самі правила також відображаються на сторінці налаштувань Clean URLs у Панелі адміністратора, звідки їх можна скопіювати безпосередньо.

Скопіюйте правила у файл phpBB .htaccess одразу після:

RewriteEngine on

Якщо phpBB встановлено в підкаталозі, наприклад /forum/, редагуйте файл .htaccess у цьому каталозі phpBB.

Якщо ви змінюєте шаблони URL на сторінці налаштувань Clean URLs, використовуйте оновлені правила Apache/LiteSpeed, згенеровані там, замість стандартних правил із apache-rules.txt.

Редагувати основні файли phpBB не потрібно.

nginx

nginx не використовує .htaccess. Розширення містить готові правила переписування nginx для стандартної конфігурації URL.

Правила nginx також відображаються на сторінці налаштувань Clean URLs у Панелі адміністратора, звідки їх можна скопіювати безпосередньо.

Якщо ви змінюєте будь-які шаблони URL, правила nginx, згенеровані на сторінці налаштувань, оновлюються відповідно.

Додайте правила до серверного блоку, який обслуговує вашу інсталяцію phpBB, перезавантажте nginx і очистіть кеш phpBB.

Налаштування URL

Clean URLs 1.0.2 містить сторінку налаштувань у Панелі адміністратора, де можна змінювати підтримувані шаблони URL.

Приклади:

• t[ID] або topic[ID] для тем
• forum-[ID] або f[ID] для форумів
• p[ID] або post[ID] для прямих URL повідомлень
• profile-[ID] для профілів користувачів
• memberlist-[START] для пагінації списку учасників

Обов’язкові заповнювачі мають залишатися в шаблонах URL. Наприклад, маршрут теми повинен містити [ID].

Щоразу, коли змінюється шаблон URL, розширення генерує відповідні правила Apache/LiteSpeed і nginx на тій самій сторінці налаштувань.

Режими посилань на повідомлення

Clean URLs пропонує два режими посилань на окремі повідомлення.

Режим прямих посилань на повідомлення використовує такі URL:

/p456#p456

Це більш сумісний варіант, оскільки ID повідомлення достатньо для його пошуку навіть у тому разі, якщо повідомлення пізніше буде перенесено до іншої теми.

SEO-дружній режим через тему використовує такі URL:

/t123#p456

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

Версія 1.0.2 оптимізує формування SEO-дружніх посилань на повідомлення та усуває зайві запити до бази даних для кожного окремого посилання, які на деяких сторінках могли спричиняти надмірне навантаження на сервер і помилки HTTP 503.

Приклади, що відображаються в Панелі адміністратора, автоматично відповідають налаштованим шаблонам URL тем і прямих посилань на повідомлення.

Без змін основних файлів phpBB

Clean URLs працює як звичайне розширення phpBB і не потребує редагування основних PHP-файлів або шаблонів phpBB.

Єдине необхідне серверне налаштування — конфігурація переписування URL для Apache, LiteSpeed або nginx.

Вимкнення або видалення розширення

Якщо ви вимкнете Clean URLs, phpBB повернеться до стандартного формату URL. ID форумів, тем, повідомлень і користувачів не змінюються.

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

Історія змін

1.0.2

• Виправлено помилки HTTP 503, які могли виникати на деяких сторінках при ввімкнених SEO-дружніх посиланнях на повідомлення.
• Оптимізовано формування SEO-дружніх URL повідомлень через тему.
• Усунено зайві запити до бази даних для кожного окремого посилання під час генерації сторінки.
• Зменшено навантаження на базу даних на сторінках із великою кількістю посилань на повідомлення.
• Покращено обробку посилань на останнє повідомлення на головній сторінці форуму та сторінках форумів.
• Покращено сумісність із лічильниками тем і повідомлень phpBB 3.3.x.
• Збережено SEO-дружні URL тем і якорі повідомлень без проблеми надмірної кількості запитів.

1.0.1

• Додано сторінку налаштувань у Панелі адміністратора.
• Додано налаштовувані шаблони URL для тем, форумів, повідомлень, профілів, списків учасників, сторінок пошуку, сторінок користувачів онлайн, входу, реєстрації та інших підтримуваних маршрутів phpBB.
• Додано підтримку користувацьких шаблонів маршрутів із заповнювачами, такими як [ID], [START] і [CHAR].
• Додано вибір між прямими URL повідомлень і SEO-дружніми URL повідомлень через тему.
• Додано динамічно згенеровані правила Apache/LiteSpeed і nginx у Панелі адміністратора.
• Додано можливість скидання налаштувань Clean URLs до стандартних значень.
• Виправлено URL пагінації списків учасників, наприклад /memberlist-100.
• Виправлено URL пагінації тем, наприклад /t3256-20.
• Виправлено обробку пагінації форумів та алфавітної пагінації списків учасників.
• Виправлено дубльовані якорі повідомлень, наприклад #p18764#p18764.
• Покращено сумісність прямих посилань на повідомлення.
• Збережено підтримку всіх мовних пакетів, що входять до комплекту.

1.0.0

• Перший публічний випуск.
• Додано чисті URL для тем, форумів, повідомлень, профілів, списків учасників, сторінок пошуку та сторінок користувачів онлайн.
• Додано правила переписування Apache/LiteSpeed і nginx.
• Додано підтримку інсталяцій phpBB у корені домену та в підкаталогах.

Завантаження

Завантажити Clean URLs 1.0.2

Поточна версія: 1.0.2