MX Calculator#

MX Calculator provides mathematical operations in ExpressionEngine templates.

It is build with modified class EvalMath (thanks to Miles Kaufmann) for safely evaluate math expressions.

Installation

• Place the mx_calc folder inside your user/addons folder
• Go to cp/addons and install MX Calculator.

Update

If you using MX Calc prior to version 3.0.5, you would need to Uninstall and install an add-on. It safe to do, because this add-on doesn't keep any data.

Configuration

Once the Plugin is installed, you should be able to see it listed in the Plugin Manager in your ExpressionEngine Control Panel. Is no needs in any control panel activation or configuration.

Template Tags

{exp:mx_calc}

you can used it as single tag

{exp:mx_calc expression="-4(15/42)^23*(4-sqrt(16))-15"}

or as tag pair

{exp:mx_calc expression="-4(15/42)^23*(4-sqrt(16))-15"}
    Cost  = {calc_result}
{/exp:mx_calc}

Parameters

expression="-4(15/42)^23*(4-sqrt(16))-15" required

var = "varible_name"

### Parameters

expression="-4(15/42)^23*(4-sqrt(16))-15" required

var = "varible_name" (optional)

decimals='2' (optional, default = 2)

force_zeros='yes' (optional, default  = no)

decimal_seperator=',' (optional)

thousand_seperator='.' (optional)

Avalible functions:

average

{exp:mx_calc expression="average(4, 8, 15, 16, 23, 42)"}

max

{exp:mx_calc expression="max(4, 8, 15, 16, 23, 42)"}

min

{exp:mx_calc expression="min(4, 8, 15, 16, (3*3+8+2*3), 42)"}

mod

{exp:mx_calc expression="mod(4, 15)"}

power

{exp:mx_calc expression="power(4,2)"}

round

{exp:mx_calc expression="round(((4*5/16)/15),2)"}

sum

{exp:mx_calc expression="sum(4, 8, 15, 16, 23, 42)"}

ceil

{exp:mx_calc expression="ceil((4*5/16) / 15)"}

pi

{exp:mx_calc expression="pi()"}

sqrt

{exp:mx_calc expression="-4(15/42)^23*(4-sqrt(16))-15"}

sin

{exp:mx_calc expression="-4(15/42)^23*(4-sin(16))-15"}

####Other functions

sinh
arcsin
asin
arcsinh
asinh
cos
cosh
arccos
acos
arccosh
acosh
tan
tanh
arctan
atan
arctanh
atanh
abs
ln
log

Single Variables

{calc_result}

The calculation result

Debug

{exp:mx_calc expression="round(10*1.35,0)asd" debug="on"}
    {calc_result} {debug}
{/exp:mx_calc}

Examples

Using varibles

{exp:channel:entries channel="demo" limit="10"}
	{exp:mx_calc var="var_1" expression="{calc}+"}
	{if count == total_results}{exp:mx_calc expression="{var_1}" backspace="1"}{/if}
{/exp:channel:entries}

Late parsing

Note You need to activate mx_cal extension to support late parsing.

{exp:channel:entries channel="demo" limit="10"}
	{exp:mx_calc var="var_1" expression="{calc}+"}
	{if count == total_results}{/if}
{/exp:channel:entries}

{exp:mx_calc expression="{var_1}" backspace="1" parsing = "late"}

Support Policy

This is Communite Edition add-on.

Contributing To MX Calculator

Your participation to MX Calculator development is very welcome!

You may participate in the following ways:

• Report issues
• Fix issues, develop features, write/polish documentation Before you start, please adopt an existing issue (labelled with "ready for adoption") or start a new one to avoid duplicated efforts. Please submit a merge request after you finish development.

License

The MX Calculator is open-sourced software licensed under the MIT license