Панель шорткодів
Для чого це потрібно?
Панель шорткодів з'являється під редактором Тіла email у вікні Email-дії. Вона надає кнопки миттєвого копіювання для динамічних плейсхолдерів (шорткодів), які підставляють дані конкретної події та підписника у ваші листи. Коли лист відправляється, кожен шорткод замінюється реальними даними — посиланням на подію, назвою події, часом старту, ідентичністю підписника або кнопками календаря. Це дозволяє написати один шаблон, який автоматично персоналізується для кожного отримувача.
Де знайти
- Відкрийте вікно Email-дії (створити нову або редагувати існуючу).
- Перейдіть до поля Тіло email (багатий текстовий редактор).
- Під панельлю інструментів редактора ви побачите секцію з назвою "Панель шорткодів" з кольоровими кнопками-іконками.
Доступні шорткоди
| Кнопка | Шорткод | Вставляє | Коли використовувати |
|---|---|---|---|
| Іконка посилання (зелена) | {eventLink} |
Клікабельне посилання на подію/форму реєстрації | "Приєднатися до події", "Зареєструватися тут", "Переглянути деталі" — будь-яке посилання-заклик до дії |
| Іконка календаря (зелена) | {eventTime} |
Дата та час старту події (відформатовані) | "Подія починається {eventTime}", "Чекаємо вас {eventTime}" |
| Іконка назви (зелена) | {eventName} |
Назва/заголовок події | "Ласкаво просимо до {eventName}!", "Ваше підтвердження для {eventName}" |
| Іконка користувача (зелена) | {userIdentity} |
Ідентифікатор підписника (ім'я/email) | "Привіт, {userIdentity}!", "Шановний {userIdentity}" — особисте привітання |
| Іконка календаря+ (зелена) | {addToCalendar} |
Кнопки Google Calendar + Outlook (перезаповнені даними події) | "Додайте до календаря:" — дозволяє отримувачам миттєво зберегти подію |
Як використати шорткод
- Поставте курсор у редакторі Тіла email там, де потрібен динамічний контент.
- Натисніть кнопку потрібного шорткоду на панелі.
- Текст шорткоду (напр.,
{eventLink}) скопіюється у буфер обміну. - З'явиться toast-повідомлення: "Успішно скопійовано: [назва шорткоду]".
- Вставте (Ctrl/Cmd+V) у позицію курсора в редакторі.
- Шорткод з'явиться у вашому тексті. Форматуйте як звичайний текст (жирний, колір, посилання тощо).
Порада: Можна вставити той самий шорткод кілька разів — кожен клік копіює його свіже в буфер.
Деталі та поведінка кожного шорткоду
{eventLink}
- Замінюється на: Повне публічне URL посилання на подію/сторінку реєстрації.
- Типове використання: Обгорнути в посилання:
<a href="{eventLink}">Зареєструватися</a>або вставити як чисте URL. - Працює для: Усіх типів отримувачів (Підписник, Власник, Спеціальний email).
{eventTime}
- Замінюється на: Відформатована дата/час старту події (напр., "15 червня 2024 о 10:00").
- Часовий пояс: Використовує налаштований часовий пояс події.
- Працює для: Усіх типів отримувачів.
{eventName}
- Замінюється на: Точну Назву події, введену в Конструкторі подій.
- Працює для: Усіх типів отримувачів.
{userIdentity}
- Замінюється на: Відображуваний ідентифікатор підписника — зазвичай ім'я, якщо надано, інакше email.
- Видимість: Приховано з панелі, коли Одержувач = Власник. Показується лише для Підписника та Спеціального email.
- Причина: Листи Власнику не мають контексту конкретного підписника — організатор і так знає, хто він.
{addToCalendar}
- Замінюється на: Дві стилізовані кнопки — Google Calendar та Outlook — кожна з предзаповненим
.icsпосиланням, що містить назву, дату/час та опис події. - Типове використання: Вставити на окремому рядку: "Збережіть дату: {addToCalendar}"
- Працює для: Усіх типів отримувачів.
Важливі правила та поради
Примітка: Шорткоди чутливі до регістру і повинні включати фігурні дужки. Вводьте або вставляйте точно як показано:
{eventLink},{eventTime},{eventName},{userIdentity},{addToCalendar}.
Робота копіювання-вставки: Кнопки копіюють у буфер — вони НЕ автоматично вставляються в редактор. Ви маєте вставити (Ctrl/Cmd+V) у позицію курсора. Це дає повний контроль над розташуванням та форматуванням.
Залежність від отримувача: Кнопка Ідентичність користувача (
{userIdentity}) зникає з панелі, коли ви змінюєте Одержувача на Власник в тому ж вікні. Переключіть назад на Підписника або Спеціальний email — кнопка з'явиться знову.
Ліміт символів: Шорткоди рахуються у ліміті 300 символів Тіла їхньою сирою довжиною (напр.,
{eventLink}= 11 символів). Фінальний відображений лист буде довшим після підстановки — це нормально.
Попередній перегляд: Використовуйте кнопку Попередній перегляд Email (зелена кнопка "preview email" у вікні), щоб побачити, як виглядає лист із розв'язаними шорткодами для тестового отримувача.
Шаблони: Шорткоди працюють у будь-якому шаблоні. Шаблон задає лейаут; шорткоди дають динамічні дані.
Поширені запитання та виправлення неполадок
Я натиснув кнопку, але нічого не з'явилось в редакторі. Кнопка копіює в буфер. Ви маєте вставити (Ctrl/Cmd+V) у позицію курсора в редакторі. Перевірте буфер — текст шорткоду має там бути.
Відсутня кнопка Ідентичність користувача. Сподіваєтесь, ви обрали Одержувач = Власник. Змініть на Підписник або Спеціальний email — кнопка з'явиться.
Чи можу я вводити шорткоди вручну замість кнопок?
Так. Вводьте їх точно з дужками: {eventLink}, {eventTime}, тощо. Кнопки — лише зручність для уникнення помилок.
Що, якщо подія не має посилання/назви/часу? Система дозволяє зберегти email-дію лише після вибору Шаблону Email. Контекст події шаблону надає дані. Якщо даних події немає, шорткод розв'язується в порожній рядок або placeholder — переконайтеся, що ваша подія повністю налаштована.
Чи працюють шорткоди в рядку Теми email? Ні. Шорткоди працюють лише в редакторі Тіла Email. Поле Теми — лише простий текст.
Чи можу я стилізувати кнопки календаря?
Шорткод {addToCalendar} рендерить попередньо стилізовані Google/Outlook кнопки. Ви не можете кастомизувати їх вигляд через редактор — вони використовують системний дефолт для максимальної сумісності.
Що станеться, якщо я відправлю на Спеціальний email?
{eventLink},{eventTime},{eventName},{addToCalendar}→ розв'язуються нормально з даними події.{userIdentity}→ розв'язується в введену вами спеціальну email-адресу (оскільки профілю підписника немає).