MathType for Joomla

  • Joomla 1.5 or higher installed.
  • For Joomla versions prior to 3.2.x: JCE module with TinyMCE
  • A valid license to install the plugin in a production environment; otherwise, you may use the downloaded file for demo purposes only.

Unzip the TinyMCE MathType app and copy the tiny_mce_wiris directory into your Joomla TinyMCE plugins directory. These would be the final paths depending on your Joomla version:

<JoomlaRoot> on this page represents the absolute path to the root of your Joomla site.
Version Path
3.2.x or higher: <JoomlaRoot>/media/editors/tinymce/plugins/tiny_mce_wiris
1.5.14 to 3.1.6: <JoomlaRoot>/media/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris
Older than 1.5.14: <JoomlaRoot>/plugins/editors/tinymce/jscripts/tiny_mce/plugins/tiny_mce_wiris
Give the web server user write permissions for the <tiny-mce-plugins-directory>/tiny_mce_wiris/cache and <tiny-mce-plugins-directory>/tiny_mce_wiris/formulas directories (they will be used to store formula MathML codes and temporary images).

Joomla 3.7.x or higher

To activate MathType, please follow these steps:

  1. Open the file <JoomlaRoot>/media/editors/tinymce/skins/lightgray/skin.min.css.
    1. Add these 2 lines to the file:
      .mce-i-tiny_mce_wiris_formulaEditor:before {content:url('<JoomlaRoot>/media/editors/tinymce/plugins/tiny_mce_wiris/icons/formula.png');}
      .mce-i-tiny_mce_wiris_formulaEditorChemistry:before {content:url('<JoomlaRoot>/media/editors/tinymce/plugins/tiny_mce_wiris/icons/chem.png');}
  2. Open the file <JoomlaRoot>/plugins/editors/tinymce/tinymce.php.
    1. Find this line: $custom_plugin = trim($levelParams->get('custom_plugin', ));.
      Replace it with this: $custom_plugin = trim($levelParams->get('custom_plugin', 'tiny_mce_wiris'));
      If there are other plugins, add a SPACE, then add tiny_mce_wiris to the list.
    2. Look for the getKnownButtons element, and add these to the $buttons variable:
      'tiny_mce_wiris_formulaEditor' => array('label' => 'MathType', 'plugin' => 'tiny_mce_wiris'),
      'tiny_mce_wiris_formulaEditorChemistry' => array('label' => 'ChemType', 'plugin' => 'tiny_mce_wiris'),
  3. Go to the browser and access the control panel (<JoomlaRoot>/administrator/index.php).
  4. Go to Extensions>Plugins, search by TinyMCE and click it in order to change TinyMCE configuration.
  5. Into the toolbar that shows the available buttons, you will see MathType and ChemType buttons. Drag and drop to the toolbar set that you want to add.

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

Very large formulas may not be rendered if the output_buferring option is enabled. Either disable it or set a high enough value in your server's php.ini file.

In order to render MathType formulas outside TinyMCE editing area, Joomla needs to load the WIRISPlugin.js render file. We have additional information in the integrations page of the documentation.

In Joomla you need to include WIRISplugins.js in your template file. This file is located at /templates/<your-template-name>/index.php.

In order to check if the integration is installed correctly, there is a page that makes some tests on your server. Open this link to see where is your test page.

Visit this page if you want to know how to clean the cache folder and backup your formula images.