JScriptcase User Manual

Introduction 

JScriptcase is a Joomla component for integrating Scriptcase applications with Joomla. It allows developer to display Scriptcase application on Joomla template like an article. All controls, links and AJAX commands on the Scriptcase application work properly to make visitor feel that the web site is a complete product.

Requirements

Operating Systems

  • Linux
  • Windows
  • Mac OS X
  • Solaris

Software Requirements

  • Joomla 1.5.x 
  • Joomla 1.6.x 
  • Joomla 1.7.x 
  • Joomla 2.5.x
  • Joomla 3.0-3.2
  • JFusion 1.5.4, 1.6.0 (Use our modified version)
  • Scriptcase 5.x
  • Scriptcase 6.x
  • Scriptcase 7.x 
  • Scriptcase 8.x 
    (We don't support friendly URLs with index page and grid app with ajax)
    • MySQL
  • Ioncube Loader (Latest version is recommended)
  • PHP 5.2.x or 5.3.x
    • php cURL extension enabled (it is also required by JFusion).

Contact us if you have any question on installing ioncube.

Installation

Your scriptcase application deployment directory should be under joomla installation directory.

Ioncube loader  should be installed on the server. Please check http://www.ioncube.com/loaders.php for installation.

JScriptcase is composed of three installation files:

JScriptcase Component, JScriptcase Module and JFusion JScriptcase Plugin.

Component Installation

Open extensions > Install/uninstall

Enter the address of com_jscriptcase_x.x.zip and press the "Install" button.

Check out configuration after installation.

JFusion Plugin Installation

Initially, download our modified JFusion from download area.

Then install our JFusion plugin

Open Components > JFusion > Plugins > Packages

Enter the address of our JFusion Plugin and press the "Install" button.

Configuration

JScriptcase Component Configuration

Open Components > JScriptcase > Configuration

Application Directory: The web directory under Joomla root directory that contains Scriptcase applications (Ex: sc_applications). JScriptcase module and component both use this directory for listing deployed applications.

License Installation

1. Download your license file through your Ilerian account.

2. Open Components > JScriptcase > Configuration and select your license file for "Install License" fields.

3. Press "Save" button. Please press the "Save" button one more to see the latest license information.

Now, your license is installed. You can install a different license later.

JFusion Plugin User integration configuration

Open configuration and edit Jscriptcase plugin

Set the parameters:

Source dir: http://your_domain.com/scriptcase_app_dir/login application.

Full Path to Software: give the absolute server path to login application

Prefix: Leave it empty if there is no prefix for your user tables.

Dual Login:

Change the following fields:

Login URL: The file name of the scriptcase login application. (Ex: form_login.php)

Form id: F1

User ID: the field name for your username on your login application

Password ID: the field name for your password on your login application

Menu Item Integration

Before using JScriptcase menu item, check that the scriptcase application is working properly. If It has links with other applications, check also the links if they work properly.

Scriptcase deploy:

Deploy your applications to a directory under joomla installation

Common:

directory structure after the domain name seen on web

/joom_dir/sc_app_dir/prod

images

/joom_dir/sc_app_dir/files

temp

/joom_dir/sc_app_dir/tmp

Open a menu on joomla: Menus > Main Menu

Click "New" button to create a new menu item.

Click JScriptcase.

Give name for your menu item and select your scriptcase application at "Component Parameters" section.

Click "Save" button.

Now the menu item link appears on the Main Menu. If you click the menu item, you can see the application integrated into the body of your Joomla template.

User Integration

Set JScriptcase as master and set  joomla int as slave.

Disable password encryption for JScriptcase

Disable Joomla auth plugin and enable JFusion auth plugin

Disable Joomla registration by: http://docs.joomla.org/Disabling_user_registration

Now, joomla logins shall check your scriptcase tables and dual session opens for both joomla and scriptcase.

  • No labels
Write a comment…