Примечание:
Эта страница - компонент, используемый на данной вики. Он предназначен для включения в другие страницы.
Страница, объединяющая все компоненты в единый список, расположена по ссылке: Хаб компонентов.
Что это?
Данный компонент за авторством
Queerious позволяет добавлять в свою статью динамически форматируемые блоки сообщений электронной почты. Эти блоки оформлены под брендинг Фонда и позволяют добавлять аватарки для персонажей.
С помощью этого компоненты вы можете наслаждаться чистым аккуратным кодом для создания Email-сообщений не заморачиваясь с таблицами!
Для использования этого компонента следуйте описанным далее шагам.
Шаг 1 - Код
В начале своей страницы добавьте следующую строчку:
[[include component:dynamic-emails code=a]]
Эту строчку необходимо добавлять единожды за всю страницу.
Шаг 2 - Собственно, Email
Для добавления блока с сообщением вставьте следующий код:
[[include component:dynamic-emails-start
|from= отправитель@scp.int
|to= получатель@scp.int
|cc= копия@scp.int
|subject= Тема сообщения
]]
Сюда вписывается сырая разметка, представляющая собой тело вашего сообщения. Пишите здесь что угодно, хоть используйте пользовательское **оформление** или изменение ##red|цвета##. Никаких проблем возникнуть не должно.
[[include component:dynamic-emails-end
|name= Имя отправителя
|title= м.н.с.
|signoff= Обезопасить, Удержать, Сохранить
|signoff-icon= /local--files/component:dynamic-emails/Default_Profile_Icon.png
]]
Текста много, поэтому давайте разберём его по порядку.
Шаг 2.1: Открывающий include
Начало стартового include: ↦
Текст, отображающийся в поле 'От' ↦
Текст, отображающийся в поле 'Кому' ↦
Текст, отображающийся в поле 'Копия' ↦
Текст, отображающийся в поле 'Тема' ↦
Конец стартового include. ↦
[[include component:dynamic-emails-start
|from= отправитель@scp.int
|to= получатель@scp.int
|cc= копия@scp.int
|subject= Тема письма
]]
Вы можете поместить любой текст в поля выше, но со следующими ограничениями:
- Вы не можете форматировать текст в полях от/кому/копия используя CSS, так как они парсятся как обычный текст, чтобы не создавались гиперссылки.
Для изменения цвета текста в этих полях, используйте следующий код в своём модуле CSS:
.top-middle-box > .from-name-box, .to-name-box, .cc-text-box{
color: #b01;
}
Можно использовать любой цвет. Для изменения цвета лишь одного поля, уберите остальные упоминания 'name-box'.
ПРИМЕЧАНИЕ: Если вы хотите убрать поле 'копия', просто введите:
|cc=none
Это скроет соответствующие поля.
Шаг 2.2: Текст сообщения
Сюда вписывается само тело сообщения. Здесь можно использовать любое форматирование текста, например, гиперссылки. Вы также можете добавлять другие div'ы и остальные штуки. (Не гарантирую 100% что оно сработает, но должно!)
Этот раздел должен находится сразу после ]] из открывающего include:
Сюда вписывается сырая разметка, представляющая собой тело вашего сообщения. Пишите здесь что угодно, используя любое форматирование, никаких проблем возникнуть не должно! Дополнительно ничего делать тоже не нужно, просто пишите между открывающим и закрывающим includ'ами!
Шаг 2.3: Закрывающий include
Начало закрывающего include: ↦
Имя отправителя в подписи: ↦
Должность отправителя в подписи: ↦
Девиз в подписи ↦
URL-ссылка на аватар ↦
Конец закрывающего include. ↦
[[include component:dynamic-emails-end
|name= Имя отправителя
|title= м.н.с.
|signoff= Обезопасить, Удержать, Сохранить
|signoff-icon= https://URL.website
]]
В поля name, title и signoff вы можете вписывать что угодно с использованием стандартного форматирования CSS.
Конкретно 'signoff-icon' принимает URL изображения, размер которого будет корректироваться в соответствии с доступным пространством. Для вашего удобства, в компонент включён стандартный аватар, доступный здесь:
/local--files/component:dynamic-emails/Default_Profile_Icon.png
Если вы не хотите, чтобы какое-либо изображение появлялось, воспользуйтесь данной ссылкой, которая представляет собой прозрачное изображение. Если оставить это поле пустым, весь блок может отобразится некорректно.
/local--files/component:dynamic-emails/transparent.png
Если вы всё сделали правильно, у вас получится блок, выглядящий как-то так:
Бонусный шаг: Вариант с приложением
В качестве альтернативы, данный компонент также поддерживает создание сообщений с приложениями. Чтобы их добавить, используйте код ниже вместо шага 2.3:
[[include component:dynamic-emails-attachment-end
|name= Имя
|title= Должность
|signoff= Обезопасить, Удержать, Сохранить
|signoff-icon= /local--files/component:dynamic-emails/Default_Profile_Icon.png
|attachment= /local--files/component:dynamic-emails/Default_Profile_Icon.png
]]
Основные различия выделены полужирным в примере выше, но вас должно интересовать поле "|attachment=". Данное поле принимает любой URL изображения и будет отображаться следующим образом:
Само приложение — это спойлер, который при нажатии показывает прикреплённое изображение:
И напоследок...
Данный компонент должен быть совместим с любыми темами на Sigma, Basalt и BHL! Если вы столкнулись с техническими неполадками, пожалуйста, уведомьте
Queerious!
Исходный код доступен в исходнике страницы