The XOOPS Installation Guide provides an overview of how install XOOPS on your Web server. it is assumed users already have a working environment that is either LAMP or WAMP.
Efforts have been made to ensure this is not merely a sequential installation document. Useful tips and pointers about XOOPS are provided as the user is guided successfully through the installation process.
If you require an installation in a language other than English, please skip now to step 6 and review the translation information and instructions to ensure you have what you need before starting the installation.
To proceed successfully, the following is required on either a local machine or hosted server:
a place to run that includes:
a. the Apache web server;
b. the database manager MySQL;
c. scripting language PHP, either on a Linux or a Windows platform; and
a downloaded copy of the latest XOOPS version (currently 2.5.0).
With the hosting environment available, the following steps are recommended to prepare for the installation:
1) Download either the TAR file or ZIP file to a local machine and uncompress the archive (using, for example, 7Zip program – see “Useful Tools” Appendix)
The resulting new directory has four subdirectories: docs, extras, htdocs, and upgrade.
2) Copy the htdocs subdirectory to the root directory of your local or remote environment. If the installation is on a local machine, this means copying the directory to a directory where the web server will look for files. For example if using WAMP (www.wampserver.com), the web root directory is called www. This will give you a file path of www/htdocs/
3) Once copied, rename the htdocs directory on the server to xoops. This means that the local site is accessed by typing “http://localhost/xoops" in a browser.
When installing on a hosted, remote server, the htdocs directory must be uploaded to an accessible directory. Most remote servers have a public_html or htdocs folder. That is the location where the contents of the XOOPS’ htdocs folder on the local computer must be uploaded. A FTP client software (see Appendix “Useful Tools”) is used for uploading files to you host. Once all of the files are uploaded to the root directory, you can access them via http://www.yoursite.com.
At this point it is important to note that only the content of the htdocs folder is uploaded to the root folder. Otherwise, the installation will be located in http://www.yoursite.com/htdocs..
4) For local server: ensure that the server is running once a local installation has been completed. This means to start the server application via the applicable control panel. This is not a requirement for an installation on a remote server.
5) The downloaded package includes two files that are used to verify the contents of uploaded files. They are checksum.mdi and checksum.php. These files assist in verifying that the contents of the root folder are correct. To use the checksum files:
6) Enter the applicable address into a browser to access the directory holding the contents of the htdocs folder. On a local machine, it should be http://localhost/xoops. On a remote server the address will be http://www.yoursite.com. If everything was uploaded properly, accessing the site will launch the XOOPS Installation Wizard.
How can I have several Xoops websites on the same web server ? If you want to install several website on the same server, copy XOOPS files into different subfolders, e.g.:
The wizard is able to distinguish between :
- Webserver root folder (/www),
- and the root folder of each XOOPS
The wizard opens a page in the browser with the following content:
Figure 2: Language selection page of the XOOPS installation wizard
If you would like to have a XOOPS installation in other language than English, please visit a local support site for a local version, or visit XOOPS on SourceForge.
If an installation in a different language is required but not available, you’ll need to do the translation yourself. Within the install folder there is another folder called language. Inside the language folder there is another folder called /english. Make a copy the folder and rename the new folder to your local language, e.g. /spanish. Then translate the English text into your language. This will facilitate the installation in the language of your choice.
For more info on how to translate the files, see Appendix 3.
New translations are always welcomed by the XOOPS community. Submitting translations can save time for other users and make XOOPS better for everyone.
All this needs to be done before the installation, so when the wizard reads the files, the desired languages are available.
7) Click [Next] to open the next screen (Figure 3) with introductory content. It includes a description of XOOPS, the license terms, environment requirements and requirements for the installation.
Figure 3: XOOPS Installation Assistant
The XOOPS Installation Assistant outlines key elements of the environment required for successful installation. More detailed explanations of the eight points are:
Confirm that the seven (7) requirements are met and click [Next].