|
v |
Install & Configure the application
Unzip the file and place all the files in a password-protected directory at your
Website. If you do not know how to create a Website directory and password-protect that
directory you will need to research this on the internet. If you do not follow this
requirement everyone will be able to read your identifier file.
Note for skilled programmers: Place your scripts in a password-protected scripts
directory, like cgi-bin.
The file you downloaded needs to be unzipped. In it you will find these files:
readme.txt |
|
This file points to what you really need to read .
. . the index.php file. |
|
|
|
index.php
(instructions) |
|
READ
THIS FILE FIRST. You will not need to read the others, though you will have to modify the
setupconfiguration.php file. This is part of what you see in the instructions. |
|
|
|
InstallAndConfigure.php
(instructions) |
|
This file describes how to install and configure
this program & is part of what you see in the instructions. |
|
|
|
ManageEmail.php |
|
This file manages the e-mail accounts and is
the E-mail manager. |
|
|
|
setupconfiguration.php |
|
Use this file to enter all variables (information)
that identify the e-mail server, the Website URL, and business name. |
|
|
|
emailList.txt |
|
This is the identifier file. It is the file this
application reads and writes to, to map an ID with other information, like e-mail address.
It contains IDs 000, 001, and 002 which
you need to delete because they are only used to test your scripts. You will delte them
using the DELETEaRecord.php script.
|
|
|
|
contactmeScript.php |
|
This script creates the user form used to send
e-mail to a staff member. |
|
|
|
contactmesent.php |
|
This script actually sends the e-mail and returns
a thank you message to the sender. It automatically closes after 5 seconds. |
|
|
|
EmailReplyScript.php |
|
This script creates and processes the form the
staff person uses to send a blind e-mail. |
|
|
|
ADDaRecord.php |
|
This script allows the administrator or Webmaster
to add a record. |
|
|
|
DELETEaRecord.php |
|
This script allows the administrator or Webmaster
to delete a record. |
|
|
|
SEARCHaRecord.php |
|
This script allows the administrator or Webmaster
to search a record so it can be identified and deleted. |
|
|
|
DeletesRecords.php |
|
This script deletes the records. |
|
|
|
exampleMoveToAnotherDirectory.htm |
|
This is a quick-and-dirty example of a page that
you would create that allows your staff to reply to an e-mail, when they want to hide
their e-mail address. Place it in another password-protected directory. |
|
|
|
header.php |
|
This generates the header information. |
|
|
|
navbar.php |
|
This generates the navigation bar information. |
|
|
|
footer.php |
|
This generates the footer information. |
|
|
|
SendReceiveManagerEmail_1dot0.css |
|
This is the casscading style sheet, which formats the text (font, size, color, etc.). |
|
|
|
Logo_01.gif |
|
This is the applications logo. |
|
|
|
bullet_lightgreen_10by10_1purple.gif |
|
This is a bullet. |
Here is the code you enter on the HTML file (page) that starts the send e-mail process.
If you are not familiar with HTML coding, even though you may use a Web page creation
program, this will sound like Greek. You will need to learn basic HTML coding.
Let us say that someone wants to send John Doe an e-mail. On the page where you are to
initiate an e-mail to John Doe, enter the following code (in red)
between the HTML head tags (<head></head>):
<head>
<title>E-mail Form Test</title>
<script language="JavaScript"><!--
function myopen(filename,windowname,properties) {
mywindow = window.open(filename,windowname,properties);
}
//--></script>
</head>
<body>
The above is JavaScript (a programming language) that works with the code below
to open up a new window. Now, on this same page, enter the following code where you want
to place a link that will refers to John Doe. Note that there are no
spaces between the code highlighted in red:
Send an e-mail to <a
href="javascript:myopen('contactmeScript.php?searchname=529','windowName','name=form1,toolbar=no,
location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=no,
copyhistory=no,width=650,height=300')">John Doe</a> </p>
The part of the code that specifies John Doe in the identifier file is 529.
The width=650 and height=300 refer to the size of the
popup window. The other code specifies window parameters that go beyond our current
discussion. Play with the window size numbers to suit your form needs. Do not forget
to replace John Doe with the staff member's name or with a phrase like Contact me.
When staff want to reply to an email using the E-mail Reply Form script, they need to go to a password-protected Web page. Yes, you
need to generate this page yourself.
- Place the page in another password-protected directory so that only autorized staff have
access to it. The page should describe your e-mail process and link to the script, located
in another directory. A quick-an-dirty example is given in the
exampleMoveToAnotherDirectory.htm file.
Identifier file
The identifier file includes the following information
(fields) on each line:
- ID: Used to identify the line that refers to John Doe. The 3
alpha/numerical ID needs to be unique (different).
- Salutation: Like Mr., Mrs, Ms., Father, Sister
- First name
- Last name
- E-mail address: This must include the entire string like JohnDoe@someplace.com
- Telephone: The format must include hyphens with no spaces, such as
000-000-0000. Note: You can change this requirement, however just make it conisistent and
do not use tabs.
- Notes: This element includes additional information. The Webmaster can
make notes to help remember the user's specific requests or leave it blank.
Of course we could have included additional fields, but this is good for a basic e-mail
program. With a little bit of examination, you should be able to figure out how to add
more fields (challenge).
The identifier file is a DOS text file and is labeled:
The seven fields above (ID through Notes) are entered on each line, SEPARATED BY ONE TAB. The E-mail address Manager program lets you add this
information without having to code the identifier file yourself. The program also enters
ONE hard return (paragraph) to end a complete record. Here is what the file could look
like:
000 The The Webmaster
webmaster@someplaceelse.com 000-333-3333
This blue text is just for this illustration to
show you that your Notes section can get pretty long. Jerry Smith is the Webmaster and
receives his mail at a different location. Notice that this line wraps to the next line.
Well, the program will continue to read this as one long line until it sees a paragraph
return. Even though you will not see the paragraph return, the program will see it. . .
and the tabs too.
001 Mr. John Doe
JohnDoe@someplace.com 651-437-5282 No notes
002 Mrs. Mary Doe
MaryDoe@someplace.com 651-437-5283 No notes
003 Father Joe Smith
fedeeecccceeeee@yahoo.com 651-437-5284 No notes
004 Sister Mary Dilanton
sistermary@someplace.com 651-437-5285
Do not forget to include tabs only between
fields if you decide to code by hand, without the use of the e-mail manager.
|
. |