I. Installation

Edit custom_configs.php file from /includes directory and set database name, user and password.
Run install.php
CHMOD 777 for 'Session', 'downloads', 'cache' and 'links' directories (in fact, apache user need write access).
Configure crontab to run "crontab_sessions.php" script at least once in a day
Configure crontab to run "send_emails.php" script once in a day.

Now you can login as admin with admin/admin (remember to change this password, is a very common password used in the entire world) Note: this package comes with a default TCS (an authentification key). It's recomandated to change this from admin section, after you login. This can be done very simple: -choose LIST SITES from menu, click RESEND TCS, and then check your email (email that you configured in custom_settings.php ) and copy paste TCS in the custom_configs.php file.

Mumsai is css based and is easy to change the design. Modify template.php and stil.css

II. Additional features

In addition, the mumsai provides useful features like link and download management.

II.1 Links management

- represents a tool to manipulate your links.

From an admin account, add a new label, add a new link, choose link's label and press [GENERATE LINK]. Links are stored in rss format (in links directory)

When the links are generated, is also generated an index.php file (full address: http://your-site.com/links/index.php), which allows your visitors to see your rss files.

The links are generated in the following manner:

is generated a single rss file with all labels (links/categories.rss)
for each label, is generated a rss file which contains all links from that category

On the client sites will appear all the links entered by you. By default, the cache time is set to 3 hours, and is made via magpierss rss parser.

II.2 How to use on a client site:

Copy the directory links_parser in the root of your client site
Create a directory named "cache" with rights permissions (chmod 0777 cache). Here are stored temporally files with links (expires after 3 hours).
If you do not want to do that, each time your client site is accessed, the rss parser will read from server site the links which imply a lot of band usage and slow speed of your site
Edit rss.php ( links_parser/rss.php), and change the address of rss file with labels
include in your script "rss.php" [e.g.: include("links_parser/rss.php"); ]
Now you can use the links array to display links in which manner you want. (e.g.: foreach ($links as $link) echo $link;)

II.3 Download management

There is a section called download management. Administrators users can upload files and set access mode (need user login, or not), description, version and links to license and documentation pages.
Each downloaded file it's counted.

II.4 Rss emails

Users can subscribe to receive newsletter in two ways:

1. Subscribe from Newsletter box" - they only need to enter their address. In this case, they will subscribe for news referring current web site address.
If doesn't exist an account associated with that email address, will be created a new one
2.Configuring Services option from their accounts (user choose name, rss address and sending interval)

Note: Rss news file for MUMSAI must be located in root directory. Also, send_emails.php script must be installed in crontab and run once per day.
To send manually emails to users, use Send email to users option.

II.5 Links exchange

If you exchange links with many sites, there is a feature (check links exchange) that can check automatically if your link it's still present in partners’ pages. When you insert a new link exchange you can choose from a list, what sites needs to be checked.

II.6 Last logins

List last logins from all clients, including MUMSAI.

II.7 User features

Once a user is selected ("choose user"/"choose user by email" option), an admin user can do the following actions:

List all registered users
List all users who receive news letter from a rss web address
1. Change user permissions (admin, user, moderator ...)
2.Change user password (do not require old password)

Installation of CLIENT SIDE

In order to authenticate users from a client web site through MUMSAI, you need to copy and configure some script files. Follow these steps:

Uncompress the file client.tar.gz to a directory in the root of your CLIENT web site.
give 777 permissions to Session directory (in fact, apache user needs write access)
From admin section, use "New site" to add this site, and then get TCS value from your email.
Edit the 'config_mumsai.php' file from client directory (more information you will find there)
Run the install.php from to create database tables.
Put specific code, located in index.php where you need (where login section you want to appear).
Configure crontab to run "crontab_sessions.php" script at least once in a day

Use example:

Your index.php should look like this:

        #start session############################################
        require ("core.php");
        $session=new Session();
        //put session in array to work like $_SESSION default array
        $SESSION=$session->getArray();
        #seesion##################################################

Login page :

        if(@$SESSION['username']=="")
        {
        echo "
        <center>
        <iframe width='400' height='400' src='redirect.php?&m=".$message."' frameborder='0'>Login frame</iframe>
        </center>";

        }
        else
        {
        echo "Welcome {$SESSION['username']}.<a href='logout.php'>Logout</a>";
        }
        ## end login ##

To find user permissions, use function getPermission(HTTP).This function will return one of the following string:

        -"User"
        -"Admin"
        -"Moderator

To store values in session, write $session->setSession("key",$value);