Gravity Extract WP Registry grade D+. High-severity findings · 3 findingsWP RegistryHigh-severity findings · 3 findingsOpen the reportD+
A WordPress plugin that integrates with Gravity Forms to automatically extract data from uploaded documents using AI vision models.
Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/guilamu/gravity-extract/releases/download/v1.1.1/gravity-extract.zipAI-powered document data extraction for Gravity Forms. Upload invoices or receipts and automatically populate form fields using powerful AI vision models via POE or Google Gemini APIs.
Document Upload
- Drag & Drop Interface: Easy-to-use upload area for document images and PDFs.
- Multi-Format Support: Handles JPEG, PNG, WebP, and multi-page PDFs (automatically converted).
- Real-Time Feedback: Visual progress indicators and immediate preview of uploaded documents.
AI-Powered Extraction
- Multi-Provider Support: Choose between POE API (GPT-4o, Claude, Gemini via POE) or Google Gemini API (direct).
- Vision Model Integration: Connects with powerful AI vision models for document analysis.
- Smart Data Parsing: Extracts merchant details, amounts, dates, and line items with high accuracy.
- Structured JSON Output: Returns clean, structured data ready for form population.
Field Mapping
- Flexible Mapping System: Associate extracted data with any Gravity Forms field type.
- AI Auto-Mapping: Automatically suggests the best connections between extracted data and form fields.
- Custom Profiles: Save, export, and reuse mapping configurations for different document types.
Key Features
- AI Field Detection: Automatically detects available fields in custom documents
- Per-Form Configuration: Each form can use a different API provider, key, and model
- Multilingual: Works with content in any language
- Translation-Ready: All strings are internationalized
- Secure: API keys are stored per form with no external data leakage
- GitHub Updates: Automatic updates from GitHub releases
Supported API Providers
POE API
- Access to GPT-4o, Claude, Gemini, and many other models through a single API key
- Dynamic model list fetched from the POE API
- Get your API key at poe.com/api_key
Google Gemini API (Direct)
- Gemini Flash — Fast and cost-effective
- Gemini Pro — Most capable model
- Uses the OpenAI-compatible endpoint for seamless integration
- Get your API key at aistudio.google.com/apikey
Requirements
- A POE API Key or a Google Gemini API Key
- WordPress 5.0 or higher
- PHP 7.4 or higher
- Gravity Forms 2.5 or higher
Installation
- Upload the
gravity-extractfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- Go to your form's Settings → Gravity Extract tab
- Select your API Provider (POE or Gemini)
- Enter your API key and select a model
- Add a Gravity Extract field to your form to start using it
FAQ
How do I get an API key?
- POE: Create a free account at poe.com and visit poe.com/api_key
- Gemini: Visit aistudio.google.com/apikey to generate a key
Can I use different providers for different forms?
Yes! Each form has its own Gravity Extract settings tab where you can independently choose the API provider, key, and model.
Does it work with PDFs?
Yes, multi-page PDFs are supported. The plugin converts them to images for the AI model to analyze.
Can I customize the extraction prompt?
Yes, use the gravity_extract_prompt filter:
add_filter('gravity_extract_prompt', function($prompt) {
return $prompt . "\nAlso extract the warranty period.";
});
Project Structure
.
├── gravity-extract.php # Main plugin file
├── README.md
├── css
│ ├── gravity-extract-admin.css # Admin styles
│ └── gravity-extract-frontend.css # Frontend styles
├── includes
│ ├── class-gravity-extract.php # Core plugin class
│ ├── class-gemini-api-service.php # Google Gemini API service
│ ├── class-github-updater.php # GitHub auto-updates
│ ├── class-gravity-extract-addon.php # GF Addon settings
│ ├── class-gf-field-gravity-extract.php # Custom GF field
│ ├── class-mapping-profiles-manager.php # Profiles manager
│ └── class-poe-api-service.php # POE API service
└── js
├── gravity-extract-admin.js # Admin scripts
└── gravity-extract-frontend.js # Frontend scripts
Changelog
1.1.1
- Improved: Rewritten GitHub updater with README.md parsing for "View details" popup
- New: "View details" thickbox link in plugin row meta
- New: Parsedown.php for reliable Markdown-to-HTML conversion
- Improved: Plugin info popup now shows Description, Installation, FAQ, and Changelog tabs
1.1.0
- New: Added Google Gemini API as an alternative AI provider
- New: Per-form API provider selection (POE or Gemini)
- New: Gemini API key and model settings per form
- New: Gemini Flash and Gemini Pro model support
- Improved: Provider-aware API routing for all extraction features (analyze, automap, detect)
- Improved: Updated README with multi-provider documentation
1.0.3
- Minor fixes
1.0.2
- Security: Fixed SSL verification issue in POE API service
- Performance: Increased memory limit for image processing
- Improvement: Cleaned up debug logs for better production hygiene
1.0.1
- New: Added GitHub auto-update support
- Improved: Updated README documentation structure
1.0.0
- Initial release
- AI-powered document extraction
- Gravity Forms integration
- Drag and drop upload
- Field mapping profiles
License
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.
Made with love for the WordPress community
Releases
4 releases. Each count is every asset in that release; expand a row for the breakdown.
Active-site estimate ≈10 comes from the median of recent superseded releases. Method.