Шаблоны действий

    Для каждого компонента данных предусмотрено 12 шаблонов действий.

    Форма добавления
    По умолчанию поля в форме добавления выводятся по очереди в порядке возрастания приоритета по одному полю на строку. Эту форму можно увидеть, нажав на ссылку «добавить» в режиме редактирования раздела. Внешний вид формы можно переопределить. Это применяется, в частности, в тех случаях, когда добавлять записи могут внешние пользователи: чтобы придать форме особенный вид или скрыть некоторые поля, чтобы пользователь не мог их добавить (например, если в компоненте «вопросы и ответы» есть поля «вопрос» и «ответ», целесообразно в форме добавления оставить только вопрос). Для создания формы добавления возьмите HTML-текст стандартной формы и внесите в него нужные изменения.
    Переменная $warnText содержит сообщение об ошибке добавления объекта. Вы можете поместить эту переменную в любом месте HTML-кода альтернативной формы добавления. Например, в начале формы:



    Для создания своей формы добавления проще всего скопировать код сгенерированной формы по умолчанию и переделать его. Форму добавления, выводимую системой «по умолчанию», Вы сможете получить, открыв страницу с формой добавления с параметром “isNaked=1”, при этом значение шаблона действия «Форма добавления» должно быть пустым.
    Внимание: в случае если компонент содержит файлы, при написании альтернативной формы добавления объектов необходимо указать атрибут ENCTYPE у тега FORM со значением “multipart/form-data” (< FORM ENCTYPE=multipart/form-data ...>), а для работы с полями типа Файл использовать функцию nc_file_field(), описанную ниже в «Приложении 2».
    В данном поле вставка PHP-кода возможна лишь при помощи кавычек “.substr(…).”.
    Пример формы добавления для компонента с 2-мя полями: тип Файл и Список.



    Условия добавления
    По умолчанию при попытке добавить объект поля проверяются согласно их свойствам (формату, типу и т.д.). Например, в случае если в числовое поле произведена попытка ввести строку, система запишет сообщение об ошибке в переменную $warnText и повторно выведет форму добавления. Некоторые дополнительные условия, которые нельзя настроить в свойствах полей (например, обязательность одного из двух полей), можно настроить в данном шаблоне действия.
    Данное поле может содержать код языка PHP. В случае если произведена попытка добавить объект, значение полей которого не удовлетворяет условиям добавления, запишите в переменную $warnText сообщение об ошибке и установите значение переменной $posting в ноль (0). Например, если обязательно нужно заполнить одно из двух полей формы:



    Действие после добавления
    По умолчанию после добавления объекта появляется сообщение об успешном добавлении объекта. Содержание этой страницы (и действия, которые происходят после добавления) можно переопределить, например, для «вопросов-ответов» вывести сообщение о том, что в скором времени вопрос будет обработан. Также можно вызывать различные действия: операции с базой, отправку писем и пр. Все поля, отправленные через форму добавления, доступны в «действии после добавления».
    Вставка PHP-кода в это поле осуществляется следующим образом:



    Форма изменения, Условия изменения, Действие после изменения
    Назначение и функциональность этих форм аналогичны форме изменения и действию после добавления. Разница лишь в действиях – эти настройки относятся к изменению записи.
    Внимание: в случае если компонент содержит файлы, при написании альтернативной формы изменения объектов необходимо указать атрибут ENCTYPE у тега FORM со значением “multipart/form-data” (< FORM ENCTYPE=multipart/form-data ...>) , а для работы с полями типа Файл использовать функцию nc_file_field(), описанную ниже в Приложении 2.
    В данном поле вставка PHP-кода возможна лишь при помощи кавычек “.substr(…).”.
    Пример формы изменения для компонента с 2-мя полями: тип Файл и Список.



    Действия после включения и удаления
    Данные действия аналогичны действиям после добавления или изменения объекта.

    Форма поиска
    HTML-код, записанный в это поле, будет доступен в префиксе или суффиксе списка объектов в переменной $searchForm. Механизм работы поиска описан в главе Поиск и выборка. Если Вам сложно сориентироваться, Вы можете скопировать системную форму поиска для данного компонента и вставить ее код в данное поле. Чтобы вызвать системную форму поиска для данного компонента раздела, нужно открыть страницу /sub/search_keyword.html , где sub – адрес раздела, keyword – ключевое слово компонента раздела.

    Форма расширенного поиска
    Устанавливая для компонента раздела «действие по умолчанию» поиск, при просмотре мы увидим стандартную форму поиска по этому компоненту. Вы можете написать свой HTML-код для этой формы в поле «Форма расширенного поиска».

    Текст письма для подписчиков, условия подписки
    Поля зарезервированы для использования в некоторых модулях. Если в Вашей системе установлены эти модули, см. документацию к ним.

« Назад          Содержание          Далее »


Сайты по теме:


    

Интересное в сети: