DOCUMENTS/POSTFIXADMIN.txt: updated

git-svn-id: https://svn.code.sf.net/p/postfixadmin/code/trunk@350 a1433add-5e2c-0410-b055-b7f2511e0802

DOCUMENTS/POSTFIXADMIN.txt

@@ -1,20 +1,26 @@
-
 ---------------------------------------
   The different parts of PostfixAdmin
 
-/admin directory scripts are used by superadmins, also known as 'site admins'.
+
-When you log in as a superadmin you'll be running scripts from /admin that
+Postfix Admin has a concept of a "global" administrator (think 'root') and 
-won't bother checking to see if you are allowed to admin for a domain.  As
+domain administrators.  When you install PostfixAdmin, the setup.php file 
-a superadmin you can add and remove domains, mailboxes, aliases, domain admins,
+will ask you to create the global administrators account. Using this global
-and create more superadmins.  A superadmin will be not stopped from doing
+account, you can (if you so wish) create domain administrators who are 
-anything, so be careful, you can delete your our login account.
+limited to making changes within the domains you specify for them.
-
+
-login.php sorts out what type of admin you are and sends you to the right place.
+Historically when you logged in as the 'global' (or superadmin) user, you'd
-The scripts in / are used by domain admins and always check to see if you are
+access /admin; with version 2.2.0, this 'functionality' was removed (as there
-an admin for the domain (or user within a domain) you are attempting to change.
+was excessive code duplication) and everyone uses the same login.php script.
-
+
-End user scripts only do operations on the currently logged in user. 
+
-If the end user options provide more than you want your users to have,
+Needless to say, as a global administrator, you can do all kinds of bad things -
-check the user options in config.inc.php, or, even better, edit the
+like deleting domains and stopping delivery of mail to a particular mailbox. So
-user templates and remove the options.
+- take care, and if you're unsure take semi-regular backups.
+
+
+If you login, and you are not an administrator (i.e. you are a 'regular' user
+who just has a mailbox on the server), then you will only see functionality to 
+modify your own account - e.g. change password, edit forward records and specify 
+whether you are on vacation (out of office) or not.
+