cgifile - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

cgiemail, cgiecho, cgifile - інструменти перетворення форми в пошту CGI

Команда cgiemail користувач керівництво

Цей посібник допоможе вам написати WWW-форму, яка надсилає вам повідомлення електронною поштою. The
необхідні наступні кроки:

· Створити шаблон електронної пошти.

· Розмістіть посилання на шаблон на своїй сторінці.

· Вирішіть, чи підійде посилання mailto:.

· Створіть форму HTML.

· Створення більш розширених HTML-форм.

· Переконайтеся, що ДІЯ правильна.

· Спробуйте свою форму за допомогою cgiecho.

· Перейти в ефір з cgiemail.

· Налагодження, якщо ви не отримуєте пошту

Наступні кроки є необов’язковими.

· Додайте текст на сторінку успіху.

· Використовуйте альтернативну сторінку успіху.

· Зробіть необхідні введення.

· Визначте форматування для деяких входів.

· Використовуйте змінні середовища CGI.

Створювати an електронна пошта шаблон
Перш ніж почати отримувати повідомлення електронної пошти через Інтернет, ви повинні вирішити, що це за повідомлення
повідомлення мають виглядати так. Створіть файл ASCII, який називається шаблоном електронної пошти, який виглядає
щось на зразок цього:

Для того, щоб: [захищено електронною поштою] РІДКИ ЗАГОЛОВНЯ
Тема: запитання третє
порожній рядок
Як вас звати? [твоє ім'я]
Який твій квест? [квест] ТІЛО
Який твій улюблений колір? [колір]

У певному сенсі цей шаблон є вільною формою. Люди, які хочуть надіслати вам електронну пошту, можуть завантажити
цей шаблон, заповніть його та надішліть вам поштою. Однак шаблон також буде використаний
програмою cgiemail, тому перед завантаженням файлу на свій WWW-сервер будьте обережні
дотримуйтесь цих рекомендацій:

· Де б ви хотіли, щоб користувач вашої форми надав інформацію, використовуйте одне слово
у квадратних дужках без пробілів, наприклад Ваше ім’я: [ваше ім’я]. Не [Вкажіть своє ім'я
тут].

· Переконайтеся, що адреса в полі Кому: правильна.

· Якщо серед рядків заголовка є порожні рядки, видаліть їх.

· Якщо перед рядками заголовка є порожні рядки, видаліть їх.

· Переконайтеся, що всі ваші рядки заголовка дійсні. Першим символом у рядку має бути a
лист. Більшість інформації має бути в тілі повідомлення; не придумуйте свій
заголовки.

· Переконайтеся, що між рядками заголовка та основною частиною є порожній рядок.

· Переконайтеся, що ви зберегли його як текст ASCII. Наприклад, якщо ви використовуєте Microsoft Word, використовуйте
«Зберегти як» і виберіть «Тільки текст з розривами рядків».

· Якщо ви створили файл на Mac, не забудьте завантажити його як текст, тобто перекладений CR.
(Комп’ютери Unix мають інші коди, що позначають кінець рядка, ніж у Mac, тому ваші
файл може виглядати як один довгий рядок на комп’ютері Unix.)

У цих рекомендаціях є велика гнучкість. Ви можете помістити Bcc:, X-Face: або будь-який інший
інший заголовок у заголовках. Ви можете розмістити такі речі, як Копія: [ваше ім’я] у заголовках. Будьте
креативний. Просто не додавайте туди нічого, що ви не хотіли б, щоб ваш веб-майстер бачив,
тому що саме туди потрапляють відхилені повідомлення.

Тепер завантажте свій шаблон електронної пошти на сервер WWW і подивіться на нього за допомогою
WWW браузер.

Ставити a link до шаблон on ваш стр.
Ось приклад:

Чи хотіли б ви перетнути міст? Завантажте мою форму "запитання три" та надішліть її на адресу
<[захищено електронною поштою]>.

Навіть після того, як ви створите свою WWW-форму, ви захочете залишити це посилання для збільшення
доступність для користувачів з обмеженими можливостями.

Вирішувати if a MAILTO: link волі робити.
Вже без будь-якого складного HTML у вас є спосіб надіслати вам людей із WWW
потрібну вам інформацію. Перш ніж приступити до створення HTML-форми, визначтеся, чи варто
це дійсно того варте. Форми на WWW мають два особливих недоліки:

· Ви отримуватимете багато легковажних листів від людей, які просто «серфінгують в Інтернеті».

· Адреса електронної пошти користувача вводиться вручну, і часто її вводять неправильно, так що у вас є
немає можливості відповісти. Це менша проблема з посиланнями mailto:.

Створювати HTML формі.
Якщо ви вирішили створити форму HTML, вам потрібно дати людям можливість надати
адреса електронної пошти. За допомогою посилання mailto: їхній розсилник надасть адресу From: для
їх. Але тепер вам потрібно додати рядок у верхній частині шаблону електронної пошти так:

Від: [електронна пошта]

Ось приклад HTML-форми.

Ваша електронна адреса: ____________________

Твоє ім'я: ____________________

Ваш квест: ____________________

Ваш улюблений колір: __________________

Надіслати електронну пошту (Цей приклад насправді не надсилає електронну пошту.)

Це джерело HTML:

<FORM METHOD="POST"
ДІЯ="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Ваша електронна адреса:
Твоє ім'я:
Ваш квест:
Ваш улюблений колір:



Це дуже простий приклад. Зауважте, що NAME кожного введення відповідає тому, що ви
попередньо введений у шаблон електронної пошти. У цьому прикладі це електронна пошта, ваше ім'я, квест,
і колір. Це ключова концепція використання cgiemail. Будьте обережні, щоб зробити їх саме такими
те саме; якщо ввести NAME="colour" у форму HTML і [color] (зверніть увагу на орфографію
різниця) у вашому шаблоні електронної пошти, введені дані не відображатимуться в електронному листі.

Створювати більше просунутий HTML форм.
Щоб навчитися створювати більш складні форми, прочитайте посібник NCSA. Усі їхні приклади форми
можна перетворити на форми cgiemail, просто змінивши ACTION. На відміну від інших форм-до-
електронних програм, вам не потрібно використовувати приховані вводи зі спеціальними іменами.

Усі типи входів (перемикачі тощо) працюють однаково. Для кожного введення потрібен NAME та
це ім’я має бути в квадратних дужках у вашому шаблоні електронної пошти. Це так просто. До
отримати більше ідей, див. сторінку прикладу cgiemail.

зробити Переконайтеся ДІЇ is виправити.
Найскладніша частина форми HTML - це правильно встановити ACTION. Почніть з
URL-адресу вашого шаблону електронної пошти, а потім розділіть його на дві частини, напр

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ /\ /
`--- Частина 1 ---' ` --------- Частина 2 ----------'

Потім ви розміщуєте назву сценарію посередині. Зазвичай це ``/cgi-bin/cgiecho'', але це
залежить від того, як налаштовано ваш сервер. На web.mit.edu це трапляється
``/bin/cgiecho'', тому моя ДІЯ виглядає так:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- Частина 1 ---' назва сценарію ` --------- Частина 2 ----------'

Для простоти ви можете пропустити частину 1, але ви повинні включити її, якщо хочете перевірити свою
форму у вигляді локального файлу. Якщо ви не знаєте, що це означає, сміливо пропустіть частину 1.

пробувати з ваш форма з cgiecho.
Помістіть свою форму у свій улюблений WWW-браузер, заповніть введені дані та надішліть її. ти
має побачити, як виглядає оброблена форма. Якщо замість цього ви бачите помилку з номером
близько 500, ваша ACTION, ймовірно, налаштована неправильно. Поверніться до попереднього кроку.

Якщо деякі з ваших введених даних, здається, не відображаються в обробленому вигляді, переконайтеся в цьому
вхідні дані мають ті самі імена у формі HTML, що й у шаблоні ASCII. напр
NAME="ваше ім'я" у формі HTML і [ваше ім'я] у шаблоні електронної пошти.

Go жити з cgiemail.
Тепер змініть cgiecho на cgiemail у ДІЇ вашої HTML-форми. Спробуй. Ти повинен
отримати електронне повідомлення з обробленою формою. Якщо ви отримуєте сторінку успіху, але не отримуєте
отримати пошту, виникла проблема з файлом шаблону. Поверніться і переконайтеся
правильно дотримувались інструкцій у кроці 1.

Якщо це спрацює, вітаю!

9. Налагоджуйте, якщо ви не отримуєте пошту

Зазвичай пошта надсилається асинхронно, тобто потрапляє в чергу для відправлення в
зручний час. Асинхронна пошта надсилається ефективніше та надійніше, але має
недоліком є ​​те, що про проблеми можна повідомити, лише надіславши повідомлення про помилку на адресу
відправник. Для поштової системи здається, що відправником пошти є веб-сервер, отже
повідомлення про помилку не прийде до вас.

Якщо ви не отримуєте пошту, ви можете тимчасово використовувати синхронну доставку пошти, створивши
прихований вхід з назвою cgiemail-mailopt і надання йому значення, що містить "sync", наприклад



Примітка: для версії 1.1 це не працюватиме. Попросіть свого веб-майстра встановити новішу версію.
Деякі розсилки мають нестандартне розширення, яке надсилає відмови на адресу в Помилки-
To: заголовок на додаток до веб-сервера. Однак у цьому рядку заголовка є деякі помилки
неможливо прочитати, тому немає жодного способу бути впевненим, що відмова дістанеться вам.

Додатково: додавати текст до успіх стр.
Коли лист надсилається, з’являється сторінка під назвою «Успіх» з текстом повідомлення електронної пошти.
Ви можете використовувати приховану змінну під назвою ``addendum'', щоб додати свій власний текст. Ось простий
приклад:



Якщо ви готові припустити, що читачі вашої форми використовують новітнє програмне забезпечення браузера
як Lynx 2.6 або Netscape 3.0, то ви можете додати HTML-розмітку в цю змінну за допомогою
відповідні сутності символів. Наприклад, якщо ви хочете додати

Дякую!

тоді буде розмітка HTML

Дякую!

це означає, що вам знадобиться наступне у вашій формі:

<INPUT TYPE="прихований" NAME="додаток"
VALUE="<em>Дякуємо!</em>">

Зауважте, що ця функція, крім того, що її складно писати, не працюватиме для людей, які користуються старшими
програмне забезпечення для браузера.

Додатково: Скористайтесь an чергувати успіх стр.
Якщо вам не подобається сторінка за замовчуванням, яка з’являється після успішної відправки електронної пошти, ви можете
вкажіть альтернативну URL-адресу, використовуючи приховану змінну під назвою ``успіх'' у вашій HTML-формі,
наприклад

<INPUT TYPE="прихований" NAME="успіх" VALUE="http://web.mit.edu/">

Примітка. Почніть свою URL-адресу з / або з http://. Інакше cgiemail спрямовує ваш браузер
до другого виклику cgiemail, що призводить до помилки Без заміни змінних.

Починаючи з версії 1.3, неможливо зробити так, щоб ця альтернативна сторінка успіху містила інформацію
користувач, поданий у формі. Ця функція, ймовірно, буде додана в майбутньому випуску.

Додатково: зробити деякі витрати вимагається.
Якщо ви хочете автоматично відхиляти форми з певними вводами, залишеними пустими, додайте
префікс ``обов'язковий-'' до назви вводу як у вашій HTML-формі, так і у вашій електронній пошті
шаблон. Ось приклад:

У формі HTML:

Твоє ім'я:

У шаблоні електронної пошти

Ваше ім'я: [обов'язкове-ваше ім'я]

Додатково: Вказувати форматування та цінності деякі вхідних даних.
Якщо у вашому шаблоні електронної пошти текст у квадратних дужках починається з %, cgiemail буде
використовувати printf () функція в C у назві поля після коми. Якщо ви не знайомі
з цією функцією подивіться в книзі на C. Якщо ви знайомі з нею, зверніть увагу на це
дві відмінності:

· Перший символ у рядку форматування має бути %.

· Символи на кшталт \n та \t мають бути буквальними. Якщо ви хочете новий рядок, ви повинні поставити a
новий рядок безпосередньо перед комою, хоча це виглядає дивно. Наприклад, якщо
Godzilla's Pizza хотіла, щоб начинки були вказані по одній на рядок, вони додали наступне
їх шаблон електронної пошти:

[%s
,топінг]

Додатково: Скористайтесь CGI навколишнє середовище змінні.
Ця функція може працювати чи не працювати залежно від того, увімкнув її ваш веб-майстер
під час налаштування cgiemail.

На додаток до введених форм, ваш шаблон електронної пошти може містити змінні середовища CGI
просто поставивши перед назві змінної знак долара. Наприклад,

[$HTTP_USER_AGENT]

додасть назву браузера та/або шлюзу користувача у ваше повідомлення електронної пошти. Щоб
поважайте конфіденційність, ваша HTML-форма повинна попереджати користувачів про будь-яку інформацію про
ті, які будуть включені в електронну пошту, наприклад HTTP_USER_AGENT, REMOTE_ADDR.

Адміністрарівія
Вихідний контакт: cgiemail[захищено електронною поштою]>

Супроводжувач Debian: Анібал Монсалве Салазар[захищено електронною поштою]>

Повна інформація щодо створення, встановлення та використання cgiemail доступна на WWW:

http://web.mit.edu/wwwdev/cgiemail/

Використовуйте cgifile онлайн за допомогою сервісів onworks.net