Документация для разработчиков
Темная тема

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

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

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

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

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



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2023, «1С-Битрикс», 2023
Наверх