xF2 Add-on - [IT] Auto Alt & Title Image Attributes | Форум вебмастеров

Compatible XF 2.x versions

Additional requirements

PHP 8.2
PHP 8.3
PHP 8.4

itnull.me - [IT] Auto Alt & Title Image Attributes

[IT] Auto Alt & Title Image Attributes
Автоматические атрибуты alt и title для изображений и вложений вместо имени файла
XFRM: поддерживается

Зачем это нужно

По умолчанию XenForo подставляет в alt и title картинок имя файла — IMG_20240512_183455.jpg, photo_2019-02-06_00-33-38.jpg и т. п. Поисковые системы не получают из этого никакой полезной информации, а посетители видят бессмысленную всплывающую подсказку.

Дополнение автоматически заменяет имя файла на осмысленный текст по вашему шаблону, например:

HTML:

<!-- было -->
<img src="..." alt="photo_2019-02-06_00-33-38.jpg" title="photo_2019-02-06_00-33-38.jpg">

<!-- стало -->
<img src="..." alt="[MySite.com] Настройка Nginx на FreeBSD" title="[MySite.com] Настройка Nginx на FreeBSD">

Используется для SEO: изображения получают релевантные атрибуты, которые индексируются в поиске по картинкам Google и Яндекс.

Возможности

Изображения [ATTACH] — миниатюры и полноразмерные, включая подпись в лайтбоксе.
Изображения [IMG] — внешние картинки по ссылке.
Список вложений под сообщением — миниатюры файлов, не вставленных в текст.
Сообщения форума и ресурсы XFRM (описание и обновления ресурса).
Белый список форумов и белый список категорий ресурсов — пустой список означает «везде».
Гибкий формат с переменными — отдельно для вложений и для [IMG].
Уважение к автору: если в BB-коде задан свой alt/title, он сохраняется. Опция «Перезаписывать» включается отдельно для [ATTACH] и [IMG].
Alt, который редактор XenForo сам вставляет как имя файла, не считается авторским и всегда заменяется.
Русский и Украинский переводы настроек ставятся автоматически.

Переменные формата

Переменная	Вложения `[ATTACH]`	`[IMG]`	Описание
`{title}`	✔	✔	Заголовок темы или ресурса
`{filename}`	✔	—	Имя файла без расширения
`{extension}`	✔	—	Расширение без точки
`{file_size}`	✔	—	Размер файла
`{upload_date}`	✔	—	Дата загрузки
`{file_hash}`	✔	—	Хеш файла
`{attach_id}`	✔	—	ID вложения
`{user_id}`	✔	✔	ID загрузившего / автора сообщения
`{username}`	—	✔	Имя автора сообщения
`{thread_user_id}`	—	✔	ID автора темы (для ресурсов — автора ресурса)
`{thread_username}`	—	✔	Имя автора темы (для ресурсов — автора ресурса)

Пример формата: [MySite.com] {title} → [MySite.com] Настройка Nginx на FreeBSD

Настройки

Admin CP → Настройки → Опции → [IT] Auto Alt & Title Image Attributes

Применять alt и title для типов контента (сообщения / обновления ресурсов)
Белый список форумов
Белый список категорий ресурсов
Формат alt и title для вложений
Перезаписывать атрибуты тега [ATTACH]
Применять к списку вложений
Формат alt и title для тега [IMG]
Перезаписывать атрибуты тега [IMG]

Технические особенности

Не изменяет файлы ядра и не создаёт таблиц в базе данных.
Работает через штатное расширение классов XenForo: BB-код рендерер и сущность вложения.
Ничего не меняет в редакторе и письмах — атрибуты подставляются только при выводе на странице, текст сообщений в базе остаётся прежним.
Экранирование выполняют шаблоны ядра — защита от XSS через заголовки тем.
Без лишних запросов к БД: данные берутся из уже загруженных на странице сообщений, расчёт кэшируется на каждое сообщение.
Файл hashes.json для проверки целостности файлов в Admin CP.

Установка

Admin CP → Дополнения → Установить/обновить из архива → выбрать архив [IT] Auto Alt & Title Image Attributes 2.3.0.zip.
Либо вручную: загрузите содержимое папки upload в корень форума и нажмите «Установить» в списке дополнений.
Откройте настройки дополнения и задайте формат.

Обновление: установите новый архив поверх — настройки сохраняются.
Удаление: Admin CP → Дополнения → Удалить. Все данные дополнения удаляются автоматически.

Требования

XenForo 2.3.0 и выше
PHP 8.3 и выше
XenForo Resource Manager — по желанию, для ресурсов

Ваш стиль может использовать изменённый шаблон attachment_macros. Откройте Admin CP → Внешний вид → Модификации шаблонов → itnull_aat_attachment_list_alt и нажмите «Проверить». Атрибуты в BB-кодах [ATTACH] и [IMG] от шаблонов стиля не зависят.