Вигляди на тегах: форма частинами, обговорення і гортання
Як розставити поля форми у своєму порядку, замінити вигляд обговорення під записом і вибрати, де показувати гортання.
Форма частинами
У виглядах із формою (вхід, реєстрація, відновлення, скидання пароля, другий чинник, підтвердження пошти, правила, пошук, кабінет) форму можна вивести цілою тегом {form} — це безпечний шлях, або зібрати частинами, щоб розставити поля в потрібному порядку:
| Тег | Що виводить |
|---|---|
{form_open} | відкриття форми з її адресою та прихованими полями; ключ захисту — там |
{field:ім’я} | поле цілком: підпис, підказка, помилка, як побудував рушій; ім’я — це name у поля введення |
{field:captcha} | перевірка «не робот» |
{submit} | кнопка надсилання |
{form_close} | закриття форми |
{form_open}
{field:email}
{field:password}
{field:captcha}
{submit}
{form_close}Поле, якого немає у вашому шаблоні, у формі не з’явиться: розстановка — вибір теми. Обов’язкові поля та перевірку «не робот» не пропускайте — без них форма не пройде перевірку.
Слово {t.хвіст} дає підпис інтерфейсу «префікс вигляду.хвіст» мовою відвідувача, тому тексти в шаблоні різними мовами не дублюються.
Обговорення (коментарі) на тегах
Файл views/comments/thread.tpl.html теми замінює вигляд обговорення під записом, сторінкою та іншими матеріалами. Немає файлу або він не пройшов перевірку — працює звичайний вигляд.
| Тег | Що виводить |
|---|---|
[each:comments]…[/each] | коментарі плоским списком у порядку показу: відповідь іде одразу за своїм коментарем, глибину дає {item.level} (0 — корінь) |
{item.id} {item.name} {item.avatar} {item.profile} {item.date} | номер (для якоря), ім’я автора, адреса аватара, адреса профілю (порожньо, якщо закритий), дата |
{item.text} | текст учасника: розмітка рушія, очищена (скриптів і чужих тегів немає); у прихованого людиною через «Кого я не бачу» порожній |
{item.likes_signed} {item.rating_class} {item.group_key} | оцінка зі знаком («+3», «−2»; мінус — коли ввімкнено голосування «проти»), клас для кольору plus / minus / neutral, машинна назва ролі автора ([if:item.group_key=admin], не залежить від мови) |
{item.likes} {item.minus} {item.rating} {item.verified} {item.op} | «Корисно» (число) або оцінка «+ / −» (число «за» мінус «проти»; {item.minus} — оцінка від’ємна), зірки відгуку, «перевірений покупець», «автор запису» |
{item.place} {item.group} {item.online} {item.signature} | поля картки автора, якщо їх увімкнув власник (місце, група, «на сайті», підпис) |
{item.group_color} {item.group_icon} {item.group_badge} | вигляд групи автора: колір (#rrggbb, порожньо — не задано), значок (готова картинка) і готова мітка «значок + назва» в кольорі ролі; задається в панелі: Ролі → роль → «Вигляд імені» |
{item.image1} {item.image2} {item.image3} | картинки коментаря (мініатюри) |
{item.actions} | готові кнопки рушія: «Корисно», «Відповісти», «Цитата», «Змінити», «Видалити», «Не бачити», «Поскаржитися» — правила показу ті самі, що у звичайному вигляді |
{compose} | форма коментаря цілком (поля, пастка для роботів, ключ захисту) і сценарій відповіді |
{form_open} {field:body} {field:author_name} {field:author_email} {submit} {form_close} | та сама форма частинами — верстка ваша, ключ захисту й приховані поля лишаються за рушієм |
{follow} | кнопка «Стежити за коментарями» (той, хто увійшов із підтвердженою поштою, — одразу, гість називає пошту й підтверджує листом); порожньо, якщо підписку вимкнув власник |
{comments_script} | сценарій «Відповісти»/«Цитата»/зірки окремо (всередині {compose} і {form_close} він уже є) |
{pager} {report} {notice} | посторінкова навігація, «Поскаржитися на запис», повідомлення замість форми (обговорення закрите, межа, потрібен вхід) |
{comments.total} [if:closed] [if:can_write] | кількість коментарів; обговорення закрите; писати можна |
{comments.category_id} {comments.category}, [if:comments.category_id=3] | рубрика запису, під яким іде обговорення (віддає новинний запис; в інших розділів порожньо): номер для умови й назва |
Приклад:
<section id="comments"><h2>{comments.word}: {comments.total}</h2>
[each:comments]
<article id="comment-{item.id}" class="c c-l{item.level}"><b>{item.name}</b> <time>{item.date}</time>
<div>{item.text}</div><footer>{item.actions}</footer></article>
[/each]
{pager}
[if:can_write]{compose}[else]{notice}[/if]
</section>Гортання зверху, знизу або і там, і там
Посторінкову навігацію у списках записів, завантажень, форуму, магазину й каталогу виводять два теги: {pager} — під списком і {pager_top} — над списком. Де вона показується, обирають у Налаштування → Загальні → «Вигляд і мова» → «Гортання в списках»: «Знизу» (за замовчуванням), «Зверху» або «Зверху й знизу». Поставте обидва теги у файл вигляду — поруч зі списком і під ним: тег, чиє місце не обрано, нічого не малює, і порожнього відступу не лишається. Якщо у вашому вигляді лише {pager}, гортання лишається знизу й за вибору «Зверху» зникне, доки ви не додасте {pager_top}. У заготовках виглядів модулів обидва теги вже стоять.