Nameko - Readme
===============

OVERVIEW
--------
Nameko is a PHP webmail.
It's very simple to install and maintain on your server, because it's composed by only one file: just copy it into your
web space and it works!


CONFIGURATION
-------------
Open the file (nameko.php) and set this variables:

$DEFAULT_COLORSET="GREEN"; //VIOLET,GREEN,BLUE,BROWN
$DEFAULT_FONTSIZE=10; //integer from 7 to 16
$DEFAULT_MAIL_PER_PAGE=10;
$SERVERS=array();

$DEFAULT_COLORSET must be a string with the default colorset to be used when the webmail is opened: you can choose among VIOLET, GREEN,
                  BLUE, BROWN and GREY (default);
$DEFAULT_FONTSIZE must be an integer between 7 and 16, with the font size to be used when the webmail is opened;
$DEFAULT_MAIL_PER_PAGE must be an integer between 5 and 50, multiple of 5, whit how many mails show per page;
$SERVERS should contain a list (array) of servers allowed to be connect to. If this array is empty you can insert the server address into
         a text field.
$USERS_POLICY must be contain keyword "allow" or "deny": it define the default behaviour of access control list. If it's "allow" by default
              every user can use Nameko except users contained into $USERS_LIST array. If it's "deny" by default no user can use Nameko,
              except users contained into $USERS_LIST array. If this variable contain an unknown value it's taken as "deny".
$USERS_LIST should contain a list (array) of users that can or cannot use Nameko, according the $USERS_POLICY value.
$POP_AUTH_METHOD should contain the kind of authentication method used by the server, between "standard" (for standard username/password
                 authentication), or "apop" (for the APOP method)
$EXTERNAL_SMTP_SERVER should contain the address of the external SMTP server to use to send email. If empty, Nameko will use the PHP build-in
                      mail() function.
$EXTERNAL_SMTP_USERNAME and $EXTERNAL_SMTP_PASSWORD should contain username and password for SMTP server that require authentication.


RFC
---
822 - Standard for the format of ARPA Internet Text Messages
1342 - Representation of Non-ASCII Text in Internet Message Headers
1939 - Post Office Protocol - Version 3
2045/2046/2047/2048/2049 - Multipurpose Internet Mail Extensions
1869/2554 - SMTP Service Extension for Authentication


SUPPORT MY WORK, PLEASE!
------------------------
Nameko is totally free. I to not make any profit by its development and maintenance.
If you think it's great and useful, you can make me a little donation through Paypal.
Not a lot: only 2 or 3 Euros (or dollars, it's the same for me), and I'll drink a pineapple juice to yours health!
If you want go to:

 https://www.paypal.com/xclick/business=paypal%40wiz.homelinux.net&item_name=Wiz%27s+Shelf+-+Nameko&no_note=1&tax=0&currency_code=EUR

and fill the Paypal form to make me a donation.
Thank you in advance!
