Print version
  Products   wiris.com 
Products » Formula and CAS plugins » Joomla plugin


WIRIS Formula Editor
Formula and CAS plugins
WIRIS Desktop
WIRIS CAS
WIRIS Quizzes
 
WIRIS Plugin installation on Joomla

1        WIRIS Plugin installation on Joomla

1.1      Download files

You only need the tinyMCE WIRIS Plugin and a server with Joomla 1.5 or higher installed.

Note: you should have a valid license to install the plugin in a production environment; otherwise, you can use the downloaded file just for demo purposes. To acquire the full rights license, please contact to info@wiris.com or visit www.wiris.com.

1.2      Copying files

Unzip the tinyMCE WIRIS Plugin and copy the tiny_mce_wiris directory into your Joomla tinyMCE plugins directory. It is usually plugins/editors/tinymce/jscripts/tiny_mce/plugins. The final directory should be plugins/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris. Now, give write permissions to plugins/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris/cache and plugins/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris/formulas directories to the web server user (it will be used to store formula MathML codes and temporal images).

1.3      Activating tinyMCE WIRIS Plugin

1.3.1      On Joomla 1.5.14 or higher

Open plugins/editors/tinymce.php and search the line with this text:

$buttons1_add_before = implode( ',', $buttons1_add_before );

Now add this code before the line:

$plugins[] = 'tiny_mce_wiris';

$buttons2_add[] = 'tiny_mce_wiris_formulaEditor';        // For WIRIS Formula Editor

$buttons2_add[] = 'tiny_mce_wiris_CAS';                      // For WIRIS CAS

The final code should look like:

$plugins[] = 'tiny_mce_wiris';

$buttons2_add[] = 'tiny_mce_wiris_formulaEditor';        // For WIRIS Formula Editor

$buttons2_add[] = 'tiny_mce_wiris_CAS';                      // For WIRIS CAS

 

$buttons1_add_before           = implode( ',', $buttons1_add_before );

The final step is the activation of the extended tinyMCE editor. In Joomla administrator panel, go to Extensions à Plugin Manager and click on Editor – TinyMCE. Now, on Functionality field (on right panel), choose Extended and then save changes.

1.3.2      On Joomla lower than 1.5.14

Open plugins/editors/tinymce.php and search the line with this text:

$buttons2 = implode(',', $buttons2);

Now add this code before the line:

$plugins[] = 'tiny_mce_wiris';

$buttons2[] = 'tiny_mce_wiris_formulaEditor';        // For WIRIS Formula Editor

$buttons2[] = 'tiny_mce_wiris_CAS';                      // For WIRIS CAS

The final code should look like:

$plugins[] = 'tiny_mce_wiris';

$buttons2[] = 'tiny_mce_wiris_formulaEditor';        // For WIRIS Formula Editor

$buttons2[] = 'tiny_mce_wiris_CAS';                      // For WIRIS CAS

 

$buttons2 = implode(',', $buttons2);

1.4      Configure

Edit plugins/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris/configuration.ini to set your own values. This table specifies all possible parameters:

Key

Description

Default value

Possible values

wirisimageservicehost(1)

Specifies formula image server host.

services.wiris.net

 

wirisimageserviceport

Specifies formula image server port.

80

 

wirisimageservicepath

Specifies formula image server path.

/formula/render

 

wirisimagebgcolor

Specifies formula background color.

#FFFFFF

 

wiristransparency

Specifies whether formula background must be transparent.

true

true, false

wirisimagesymbolcolor

Specifies formula foreground color.

#000000

 

wirisimagefontsize

Specifies formula font size.

16

 

wirisformulaeditorcodebase(1)

Specifies where is your formula editor applet codebase.

http://services.wiris.net/formula/codebase/

 

wirisformulaeditorarchive

Specifies the formula editor applet file name.

wiriseditor.jar

 

wirisformulaeditorcode

Specifies main formula editor applet class.

WirisFormulaEditor

 

wirisformulaeditorlang

Specifies main formula editor language.

en

ar, ca, de, es, et, en, eu, fr, gl, it, nl, pt, zh

wiriscascodebase(1)

Specifies where is your CAS applet codebase.

http://www.wiris.net/wiris/wiris-codebase/

 

wiriscasarchive(1)

Specifies the CAS applet file name.

wrs_net_en.jar

 

wiriscasclass(1)

Specifies main CAS applet class.

WirisApplet_net_en

 

CAS_width

Specifies the default CAS applet width.

450

 

CAS_height

Specifies the default CAS applet height.

400

 

wirisproxy

Specifies if your server is using a proxy connection or not.

false

true, false

wirisproxy_host

If wirisproxy is true, this value specifies the proxy host.

 

 

wirisproxy_port

If wirisproxy is true, this value specifies the proxy port.

 

 

(1) The WIRIS plugin needs to access an external server to get additional resources (formula editor applet, image service and WIRIS CAS). See architecture for more information. The default configuration connects to services.wiris.com to get such services. However, you might consider acquiring a production access. Under certain circumstances it is possible to install all necessary services in the customer server (not only the plugin).

Advanced:

You can also modify other values in javascript environment. Open plugins/editors/tinymce/jscripts/tiny_mce /plugins/tiny_mce_wiris/editor_plugin.js and read the first few lines.