HTML, JSON-LD, обложки, иллюстрации и безопасная обработка содержимого
Поле content — HTML статьи с иллюстрациями в тегах figure, cover — обложка WebP с размерами и alt, json_ld — разметка для вставки в script type=application/ld+json. Обрабатывайте HTML безопасно и не дублируйте заголовок.
HTML статьи — content
- Подзаголовки
h2/h3, абзацы, списки, таблицы, ссылки. - Текст может начинаться с
<h1>с заголовком статьи. Если тема CMS сама выводит заголовок записи изtitle, уберитеh1из содержимого, чтобы заголовок не повторялся. - Иллюстрации уже вставлены в текст:
Изображения лежат по публичным стабильным адресам; их можно оставить по ссылке или скопировать в медиатеку CMS.<figure data-sj-asset="…"><img src="…" alt="…" width="…" height="…"></figure>
Обложка — cover
{"url": "https://…/cover.webp", "alt": "…", "width": 1536, "height": 1024}
Или null, если обложки нет. Изменение обложки или её alt даёт новую версию доставки, как изменение текста.
Разметка — json_ld
Объект schema.org для поисковых систем. Выводите его на странице статьи так:
<script type="application/ld+json">{…json_ld…}</script>
Данные автора и издателя берутся из настроек проекта «Данные для поисковых систем». Пустой объект — разметки нет.
Безопасность
- Пропускайте HTML через санитайзер вашей CMS со списком разрешённых тегов: текст, заголовки, списки, таблицы, ссылки,
figure/img. json_ldвставляйте как JSON, экранируя</, а не как произвольный HTML.- Не выполняйте скрипты из содержимого.
Поля снимка — Справочник публичных методов, параметров, схем и примеров.
Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.