Использование пакета

Формы создаются через веб, так же как контент-объекты, что позволяет не разрабатывать новые продукт для каждого сайта, а просто создать экземпляр уже готового компонента и настроить его. Настройка включает в себя:

• Создание формы;
• Создание в ней нескольких полей, доступные типы полей описаны в ng.base.form;
• Заполнение шаблона письма (для тела и темы пишется текст, в котором те места, в которых должно быть вставлено значение поля из формы, заменяются на %(имя поля)s);
• Создается список адресов по которым будет рассылаться форма;
• Список адресов регистрируется как утилита;
• В настройках формы выбирается только что созданный список адресов и коннектор SMTP.

После этого можно перейти на вкладку с формой, заполнить ее и отправить.

Использование формы возможно двумя способами. Самое простое - создать ее внутри области сайта, доступной через навигацию. Посетителю предоставляется вид "@@dialog.html", остальные виды скрываются настройкой прав. Так, форму "SomeForm" созданную в разделе "SomeFolder" можно вызвать так:

http://localhost:8080/SomeSite/SomeFolder/SomeForm/@@dialog.html

Более сложный способ - создать форму внутри сайт-менеджера (или в любом другом месте) и зарегистрировать с интерфейсом ng.base.form.interfaces.IDialog, указав уникальное имя. Такую форму можно вызвать из простраства имен ++dialog++ по имени, указанному при регистрации, из любого места сайта. Наприм, форму зарегистрированную под именем "someform" можно вызвать так:

http://localhost:8080/SomeSite/SomeFolder/SomeObject/++dialog++someform

Выбор между созданием формы в области навигации и в сайт-менеджере определяется способом использования: так, формы, общие для всего сайта, имеет смысл создавать в сайт-менеджере, а формы, специфичные для конкретного раздела (по набору полей, по списку адресов для рассылки и т.п.) - в этом разделе.