WordPress Plugin Setup
The Form Shield WordPress plugin connects your Gravity Forms to TrolleyShield for AI-powered spam protection.
Requirements
- WordPress 5.8+
- Gravity Forms 2.5+
- PHP 7.4+
- A TrolleyShield account with Form Shield enabled
Installation
1. Enable Form Shield in TrolleyShield
- Log in to your TrolleyShield dashboard
- Go to Settings → Form Shield
- Click Enable Form Shield
- Copy your license key (format:
TFSP-XXXX-XXXX-XXXX-XXXX)
2. Install the Plugin
- Download the Form Shield plugin ZIP file
- In WordPress admin, go to Plugins → Add New → Upload Plugin
- Upload the ZIP file and click Install Now
- Click Activate
3. Configure the Plugin
- Go to Form Shield in the WordPress admin menu
- Paste your license key in the settings field
- Click Verify License
- You should see a green "Active" badge with your account name and tier
That's it — your forms are now protected.
Plugin Settings
Behavioral Analysis
Behavioral analysis tracks how users interact with your forms to detect bots:
| Setting | Default | Description |
|---|---|---|
| Enable Behavioral Analysis | On | Track mouse/keyboard patterns |
| Behavioral Threshold | 40 | Score below this triggers further AI analysis |
Actions Per Intent
Configure what happens for each classification:
| Intent | Default Action | Options |
|---|---|---|
| Spam | Block | Allow, Flag, Block |
| Bot | Block | Allow, Flag, Block |
| Phishing | Block | Allow, Flag, Block |
| Suspicious | Flag | Allow, Flag, Block |
| Legitimate | Allow | Allow, Flag, Block |
Actions explained:
- Allow — submission is accepted normally
- Flag — submission is accepted but routed to the spam folder for review
- Block — submission is rejected with an error message
Business Context
Provide a description of your business to improve AI classification accuracy. This helps the AI understand what a legitimate submission looks like for your specific use case.
Troubleshooting
"License key invalid"
- Double-check the key matches what's shown in TrolleyShield Settings
- Ensure Form Shield is enabled in your TrolleyShield account
- Try clicking Verify License again
"API connection failed"
- Check that your WordPress server can reach
app.trolleyshield.com - Verify your server's PHP allows outbound HTTPS requests
- Check for firewall or security plugin interference
Forms not being analyzed
- Ensure Gravity Forms is active and the form has entries
- Check that behavioral analysis is enabled in plugin settings
- Review the Form Shield log in WordPress admin for error details
"Monthly limit reached"
- Your account has used all included analyses for the current billing period
- Paid tiers allow overages (billed at end of month)
- Consider upgrading your plan for higher limits
Usage Dashboard
The plugin displays a usage widget in the WordPress admin showing:
- Analyses used this billing period
- Monthly limit for your tier
- Remaining analyses
- Overage count (if applicable)
Usage data is updated after each form analysis.