================================================================================
@@ @@@@ @@ @@ @@ @@ @ @ 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 EMail 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.
FEATURES: (version: 5.4 - date: 24.05.2010)
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
· 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.
· it optionally supports attachments.
CHANGES:
¯¯¯¯¯¯¯¯
· updated the documentation.
· fixed bug under MacOS(X).
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 or 777.
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 grafic 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)
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.
$size = "1024";
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The size of the attachment. 1024 is equal to 1 MB. 0 automatically turns off
the attachments.
$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.
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
$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 = "antonio.vivaldi@composer.it";
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
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 = "your_own@email.address.com, your_friend@email.address.co.uk";
$info = "http://www.db.ripe.net/whois?";
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
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: alecos@alecos.it
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-2010, 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.
================================================================================