StandartEdit
StandartEdit это схема редактирования стандартных объектов.
Форма редактирования
Например создаём страницу с таблицей, содеращей определённые элементы, стандартная ситуация, не так ли?
Для редактирования каждого элемента создаём кнопку "Редактировать" и в качестве действия указываем:
onclick="seEdit(<имя объекта>,<ID объекта>,<контроллер>, <плагин>)" Параметры: <имя объекта>: Любое название объекта состоящее из латинских букв без пробелов пример: org <ID объекта>: ID объекта - целое число. Также можно передать объект с несколькими параметрами пример: {'id': 2, 'parent': 4} <контроллер>: (ОПЦИОНАЛЬНО) если передан этот параметр то метод редактирования будет вызван в переданном, контроллере <плагин>: (ОПЦИОНАЛЬНО) если передан этот параметр то метод редактирования будет вызван в переданном, контроллере
функция JS вызовет переданный плагин, контроллер(если параметры не переданы будут вызваны текущий плагин и контроллер) с экшном seeditobject
- Для работы, необходима активация транспорта переменных в среду JavaScript
Экшн steditobject, находящийся в CmsBaseController в свою очередь возвращает форму редактирования элемента, которую он берёт из папки
Шаблон редактирования объекта /<ПАПКА ПЛАГИНА>/views/seedit/<имя объекта>.tpl
Перед отрисовкой формы вызывает метод segetdata<Имя объекта(первая буква большая)> сначала модели, затем контроллера, в случае если они определены При вызове метода модели, данные, возвращённые методом помещаются в массив $data, доступный в шаблоне редактирования объекта. Первым аргументом передаётся массив с параметрами, содержащий элементы запроса и переменные
object - тип объекта objectid - его ID (второй аргумент js функции seEdit)
или принимает данные для редактирования(в случае отправки запроса методом POST).
Контроль прав
Так как при редактировании у нас вызывается один и тот же экшн то в схему внедрена дополнительная проверка прав доступа для корректной работы нам необходимо добавить ресурс, выглядящий следующим образом
Ресурс для контроля прав <текущий плагин>/<текущий контроллер>/seedit<имя объекта>
Такое поведение работает только когда используется плагин ACL.
Во всех остальных случаях просто проверяется переменная контроллера $this->edit_allowed. Если она = true, то редактирование будет разрешено.
Сохранение данных
При нажатии на кнопку "Сохранить" во всплывающем окне вызывается функция seSaveData которая собирает данные с формы и отправляет POST AJAX запрос на сохранение данных.
В случае если функция обнаружит в форме input type="file" то экшн сохранения будет вызван не через AJAX, а через обычный POST так как AJAX запрос не умеет загружать файлы.
Бывают такие ситуации когда на форме есть input для загрузки файла, но форму необходимо сохранить через AJAX. В этом случае мы просто добавляем тег seIgnore="true" к input-у и его наличие будет проигнорировано.
При сохранение данных об объекте вызываются по очереди методы текущего контроллера и его модели 'seedit<Имя объекта>'(к примеру: seeditOrg) в случае если они определены.
методу модели в качестве аргумента передаётся массив с параметрами запроса
Завершение
По завершении вызывается метод управляющего контроллера sefinishedit<Имя объекта>