This is the bridge between a Joomla installation and an AjaXplorer. The aim is to provide a single-signon mechanism based on the Joomla users system : users logged in joomla must have access to repositories of AjaXplorer. It's never totally evident to interface two different softwares, so don't expect it to be magical, and please follow the steps carefully and in this order.

1/ Base Installation

1.1 Install AjaXplorer and Joomla
First of all, make sure you have AjaXplorer 3.0.1 installed and Joomla 1.5, 1.6, 2.5 or 3.0

1.2 Install Joomla plugin
Drop the right plugin version inside your Joomla installation folder (the "tmp" folder of your Joomla installation.)

2/ AjaXplorer configuration

2.1 Create administrator
If it's not already done, with the standard ajaxplorer authentication mechanism, be sure that at least an "admin" user is created.

2.2 Guest Browsing
If you intend to allow guest browsing, set the "Allow Guest Browsing" option to true in the Ajaxplorer Settings > Core Options > Common Auth Options, and if you are logged, log out. This should create the "guest" user. As admin, log back to the interface and create a "Guest" Repository. Go to the users section and grant access (read only may be better) to this repository to the "guest" user. Now, when you log out, you should have access to this repository.

2.3 Repositories
Now create one or many repositories that you will want your joomla logged users to access. You can use the AJXP_USER keyword inside the repository PATH if you want to create automatically "personnal" folders for each users. Considering the acces rights, the trick here would be to set a DEFAULT_RIGHT value to "rw", so that you don't have to manually edit the users rights each time you add them.

2.4 Log out of AjaXplorer

2.5 Auth.remote configuration
Now go back to your conf/bootstrap_plugins.php and set the Authentification driver to be the auth.remote. There is a commented sample in the config file aimed at wordpress user, you should use the following values :

	"AUTH_DRIVER" => array( 
		"NAME" => "remote",
		"OPTIONS" => array(
		"SLAVE_MODE" => true,
		"USERS_FILEPATH" => "AJXP_DATA_PATH/plugins/auth.serial/users.ser",
		"LOGIN_URL" => "/joomla/",
		"LOGOUT_URL" => "/joomla/",
		"SECRET" => "my_own_private_joomla_key",
	        "MASTER_AUTH_FUNCTION" => "joomla_remote_auth",
	        "MASTER_HOST" => "localhost", // the joomla host
	        "MASTER_URI" => "/joomla/",
	        "MASTER_AUTH_FORM_ID" => "login-form", // or maybe form-login, check your login page
		"TRANSMIT_CLEAR_PASS" => true)
	),

What you should edit here are only LOGIN_URL, LOGOUT_URL and SECRET. LOGIN&LOGOUT should point to your joomla installation URL on the server (URL, not the folder path from the server root). For example, here we consider joomla to be found at http://www.mydomain.com/joomla/. The SECRET key is what will assure AjaXplorer that the authentification operations called programmatically are indeed called by a trustee. You may put whatever you want, it will be a configuration of the Joomla Ajaxplorer plugin.  Warning, if you want to use a "$" sign in your key, you have to put a \ before.

2.6 Checks
Now if you are logged out, when you go to AjaXplorer URL, if you have enabled guest browsing you should have access to the Guest repository and clicking on the "Back" button should send you to Joomla. If "guest" is not enabled, you should be automatically redirected to Joomla.

3/ Joomla Configuration

3.1 Install Extension
Login to Joomla adminstration front-end and go to "Extensions > Install/Uninstall". Normally, the "Install from a folder" section should be already filled with your "tmp" folder path. Click "Install" beside this field. It should install successfully the User - AjaXplorer plugin.

3.2 Activate and Configure the new plugin
Go to "Extension > Manage Plugins" and find the User - AjaXplorer plugin module in the list. You can select the plugin type "user" to filter the list. Click in the "Active" column to activate this plugin, then enter the plugin configuration. Change the "Order" parameter to make sure this plugin is called AFTER your master authentication plugin, generally user.joomla. Then there are three ajxp-parameters to configure for this plugin : 

Save the module configuration.

3.3 Use!
Now everything should be connected, and you can try the following : create an Administrator user and a simple user in Joomla. Log in to Joomla as these user and check that you are recognized in AjaXplorer, and further more, that the administrator has AjaXplorer administration rights. If you want to enable the guest mechanism in AjaXplorer, log out from Joomla and check that you are recognized as "guest" in AjaXplorer.