README
上传用户:wl2659
上传日期:2007-01-04
资源大小:8k
文件大小:6k
源码类别:

WEB邮件程序

开发平台:

PHP

  1.   phpEasyMail
  2.   Version 2.0 - 04/05/1999
  3.   Authors: Tobias Ratschiller <tobias@dnet.it>
  4.            Jason Birch <jason@psp.pair.com>
  5.   see bottom for version history
  6.   Description:
  7.     This is Yet Another Form2Mail Script. 
  8.   Requirements:
  9.     PHP3 - tested with 3.0.6
  10.     MySQL if you want logging - untested
  11.                 
  12.   Summary:
  13.     phpEasyMail is intended to send HTML-forms via email
  14.     in a formatted style. Additionally, some simple statistics
  15.     can be provided for the adminstrator.
  16.   Two versions?
  17.     Yes, there are two versions of php{Easy}Mail included:
  18.     - phpEasyMail is the same as earlier versions, but with added functionality.
  19.     - phpMail is a complete rewrite to allow calling it instead of calling an HTML page.
  20.     You can choose which one best suits your needs.  The second version is a bit
  21.     more powerful in that it can report on what fields are missing, whether an
  22.     email address is incorrectly formatted, whatever, while the first version
  23.     is somewhat easier to configure.
  24.   Getting Started (phpEasyMail.php3):
  25.     - create an HTML page to input a form (see from.inc for examples)
  26.       as well as a success page and a failure page.
  27.     - have the form HTML page call phpEasyMail.php3
  28.     - modify the defaults.inc file to suit your preferences
  29.     - set up your database if required (see Logging below)
  30.   Getting Started (phpMail.php3):
  31.     - rename the file phpMail.php3 to something that suits your form
  32.     - modify the defaults.inc file to suit your preferences
  33.     - change the HTML in "header.inc", "footer.inc", "form.inc",
  34.       "welcome.inc", "missing.inc", "badfrom.inc", and "thanks.inc"
  35.       to match your site.
  36.     - set up your database if required (see Logging below)
  37.   The Form Interface:
  38.     The form which is called by phpEasyMail.php3 controls 
  39.     the script by form-variables:
  40.     to           The target email-address.
  41.     from         The sender's email-address.
  42.     subject      The subject of the email.
  43.     extras       Any extra headers to include in the mail
  44.     required     Used to enter the fields (comma-separated) which must
  45.                  be filled out by the sender.
  46.     template     A template for the email-body. Variable-names 
  47.                  are enclosed with "%".
  48.     autofrom     Who the autoreply should be from.
  49.     autosubject  The subject of the autoreply.
  50.     autoextras   Any extra headers to include in the autoreply
  51.     autoreply    If the inquiry should be answered with an auto-reply, you
  52.                  can specify the text for it here. This uses the same format
  53.                  as the template field.
  54.     checkfrom    (En/Dis)able checks for valid email address
  55.     log          Determines if logging should be enabled.
  56.     logbodies    Specifies whether the body should be logged.
  57.     askagain     Should the user be prompted for another submission? (phpMail only)
  58.     url_error    Where to go when things go bad (phpEasyMail only).
  59.     url_success  Where to go when things go good (phpEasyMail only).
  60.     More information on these form-variables can be found in the
  61.     config file "defaults.inc".  Just remove the "def" to get the
  62.     variable name.
  63.     Examples of how to use these in a form can be found in the
  64.     included file: "form.inc"
  65.     
  66.     All variables are optional as long as you set up default values for them
  67.     in the config file.  If you don't specify a template, all form-variables
  68.     are sorted and inserted line by line into the email-body.
  69.   Logging:
  70.     Logging requires MySQL and MySQL-support in PHP3.  A text file (phpEasyMail.sql)
  71.     has been included to give you the table format.  Be sure to change the table
  72.     name when creating the table if you change the value of $table in the
  73.     "dbase.inc" file.
  74.   Configuration:
  75.     All configuration options can be found in the well-documented
  76.     file "defaults.inc".  There are quite a few more in version 2 than
  77.     there were in version 1, but all the new ones can be ignored until
  78.     you find a need for them.
  79.  
  80.   Differences from 1.x
  81.     - Primarily, the addition of phpMail to the distribution.
  82.     - Optionally, allows user to post another message after first.
  83.     - Several added configuration options, including the ability
  84.       to supress mail (log and/or autoreply only) as well as the
  85.       ability to log message bodies, and more control over the
  86.       autoreply function.
  87.     - Code has been modularized for easier maintenance.
  88.   Todo:
  89.     - Any suggestions?
  90.   Files:
  91.     readme             - This file (you're reading it)
  92.     phpEasyMail.php3   - Forms processor version.
  93.     phpMail.php3       - Forms generator version.
  94.     common.inc         - Common functions for both versions.
  95.     defaults.inc       - Configuration defaults.
  96.     dbase.inc          - Database setup file.
  97.     files.inc          - Filenames for HTML chunks.
  98.     form.html          - HTML form including required fields.
  99.     header.html        - HTML display header.
  100.     footer.html        - HTML display footer.
  101.     welcome.html       - HTML welcome message.
  102.     missing.html       - HTML missing required fields message.
  103.     badfrom.html       - HTML bad email address message.
  104.     thanks.html        - HTML thank-you message
  105.     phpEasyMail.sql    - A MySQL dump of the logging table.
  106.     phpMailStats.php3  - A simple statistics page.
  107.     percent.gif        - support file for the stats program
  108.     percentoff.gif     - support file for the stats program
  109.     styles.css         - A style sheet for the stats program.
  110.   Version History:
  111.     v 2.0.0 - 04/05/1999: Initial rewrite by Jason Birch
  112.     v 1.1.0 - 03/02/1999: Bugfixes in the stats-part.
  113.                           Added auto-reply.
  114.                           Added check to see if the from-address is valid.
  115.     v 1.0.1 - 09/26/1998: Added stripslashes().
  116.                           Changed min(t_stamp) to now().
  117.                           Changed $REMOTE_ADDR to GetHostByAddr($REMOTE_ADDR).
  118.                           Added number_format to Avg. Mails/Day.
  119.     v 1.0.0 - 09/19/1998: First release. Added percent-bars.
  120.     v 0.9.0 - 09/09/1998: First internally used version
  121.