NumroQ Numerology & Astrology Calculators

Description

NumroQ Numerology & Astrology Calculators lets you drop over 200 ready made calculators onto any page or post with a shortcode. Your visitor enters a name or a birth date, and the calculator returns the result instantly, styled to match your site.

The plugin covers many traditions in one place: Western, Vedic, Chaldean, Jewish and Greek numerology, Islamic Abjad and Ism-e-Azam, Western and Vedic astrology, Chinese astrology, the Matrix of Destiny, tarot and other divination tools, plus everyday number utilities.

The calculations run on the NumroQ API, so you do not have to build or host a numerology or astrology engine yourself. You connect the plugin once with a free API key from numroq.com, and every shortcode works from then on.

How you embed a calculator

  • [numroq_tool type="tool_id"] – the main shortcode: embed any of the 200+ registered NumroQ calculators by its id (Life Path, birth chart, Kundli, compatibility, tarot and many more).

A few popular ones also have their own short shortcodes:

  • [numroq_abjad] – Abjad calculator: the Kabir and Saghir value of any Arabic name or word, with its element and ruling planet and a per letter breakdown.
  • [numroq_ismazam] – Ism-e-Azam finder for a name.
  • [numroq_matrix_of_destiny] – a visual Matrix of Destiny chart.

Why you will like it

  • One shortcode per calculator, no coding.
  • Right to left and Arabic script handled correctly.
  • Results are computed server side and cached, so pages stay fast.
  • Your API key is stored in WordPress and sent only server to server. It is never exposed in the browser.
  • Works with any theme.

Free and paid

The plugin is free. You need a NumroQ API key to run the calculators, and NumroQ offers a free plan you can start with at no cost. Higher call volumes and the full white label website are available on paid plans, but nothing here is locked behind a payment inside WordPress.

External services

This plugin relies on two external services. Both are required for the calculators to work, because the plugin does not compute results or geocode locations inside WordPress. No visitor data is stored by the plugin itself.

1. NumroQ API (calculations)

This service performs the numerology, Abjad and astrology calculations.

  • What is sent, and when: when a visitor uses a calculator on your site, the values they enter (for example a name in Arabic script, or a birth date) are sent from your server to the NumroQ API, together with your site’s API key, so the result can be computed and returned. A request is made each time a calculator is rendered or submitted.
  • Endpoint: https://numroq-api-production.up.railway.app/api/v1/ (calculation requests).
  • Provider: NumroQ (https://numroq.com).
  • Terms and privacy: Terms of Service and Privacy Policy.

2. Open-Meteo Geocoding API (location autocomplete)

Some astrology calculators need a birth place. When a visitor types a place name into such a calculator, the browser calls the free Open-Meteo geocoding service to suggest matching locations.

  • What is sent, and when: the place-name text the visitor types is sent from the visitor’s browser to Open-Meteo, only while they are typing in a location field, to fetch matching city suggestions. Nothing else is sent, and no API key is involved.
  • Endpoint: https://geocoding-api.open-meteo.com/v1/search (place-name search).
  • Provider: Open-Meteo (https://open-meteo.com).
  • Terms and privacy: Terms and Privacy.

Nothing is sent to any service other than the two described above.

Screenshots

Installation

  1. Install and activate the plugin from Plugins > Add New, or upload the ZIP under Plugins > Add New > Upload Plugin.
  2. Get a free API key: sign up at numroq.com, open the developer portal at dev.numroq.com, and copy your key from My API Keys.
  3. In WordPress, go to Settings > NumroQ and paste your API key, then Save.
  4. Add a shortcode such as [numroq_abjad] to any page or post and publish.

FAQ

Do I need an account to use this plugin?

You need a NumroQ API key, which is free to obtain. Create an account at numroq.com and copy the key from the developer portal into Settings > NumroQ.

Is my API key safe?

Yes. The key is stored in your WordPress options and is only ever sent from your server to the NumroQ API. It is never printed into the page or exposed to the visitor’s browser.

Which scripts can visitors type names in?

Arabic, Urdu and Persian script are supported for the Abjad and Ism-e-Azam calculators. Roman or Latin spellings are not, because Abjad values belong to the Arabic letters.

Can I embed calculators other than the ones listed?

Yes. Use [numroq_tool type="tool_id"] with the id of any registered NumroQ calculator to embed it.

Does it slow down my site?

No. Results are fetched server side and cached, and no heavy scripts are loaded on the front end unless a calculator is present on the page.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“NumroQ Numerology & Astrology Calculators” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.10.29

  • The calculation REST endpoint is now declared as a public endpoint (permission_callback returns true), because the calculators are meant to work for every visitor, including logged-out ones. The WordPress nonce check has been moved inside the handler as an abuse-prevention layer, so the site’s API key still cannot be drained by off-site scripts.

1.10.28

  • Inline scripts and styles are now registered through WordPress’ own script and style system (wp_add_inline_script / wp_add_inline_style) instead of printing raw tags.
  • The calculation REST endpoint now requires a valid WordPress nonce, so the site’s API key can only be used from pages served by your own site.
  • The “Powered by NumroQ” credit is now off by default and only shown when the administrator opts in (Settings > NumroQ).
  • Documented the Open-Meteo geocoding service used for location autocomplete.

1.10.27

  • Public release for the WordPress.org directory.
  • Embed any of the 200+ registered NumroQ calculators with [numroq_tool type="tool_id"], plus short shortcodes for the Abjad calculator, Ism-e-Azam finder and Matrix of Destiny chart.
  • Server side, cached calculations with the API key kept out of the browser.
  • Full external service disclosure and free API key onboarding.