Factor Calculator Widget

A secure, obfuscated Web Component (<factor-calculator-widget>) 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-widget

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

🔑 License Setup

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

Example usage:

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

Domain & IP Binding

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

Development

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

• Typical entries include:

  • 127.0.0.1 (localhost)
  • Your LAN IP (e.g., 192.168.1.100)

• 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/ip against your license record.

If the domain or IP 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 IP 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
  • IP binding
  • Expiry date

If validation fails, the widget does not render.

📦 Usage

React Example

import "@simplifyingcalculation/factor-calculator-widget";

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

export default App;

Angular Example

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

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

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/@your-scope/factor-calculator-widget/dist/wp-widget.zip

   Or grab the ZIP directly from our Releases.

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_widget license-key="YOUR-KEY"]

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

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

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.