Installation

Activation of PHP extensions

With PHP5, the PHP extensions php_xsl and php_gd2 must be enabled, but php_domxml must be disabled (it's an extension for PHP4).

With PHP4, the PHP extensions php_xslt, php_gd2 and php_domxml must be enabled. These extensions are enabled by default in some distributions (such as MAMP on the Mac), but not on others (such as WAMP on Windows).

Placing the folder

WebJaxe's folder can be placed anywhere on the website. The website root is often a folder called htdocs, in which the webjaxe folder can be copied.

File permissions

The PHP user needs write access to the following folders : site_config, contribXML, sites, historique, poubelle and tmp. Permissions for these folders should be checked before starting WebJaxe for the first time.

Initialisation

Open the following page in a web browser :

http://[your_website]/[WebJaxe_folder]/index.php

To start with an English configuration, choose XPAGES_en as the configuration, and en for the language.

To create WebJaxe's database, the login and the password for the database administrator have to be entered (often 'root' / '' or 'root' / 'root' by default). The database is called webjaxe by default.

The other fields to fill in are used to create WebJaxe's administrator account, who will be the first user. Once this is done, click on the "Create database" button to finish WebJaxe's installation.

The mail management is used to alert for a new user, you have 3 options:

• Disabled : sending email is disabled
• mail PHP function : the email will be sent by using PHP function of your host
• SMTP server : the host or provider SMTP server adress have to be entered

Once this is done, click on the "Create database" button to finish WebJaxe's installation.

TeX equations images server

Those who would like to use equations with the TeX syntax in the XPAGES language also need to configure a little additional server. The Jaxe applet and its XPAGES plugin do not contain a TeX processor (it would be too heavy !). So, the plugin calls a server, sending the equation text, to which the server replies with the image of the equation. This server is already present in WebJaxe's serveurtex folder, but it requires the installation of the following programs : latex, dvipng and ImageMagick. It is also necessary to edit the file config/XPAGES/XPAGES_config.xml by hand to specify the server to use (look for "tex.php" to find it). The default value is set to a server that is not necessarily available. The paths to the commands convert and tex2png can be changed if necessary in tex.php. Permissions should be checked to make sure the PHP user can write inside serveurtex/CACHE.