Логика работы

Внимание! Мы настоятельно рекомендуем ознакомиться сначала с REST-документацией модуля Сайты, чтобы понять как модуль функционирует (тем более REST доступен и в коробочной версии). Данную документацию рассматривайте как подспорье при работе в коробке, когда вам действительно мало функционала REST, или вы хотите детальнее разобраться в API.

В отличии от логики работы остального модуля, методы, перечисленные в этом разделе, отличаются. После того как работа с контентом блока произведена, его необходимо сохранить. Это сделано из соображений безопасности. Ведь работа с контентом, как правило, это массовая работа (поменять содержимое одной ноды, поменять стили другой ноды, добавить или удалить карточку, потом поменять контент карточки, и так далее). Чтобы после каждого такого действия не нагружать БД, было и принято такое решение.

Хоть в примерах раздела методы и приведены обособленно, в работе их можно компоновать. Это значит, что можно вызвать сначала метод изменения стилей ноды блока, потом поменять контент этой ноды, а потом и вовсе перейти к карточкам. И только в конце вызвать save – результат сохранится. Главное всегда держать в голове логический результат своей работы (если первым методом вы удалили 3-ю карточку, то нет смысла к ней обращаться следующим методом).

И пара слов об идеологии работы с содержимым блока. Да, вы можете конечно получить содержимое блока через метод getContent, изменить его по своим соображениям, и сохранить через метод saveContent. Но это работа без контроля манифеста блока. Если в нем не разрешены какие-то селекторы к изменению, то и действие методов (например, изменение текста) не принесут эффекта.