OnBeforeDocFormSave
Последнее обновление Sep 24th, 2021 | История страницы | Улучшить эту страницу | Сообщить о проблеме
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$294 per month—let's make that $500!
Learn moreСобытие: OnBeforeDocFormSave¶
Запускается до сохранения ресурса в менеджере через форму редактирования. Это позволяет коду предотвращать сохранение документа.
Служба: 1 - Parser Service Events Группа: Documents
Будь осторожен с TVs Изменение или вставка значений TV лучше сделать OnDocFormSave поскольку процесс сохранения TV во время onBeforeDocFormSave более сложен из-за визуализации значений TV.
Плагины, привязанные к этому событию, должны вернуть null в случае успеха. Любое возвращенное значение будет отправлено в журналы как ошибка (но страница все равно будет сохранена).
Вы также можете передать сообщение в функцию $modx->event->output()
, и оно будет отображено пользователю во всплывающем модальном окне. Если вы передаете значение здесь, страница не будет сохранена!
Только текст
Если вы передаете значение в $modx->event->output()
, оно должно быть только текстовым! HTML-теги не допускаются: они приводят к зависанию модального окна.
Параметры события¶
Имя | Описание |
---|---|
mode | Либо 'new' либо 'upd', в зависимости от обстоятельств. |
resource | Ссылка на объект modResource. |
id | Идентификатор ресурса. Будет 0 для новых ресурсов. |
Примеры¶
Требуемые поля¶
Рассчитать значение поля¶
Такой плагин не разрешит создавать новые ресурсы, и не будет сохранять ресурсы, у которых не заполнено introtext
:
Такой плагин установит значение поля template=1
у всех ресурсов находящийхся в корне т.е parent=0
:
Принудительное сохранение
Также необходимо запустить $resource->save()
метод, так как это не происходит автоматически.
Смотри также¶
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$294 per month—let's make that $500!
Learn more