> 🔖 Это руководство объясняет, как настроить и устранить неполадки с oneboxes в Discourse. Оно охватывает параметры администратора, принцип работы oneboxes и шаги по решению распространённых проблем.
>
> 🙋 Требуемый уровень пользователя: Администратор
Oneboxes — это расширенные предпросмотры ссылок, которые пользователи могут создавать в своих сообщениях. Хотя пользователи могут легко генерировать такие предпросмотры, администраторы сайта имеют дополнительные возможности управления и могут нуждаться в устранении неполадок, когда ссылки не отображаются как ожидалось.
## Настройка администратора
Для управления параметрами onebox:
1. Перейдите в панель администратора
2. Перейдите в раздел настроек сайта
3. Найдите “onebox”
Вы увидите список параметров, связанных с onebox:
Некоторые важные параметры:
- `post onebox maxlength`: Контролирует объём текста, включаемого в onebox
- `max oneboxes per post`: Ограничивает количество oneboxes, которые могут отображаться в одном сообщении (по умолчанию: 50)
- `enable inline onebox on all domains`: Включает встроенные oneboxes для всех доменов, преобразуя простые URL в связанные заголовки (например, `https://en.wikipedia.org/wiki/Fun_(band)` становится “Fun (band) - Wikipedia”). Включено по умолчанию.
- `blocked onebox domains`: Позволяет отключить oneboxes для конкретных доменов
- `block onebox on redirect`: При включении предотвращает создание onebox для URL, которые перенаправляют на другое место назначения
## Как работают oneboxes
Когда в сообщение включена ссылка, Discourse посещает целевую страницу и ищет теги [Open Graph](http://ogp.me/) или [oEmbed](https://oembed.com/), включая:
- Адрес сайта
- Заголовок
- Изображение-обложка
- Иконка сайта (или favicon)
- Описание (обязательно)
- Цена товара (если применимо)
> ⚠ Discourse требует, чтобы тег описания присутствовал и содержал достаточно текста для краткого изложения страницы. Без этого целевая ссылка не будет преобразована в onebox.
Вот пример onebox для [https://discourse.org](https://discourse.org), отображающий заголовок сайта, изображение-обложку, иконку и описание:
> **[Where Tech Companies Build Communities](https://discourse.org/)**
>
> The customizable, scalable community platform powering over 22,000 communities. Create knowledge through conversation.
## Устранение неполадок
Если oneboxes не работают как ожидалось, попробуйте следующие шаги:
1. Протестируйте сайт с помощью [iFramely](https://iframely.com/embed):
2. Проверьте, не блокируется ли запрос onebox:
3. Для внутренних ссылок, которые не отображаются как oneboxes:
Из консоли Rails вы можете явно инвалидировать/получить oneboxes, вызвав [соответствующие методы](https://github.com/discourse/discourse/blob/main/lib/oneboxer.rb) во время тестирования:
```plaintext
[1] pry(main)> Oneboxer.invalidate(url)
=> 0
[2] pry(main)> Oneboxer.onebox(url)
=> "