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


WIRIS Formula Editor
Formula and CAS plugins
WIRIS Desktop
WIRIS CAS
WIRIS Quizzes
 
Wordpress WIRIS Plugin integration

1        Wordpress WIRIS Plugin integration

1.1      Download files

Available packages:

  • Wordpress WIRIS Plugin: a Wordpress plugin ready to be installed on your blog. It provides WIRIS Formula Editor and WIRIS CAS for Wordpress tinyMCE editor.

 

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 Wordpress WIRIS Plugin and copy the content of wordpress_wiris directory into your Wordpress root directory. The content consists of two directories that you should copy: wp-includes and wp-content. Now, give write permissions to wp-includes/js/tinymce/plugins/tiny_mce_wiris/cache and wp-includes/js/tinymce/plugins/tiny_mce_wiris/formulas directories to the web server user (it will be used to store formula MathML codes and temporal images).

Because the plugin needs server scripting support, we provide a solution based on PHP (which could be rewritten to any desired scripting language). To use our PHP integration files, you must give execution right to the web server user on the PHP files contained at tiny wp-includes/js/tinymce/plugins/tiny_mce_wiris/integration.

1.3      Configure

Edit wp-includes/js/tinymce/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 wp-includes/js/tinymce/plugins/tiny_mce_wiris/editor_plugin.js and read the first few lines.

1.1      Activate Wordpress WIRIS Plugin on your own platform

You must activate the Wordpress WIRIS Plugin plugin through Wordpress admin page.

1.2      Clean and backup your Wordpress WIRIS Plugin installation

There are two important folders: wp-includes/js/tinymce/plugins/tiny_mce_wiris/cache and wp-includes/js/tinymce/plugins/tiny_mce_wiris/formulas.

1.2.1      Freeing disk space: cleaning the image cache folder

If you want to free your disk space, you can empty wp-includes/js/tinymce/plugins/tiny_mce_wiris/cache folder (remember: don’t delete the folder, only remove its contents).

Your web site formula images will be available as nothing occurred.

1.2.2      Migrating your web server

If you want to migrate your web server, and you want to backup your formula images, you must migrate also wp-includes/js/tinymce/plugins/tiny_mce_wiris/formulas directory.

This directory contains the MathML of your web site formula images. If these files are removed, you will lose formulas.