The BOX of Joomla Extensions

JExtBOX Equation

This extension helps to display your math equations, diagrams, and figures.

This extension adds functionality for inserting and displaying math equations (LaTeX) and figures (PSPicture). Also, it supports equation numbering. The extension is based on MathJaxLaTeX2JS, and Mathapedia.

Extension
component,plugin
Compatibility
3.10 or 4
Version
2.12.6
Last update
Mon, 29 Nov 2021
1'st release
Sun, 21 Apr 2013
Price
$10.00
JED page
ext...org /...x-equation
Live demo
Visit demo

This extension has two versions: free and paid. The paid full version has the following features.

  1. Editor button for inserting math equations and figures
  2. Live preview and LaTeX template (typical scripts)
  3. Custom installation: You can use a local installation of MatJax on your website.
  4. MathJax custom config & default config which are provided by the maintainer
  5. MathJax source: Content Delivery Network (CDN) or Local installation.
  6. Fallback: Loads the local installation, if CDN fails.
  7. Resource & time saving: Stops when any equations are not detected in the text of an article or whole body of an HTML page.
  8. Direct conversion
    1. Converts LaTeX equations in HTML including content which is loaded by AJAX, to MathJax formatted script on the fly.
    2. Skips HTML tags: "pre" & "code", i.e. does not convert equations and pspictures inside these tags.
    3. Doesn't convert $ selector of JavaScript library in tags "script".
    4. Clean-up spaces after line equations.

2.12.6. Nov 29, 2021. Solved an issue for previewing on the modal. The issue was pushed with the previous version 2.12.5. Also improved visibility of the modal window on site's front-end.

2.12.5. Nov 29, 2021. Patch for the latest version of MathJax. The default configuration has been changed for version 2.x.x of MathJax.

2.12.4. Oct 30, 2021. Patch for the new update server. A minor issue which is related to the local installation path of MathJax has been solved. The logic of fallback between CDN and local installation has been improved. A bug for rendering maths which are loaded by AJAX has been solved.

2.12.3. Sep 14, 2021. Solved an issue on javascript script initializing for the rendering of PSPictures. Also, LaTeX2HTML5 source files have been renewed. The changes have affected the free basic version too and it was numbered as 2.8.3.

2.12.2. Sep 7, 2021. For the content plugin, solved an issue for multiple executions of the PSPicture script. The free basic version has been updated too and it was numbered as 2.8.2. For the paid version, the system plugin has been updated due to confliction of events "dom ready" and "dom modified".

2.12.1. Aug 24, 2021. Patch for Joomla 4. All known issues are solved. MathJAX CDN sources are updated according to the instructions on the documentation of MathJax. The free basic version has been updated too and it was numbered as 2.8.1.

2.12.0. Nov 9, 2018. Descriptions and language files were updated. The configuration form was improved. A minor bug for the back-end about page was solved.

2.11.1. Sep 4, 2017. A minor bug for the front-end editor has been solved.

2.11.0. Jun 24, 2017. Dollar sign escape.

2.10.0. May 8, 2017. Maintenance for MathJax CDN changes.

2.9.1. February 23, 2017. Minor modification for live preview due to MathJax issue.

2.9.0. February 4, 2017. Templates for typical scripts.

2.8.3. February 4, 2017. A bug for live preview on the front-end editor has been solved.

2.8.2. January 19, 2017. The Front-end editor has been supported.

2.8.1. October 27, 2016. Maintenance for the latest version of Joomla.

2.8.0. April 24, 2016. Editor button and live preview have been added.

2.7.0. March 11, 2016. Code improvement.

2.6.0. August 26, 2015. Maintenance release for MathJax CDN.

2.5.0. January 25, 2015. MathJax custom config parameter has been added. The free version was released.

2.4.0. November 18, 2014. Conversion, on the fly, the function has been improved. Also some minor development in the content plugin.

2.3.0. June 03, 2014. MathJax version selection option & skip code tag functionality have been added.

2.2.0. March 22, 2014. Listener for DOM changes has been added to the system plugin.

2.1.1. March 19, 2014. Some bug has been fixed.

2.1.0. March 9, 2014. System plugin.

2.0.0. December 18, 2013. PSPicture.

1.0.0. April 21, 2013. Initial version.

You have to write all your equations by using LaTeX script. We recommend using an editor button "Insert Math" for writing and inserting math equations and figures. The button is included in the paid full version of this extension and it opens a popup modal window with a live preview for LaTeX equations.

The functionality for displaying math equations is based on MathJax. Also please visit LaTeX2JS or Mathapedia to know about PSPicture on the web page.

For the configuration of the full extension, we write detailed information for all parameters.

For daily usage, beware of equation label conflictions in one page and bad syntaxes.

Bad syntax

If LaTeX or PSPicture syntax includes any HTML tags such as <span>, the syntax is not rendered correctly. Also new lines in PSPicture syntax must created with the HTML tag <br />, but not created with the (paragraph) tag <p>. These errors are very popular. So you need to check the HTML source of your content before publishing it.

One of the useful methods to clean the tag <span> is the command "Clear Formatting" of the editor.

Finally, remember that an effective method to avoid bad syntaxes is using the editor button i.e. the popup modal window which is provided by the paid full extension.

Dollar sign escape

To escape the dollar sign, you need to replace $ by \$.

Example code

You can use the following codes to test the extension.

$$f_{\xi}(x)=\frac{1}{\sqrt{2\pi}}\int_{-\infty}^{x}e^{-t^2/2}dt$$
Inline equation $x^2+y^2=1$
Numbered equation \begin{equation}\Phi(0)=\frac{1}{2}\label{eq1}\end{equation}
Now calling (\ref{eq1})
PSPicture
\begin{pspicture}(-2,-2)(2,2)
\psline[linecolor=green]{->}(0,0)(1.2,1.2)
\psline[linecolor=red]{->}(0,0)(-1.2,-1.2)
\psline[linecolor=purple]{->}(0,0)(1.2,-1.2)
\psline[linecolor=lightblue]{->}(0,0)(-1.2,1.2)
\end{pspicture}

Configuration of the paid full version

Typically, the extension has not required any configurations. Especially, if you have newly installed, in other words, if you haven't updated the full version, you don't need to configure it. However, if you want to manually configure, please follow the below steps.

  1. Open "Global Configuration"
  2. Click "JExtBOX Equation" on sidebar
  3. Configure

As mentioned above, we write detailed information for all configuration parameters. For Joomla 3, detailed information is displayed as a tooltip of a parameter.

If you use the extension, do not disable any JExtBOX Equation plugins. Also, we recommend you choose the option "whole front-end pages" for the parameter "Apply to".

For the MathJax version, we recommend you to choose version 2 which is a stable version of MathJax. The back-end functionalities (the popup window for inserting equations) are developed with version 2. However, if you want, the latest version 3 can be used for front-end pages.

For MathJax configuration, we provide our default configurations:

  • For MathJax 2:
    MathJax.Hub.Config({
      TeX: {
        extensions: ["autoload-all.js"],
        equationNumbers: {autoNumber: "AMS"}
      },
      showMathMenu: false,
      messageStyle: "none"
    });
  • For MathJax 3:
    window.MathJax = {
      tex: {tags: "ams"},
      options: {enableMenu: false}
    };

You can customize its configuration such as the following:

MathJax.Hub.Config({
  TeX: { equationNumbers: {autoNumber: "AMS"} },
  showMathMenu: false,
  messageStyle: "none",
  "HTML-CSS": {
    preferredFont: "STIX-Web",
    scale: 100
  }
});

For font configuration, the possible values are TeX, STIX-Web, Asana-Math, Neo-Euler, Gyre-Pagella, Gyre-Termes, and Latin-Modern. P.S. MathJax 3 currently doesn't support font options.

Update

For the latest version of the update server, the free version is updated to the newest free version, and the paid full version is updated to the latest paid full version. To update the full version by using Joomla Updater, you need to enter your Payment or Invoice ID into the corresponding field on the configuration page of the JExtBOX Equation component.

For several specific versions which are listed below, it requires additional operations.

  • Update to 2.9.0 or newer from the older version
    Uninstall any older version (2.8.3 or older) completely before installing/updating. Otherwise, delete old language files ("en-GB.com_jextboxequation.ini" and "en-GB.com_jextboxequation.sys.ini") from the directory "administrator/language".
  • Update to 2.12.4 or newer from the older version
    For paid version with valid payment or invoice ID, you should enter the ID to the configuration of the component JExtBOX Equation before updating. Because if you will update by using Joomla Updater when you don't enter your Payment or Invoice ID, its free version will be installed. Or else you can download the binary file and install it manually.
  • Update to 2.12.5 or newer from the older version
    After updating the paid full version, you need to open the configuration page of the "JExtBOX Equation" component and press the "Save" button.

Usage

After installing the paid full version, it adds the button, which is titled "Insert Math", into the editor.

If you want to insert a math equation into a content, please follow the steps below.

  1. Place your cursor where you want the equation to be inserted.
  2. Click the "Insert Math" button. The modal window is opened.
  3. Type your math equation.
  4. Click the "Insert" button. The equation is inserted into the editor and the modal window is closed.

JExtBOX Equation is the Joomla extension.
Copyright (©) 2013 - 2021 Galaa

JExtBOX Equation is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

JExtBOX Equation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see www.gnu.org/licenses.

Plans

We accept PayPal.
Your purchase will be valid for 12 months. In this period, you can download purchased extensions and its upcoming newer versions free of charge.

Basic

$0.00

Full

$10.00
  • Full Functionality
  • 12 Months Update
  • Support

Basic vs Full

Difference between Free and Paid versions

FeaturesBasicFull
Direct conversion of LaTeX scripts
Content Construction Kit Support (such as K2, core Content)
Front-end components and modules support
Renders maths are loaded by AJAX
Editor button and Popup window for math inserting
Live Preview in Popup Window
MathJax versions, local installation, fallback to local installation, custom config
PSPicture support
Skips maths inside pre and code tags
Clean-ups spaces after line equations

Featured Extensions

Best Selling, Most Downloaded and Recommended Extensions