Formulix Math & Chemistry Blocks

Description

Formulix adds a block to the block editor (Gutenberg) to insert and re-edit math formulas, long-hand arithmetic (“contas armadas”: long division, multiplication with carries, subtraction with borrowing), function graphs and chemistry items. It is built for teachers, schools and educational publishers.

• Visual formulas: fractions, roots, powers and matrices without knowing LaTeX (LaTeX is accepted too).
• Arithmetic as it is taught: long division, multiplication and subtraction laid out step by step, with aligned decimals.
• Algebra: 1st and 2nd degree equations, 2×2 systems, LCM/GCD, fractions, rule of three, tables and function studies.
• Graphs: up to five functions with roots, vertices and intersections, inserted as PNG and re-editable.
• Chemistry: equation balancing, molar mass, electron configuration, periodic table, lab glassware and carbon chains.

The interface supports Brazilian Portuguese, English, Spanish, French, German, Italian, Japanese, Simplified and Traditional Chinese and Hindi, and uses local notation (for example, decimal comma).

The plugin is free and GPL, with no trial period and no local features locked behind payment. Calculations, chemistry, graphs and insert conversions are performed by the external Formulix service, which works without an account: your site domain gets the free plan, and when it runs out you register the domain and choose a paid plan. There is a free plan and paid plans with monthly insert limits; the service does real processing and is not a license check.

Items are saved as static HTML. Formulas and tables stay in the post; graph and drawing PNGs go to the WordPress media library. Reading posts does not contact the API and does not load the editor scripts. Content stays readable if the plugin is removed.

Tested automatically on WordPress 6.8 and 7.1.3 with PHP 8.3. The classic editor is not supported.

External services

This plugin relies on the Formulix API, operated by Kaio Spacini (https://formulix.com.br, suporte@formulix.com.br), to calculate arithmetic and expressions, solve chemistry operations, draw graphs and convert the confirmed item into HTML, MathML or SVG. When needed, the browser converts the SVG to PNG.

Endpoint: the URL in Settings > Formulix, https://api.formulix.com.br by default (clear it to disable). There is no request on activation; requests happen only when an editor opens the Formulix dialog. The client code ships with the plugin; no code is downloaded from the API.

What is sent and when:

• POST /v1/calc: the operation, values and math/chemistry expressions typed, graph settings, language and notation, for automatic previews when panels open and while typing. Happens before the insert is confirmed and does not count against the plan.
• POST /v1/calc (op “word”): when pasting from Word into the dialog formula field, the clipboard HTML and RTF. Does not count against the plan.
• GET /v1/tabela?idioma=…: the language, when the periodic table opens. No post content is sent.
• POST /v1/inserir: item type and data (for example LaTeX, numbers, chemical equation or graph functions/points), language and notation, when an item is confirmed. This request is metered for the plan.
• When a key is configured, every request carries it in the X-Formulix-Chave header. As with any HTTP request, the operator receives the editor’s IP address, the site origin and standard browser headers. Do not type personal data into the fields.

The plugin never sends the whole post, titles, user records, passwords or the media library to the API; only the data of the item being edited. PNGs are uploaded to the site’s own authenticated /wp/v2/media endpoint (REST nonce and upload_files check), not to an external service.

Terms of use: https://formulix.com.br/docs/termos.html
Privacy policy: https://formulix.com.br/docs/privacidade.html

Development

Sources and the build script ship in the plugin’s source folder. Run npm install and npm run build there. The development repository is private; the shipped sources are complete for rebuilding the plugin.