FULL DETAILED INSTALL GUIDEstep one: downloading the latest XOOPS system package.The first thing you will need to do if you want to set up your own XOOPS site, is to get the latest version of the XOOPS system files. These files are convinently packaged in a compressed archive (zipped for windows users, and a tarball for linux users). Click
here to go to the 'latest version' page. When you have downloaded the latest version, continue to step two.
step two: unpacking the latest XOOPS system archive.Now that you have the archive stored on your local computer, it first needs to be decompressed, or unpacked to a local folder. For windows users it is the easiest thing to create a new folder on your desktop called XOOPS, and extract the archive into that folder. Zip files need to be extracted with a compression tool that can handle zip files. The most well-known of those is
winzip. Windows XP has native .zip support however. For more information on extracting .zip archives, I refer to the user manual of the application you're using to extract the archive. When the archive is extracted, continue to step three.
step three: uploading the system files to the server.Now that you have a local copy of the system files on your computer, you will need to upload the system to the webserver.
NOTE: XOOPS will only run on webservers that have at least PHP 4.1.0 and a mySQL database. Check with your hosting provider to see if your hosting account is suited for XOOPS.
Fire up your FTP application, connect to the webserver, and go to the folder that will contain your site's root (most often this is a public_html/ folder. This means that the XOOPS site will show when you go to the URL of your site. Check the hosting provider's documentation to find out exactly where the site's root is located). Use a subfolder if you don't want your XOOPS site to be in the site's root.
Now, upload the contents of the /HTML/ folder (not the folder itself, but ALL it's contents) to the site's root folder. Thus, you're creating (at least) the following structure:
public_html/cache/
public_html/templates_c/
public_html/modules/
etc. For public_html/ read your own site's root folder.
If all files are uploaded (this may take a while), continue to step four.
step four: changing the access rights of the folders and files.This step can also be done during the install process itself, but it's easier to do it while you're in the FTP application.
To change the access right of the files and folders on the server, you will have to find out how to use the CHMOD command or feature in your FTP application. Most have it in the rightclick context menu, under options or something similar. Just rightclick on the file mainfile.php, and change the acces rights to 777 (all rights for everyone). You can also CHMOD folders, and you will have to repeat this for the cache/ templates_c/ and uploads/ folders, all in your site's root.
Now that the folders and mainfile have been made writable, you can start the installation process. And that is step five.
step five: the XOOPS installer.The XOOPS system has an easy installer. Once you have succesfully uploaded the files, and set the access rights of the appropriate file and folders, you're in for a treat.
Start your browser and point it to your site's root. FOr instance, if you have the domain
http://www.mysite.com, and uploaded the files to sites/www.mysite.com/public_html/, just point your browser to
http://www.mysite.com. This will start the XOOPS installer.
You will need to have some basic information to install you XOOPS site. The MySQL server name where the database for your XOOPS site is installed, the database username and password, and the database name are the most important. This information should have been given to you by your hosting provider when you signed up. If not, contact them to obtain this information. Without it, you can't install XOOPS.
The installer will take you through the entire process, and it would be double to repeat that in this how-to.
Now you're good to go and ready for your XOOPS install!
Herko