Список, в который клиент сам добавляет строки
fld-loop="Название списка" Меню напитков, отзывы, команда, вопросы и ответы — всё, где одинаковые карточки идут подряд. Клиент добавляет, удаляет и переставляет строки, вид карточки не меняется.
Куда ставить
На блок, внутри которого повторяются карточки. Первая карточка с полями становится образцом строки, остальные — строками, которые принесёт «Загрузить данные».
Поля внутри карточки размечаются как обычно: fld-text для текста, fld-image для картинки.
Поле появится в админке, только если у страницы есть имя группы: wp-fields-group на её <body>.
Пример: меню напитков
<div class="cards" fld-loop="Drinks">
<article class="card">
<h3 fld-text="Name">Latte</h3>
<span fld-text="Price">$4.20</span>
</article>
<article class="card">
<h3 fld-text="Name">Cappuccino</h3>
<span fld-text="Price">$3.90</span>
</article>
</div>Третью строку клиент добавил в админке, в вёрстке её не было.
Что важно
- Размечайте все карточки, а не только первую. Карточка без атрибутов в админку не попадёт.
- Название списка — это его заголовок в админке: пишите так, чтобы клиент понял.
- У полей внутри строки разные имена.
- Если в админке нет ни одной строки, блок пропадает со страницы целиком.
Частые ошибки
Журнал сборки — вкладка «Логи» вашего проекта на themeforge.pro; те же замечания показывает бесплатная проверка разметки.
<div fld-loop="Drinks">
<div class="deco"></div>
<article class="card">
<h3 fld-text="Name">Latte</h3>
</article>
</div>Декоративный элемент перед карточками: сборка его пропускает, пишет об этом в журнал, и элемент не выводится.
<div class="deco"></div>
<div fld-loop="Drinks">
<article class="card">
<h3 fld-text="Name">Latte</h3>
</article>
</div>Декор — снаружи списка.
<section fld-loop="Drinks">
<div fld-loop="Drinks">…</div>
</section>Список внутри списка с тем же именем: сборка переименует внутренний в «Drinks 2» и сообщит о коллизии.
<section fld-loop="Menu sections">
<div fld-loop="Drinks">…</div>
</section>У каждого списка своё имя.
То же в настройках сайта или у рубрики
fld-loop | у страницы или записи — как в примере |
|---|---|
opt-loop | в настройках сайта: один список на все страницы, например соцсети |
tax-loop | у рубрики или метки |
Альтернативная запись
f_loop, o_loop, t_loop работает так же: сборка даёт одинаковую тему.