Factor Calculator Widget - 🚀 Live Demo

A secure, obfuscated Web Component (<factor-calculator>) that can be embedded into any framework (React, Angular, Vue, Wordpress) with domain-bound license validation.

🚀 Installation

You need a valid license key to install this SDK.

SDK_LICENSE_KEY=YOUR-LICENSE-KEY npm install @simplifyingcalculation/factor-calculator

⚠️ Installation will fail if the license key is missing or invalid.

🔑 License Setup

The widget requires a license-key. These is issued by your account portal after purchase.

Example usage:

<factor-calculator
  license-key="acb-000-yzx"
></factor-calculator>

Domain & Local Address Binding

The license validation system supports local address binding (for development) and domain binding (for staging/production). Both must be configured correctly for the widget to work in the respective environment.

Development

• You must register at least one local address in your license portal.

• Typical entries include:

  • 192.1xx.xx.xxx:3000 (ip_address:port_number)
  • localhost:3000 (localhost:port_number)

• This ensures the widget runs correctly on your local machine during development.

Staging & Production

• You must register the domain names where the widget will be deployed.

• Examples:

  • staging.example.com
  • app.example.com

• At runtime, the widget checks the current domain against your license record.

If the domain or local address is not whitelisted, validation will fail and the widget will not render.

Setup Checklist

1. Log in to your account portal.
2. Register your development Local address.
3. Register your production domain.
4. Register your staging domain (optional).
5. Deploy the widget with the correct license-key.

How It Works

• license-key → your public identifier

• user-validation → automatically validates (package):

  • Domain binding
  • Local address binding
  • Expiry date

If validation fails, the widget does not render.

📦 Usage

👉 Full Docs on Portal

React Example

import "@simplifyingcalculation/factor-calculator";

function App() {
  return (
    <div>
      <h1>My App</h1>
      <factor-calculator
        license-key="YOUR-KEY"
      />
    </div>
  );
}

export default App;

Angular Example

// main.ts
import "@simplifyingcalculation/factor-calculator";

<!-- app.component.html -->
<factor-calculator
  license-key="YOUR-KEY"
></factor-calculator>

WordPress Plugin Installation (ZIP included in this package)

We provide a ready-to-install WordPress plugin ZIP inside this package, so you don’t need to write any PHP code yourself.

Steps

1. Download the plugin ZIP

   After installing this package, you’ll find the plugin at:

   node_modules/@simplifyingcalculation/factor-calculator/dist/wp-widget.zip

   Or ⬇️ Download the ZIP directly.

2. Upload to WordPress

   • Go to your WordPress Admin dashboard.
   • Navigate to Plugins → Add New → Upload Plugin.
   • Choose wp-widget.zip and click Install Now.
   • After installation, click Activate Plugin.

3. Use the widget

   In any post or page, insert the shortcode:

   [factor_calculator license-key="YOUR-KEY"]

   Or use the Custom HTML block and insert the tag directly:

   <factor-calculator
     license-key="YOUR-KEY"
   ></factor-calculator>

Notes

• The plugin automatically enqueues the widget’s JavaScript and CSS assets, no extra setup required.
• Keep your license-key values secure — treat them as you would any public API key.

📜 License

This Widget is proprietary to SIMPLIFYING CALCULATION and requires a valid license to install and use. Unauthorized usage or distribution is prohibited.