Clean URLs — безкоштовне розширення phpBB від ButtonPusher, яке замінює довгі стандартні URL-адреси phpBB короткими, стабільними та зрозумілими адресами.
Розширення робить URL-адреси компактними, зберігаючи звичайну функціональність phpBB. Замість довгих рядків параметрів, наприклад viewtopic.php?f=5&t=123, Clean URLs створює прості адреси на основі ідентифікаторів.
Підтримка й обговорення на phpBB.com: тема розширення Clean URLs.
Можливості
- Короткі URL-адреси для тем, форумів, повідомлень, профілів користувачів, списків учасників, сторінок пошуку та перегляду користувачів онлайн.
- Стабільні URL-адреси на основі ідентифікаторів, які не залежать від назв тем і форумів.
- Зручні адреси сторінок пагінації для тем, форумів, списків учасників та інших підтримуваних сторінок.
- Сторінка налаштувань у панелі адміністратора (ACP).
- Можливість змінювати шаблони URL-адрес для підтримуваних маршрутів.
- Підтримка заповнювачів, зокрема
[ID],[START]і[CHAR]. - Налаштовуваний формат URL-адрес тем, наприклад
t[ID]абоtopic[ID]. - Налаштовуваний формат URL-адрес форумів, наприклад
forum-[ID]абоf[ID]. - Налаштовуваний формат прямих URL-адрес повідомлень, наприклад
p[ID]абоpost[ID]. - Вибір між прямими посиланнями на повідомлення та SEO-дружніми посиланнями через адресу теми.
- Оптимізоване створення SEO-дружніх посилань на повідомлення зі зменшеним навантаженням на базу даних.
- Динамічне формування правил переписування URL для Apache/LiteSpeed і nginx відповідно до поточних налаштувань адрес.
- Можливість скинути налаштування до стандартних значень у панелі адміністратора.
- Короткі посилання в HTML-коді, який генерує phpBB.
- Підтримка прямих посилань на повідомлення та якорів повідомлень.
- Правильні URL-адреси на основі теми під час переходу до першого непрочитаного повідомлення з email-сповіщення phpBB.
- Коректні посилання схвалення тем і відповідей, що очікують модерації, зокрема правильні адреси повернення після схвалення.
- Короткі URL-адреси в посиланнях карти сайту.
- Перенаправлення зі стандартних URL-адрес phpBB, які підтримує розширення.
- Видалення ідентифікаторів сесії з публічних URL-адрес форуму в SEO-дружньому режимі зі збереженням необхідних параметрів запиту.
- Збереження стандартної обробки сесій у режимі сумісності та захисних ідентифікаторів сесій для адміністрування й виходу з облікового запису.
- Робота з 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-дружній режим посилань на повідомлення, адресу на основі теми, наприклад /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
Встановлення
- Завантажте архів розширення.
- Розпакуйте його до каталогу встановленого phpBB так, щоб файли розширення розташовувалися за шляхом:
ext/buttonpusher/cleanurls/ - Для Apache або LiteSpeed відкрийте файл:
ext/buttonpusher/cleanurls/docs/apache-rules.txt
Ті самі правила переписування URL для Apache/LiteSpeed також доступні на сторінці налаштувань Clean URLs у панелі адміністратора. - Скопіюйте правила переписування URL у файл
.htaccessвашого phpBB безпосередньо після рядка:
RewriteEngine on - Якщо phpBB встановлено в підкаталозі, наприклад
/forum/, редагуйте файл.htaccessусередині цього каталогу phpBB. - Для nginx використовуйте правила переписування URL, що входять до комплекту розширення, або скопіюйте їх зі сторінки налаштувань Clean URLs у панелі адміністратора.
- Збережіть конфігурацію вебсервера.
- Відкрийте панель адміністратора phpBB.
- Перейдіть до розділу Customise → Manage extensions (Налаштування → Керування розширеннями).
- Знайдіть Clean URLs і натисніть Enable (Увімкнути).
- Відкрийте сторінку налаштувань Clean URLs у панелі адміністратора.
- Перевірте шаблони URL-адрес і режим посилань на повідомлення.
- Якщо ви змінили стандартні шаблони URL-адрес, скопіюйте нові правила переписування URL для Apache/LiteSpeed або nginx зі сторінки налаштувань Clean URLs і відповідно оновіть конфігурацію сервера.
- Очистьте кеш phpBB.
Apache та LiteSpeed
Для Apache та LiteSpeed стандартні правила переписування URL містяться у файлі:
ext/buttonpusher/cleanurls/docs/apache-rules.txt
Ті самі правила також відображаються на сторінці налаштувань Clean URLs у панелі адміністратора, звідки їх можна скопіювати безпосередньо.
Скопіюйте правила у файл .htaccess вашого phpBB відразу після рядка:
RewriteEngine on
Якщо phpBB встановлено в підкаталозі, наприклад /forum/, редагуйте файл .htaccess усередині цього каталогу phpBB.
Якщо ви змінюєте шаблони URL-адрес на сторінці налаштувань Clean URLs, використовуйте згенеровані там оновлені правила для Apache/LiteSpeed замість стандартних правил із файлу apache-rules.txt.
Редагувати файли ядра phpBB не потрібно.
nginx
nginx не використовує .htaccess. Розширення містить готові правила переписування URL для nginx зі стандартними налаштуваннями адрес.
Правила для nginx також відображаються на сторінці налаштувань Clean URLs у панелі адміністратора, звідки їх можна скопіювати.
Якщо ви змінюєте шаблони URL-адрес, правила для nginx, згенеровані на сторінці налаштувань, відповідно оновлюються.
Додайте правила до серверного блоку, який обслуговує ваш phpBB, перезавантажте конфігурацію nginx та очистьте кеш phpBB.
Налаштування URL-адрес
Починаючи з версії Clean URLs 1.0.3, у панелі адміністратора доступна сторінка налаштувань, на якій можна змінювати підтримувані шаблони URL-адрес.
Приклади:
t[ID]абоtopic[ID]для темforum-[ID]абоf[ID]для форумівp[ID]абоpost[ID]для прямих URL-адрес повідомленьprofile-[ID]для профілів користувачівmemberlist-[START]для пагінації списку учасників
Обов’язкові заповнювачі мають залишатися в шаблонах URL-адрес. Наприклад, маршрут теми повинен містити [ID].
Після кожної зміни шаблону URL-адреси розширення генерує відповідні правила переписування URL для Apache/LiteSpeed і nginx на тій самій сторінці налаштувань.
Режими посилань на повідомлення
Clean URLs пропонує два режими посилань на окремі повідомлення.
Режим прямих посилань на повідомлення використовує адреси на зразок:
/p456#p456
Цей варіант забезпечує кращу сумісність, оскільки ідентифікатора повідомлення достатньо, щоб знайти його, навіть якщо згодом повідомлення буде перенесено до іншої теми.
SEO-дружній режим посилань через адресу теми використовує адреси на зразок:
/t123#p456
Такий варіант створює чистішу адресу на основі теми, однак посилання може стати менш надійним, якщо повідомлення перенести до іншої теми.
Версія 1.0.2 оптимізує створення SEO-дружніх посилань на повідомлення та усуває зайві запити до бази даних для кожного посилання, які могли спричиняти надмірне навантаження на сервер і помилки HTTP 503 на деяких сторінках.
У версії 1.0.3 прямі посилання на повідомлення, наприклад /p456#p456, у SEO-дружньому режимі перенаправляють на відповідну тему з якорем повідомлення, наприклад /t123#p456. Якщо повідомлення розташоване на наступній сторінці, цільова адреса містить правильний зсув пагінації, наприклад /t123-20#p456. Підтримуються власні шаблони URL-адрес і встановлення phpBB у підкаталогах.
Версія 1.0.7 виправляє посилання на перше непрочитане повідомлення з email-сповіщень phpBB. У SEO-дружньому режимі посилання на кшталт /t123?e=1&view=unread#unread тепер відкриває адресу повідомлення на основі теми, наприклад /t123#p456 або /t123-20#p456 для наступної сторінки, замість того щоб залишати в адресному рядку браузера пряме посилання /p456#p456.
Версія 1.0.6 виправляє посилання схвалення повідомлень, що очікують модерації. Коли адміністратор схвалює перше повідомлення нової теми, адреса повернення тепер веде на коротку адресу теми, наприклад /t123, замість помилкової адреси /t123&p=456#p456. Посилання схвалення наступних відповідей зберігають відповідну адресу повідомлення з урахуванням пагінації теми та налаштованих шаблонів URL.
Після створення теми або редагування її першого схваленого повідомлення посилання повернення веде на коротку URL-адресу теми. Після збереження відповіді або редагування іншого повідомлення користувач повертається саме до цього повідомлення з правильним зсувом пагінації та одним якорем.
SEO-дружній режим видаляє sid із публічних URL-адрес форуму та використовує файли cookie для підтримки авторизованих сесій. Тому файли cookie мають бути ввімкнені, а налаштування cookie на форумі — правильними. URL-адреси панелі адміністратора й посилання виходу зберігають захисні ідентифікатори сесій, необхідні phpBB. У режимі сумісності використовується стандартна обробка ідентифікаторів сесій.
Приклади, показані в панелі адміністратора, автоматично відповідають налаштованим шаблонам URL-адрес тем і прямих посилань на повідомлення.
Без змін ядра phpBB
Clean URLs працює як звичайне розширення phpBB і не потребує редагування PHP-файлів ядра чи шаблонів phpBB.
Єдине необхідне налаштування на стороні сервера — правила переписування URL для Apache, LiteSpeed або nginx.
Вимкнення або видалення розширення
Якщо вимкнути Clean URLs, phpBB повернеться до стандартного формату URL-адрес. Ідентифікатори форумів, тем, повідомлень і користувачів не змінюються.
Якщо ви остаточно видаляєте розширення, також видаліть правила переписування URL, які було додано до .htaccess або конфігурації nginx.
Історія змін
1.0.7
- Виправлено посилання на перше непрочитане повідомлення з email-сповіщень phpBB у SEO-дружньому режимі. URL-адреси на кшталт
/t123?e=1&view=unread#unreadтепер ведуть на короткі адреси повідомлень на основі теми, наприклад/t123#p456, замість того щоб залишатися на/p456#p456. - Виправлено URL-адресу
U_MINI_POST, яку використовують якір непрочитаного повідомлення phpBB та JavaScript для оновлення адресного рядка браузера. - Збережено пагінацію тем, власні шаблони URL-адрес тем, наявні прямі посилання на повідомлення та перенаправлення після схвалення модератором.
- Змінювати правила переписування URL для Apache/LiteSpeed або nginx, налаштування розширення чи файли ядра phpBB не потрібно.
1.0.6
- Виправлено некоректні перенаправлення після схвалення через MCP, коли phpBB додавав
&p=POST_ID#pPOST_IDдо вже короткої URL-адреси теми та поміщав результат у закодований параметрredirect. - Після схвалення першого повідомлення теми, що очікувала модерації, адміністратор повертається на коротку URL-адресу теми, наприклад
/t123, замість/t123&p=456#p456. - Збережено адреси конкретних повідомлень після схвалення наступних відповідей з урахуванням пагінації, вибраного режиму посилань і власних шаблонів URL.
- Інші дії MCP, коректні перенаправлення, токени підтвердження та параметри, важливі для безпеки, залишено без змін.
Під час оновлення з 1.0.5 до 1.0.6 змінювати чинні робочі правила переписування URL для Apache/LiteSpeed і nginx не потрібно.
1.0.5
- Виправлено неправильні перенаправлення після перенесення теми до іншого форуму через швидку модерацію phpBB. Тепер браузер відкриває коротку URL-адресу теми, наприклад
/t123, замість помилкової адреси/.%2Ft123. - Усунено подвійне URL-кодування параметра
redirect, уже закодованого phpBB. - Збережено закодовані параметри запиту в перенаправленнях та коректну обробку знака плюс без впливу на власні шаблони URL-адрес або інші параметри адрес.
Під час оновлення з 1.0.4 до 1.0.5 змінювати чинні робочі правила переписування URL для Apache/LiteSpeed і nginx не потрібно.
1.0.4
- Збережено явно вказаний параметр
t=TOPIC_ID, коли сторонні розширення створюють посилання на останнє повідомлення, що містять одночасноt=TOPIC_IDіp=POST_ID. - Покращено сумісність із Precise Similar Topics 1.8.0 і RH Topic Tags 3.0.0: такі посилання зберігають канонічний формат теми, наприклад
t123#p456, замість скорочення доp456#p456. - Виправлено посилання в результатах пошуку з параметром
hilit: адреси на кшталтviewtopic.php?t=123&hilit=...перетворюються наt123?hilit=...зі збереженням підсвічування пошукового запиту.
Під час оновлення з 1.0.3 до 1.0.4 змінювати чинні робочі правила переписування URL для Apache/LiteSpeed і nginx не потрібно.
1.0.3
- Видалено ідентифікатори сесій із публічних URL-адрес форуму в SEO-дружньому режимі, зокрема з навігаційних посилань, форм надсилання повідомлень і цільових адрес перенаправлень.
- Збережено захисні ідентифікатори сесій для панелі адміністратора та виходу, а також стандартну обробку сесій у режимі сумісності.
- Виправлено дубльовані якорі повідомлень на кшталт
#p456#p456у посиланнях і перенаправленнях після збереження повідомлень. - Виправлено URL-адресу повернення після створення теми або редагування її першого схваленого повідомлення: тепер вона веде на коротку адресу теми.
- Виправлено повернення до збереженої відповіді або відредагованого повідомлення, яке не є першим у темі, зокрема на наступних сторінках теми.
- Виправлено перенаправлення з прямих URL-адрес повідомлень, наприклад
/p456#p456, на відповідну адресу теми з правильним зсувом пагінації та якорем повідомлення в SEO-дружньому режимі. - Збережено наявні зсуви пагінації тем під час обробки коротких посилань на повідомлення.
- Покращено обробку перенаправлень із прямих посилань на повідомлення для власних шаблонів URL-адрес і форумів, установлених у підкаталогах.
- Виправлено відносні навігаційні посилання ACP завдяки виключенню адміністративних запитів із переписування URL і видалення ідентифікаторів сесій.
Під час оновлення з 1.0.2 до 1.0.3 змінювати чинні робочі правила переписування URL для Apache/LiteSpeed і 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-адресами через тему.
- Додано динамічне формування правил переписування URL для Apache/LiteSpeed і nginx у панелі адміністратора.
- Додано можливість скидання налаштувань Clean URLs до стандартних значень.
- Виправлено URL-адреси пагінації списку учасників, наприклад
/memberlist-50. - Виправлено URL-адреси пагінації тем, наприклад
/t123-20. - Виправлено обробку пагінації форумів і списку учасників за алфавітом.
- Виправлено дубльовані якорі повідомлень на кшталт
#p456#p456. - Покращено сумісність прямих посилань на повідомлення.
- Збережено підтримку всіх мовних пакетів, що входять до комплекту.
1.0.0
- Перший публічний випуск.
- Додано короткі URL-адреси для тем, форумів, повідомлень, профілів, списків учасників, сторінок пошуку та користувачів онлайн.
- Додано правила переписування URL для Apache/LiteSpeed і nginx.
- Додано підтримку встановлення phpBB у корені домену та в підкаталогах.
Завантаження
Поточна версія: 1.0.7
Коментарі (0)