********************************************************************************************
* Users List Module for Mambo v1.4                                                         *
* 19-05-2002                                                                               *
*                                                                                          *
* Copyright (C) 2002 Emir Sakic                                                            *
* Distributed under the terms of the GNU General Public License                            *
* This software may be used without warranty provided and these statements are left intact.*
* This source is available at http://www.superbosna.com/mambo_hacks                        *
*                                                                                          *
* LoudMouth and Mambo are Copyright (C) 2000-2001 Miro Construct Pty Ltd                   *
* Source is available at http://sourceforge.net/projects/mambo                             *
*                                                                                          *
* Site Name: Mambo Server Site Version 3.0.5 - 3.0.7                                       *
* Component Name: Users List Module                                                        *
* Developer: Emir Sakic - saka@hotmail.com                                                 *
* Date: 19/05/2001                                                                         *
* Version #: 1.4                                                                           *
* Comments: This is users list module component for Mambo.                                 *
*           The module component shows list of registrated users                           *
*           fully integrated in mambo.                                                     *
*           Features paged view and user search.                                           *
*           Demo can be viewed at http://www.superbosna.com                                *
********************************************************************************************

This module contains following scripts:
- index.php (hacked Mambo script)
- userlist.php (module script)
- instulm.php (installation file)
- userlist/users.php (module script)
- userlist/english.php (language module script)

Instalation
===========

Before you do anything please make a back up of the following file:
index.php so you can regret the changes.

Easy way (replace the files)
----------------------------
1. Go to root directory of your Mambo instalation.
2. Upload file index.php (replace).
3. Upload file userlist.php and directory userlist/.
4. Upload the file instulm.php.
   Make sure the configuration.php is in the same directory.
5. Go to URL: http://www.yoursite.com/instulm.php to execute the installation file.
   Once successfully installed you can delete instulm.php from server.
6. Installation is now finished and you can go to your Mambo control panel to make 
   new meny item for this module (Components>Main Menu>Top Sections>New>Mambo Component>Users List).

Done!

Harder way (hack your file)
----------------------------
1. Go to root directory of your Mambo instalation.
2. Open your index.php file.
   Search for code:

		switch ($option){

   Under that insert the following code:

		case "userlist":
			include("userlist.php");
			break;

   Save and upload.
3. Upload file userlist.php and directory userlist/.
4. Upload the file instulm.php.
   Make sure the configuration.php is in the same directory.
5. Go to URL: http://www.yoursite.com/instulm.php to execute the installation file.
   Once successfully installed you can delete instulm.php from server.
6. Installation is now finished and you can go to your Mambo control panel to make 
   new meny item for this module (Components>Main Menu>Top Sections>New>Mambo Component>Users List).

Done!

Look at the files included for reference.

Several configurations can be made in users.php file.
You can set how many rows per page you want displayed and how many pages you want displayed in the menu.
You can configure whether you want user e-mail addresses to be shown (hidden by default).
If e-mail is enabled users can also be searched by e-mail.

The translation can easily be done either editing english.php file or making a new language file 
and including it in users.php instead of english.php.
The module look can easily be customized editing users.php file.


Send your comments or suggestions to: saka@hotmail.com