General Settings
2 min read
The General settings tab is the top-level configuration page for TrustLens. It controls store-wide scoring behavior, checkout enforcement, and the basic display options that affect the rest of the plugin. This page walks through every setting on the tab and explains the effect of each.
Location: TrustLens → Settings → General.
Scoring Settings #
Minimum Orders for Scoring #
Default: 3
Customers below this threshold stay at score 50 / segment Normal regardless of signals. Prevents false positives on new customers with limited history.
Lower (2) if: Strong signal quality, want faster classification.
Raise (5+) if: Very generous return policy, want extra patience.
Segment Thresholds #
Defaults: VIP 90, Trusted 70, Normal 50, Caution 30, Risk 10, Critical 0
Score boundaries between segments. Rarely needs tuning — the defaults match how the rest of the plugin is documented. Customize via the trustlens/segment_thresholds filter if needed.
Return-Risk Thresholds #
Defaults: 25% elevated, 40% high, 60% critical
Trigger points for Returns module signals. See Return Abuse Detection for the per-industry tuning recommendations.
Checkout Enforcement #
Enable Checkout Blocking #
Default: Off in Free
Master toggle for whether blocked-customer status enforces at checkout. When off, you can mark customers as blocked but they can still check out. Turn on once you trust the scoring.
Block Add-to-Cart #
Default: Off
If on, blocked customers can’t add items to cart. More aggressive than checkout-only blocking. Use only after you’ve confirmed false positives are rare.
Block Message #
Default: “We’re unable to process your order at this time. Please contact support.”
The error shown to blocked customers at checkout. Keep neutral — don’t include words like “blocked,” “fraud,” or “risk.”
Display Settings #
Show Trust Column on Orders List #
Default: On
Adds the Trust badge column to the WooCommerce orders list. Per-user can override via screen options.
Show Trust Meta Box on Order Edit #
Default: On
Adds the TrustLens meta box to the order edit page.
Show Trust Badge on Customer List in WooCommerce #
Default: On
Adds the trust badge to the WooCommerce customer list (if you have one — varies by WC version).
Card-Testing Defense #
Card-Testing Defense Enabled #
Default: On
Master toggle for the Card-Testing Defense module. Disabling stops all velocity tracking and lockouts. Rarely a reason to disable.
VIP Customer Bypass #
Default: On
VIPs skip velocity checks at checkout. See VIP Bypass.
Privacy Settings #
Show Email Addresses in Admin #
Default: On
Whether customer emails are visible in the Customers list. Off shows only hashes (more privacy-protective; harder to act on).
Auto-Erase Inactive Customers #
Default: Off
If on, customers inactive for the configured period have their TrustLens data automatically erased. Useful for compliance-driven retention policies.
Inactive Period (days) #
Default: 730 (2 years)
Used by Auto-Erase Inactive Customers.
Performance Settings #
Score Update Latency Target #
Default: 60 seconds
Target delay before queued score recalculations run. Lower values mean fresher scores but more queue work. Higher values mean less queue work but slightly stale scores.
Dashboard Cache TTL #
Default: 15 minutes
How long Dashboard analytics are cached before recomputing. Lower means fresher dashboard but more database work. Higher means snappier dashboard but slightly stale.
Saving and Validation #
Settings save with WordPress’s standard form submission. Most settings take effect immediately on save; some (like minimum orders) require an existing score recalculation to manifest — use bulk recalculate from the Customers list to force.
Validation runs on each save. Invalid values (negative thresholds, malformed messages) are flagged inline with specific errors.
Restoring Defaults #
The Restore Defaults button at the bottom of each settings page resets all settings to their initial values. Useful if you’ve experimented with settings and want to reset to a known good state. Confirmation dialog before action.
Restoring defaults doesn’t delete customer data or scoring history — only the settings.
