Список из данных
Результат: блок «Тарифы» из карточек, который собирается из набора tariffs. Цена меняется запросом к данным — разметку никто не трогает.
1. Набор
curl -s -X PUT "$API/site/$SITE/data/tariffs" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"items": [
{"slug": "start", "title": "Старт", "price": "0 ₽", "note": "Для пробы", "url": "/tarify/start/"},
{"slug": "pro", "title": "Про", "price": "990 ₽", "note": "Свой домен", "url": "/tarify/pro/"},
{"slug": "team", "title": "Команда", "price": "2 990 ₽", "note": "Несколько авторов", "url": "/tarify/team/"},
{"slug": "agency", "title": "Агентство","price": "9 990 ₽","note": "Много сайтов", "url": "/tarify/agency/"}
]}' | jq -c '{applied, items: .dataset.items, fields: [.dataset.fields[].field]}'
Схемы нет: какие поля положили, такие доступны в разметке как item.<поле>.
2. Фрейм блока
tariffs__cards.html:
<section class="tariffs">
<h2 class="tariffs__title">Тарифы</h2>
<div class="tariffs__grid">
<!-- onpress/repeat {"source":"tariffs","limit":3,"offset":"(page.paged - 1) * 3","empty":"frame"} -->
<a class="tariffs__card" data-op-bind='{"href":"item.url"}'>
<span class="tariffs__name" data-op-bind='{"text":"item.title"}'></span>
<strong class="tariffs__price" data-op-bind='{"text":"item.price"}'></strong>
<span class="tariffs__note" data-op-bind='{"text":"item.note"}'></span>
</a>
<!-- /onpress/repeat -->
</div>
<nav class="tariffs__pages"><a href="?blog_page=1">1</a> <a href="?blog_page=2">2</a></nav>
</section>
limit: 3иoffsetотpage.paged— по три карточки на страницу; номер страницы — параметр?blog_page=Nв адресе, без него — первая;"empty":"frame"— если на какой-то странице разбивки карточек не осталось, блок не выводится вовсе;- ссылки на страницы разбивки — обычная разметка.
curl -s -X POST "$API/site/$SITE/frames" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d "$(jq -n --rawfile html tariffs__cards.html '{slug: "tariffs__cards", html: $html}')" \
| jq -c '{slug: .frame.slug, sources, renders_on_request, live_reasons}'
{"slug":"tariffs__cards","sources":["tariffs"],"renders_on_request":true,"live_reasons":["op/repeat limit/offset uses page.* tokens"]}
Окно от page.paged делает фрейм зависимым от страницы — он собирается на каждом запросе. Без разбивки ("limit": 3 без offset) блок попал бы и в статическую копию.
3. Поставить на страницу
Лучше всего — во фрейм страницы (оболочку) строкой <!-- onpress/frame {"name":"tariffs__cards"} /-->: тогда платформа знает, какие страницы зависят от набора, и сама сбрасывает их кэш после правки данных. Можно и прямо в тело страницы — той же строкой в markdown, но тогда после правки набора кэш этой страницы придётся сбросить вручную (шаг 5):
---
name: "Тарифы"
slug: "tarify"
url: "/tarify/"
lang: "ru"
frame: "article"
---
Выберите тариф.
<!-- onpress/frame {"name":"tariffs__cards"} /-->
4. Проверить заранее
Что получит повторитель на первой и второй странице разбивки:
for n in 1 2 3; do
printf 'blog_page=%s: ' "$n"
curl -s -X POST "$API/site/$SITE/data/resolve" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d "{\"source\": \"tariffs\", \"limit\": 3, \"offset\": \"(page.paged - 1) * 3\", \"paged\": $n}" \
| jq -c '{window, window_total, titles: [.items[].title]}'
done
blog_page=1: {"window":{"offset":0,"limit":3},"window_total":4,"titles":["Старт","Про","Команда"]}
blog_page=2: {"window":{"offset":3,"limit":3},"window_total":4,"titles":["Агентство"]}
blog_page=3: {"window":{"offset":6,"limit":3},"window_total":4,"titles":[]}
На странице сайта: /tarify/, /tarify/?blog_page=2.
5. Поправить данные
curl -s -X PATCH "$API/site/$SITE/data/tariffs" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"ops": [{"op": "merge", "match": {"slug": "pro"}, "fields": {"price": "1 290 ₽"}}]}' \
| jq -c '{applied, rebaked: .rebaked | {status, cache: .cache.status}}'
Если блок стоит во фрейме страницы, запись сама сбрасывает кэш этих страниц (rebaked.cache.status: "ok") — новая цена видна на следующем запросе. Если блок вставлен в тело страницы, платформа эту связь не видит ("cache": "nothing"), и посетители получат старую копию из кэша, пока её не сбросить:
curl -s -X POST "$API/site/$SITE/cache/flush" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"urls": ["/tarify/"]}' | jq -c .flushed.urls.status
Варианты
- Фильтр по странице — показывать на странице только «её» элементы: поле
pageв элементах и"match":{"page":"page.slug"}в повторителе. - Выбор по списку —
"match":{"slug":["raw:pro","raw:team"]}выводит только два тарифа. - Перевод —
PUT /data/tariffsс"lang": "en": английские страницы получат английский вариант. - Без набора — короткий неизменный список можно держать прямо в атрибуте:
<!-- onpress/repeat {"items":[{"title":"…"},{"title":"…"}]} -->.