Модули

Понимание композиций

Оба формата поддерживают предпросмотр, цвета, изображения, несколько встроенных сообщений, раскрытие, копирование, удаление и перестановку. V1 использует фиксированные поля Discord, V2 — свободные блоки. Следующие разделы объясняют доступные настройки и различия.

Название композиции используется только для управления в личном кабинете и не отправляется в Discord. На одном сервере можно хранить до 50 композиций с именами длиной не более 50 символов каждая.

Компоненты V1 / V2

Новые композиции начинаются с V2.

Выберите V1 или V2 до первого сохранения. После сохранения версия неизменна, даже для черновика или после удаления публикации. Для другого формата создайте новую композицию. Копирование сохраняет версию. Сохранённые сообщения V1 не преобразуются и не удаляются автоматически.

V1

V1 использует классические встроенные сообщения Discord с цветом и фиксированными областями. Допускается десять сообщений. В таблице указано максимальное число символов. Автор, заголовок, описание, подпись и все названия и значения полей вместе ограничены 6000 символами для всех встроенных сообщений. Обычный текст имеет отдельный лимит. В каждом сообщении V1 допускается до 25 полей.

Все области оформления необязательны. После добавления поля обязательны его название и значение. Удаляйте неиспользуемые поля. Размещение рядом включает поля в строку, окончательная раскладка зависит от Discord и ширины экрана. Ссылка или значок автора требуют имени автора, ссылка заголовка — заголовка, значок подписи — текста подписи. Необязательные ссылки должны быть полными адресами HTTP(S). Временная метка показывает момент отправки.

Выбор ролей и каналов доступен в обычном тексте, описании V1 и значениях полей. В авторе, заголовке, подписи и названиях полей таких инструментов нет. Эмодзи сервера можно использовать в этих текстах. URL автора и ссылка заголовка принимают только URL, без ролей, каналов и эмодзи. Упоминания в классических встроенных сообщениях не уведомляют участников.

Кнопки-ссылки

V2 объединяет до пяти кнопок ссылок в строке действий. Вместо ограничения V1 в пять строк действует общий бюджет компонентов.

Кнопки ссылок открывают сайты и не назначают роли. Каждая добавленная кнопка требует подписи до 80 символов и полного URL HTTP(S) до 512 символов. Эмодзи необязателен. Кнопки можно перемещать и удалять. V1 показывает их под встроенными сообщениями, до пяти кнопок в строке и пяти строк всего, то есть до 25 кнопок. V2 размещает их в соответствующем контейнере, считая кнопки и строки в бюджете 40.

Создать композицию

Внутреннее название обязательно даже для сохранения черновика. Редактор допускает до 50 символов. Новая композиция получает предложенное название, которое можно изменить. Оно видно только в панели. Публикация требует доступного канала и видимого текста, встроенного сообщения или полной кнопки ссылки. Описание или изображение не требует заголовка. Пустому черновику пока не нужно содержимое.

Необходимые права в Discord

В V1 упоминания в обычном тексте могут уведомлять, а классические встроенные сообщения — нет. В V2 текстовые блоки также могут вызывать упоминания. Для @everyone, @here и ролей, недоступных для общего упоминания, требуется соответствующее разрешение Discord. Проверьте упоминания перед публикацией.

Для публикации нужны просмотр канала и отправка сообщений. Встраивание ссылок необходимо для классических встроенных сообщений и их изображений. Прикрепление файлов требуется при разовой отправке локальных изображений. Сохранение черновика ещё не публикует сообщение Discord.

1. Откройте Встроить на панель управления.
2. Выберите Новая композиция и присвойте ей внутреннее имя.
3. При необходимости добавьте обычное содержимое сообщения.
4. Разработайте первое внедрение и при необходимости добавьте дополнительные.
5. Проверьте результат в предварительном просмотре Discord.
6. Выберите целевой канал для публикации или оставьте канал пустым, чтобы сохранить только черновик.

Содержимое сообщения

Обычное содержимое сообщения отображается над встраиванием и может содержать до 2000 символов. Роли, каналы и смайлы сервера можно использовать, выбрав их в редакторе.

В V1 упоминания в обычном тексте могут уведомлять, а классические встроенные сообщения — нет. В V2 текстовые блоки также могут вызывать упоминания. Для @everyone, @here и ролей, недоступных для общего упоминания, требуется соответствующее разрешение Discord. Проверьте упоминания перед публикацией.

Встраиваемый дизайн

Discord показывает значок автора только если указано имя автора. Введите имя выше, чтобы значок появился в предпросмотре. Discord показывает значок подвала только если указан текст подвала. Введите текст выше, чтобы значок появился в предпросмотре.

V2

Блок изображения может содержать галерею из десяти изображений. «+ Ещё изображение» добавляет изображения, которые можно удалять отдельно. Для каждого изображения и миниатюры доступны необязательное описание до 80 символов и настройка спойлера. Раздел поддерживает три текста до 4000 символов каждый. «+ Ещё текст» добавляет до двух дополнительных текстов. В поле «Дополнение» выберите миниатюру или кнопку-ссылку. Кнопке необходимы надпись до 80 символов и полный HTTP(S)-адрес до 512 символов. Эмодзи и отключение необязательны. Дополнительные тексты и кнопка учитываются в лимите компонентов. Отдельные изображения галереи не считаются дополнительными компонентами.

В V2 контейнеры и изображения, включая миниатюры, можно пометить как спойлеры. Их содержимое скрыто и раскрывается по нажатию.

V2 предлагает десять контейнеров с отдельными цветами. Используйте текстовые блоки или разделы с необязательной миниатюрой справа, каждый до 4000 символов с Markdown. Разделители показывают линию или только маленький либо большой отступ. Добавляйте, копируйте, удаляйте и перемещайте блоки стрелками. Пустые текстовые блоки и изображения не создают видимого содержимого. В текстах V2 доступны выбор ролей, каналов и эмодзи сервера.

В V2 нет классических полей автора, ввода ссылки заголовка, полей в строку, значков подписи и переключателя времени. Заголовки и ссылки оформляются Markdown. Пример ниже создаёт мелкую подпись, токен времени — временную метку. В V1 нет свободно размещаемых блоков V2. Форматы нельзя смешивать в одном сообщении.

-# ... · {time.full}

V2 ограничен 40 компонентами на всё сообщение. Учитываются контейнеры, тексты, разделы, миниатюры, галереи, разделители, строки действий, кнопки и меню. Варианты меню не считаются отдельно. Автоматически добавленные разделители и элементы управления тоже учитываются. Например, контейнер с текстом, изображением, разделителем и кнопкой со строкой действий использует шесть компонентов. Поэтому нельзя неограниченно заполнить все десять контейнеров.

Использовать изображения

Лимиты изображений применяются к каждому файлу. В V1 значок автора, миниатюра и значок подписи допускают по 5 MB. Лимит большого изображения совпадает с указанным ниже лимитом блоков V2. Поддерживаются PNG, JPG/JPEG, WebP и GIF. Выбор файла заменяет изображение, удаление очищает слот. Значки автора и подписи невидимы без соответствующего текста.

Выбирайте PNG, JPG/JPEG, WebP или GIF. Изображения загружаются при сохранении. Для миниатюр предел 5 MB, для блоков изображений — 10 MB. Разовая отправка в модуле встраиваний допускает десять локальных изображений общим объёмом 20 MB.

Сохранить и опубликовать

Если управляемое сообщение уже отсутствует в Discord, повторное сохранение публикует его заново. Копия сохраняет формат, но начинается без канала публикации и независима от оригинала.

Сохранить как черновик

Оставьте поле выбора канала пустым и сохраните. Черновик остается доступным на панели управления без создания сообщения Discord.

Опубликовать навсегда

Выберите канал и сохраните. Созданное сообщение Discord остается связанным с композицией. Последующие изменения будут обновлены в том же сообщении при сохранении.

Отложить публикацию

Если вы выберете другой канал для уже опубликованной композиции, при следующем ее сохранении сначала будет создано новое сообщение, а затем старое будет удалено.

Удалить публикацию

Удалить сообщение удаляет только управляемое сообщение Discord. Композиция остается сохраненным черновиком.

Удалить композицию

Удаление композиции удаляет сохранённую запись и её изображения. Уже отправленное сообщение Discord остаётся и может потерять ссылки на изображения. Чтобы удалить и управляемое сообщение, сначала явно удалите публикацию. Разовые сообщения не управляются после отправки.

Управление и дублирование

Сохраненные композиции можно открывать, переименовывать, дублировать и удалять. В композиции можно создавать, переставлять и дублировать до десяти вложений. Дублирование предотвращается, если это приведет к превышению ограничений Discord по количеству или тексту.

Внутри модуля можно переключаться между композициями и обзором. Несохранённые изменения сохраняются в редакторе. Перед выходом из модуля сохраните или отмените все незавершённые изменения. Общая панель сохранения остаётся видимой и в обзоре. Сохранение применяет все незавершённые изменения композиций, а отмена сбрасывает их. Это касается и композиций, которые сейчас не открыты.

Исправить ошибки

Подстановки композиций

Используйте следующие подстановки в обычном тексте обеих версий и классических полях V1. Они заменяются при отправке или обновлении, не непрерывно. Подстановки сервера, канала и бота сейчас не заменяются в блоках V2. Там работает описанный выше токен времени. Подстановки участника и динамические аватары относятся к приветствию.

Требования и ограничения

Необязательно заполнять все области оформления. Один цвет или пустые блоки не заменяют видимое содержимое для публикации. Предпросмотр не отправляет сообщение и не заменяет проверку в целевом канале. Ни один редактор не предлагает опросы, стикеры, формы или программируемые действия. Данные и возможности редактирования зависят также от предоставленных прав панели.

Предпросмотр, спойлеры и файлы изображений

В предпросмотре V2 одиночное изображение галереи сохраняет пропорции. Несколько изображений образуют сетку с одинаковыми областями обрезки 16:9. Два или четыре изображения занимают два столбца, три и от пяти до десяти — три столбца. Миниатюра находится справа от текста раздела. Описание изображения используется как альтернативный текст, а не как дополнительная видимая подпись.

Переключатели спойлеров изображений и контейнеров относятся к редактору V2. Изображения галереи и миниатюры можно скрывать независимо. Спойлер контейнера скрывает содержимое, оставляя внешнюю рамку видимой. Щелчок раскрывает предпросмотр, не меняя сохранённую настройку. Участники также могут раскрывать спойлеры щелчком в Discord.

Для изображений сообщений поддерживаются PNG, JPG/JPEG, WebP и GIF. Тип файла должен соответствовать содержимому. Изменение расширения HTML- или SVG-файла не превращает его в поддерживаемое изображение. Ограничения из таблиц по-прежнему действуют для каждого файла. Если локальное изображение отклонено или больше не читается, снова выберите исходный файл и сохраните изменения.

Текстовые области Markdown поддерживают веб-ссылки и ссылки электронной почты. Предпросмотр открывает HTTP(S) и mailto, но не локальные файлы и адреса Blob. Ссылки автора, заголовка и кнопки ссылок требуют полных HTTP(S)-адресов. Предпросмотр не публикует сообщение. Проверьте сохранённый результат в Discord, где вид может зависеть от клиента и ширины экрана.