Location: PHPKode > scripts > A71Mail - The Email Form Written In PHP > A71Mail/a71mail_doc/doc_en.txt
================================================================================

     @@  @@@@  @@      @@ @@  @@  @ @          Email System Written In Php
    @  @   @  @ @      @ @ @ @  @ @ @          ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    @@@@  @     @ @@@@ @   @ @@@@ @ @            By Alessandro Marinuzzi
    @  @  @     @      @   @ @  @ @ @@@@         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯



    INTRODUCTION:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    I wrote A71-Mail only for my personal use because  I wasn't enough satisfyed
    with other  web mail scripts! Now, A71-Mail is available  for those who  are
    still looking for an efficient and customizable php  script in order to keep
    the contacts on the web  with other people. Of course, A71-Mail doesn't show
    your email address in any way and so it respects your privacy. The result is
    that any spammer cannot bother you! A71-Mail is able to  provide infos about
    the senders, so you are able to protect yourself in case of offensive email!
    A71-Mail means Alecos71-Mailer!

     _________________________________________________
    | ·-·-· A71-Mail is dedicated to my mother! ·-·-· |
     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


    REQUIREMENTS:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    · Any web server capable to run php scripts.
    · Php 4.3 or better installed on the server.
    · Suggested to migrate to PHP 5.


    FEATURES: (version: 5.640 - date: 01.09.2012)
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    · it supports multiple email recipients.
    · it's nice and has friendly error messages.
    · it gives details about the visitors like ip, browser, os, referer...
    · it's configurable by setting the file "userdat.php".
    · it's very easy to use and install.
    · it comes with a nice graphic interface.
    · it's fully configurable because it uses esternal templates.
    · it has inline error messages.
    · it's able to verify any field by using the regex.
    · it optionally supports a whois service.
    · it supports an external argument as variable in the url.
    · it supports non standard browsers.
    · it supports 6 languages at the moment.
    · it doesn't need to be revalidated each time.
    · it supports email-log for every mail sent.
    · it supports antispam filters and keys.
    · it uses a captcha-like technique.
    · it includes only files that are on your web site.
    · it supports UTF-8.
    · it optionally supports a GeoIP service.
    · it supports the skins (a71mail_css).
    · it optionally supports multiple attachments.
    · it checks for updates.
    · it shows a progress image for attachments.
    · it allows to change the progress image (a71mail_img).
    · it optionally use extensions filter for attachments.


    CHANGES:
    ¯¯¯¯¯¯¯¯
    · removed border-radius.htc.
    · fixed problem with the permissions for logs.


    INSTALLATION:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    NOTE: When modify a file, remember to save it as UTF-8 format!
    ¯¯¯¯¯
    Simply you have to follow these simple steps:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    1) Extract A71Mail.zip where you want.
    2) Modify the file "userdat.php" using a text-editor.
    3) Modify the file "keyword.php" using a text-editor.
    4) Copy all files into the same folder on your web site.
    5) Set the permissions for all files to 755.
    6) Link a71mail.php in your web page.
    7) Enjoy A71-Mail!
    8) There is nothing else to do!


    NOTES: (for experts)
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    The following files  are fully customizable so you can arrange them in order
    to satisfy your own graphic necessities:

    · userdat.php <- configuration file (ascii,utf-8)
    · formail.php <- mail form (html,utf-8)
    · confirm.php <- redirect (html,utf-8)
    · strg_en.php <- english strings (ascii,utf-8)
    · strg_it.php <- italian strings (ascii,utf-8)
    · strg_fr.php <- french strings (ascii,utf-8)
    · strg_de.php <- german strings (ascii,utf-8)
    · strg_es.php <- spanish strings (ascii,utf-8)
    · strg_sq.php <- albanian strings (ascii,utf-8)
    · keyword.php <- antispam keywords (ascii,utf-8)
    · default.css <- cascading style sheet (ascii,ansi)
    · colored.css <- cascading style sheet (ascii,ansi)
    · bluesky.css <- cascading style sheet (ascii,ansi)
    · bluelit.css <- cascading style sheet (ascii,ansi)
    · histyle.css <- cascading style sheet (ascii,ansi)

    If you  want to translate  A71Mail into your language  simply make a copy of
    the file strg_en.php and translate the strings into your language  but don't
    forget to  rename your  stranslated copy  of strg_en.php in  strg_<lang>.php
    where <lang> is the code lang used  by the browser... for example if you are
    a japanese user rename  your stranslated  copy of  the file  strg_en.php  in
    strg_ja.php and A71Mail will detect the new language automatically.

    You are allowed to rename the following file but you cannot modify it in any
    way (example: a71mail.php -> index.php):

    · a71mail.php <- main script (engine)


    CONFIGURATION: (userdat.php)
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Warning: these variables must start with " and must end with ";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    · if the " is deleted or missed the script will fail.
    · if the ; is deleted or missed the script will fail.

    $chck = "on";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    Set to "on" notify updates via mail. Set to "off" disables this feature.

    $size = "1024";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    The size of the attachment. 1024 is equal to 1 MB. 0 automatically turns off
    the attachments.

    $file = "3";
    ¯¯¯¯¯¯¯¯¯¯¯¯
    The number of attachments allowed. There is no limit for attachments! Can be
    1 or 100!

    $chex = "on";
    ¯¯¯¯¯¯¯¯¯¯¯¯
    Set  to "on" uses a filter for the attachments allowed while set to "off" ac
    cepts any attachments.

    $type = array("zip","lha","rar","txt","doc","jpg","png","gif");
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    This is the filter for the extensions  allowed for the attachments. Edit the
    list as you like.

    $text = "LTR";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    The direction of text:

      · LTR is used for writing from left to right

      · RTL is used for writing from right to left

    $lang = "auto";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Forces your preferred  language (allowed values are: "it" or "en" or "fr" or
    "de" or "es" or "sq" or "auto").
    A71-Mail is auto-detect and  so it  can get  the  language from the  visitor
    showing the  form in the native user language (for this purpose, the browser
    must support this feature). If you  want to  enable the  auto-detect feature
    let $lang = ""; without any value within the variable or let $lang = "auto";

    This value can be overwritten by invoking the script as follow:

      · http://www.your.website.com/a71mail/a71mail.php?lang=it

        or

      · http://www.your.website.com/a71mail/a71mail.php?lang=fr

        or

      · http://www.your.website.com/a71mail/a71mail.php?lang=de

        or

      · http://www.your.website.com/a71mail/a71mail.php?lang=es

        or

      · http://www.your.website.com/a71mail/a71mail.php?lang=sq

        or

      · http://www.your.website.com/a71mail/a71mail.php?lang=en

    $skin = "default";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Here  you can  choose the  skin to show to visitors. At the moment there are
    the following skins: default, colored, bluesky, bluelit, histyle.

    This value can be overwritten by invoking the script as follow:

      · http://www.your.website.com/a71mail/a71mail.php?skin=default

        or

      · http://www.your.website.com/a71mail/a71mail.php?skin=colored

        or

      · http://www.your.website.com/a71mail/a71mail.php?skin=bluesky

        or

      · http://www.your.website.com/a71mail/a71mail.php?skin=bluelit

        or

      · http://www.your.website.com/a71mail/a71mail.php?skin=histyle

    $path = "http://www.your.website.com/";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    When the email is  sent the visitor may be redirected to a specific place of
    your web site. Example:

    · $path = "http://www.your.website.com/thanks.php";

    If you like, you can  use a default configuration, so that the  visitor will
    be redirected  to the root of  your web site. So, if you want to  enable the
    default  configuration, let $path = ""; without any value  within the varia-
    ble.

    The $path variable can be overwritten invoking the script as follow:

    http://www.website.com/web/a71mail.php?page=http://www.website.com/info.html

      or

    http://www.website.com/a71mail/a71mail.php?page=http://www.website.com/

    $mode = "_top";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Only for expert users. Redirecting visitors to a specific place  of your web
    site may be very hard if you have frames, so you can set a specific value in
    order to solve this problem. Examples:

    · $mode = "_top";

    Overwrites all frames loading a single web page or the complete web site.

    · $mode = "_parent";

    Overwrites the last  frame loading a single web page or the complete web si-
    te.

    · $mode = "_self";

    Loads a specific web page into the current frame or window.

    · $mode = "_blank";

    Loads a specific web page into a new window.

    $logs = "on";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    If the variable $logs is set to "on" a log file for  each email sent will be
    created. If the variable $logs is set to "off" no log will be created.

    $name = "Antonio Vivaldi";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Put into the variable $name your name and surname or firm name.

    $mail = "hide@address.com";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Put into the variable $mail your email address. If you want to  process more
    email addresses as  recipients add, after a comma and a blank space, the new
    email address so that the email form contents will be sent  to the specified
    recipients. Example:

    · $mail = "hide@address.com, hide@address.com";

    $info = "http://whois.domaintools.com/";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    This is the default whois service but you can change it with another one. So
    you will be able  to know more  infos about the sender in case  of offensive
    email.

    $goip = "http://www.geoiptool.com/?IP=";
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    This is the default GeoIP service but you can change it with another one. So
    you will be able to know more infos about the sender.


    TIPS AND TRICKS:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    http://www.your.website.com/a71mail/a71mail.php?lang=en&fname=your name

    http://www.your.website.com/a71mail/a71mail.php?lang=en&fmail=your email

    http://www.your.website.com/a71mail/a71mail.php?lang=en&subject=your subject

    http://www.your.website.com/a71mail/a71mail.php?lang=en&message=your message

      or

    mail.php?fname=something&fmail=something&subject=something&message=something


    AUTHOR:
    ¯¯¯¯¯¯¯
    Alecos ->  Fullname: Alessandro Marinuzzi
               Country:  Italy

    E-Mail:    hide@address.com
    Web:       http://www.alecos.it/


    THANKS:
    ¯¯¯¯¯¯¯
    · Adolf Brunner for German translation.
    · Javier de las Rivas for Spanish translation.
    · Bledy for Albanian translation.


    STATUS:
    ¯¯¯¯¯¯¯
    A71-Mail · Copyright © 2004-2012, Alessandro Marinuzzi [Alecos] · All Rights
    Reserved.

    A71-Mail is Shareware! This means that if you like this software and you use
    it, you are asked to make me a payment using PayPal or other system.
    The price is 10 Euro! The license is valid for a single website, If you want
    to use A71-Mail on multiple websites you need to buy more licenses.


    LEGAL:
    ¯¯¯¯¯¯
    This software is subject to the following terms of licence:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    1) You cannot modify the script a71mail.php, the other files may be changed.
    2) You cannot distribute  this software  together to  the obscene or illegal
       stuff.
    3) You cannot modify in any way the archive which contains my script and all
       related files without my express permission.
    4) You cannot use this software for any illegal or obscene purpose.
    5) You cannot use this software as an anonymous emailer.
    6) You cannot use this software for spamming or sending offensive email.
    7) You accept any risk downloading this software as described below.
    8) If you don't agree with these terms of licence, delete this software now!


    DISCLAIMER:
    ¯¯¯¯¯¯¯¯¯¯¯
    THIS  SOFTWARE IS  PROVIDED "AS IS", WITHOUT  WARRANTY  OF ANY  KIND, EITHER
    EXPRESSED  OR IMPLIED, OR OTHERWISE. BY USING THIS  SOFTWARE, YOU ACCEPT THE
    ENTIRE  RISK. ALESSANDRO MARINUZZI  SHALL BE  NOT LIABLE  FOR ANY  DIRECT OR
    INDIRECT  DAMAGE, INCLUDING DAMAGE FOR ANY  DATA OR INFORMATION WHICH MAY BE
    LOST.

================================================================================
Return current item: A71Mail - The Email Form Written In PHP