Maian Uploader v4.0 Documentation
- HOME -   - INSTALLATION -   - UPGRADE -   - F.A.Q. -   - SCRIPT INFO -
Please read the following installation instructions carefully:
• A server running PHP v4.3 or higher. Some of the syntax will NOT work on earlier versions.
• Javascript enabled browser.
• A MySQL database to hold the script tables.
GD Library with Freetype support for image resizing & captcha code display. To find out how to check if you have this installed, see the F.A.Q page.
CURL support for the Paypal IPN system. To find out how to check if you have this installed, see the F.A.Q page.
• Safe Mode Off. Certain features will not function correctly if safe mode is enabled.
1 => Create a database to hold the script tables. If you are unsure of this procedure contact your web hosting company.

2 => Open up the 'inc/db_connection.inc.php' file in a text editor and edit it to point to the database you just created. DO NOT comment out the prefix function. If you don`t need to change it leave it as it is. You MUST also specify a cookie name and a secret key. DO NOT use the defaults!!

3 => Again in your text editor, open up the 'admin/inc/password.inc.php' file and choose a username and password for your admin area.

4 => Upload all the files/folders into a directory on your web server. Example: /uploads/

5 => Chmod the following folders to 777 to make them world writeable. (If your server accepts 755, then you should choose this as its known to be more secure):

- admin/backup/
- ftp/
- images/banners/
- log/
- user_uploads/

6 => Access the 'install/index.php' file in your browser and follow the set up instructions to complete installation.

7 => If the setup was successful log in to your admin area and select 'Options/Settings' from the drop down menu. Update the settings to your own preferences.

8 => Thats it, all done. For account set up see below.

SECURITY NOTE: For extra security you should rename your 'admin' folder to something unique!!
If the auto install has aborted, this is no problem, follow these instructions:

1 => Access your database using your MySQL admin program. PHPMYADMIN?. Click on the database you created for this script and delete any tables that have been created by this script. If you only have 1 database, be careful not to delete any other important tables.

2 => IMPORTANT!: The .sql file in the script has the prefix of 'mu_' before the table names. If you have specified a different prefix in the connection file then you need to change the prefix for the table names in the 'docs/schematic/tables.sql' file BEFORE you run it.

3 => When you are ready browse for and run the 'docs/schematic/tables.sql' file to set up the script tables.

4 => Log in to your admin area and select 'Options/Settings' from the drop down menu. Update the settings to your own preferences.

5 => Thats it, all done. For account set up see below.

SECURITY NOTE: For extra security you should rename your 'admin' folder to something unique!!
1 => To begin you need to create some account types, do this by selecting 'Accounts/Account Types' from the drop down menu. Add as many different account types as you need.

2 => If you want to collect additional information about your members, click on 'Accounts/Signup Fields' on the menu and enable any fields you need to.

3 => If you have enabled the banner rotation system, make sure you upload some banners. Do this by selecting 'Options/Banner Rotator' from the menu.

4 => The script processes files based on its mime type. To add additional mime types to the program, click 'Options/Mime Types' from the drop down menu. Note that some mime types may not be supported. To find out a mime type for a file, set up a user account and upload a file. The mime type will be specified in the user/admin area. For most people the mime types don`t need to be changed and will be fine as they are.

5 => If you need to post any admin announcements in the user admin areas, select 'Accounts/Announcements'. When an announcement is posted, a member is automatically directed to the announcements page when they log in. This will happen until they mark the message as read. If the announcement is updated, then the read status is removed and the member is directed to this page again. etc

6 => Most of the other buttons in the admin area should be self explanatory, but there is some additional info below for some of the functions and how they work. My advice would be to play around with the script and its functions before you go live.

7 => Assuming the script is in a folder called 'uploads', access the user sign up page using the following URL:

- http://www.yoursite.com/uploads/index.php?cmd=create

8 => Assuming the script is in a folder called 'uploads', access the user admin area using the following URL:

- http://www.yoursite.com/uploads/index.php?cmd=login or
- http://www.yoursite.com/uploads/index.php

9 => Assuming the script is in a folder called 'uploads', access the webmaster admin area using the following URL:

- http://www.yoursite.com/uploads/admin/index.php?cmd=login or
- http://www.yoursite.com/uploads/admin/index.php
For spam prevention, this script utilises a Captcha class to generate a random image on the sign up and new password pages.

For most people the default options will be fine. however if you wish, you can adjust the captcha settings. To alter the captcha settings, please open the following file in your text editor:

- classes/php-captcha.inc.php

Descriptions of each option are shown as you scroll down. Once you have made any changes, save and re-upload this file.
If you have a Paypal business account you can use their IPN (Instant Payment Notification) system to process payments. CURL MUST be installed on your server for this to work. The first thing you need to do is activate the IPN system if you haven`t already done so.

1 => If you are using the IPN system with another script, the IPN system will already be active. This script will not affect any other scripts using the system or your E-Bay account.

2 => Log in to your Paypal business account at http://www.paypal.com.

3 => Select 'Profile' from the top menu and then click 'Instant Payment Notification Preferences'. Then click the 'Edit' button.

4 => Before you enable the IPN system click the 'read the instructions' link on the Paypal website to make sure your server supports the IPN system.

5 => Check the box to enable the IPN system and in the URL box enter the following URL:

- http://www.yoursite.com/uploads/index.php?cmd=process

6 => Make sure the URL is correct. The IPN needs a default URL to send the data to. If you already have a URL in place, don`t worry, leave it as it is, it should still work ok as the URL of this script is sent to the Paypal website.Then click 'Save'.

7 => The IPN system is now enabled.

8 => If you want to log error responses from the Paypal website, activate logging in your admin area. The log entries will be visible in the 'logs/paypal_errors.txt' text file. It is recommended you do activate logging to analyze any problems that may appear.
The really great thing about the IPN system is you can test it out to make sure it works without the worry of actually processing any payment. For this unique option you need to have a Sandbox account. This is free to web developers and can be found here:

- https://developer.paypal.com

There are support forums for you to get help with the IPN system if you are experiencing problems. Once you have a Sandbox account set up you can enable this to test the script out.

To enable the IPN system in the script go to your admin area and select 'Options/Paypal IPN' from the drop down menu.
Paypal subscriptions are a work in progess. At the moment, renewing a cancelled account from the uploader interface is not available, nor is the option to update current single payment accounts to subscription based.

If subscriptions do not work as you want, revert to single payment.
If you are familiar with the IPN POST data variables you can echo these values on the 'paypal_thanks.php' page or any page you create providing it has a .php extension or is set to parse as a .php file. ie: using .htaccess.

Example:

Thank you for payment for <?php echo $_POST['item_name']; ?>.
The cost of your package was <?php echo $_POST['amount']; ?>

Any variable returned by the Paypal website may be used here to make your pages look more professional.

For more information visit the Paypal website and view the IPN documentation.
If you wish, you can enable FTP uploads for members. This is useful for large uploads. Here`s how it works:

1 => Log in to your server control panel and set up an FTP account for a member.

2 => Access your upload admin area, and find the member info for the member you wish to have FTP access. Click on the FTP icon to open the window with the FTP settings and enter the information for the account. The system will attempt to create the members FTP folder. If it can`t create it, it must be done manually. When the access is enabled, an additional folder is create inside the members upload dir. NOTE that you should give members access to their FTP folders ONLY.

3 => When the member logs into their account, they will see the FTP option. They must upload files to this directory and then refresh the page. The system will attempt to identify invalid files. When the files are processed, invalid files are auto deleted.

4 => FTP upload processing works similar to standard file uploads. The report that comes through is the same as for file uploads. A member could be locked out if they attempt to add invalid files via FTP and they have a lock limit set.

FTP uploads should only be set for members you can trust who will not abuse the system.

Admin FTP uploads work slightly differently. Firstly, specify the name of your FTP directory in your settings and create this directory in the uploader root. Upload files into this directory, then move them to the relevant member folder in your admin area.
All system templates are in the '/templates/' folder. All colour attributes and formatting can be found in the '/templates/stylesheet.css' file. For further information about some of the templates, see the '/templates/README.txt' file.
The code generator was updated in v4.0 to send code via e-mail. The templates for this feature are in '/templates/codegen_templates/' folder. Update the code if you need to. For most applications, the default should be fine.
Hopefully this installation guide has helped you get the script up and running. Check out the F.A.Q page for some solutions to common problems.

If you require any help at all, please post on the support forums. Thank you.
Powered by Maian Uploader v4.0
© 2003- Maian Script World. All Rights Reserved.