Improve user friendliness for Jooma! by providing contextual help on installation

Currently when a Joomla install is run, \civicrm\jooma\install.civicrm.php puts up a message that says "installation: successful.

It would make the installation/upgrading process less error prone if a verision of the following instructions was included on this page:

If this is a new installation:

CiviCRM includes the ability to expose Profile forms and listings, as well as Online Contribution Pages, to users and visitors of the 'front-end' of your Joomla! site. If you wish to use this option:

• Open <site root>/index.php in your favorite editor and find this line. (note that the below line might be slightly different based on your exact version of Joomla!.

// mainframe is an API workhorse, lots of 'core' interaction routines
$mainframe = new mosMainFrame( $database, $option, '..', true );

You may need root privileges or special permissions to edit this file. Add the following lines ABOVE the "$mainframe..." line you just found.

// These lines are needed for proper function of CiviCRM at the frontend
session_name( md5( $mosConfig_live_site . '_frontend' ));
session_start();

If this is an upgrade:

1. Upgrade the database using the sql script provided under:

HOME/com_civicrm/civicrm/sql/civicrm_upgradedb_vOLD_vNEW_XX.sql

vOLD = Old CiviCRM version
vNew = New CiviCRM version
XX = mySQL version (use 4.0 for mySQL 4.0.x or 4.1 for mySQL for 4.1.x)

1. Delete the files in

JOOMLA_ROOT/media/civicrm/templates_c

and

JOOMLA_ROOT/media/civicrm/upload

1. Delete all session files wherever they are located. You can use a debug too to achieve both this and step 7, refer to Installation and Configuration Trouble-shooting
2. Update both copies of the new civicrm.settings.php file with any changes that you made in the prior version of civicrm.settings.php file (e.g. Paypal settings, Enable CiviContribute, etc.). Joomla installations use two separate settings files - one in JOOMLA_ROOT/components/com_civicrm for front-end pages, and one in JOOMLA_ROOT/administrator/components/com_civicrm.

(these instructions are just copied from the documentation. It would also be a good idea to include a link to the full documentation here.)