Особисті повідомлення, зворотний зв'язок і «Запропонувати запис» на тегах
Які файли теми замінюють сторінки листування, форми зворотного зв'язку та пропозиції запису, і які теги в них працюють.
«Особисті повідомлення» (модуль «Повідомлення»)
Файли теми: views/messages/index.tpl.html (список розмов) і views/messages/thread.tpl.html (листування). Немає файлу — сторінка як раніше. Заготовки лежать у modules/messages/starters. Форми (кому, пошук, відповідь, правка, скарга, масові дії) пише рушій: ключ захисту й поля втратити не можна, тема лише розставляє готові шматки.
Список розмов
| Тег | Що це |
|---|---|
{total} {unread_total} {mode} {query} {to_query} {messages_url} | скільки розмов і непрочитаних; вкладка (all / unread); рядок пошуку; адреса списку |
[if:closed] | особистий прийом закрито самою людиною |
[if:mailbox] {mailbox_used} {mailbox_limit} [if:mailbox_full] [if:mailbox_near] {mailbox} | межа «зберігати листів» у ролі: зайнято, межа, «повна», «майже повна»; {mailbox} — готовий індикатор «Заповнено N з M» зі шкалою (у ролі без межі порожньо) |
{to_form} {tabs} {search_form} {receiving_form} | готові форми й вкладки рушія |
{bulk_open} … {bulk_close} | масові дії над позначеними розмовами (прапорець — {item.pick}) |
[each:threads] | розмови: {item.name} {item.username} {item.url} {item.user_url} {item.avatar} {item.initials} {item.hue} {item.unread} {item.unread_label} {item.subject} {item.excerpt} {item.mine} {item.when} {item.pick} |
[if:nothing] {nothing_text} | розмов немає і чому |
Листування
| Тег | Що це |
|---|---|
{name} {username} {profile_url} {back_url} {avatar} {initials} {hue} | співрозмовник |
{role} {role_key} {role_color} {role_badge} | роль співрозмовника: назва, машинна назва (для умов), колір, готова плашка |
[if:online] | співрозмовник «на сайті»: він щось робив за останні п'ять хвилин і сам дозволив показувати активність |
{registered} | дата приходу на сайт — лише якщо людина дозволила «Показувати дату реєстрації» |
[if:can_reply] {denied} {reply_form} {tools} | чи можна писати (інакше — причина словом); форма відповіді; інструменти розмови |
[each:letters] | листи: {item.id} {item.body} (текст, цитати блоками) {item.files} (вкладення) {item.subject} {item.when} {item.edited} {item.edited_when} {item.read} {item.read_when} {item.mine} (власний лист) {item.quote} (кнопка «Цитувати») {item.own} (правити й видаляти власний непрочитаний) {item.report} (поскаржитися на чужий) |
Листи лише власні: розмови добирає рушій за людиною, що увійшла, текст екранується.
«Зворотний зв'язок» (модуль «Зворотний зв'язок»)
Файл теми: views/feedback/form.tpl.html (заготовка — modules/feedback/starters/form.tpl.html). Немає файлу — сторінка як раніше. Форму пише рушій (ключ захисту, поле-пастка від роботів, перевірка): цілком — {form}, або частинами.
| Тег | Що це |
|---|---|
{form_open} … {form_close} {submit} | відкриття й закриття форми (з ключем захисту та прихованими полями) і кнопка |
{field:name} {field:email} {field:subject} {field:message} | основні поля; ім'я, пошта й текст обов'язкові — без них форма не пройде перевірку |
{field:phone} | телефон: з'являється, якщо в «Налаштування → Зворотний зв'язок» поле «Телефон у формі» увімкнено («за бажанням» або «обов'язково»); вимкнено — поля у формі немає |
{intro} [if:intro] | власний вступ власника |
{agreement} [if:agreement] | згода на обробку даних |
[if:user.logged] … [else] … [/if] | чи увійшла людина (ім'я й пошту підставлено); [else] — для гостя |
{t.title} {t.lead} {t.submit} | слова сторінки мовою відвідувача |
Захист від роботів (поле-пастка, пауза, частота) — частина форми рушія: вона прийде разом із {form_open}, окремим тегом її ставити не треба.
«Запропонувати запис» (модуль «Новини»)
Файли теми: views/news/suggest.tpl.html (форма для того, хто увійшов) і views/news/suggest-login.tpl.html (гостю: пояснення й кнопки входу). Немає файлу — сторінка як раніше.
Форму пише рушій (ключ захисту, пастка від роботів, перевірка): цілком — {form}, або частинами {form_open} … {form_close}:
| Тег | Що це |
|---|---|
{field:title} {field:excerpt} {field:category} {field:tags} {field:body} | основні поля; поля, якого немає в шаблоні, у формі не буде (заголовок і текст обов'язкові — без них форма не пройде) |
{field:f_назва} | власне додаткове поле: лише те, яке власник позначив у «Дод. поля» пташками «у формі сайту» й «заповнює відвідувач»; прив'язане до рубрики показується, коли вибрано її; картинки, файли й відео відвідувачу не даються |
{submit} | кнопка надсилання |
{t.title} {t.lead} {t.note} {t.send} {t.mine} {t.too_many} | слова сторінки мовою відвідувача |
{left}, [if:can_send] | скільки пропозицій лишилося за добу; чи можна ще надсилати |
{mine_url} | адреса «Мої пропозиції» |
[each:categories] | рубрики для вибору: {item.id} {item.title} |
Сторінка для гостя: {login_url}, {register_url}, [if:can_register], слова {t.guest_title} {t.guest_text} {t.guest_login} {t.guest_register}.