Schema for phpBB — безкоштовне розширення для phpBB 3.3.x від ButtonPusher, яке додає структуровані дані Schema.org DiscussionForumPosting на сторінки тем форуму.
Розширення розроблене з урахуванням вимог Google до структурованих даних форумів і використовує мікророзмітку (Microdata), безпосередньо пов’язану з уже видимим вмістом сторінки. Повний текст повідомлень і відповідей не дублюється в окремому блоці JSON-LD.
Підтримка та обговорення на phpBB.com: тема розширення Schema for phpBB.
Можливості
- Розмітка Schema.org
DiscussionForumPostingдля сторінок тем phpBB. - Відповіді на поточній сторінці теми подаються як елементи
Comment, якщо містять підтримуваний текст або зображення. - Заголовок теми та її канонічна URL-адреса.
- Ім’я автора та посилання на його профіль, якщо вони доступні.
- Публічні URL-адреси профілів зареєстрованих користувачів.
- Підтримка повідомлень гостей і видалених користувачів, зокрема локалізованих резервних імен без некоректних посилань на профілі.
- Дати публікації та редагування.
- Повний видимий текст повідомлення передається через Microdata без дублювання в HTML-коді сторінки.
- Кількість відповідей через
commentCount. - Кількість переглядів теми за допомогою
InteractionCounterіViewAction. - Інформація про форум, до якого належить тема.
- Зображення, вбудовані в повідомлення, додаються до властивості
image. - Для вкладених зображень phpBB використовується URL повнорозмірного файлу, а не згенерованої мініатюри.
- Смайлики phpBB та службові піктограми виключаються з властивості Schema.org
image. - Відповіді, що містять лише смайлики, не додаються до розмітки
Comment, щоб уникнути попередження Google про відсутністьtext,imageабоvideo. Водночас вони враховуються вcommentCount. - Підтримка тем із кількома сторінками.
- Коректна обробка тем, у яких початкове повідомлення видалене, приховане або недоступне з інших причин.
- Сумісність із ButtonPusher Clean URLs, якщо це розширення ввімкнене.
- Без додаткових таблиць бази даних і міграцій.
- Не потребує налаштувань у панелі адміністрування.
- Не змінює файли ядра phpBB.
Як це працює
Повідомлення на форумі можуть містити багато тексту. Копіювання всієї теми та кожної відповіді в окремий блок JSON-LD призвело б до непотрібного дублювання вмісту в згенерованому HTML.
Натомість Schema for phpBB позначає вже відображений текст повідомлення властивістю Schema.org text і пов’язує його з відповідним елементом DiscussionForumPosting або Comment.
Завдяки цьому структуровані дані безпосередньо пов’язані з тим, що бачать відвідувачі, а в HTML-коді сторінки не з’являється друга копія кожного повідомлення.
Теми та відповіді
Перше повідомлення використовується як основний елемент DiscussionForumPosting, якщо його вміст доступний. Відповіді, показані на поточній сторінці, додаються як елементи Comment, якщо містять підтримуваний текст або зображення.
Відповіді, що містять лише смайлики phpBB, не створюють елементів Comment. HTML-атрибут alt смайлика не вважається видимим текстом повідомлення, а декоративні смайлики не визначаються як змістові зображення. Такі відповіді й надалі враховуються в commentCount.
Якщо початкове повідомлення видалене, приховане або недоступне на першій сторінці теми з інших причин, розширення не створює неповний елемент DiscussionForumPosting без коректної властивості text, image або video. Це запобігає критичним помилкам структурованих даних без вигадування відсутнього вмісту.
У темах із кількома сторінками основний запис і далі посилається на першу сторінку теми, а відповіді використовують свої постійні URL-адреси. Якщо ButtonPusher Clean URLs встановлено та ввімкнено, Schema for phpBB автоматично використовує відповідні людино-зрозумілі адреси тем, форумів, профілів і повідомлень.
Зображення
Розширення додає до властивості Schema.org image лише справжні зображення, що є частиною вмісту повідомлення.
Вбудовані зображення та вкладені графічні файли phpBB визначаються автоматично. Для вкладень використовується URL повнорозмірного зображення замість технічної мініатюри, згенерованої phpBB.
Смайлики, піктограми та подібні елементи інтерфейсу навмисно виключені, оскільки вони не є зображеннями, що представляють зміст повідомлення. Відповіді, які містять звичайний текст разом зі смайликами, як і раніше, можуть отримувати розмітку Comment.
Для теми, що містить лише текст, Google Rich Results Test може показувати попередження Missing field "image" (optional). Це очікувана поведінка, яка не робить структуровані дані недійсними.
Старі повідомлення з відео
Деякі старі інтеграції [video] у phpBB виводять у серверному HTML лише заповнювач відеопрогравача та не надають достатньо відомостей для створення коректного об’єкта Schema.org VideoObject.
Тому відповідь, яка містить лише такий старий відеовіджет, не додається як окремий елемент Comment, якщо в ній немає також підтримуваного тексту або зображень. Водночас ця відповідь враховується в commentCount.
Це дозволяє уникнути неповної розмітки Comment без коректного значення text, image або video.
Системні вимоги
- phpBB 3.3.0 або новіша версія в межах серії phpBB 3.x.
- PHP 7.2 або новіша версія.
Підтримувані мови
Розширення містить мовні пакети для чеської, німецької, англійської, іспанської, французької, івриту, італійської, польської, португальської, бразильської португальської, російської, турецької та української мов.
Встановлення
- Завантажте архів розширення.
- Розпакуйте його до каталогу вашого phpBB так, щоб файли розширення розташовувалися за шляхом:
ext/buttonpusher/schema/ - Відкрийте панель адміністрування phpBB.
- Перейдіть до розділу Customise → Manage extensions.
- Знайдіть ButtonPusher Schema for phpBB Forums і натисніть Enable.
- Очистьте кеш phpBB.
Щоб оновити вже встановлене розширення, вимкніть його без видалення даних, замініть файли новою версією, знову ввімкніть розширення та очистьте кеш phpBB. Якщо PHP продовжує використовувати стару версію файлу з кешу, також очистьте PHP OPcache.
Змінювати файли ядра phpBB, шаблони або базу даних не потрібно.
Перевірка розмітки
Після встановлення відкрийте загальнодоступну тему та перевірте її URL-адресу за допомогою Google Rich Results Test або Schema.org Markup Validator.
Рекомендується перевірити різні типи тем: повідомлення лише з текстом, теми з кількома відповідями, відповіді тільки зі смайликами, текст зі смайликами, вкладені та вбудовані зображення, багатосторінкові обговорення, а також теми з видаленим або недоступним початковим повідомленням.
Відповіді, що містять лише смайлики, не повинні відображатися як неповні елементи Comment, але мають враховуватися в загальному значенні commentCount.
Версія 1.0.2
- Усунено попередження Google Search Console для
CommentSpecify "text", "image" or "video", яке виникало у відповідях, що містять лише смайлики phpBB. - Виправлено визначення вмісту: атрибут
altзображення смайлика більше не сприймається як справжній текст повідомлення. - Відповіді лише зі смайликами виключено з мікророзмітки
Commentзамість створення порожньої властивостіtextабо використання декоративних піктограм як змістових зображень. - Збережено повний підрахунок відповідей у
commentCount, включно з відповідями лише зі смайликами, які не потрапляють до структурованих елементівComment. - Збережено коректну обробку звичайних текстових відповідей, тексту зі смайликами, справжніх вбудованих зображень і графічних вкладень phpBB.
- Зміни бази даних і міграції не потрібні.
Версія 1.0.1
- Виправлено помилку відсутнього
author.nameу Schema.orgDiscussionForumPosting, коли ім’я автора початкового повідомлення порожнє або недоступне. - Додано локалізоване резервне ім’я гостя для авторів, чиї імена користувачів більше не вдається визначити.
- Покращено обробку видалених або недоступних облікових записів без створення некоректних посилань на профілі авторів.
- Усунено критичну помилку Google Rich Results Test Specify "text", "image" or "video" для тем, у яких початкове повідомлення більше недоступне.
- Припинено створення неповної розмітки
DiscussionForumPostingна першій сторінці теми, якщо початкове повідомлення відсутнє, приховане або видалене. - Збережено генерацію структурованих даних для звичайних і багатосторінкових тем.
- Покращено сумісність зі старими темами форумів, що містять видалені повідомлення або недоступних авторів.
- Зміни бази даних і міграції не потрібні.
Версія 1.0.0
- Перший публічний реліз.
- Додано мікророзмітку Schema.org
DiscussionForumPostingдля сторінок тем phpBB. - Додано структуровані дані про авторів, дати, відповіді, кількість переглядів і батьківські форуми.
- Додано визначення вбудованих зображень і графічних вкладень.
- Додано підтримку багатосторінкових тем.
- Додано сумісність із ButtonPusher Clean URLs.
- Смайлики phpBB виключено зі структурованих даних про змістові зображення.
- Покращено обробку старих відповідей, що містять лише відео, щоб уникнути некоректної розмітки
Comment. - Додано мовні пакети для чеської, німецької, англійської, іспанської, французької, івриту, італійської, польської, португальської, бразильської португальської, російської, турецької та української мов.
Завантаження
Завантажити Schema for phpBB 1.0.2
Поточна версія: 1.0.2
Ліцензія: GNU General Public License v2.0 only (GPL-2.0-only).
Коментарі (0)