Requirements
Installation procedure

1 - Unzip all the files on your computer, and upload them to your server.

2 - The /temp directory should be chmodded to 777 (you can use net2ftp.com to do this).

3 - Set your settings in the settings.inc.php file. (Read "Next steps" below for more details.)

4 - A database is only required if you want to log the actions of the users. To create the tables, execute the SQL queries below (also in the "create_tables.sql" file). This can be done easily in PhpMyAdmin, the popular front-end to MySQL.




Next steps


Integration of net2ftp in an existing website
Integrating the login form

If your website runs PHP: in your existing script, include the PHP file "net2ftp_loginform.inc.php" and use the function "net2ftp_loginform()" to print the net2ftp login form -- see the file example_login_page.php. This will provide all functionality: the PHP function will read the net2ftp settings files and adjust the form automatically. For example, if only a list of FTP servers are allowed, the FTP server textbox will be changed a dropdown box.

If your website does not run PHP: simply copy the login form HTML -- see the file example_login_form.html. This will provide basic client-side functionality: the login form + the Javascript function which checks if the username and password are entered.

Linking directly to a particular net2ftp page
It is possible to direct users to a particular net2ftp page (browse a particular directory, upload page, ...). Log in, go to the page you want to link to, and click on the Bookmark button: . The next page will show you the link to use; this link does not contain any login information (username or password). When the users click on the link, they will be prompted for their login information by a popup window.

Integrating the other pages
If you not only want to integrate the login form, but also all the other pages, you will have to change the code in html.inc.php. This is where the HTML start and end output is generated: header, link to stylesheets, ...

net2ftp in other applications
Xoops
net2ftp version 0.80 has been ported to Xoops.

Mambo
net2ftp Mambo component: http://mamboforge.net/projects/com-net2ftp/.

Web-based control panels


Known bugs and limitations
Notes regarding Windows servers
IF YOUR WEB SERVER RUNS ON WINDOWS
If you can log in but you cannot see any directory or file in the Browse Screen, then it is probably caused by a filesystem permission problem on your web server.

Quote from the PHP bug report database:
ftp_rawlist requires write permissions to the system's tempoarary directory.
IIS's default installation does not include this in the permissions for IUSR.
The bug is in system configuration, not PHP.

This was discussed in the following PHP bug reports:
http://bugs.php.net/bug.php?id=8874
http://bugs.php.net/bug.php?id=13720
http://bugs.php.net/bug.php?id=16057

IF YOUR FTP SERVER IS THE IIS FTP SERVER
In the FTP server's configuration, set it for UNIX style directory listings rather than MSDOS style listings.

Beta functions
Beta functions can be turned on or off in settings.inc.php. This is to be able to give you a feeling of where the development is going, without putting live production environments at risk. If you want to join the development team, read the Developer section.