|
WWW-страница. Заполнение формы.
Использование скрипта, отправляющего результаты работы формы по почте.
 Вызов скрипта (из формы):
<form action="http://cgi.iti.lt/cgi-bin/FormMail.pl" method="POST">
Необходимые поля (в форме)
Tолько одно поле действительно необходимо для корректной работы скрипта
| Поле: | recipient
|
| Описание: |
Установка адреса, на который будут приходить данные из формы
|
| Пример: | <input type=hidden name="recipient" value="login@iti.lt"> |
Дополнительные поля
| Поле: | subject
|
| Описание: |
Позволяет указать тему письма. Если не указано ничего, то будет стоять
"WWW Form Submission"
|
| Пример: | если вы хотите указывать тему сами:
<input type=hidden name="subject" value="то, что вы хотите">или давать эту возможность пользователю:
<input type=text name="subject"> |
| Поле: | email
|
| Описание: | Тут можно написать то, что будет ставиться в поле "From"
отправляемого письма (полезно для возможности ответа на приходящие письма).
Если вы хотите, что бы это поле было обязательным - добавьте его с помощью "required".
|
| Пример: | <input type=text name="email"> |
| Поле: | realname
|
| Описание: | Значение этого поля формы будет именем отправителя письма. |
| Пример: | <input type=text name="realname"> |
| Поле: | redirect
|
| Описание: | Если после заполнения формы вы хотите перенаправить пользователя на
другую страницу вместо того, чтобы показать ему результат заполнения формы, то используйте это скрытое поле.
|
| Пример: | Чтобы указать URL страницы на которую направить пользователя: <input type=hidden name="redirect" value="http://your.host.com/to/file.html">
|
| Поле: | required
|
| Описание: | Вы можете обозначить поля, которые обязательно должны быть заполнены и без
них обработка формы не будет произведена. Просто впишите имя поля, которое должно быть обязательно, и пользователю
будет указано, если он его не заполнит.
Если вы хотите сделать отдельные страницы для различного типа ошибок, то смотрите 'missing_fields_redirect' |
| Пример: | Если вам необходимо наличие поля email и phone,
то строчка будет выглядеть так:
<input type=hidden name="required" value="email,phone"> |
| Поле: | env_report
|
| Описание: | Если ваше любопытство заходит дальше заполняемых пользователем полей,
то вы можете получить дополнительную информацию от сервера, такую как: тип браузера; ip-адрес пользователя и подобное.
Вот краткий лист переменных, которые могут быть использованы:
REMOTE_HOST - имя удаленного хоста
REMOTE_ADDR - ip адрес хоста, с которого
была заполнена форма
HTTP_USER_AGENT - тип использованного браузера
Но это только немногие наиболее используемые. Полный список вы можете посмотреть на
The CGI Resource Index: Documentation: Environment Variables
|
| Пример: | Если вы хотите узнать, с какого хоста и браузера отправлена форма:
<input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT"> |
| Поле: | sort
|
| Описание: | Результат заполнения формы, который вы получаете по почте,
может быть отсортирован по удобному вам принципу. Вы можете выбирать между сортировкой по алфавиту, в порядке
заполнения полей (как вы их перечислили в форме) или указав собственный метод. Для установки собственного порядка
следует написать "order:" в первой части значения поля, далее нужно перечислить имена переменных в
необходимо вам последовательности.
|
| Пример: | Для сортировки по алфавиту
<input type=hidden name="sort" value="alphabetic">
Указанная последовательность:
<input type=hidden name="sort" value="order:name1,name2,etc..."> |
| Поле: | print_config
|
| Описание: | Переменная print_config
позволяет установить, какие значения каких полей должны быть посланы вам письмом. Это нужно для того,
чтобы в теле письма вы могли увидеть email, subject и подобные "рабочие" значения, в противном случае, вы их
сможете вычислить только из заголовка полученного письма.
|
| Пример: | Если вам надо выводить email и subject
<input type=hidden name="print_config" value="email,subject"> |
| Поле: | print_blank_fields
|
| Описание: | Переменная print_blank_fields
устанавливает вывод пустых (незаполненных) полей. В установках "по умолчанию", это возможность отключена, т.е.
незаполненые поля не будут упоминаться в письме. |
| Пример: | Если вы хотите видеть незаполненные поля (названия):
<input type=hidden name="print_blank_fields" value="1"> |
| Поле: | title
|
| Описание: | Установка заголовка страницы с результатами заполнения
формы, если у вас не установлено перенаправление пользователя на другую страницу.
|
| Пример: | Установить заголовок 'Feedback Form Results':
<input type=hidden name="title" value="Feedback Form Results"> |
| Поле: | return_link_url
|
| Описание: | Адрес страницы, на которую будут попадать после нажатия
кнопки back на странице, выведенной после заполнения формы. Это поле не нужно, если вы используете redirect.
|
| Пример: |
<input type=hidden name="return_link_url" value="http://cgi.iti.lt/~login/index.html"> |
| Поле: | return_link_title
|
| Описание: | Если вы хотите, чтобы вместо надписи back (см. return_link_url)
была какая-то другая, то тут вы можете ее указать. |
| Пример: |
<input type=hidden name="return_link_title" value="Вернуться домой"> |
| Поле: | missing_fields_redirect
|
| Описание: | Это поле позволяет указть адрес страницы, на которую будут
отправлены пользователи не заполнившие все необходимые поля формы. Таким образом вы можете сделать свою страницу об ошибке
вместо использования встроенной. |
| Пример: |
<input type=hidden name="missing_fields_redirect"
value="http://your.host.com/error.html"> |
| Поле: | background
|
| Описание: | Если очень надо, то вы можете установить фон
страницы, показываемой пользователю после заполнения формы, если, конечно, вы его не перекидываете на уже готовую страницу.
|
| Пример: |
<input type=hidden name="background" value="http://cgi.iti.lt/~login/fon.gif"> |
| Поле: | bgcolor
|
| Описание: | Устанавливает цвет фона результирующей страницы.
|
| Пример: | Чтобы установить цвет фона White:
<input type=hidden name="bgcolor" value="#FFFFFF"> |
| Поле: | text_color
|
| Описание: | Устанавливает цвет текста результирующей страницы.
|
| Пример: | Черный текст:
<input type=hidden name="text_color" value="#000000"> |
| Поле: | link_color
|
| Описание: | Устанавливает цвет ссылок на результирующей странице. |
| Пример: | Красная:
<input type=hidden name="link_color" value="#FF0000"> |
| Поле: | vlink_color
|
| Описание: | Устанавливает цвет посещенных ссылок на результирующей странице. |
| Пример: | Синяя:
<input type=hidden name="vlink_color" value="#0000FF"> |
| Поле: | alink_color
|
| Описание: | Устанавливает цвет активных ссылок на результирующей странице. |
| Пример: | Синяя:
<input type=hidden name="alink_color" value="#0000FF"> |
Все остальные (не служебные) поля формы будут вам отправлены почтой и показаны пользователю, если вы не перенаправили его на
другую страницу. Нет никаких ограничений на то, сколько полей может быть использовано, исключая накладываемые браузером
|
|