Skip to main content

Installation

Prerequisites​

  • WordPress 6.9+
  • WooCommerce active
  • PHP 7.4+
  • Writable database for custom tables

Install Plugin​

  1. Copy plugin folder to:
wp-content/plugins/suma-security
  1. Activate plugin in WordPress admin.
  2. Confirm plugin appears under Settings -> Suma Security.
  3. Visit checkout once to validate frontend script loading.

Activation Side Effects​

On activation, plugin lifecycle provisions defaults and schema:

  • Creates session lock table
  • Creates device token table
  • Creates fingerprint activity table
  • Creates fingerprint state table
  • Stores secure defaults:
    • suma_security_require_device_token = 1
    • suma_security_enable_second_failure_email = 1
    • suma_security_velocity_block_threshold = 12
    • suma_security_payment_lockout_duration = 1800

JavaScript Build (if source changed)​

From plugin directory:

npm install
npm run build

Build outputs:

  • assets/js/dist/checkout-velocity-fingerprint.js
  • assets/js/dist/checkout-verification.js

Post-Install Verification​

  • Checkout page loads with no JS/PHP fatals.
  • Hidden fingerprint fields are injected on checkout form.
  • Device token cookie is issued on checkout route.
  • Settings page saves options successfully.
  • Tools page loads fingerprint table UI.