=== Kainoto Webhook for Contact Form 7 === Contributors: dusanvr Tags: contact form 7, webhook, form data, integration, api Requires at least: 5.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.6 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Send Contact Form 7 submissions to webhook URLs without waiting for response. Perfect for integrations with external services. == Description == Kainoto Webhook for Contact Form 7 is a lightweight WordPress plugin that extends Contact Form 7 functionality by sending form submission data to specified webhook URLs. The plugin operates asynchronously, ensuring your website's performance isn't affected by external API response times. = Key Features = * **Asynchronous Processing**: Sends webhook data without waiting for response, maintaining optimal site performance * **Easy Configuration**: Simple webhook URL setup directly in Contact Form 7 admin panel * **JSON Format**: Sends form data in clean JSON format for easy processing * **URL Validation**: Built-in validation ensures only proper URLs are accepted * **No Response Dependency**: Fire-and-forget approach prevents external service issues from affecting your forms * **Lightweight**: Minimal code footprint with no unnecessary bloat = Perfect For = * CRM integrations * Email marketing services * Custom analytics tracking * Third-party notification systems * API-based workflow automation * Real-time data synchronization = How It Works = 1. Install and activate the plugin 2. Edit any Contact Form 7 form 3. Navigate to the new "Webhook" tab 4. Enter your webhook URL 5. Save the form That's it! Now every form submission will automatically send the data to your specified webhook URL in JSON format. = Technical Details = * Hooks into Contact Form 7's submission process after validation but before email sending * Sends POST requests with JSON payload containing all form field data * Uses WordPress HTTP API for reliable delivery * 15-second timeout with non-blocking execution * Sanitizes and validates all webhook URLs == Installation == = Automatic Installation = 1. Log in to your WordPress admin panel 2. Go to Plugins > Add New 3. Search for "Kainoto Webhook for Contact Form 7" 4. Click "Install Now" and then "Activate" = Manual Installation = 1. Download the plugin zip file 2. Upload it to your `/wp-content/plugins/` directory 3. Extract the files 4. Activate the plugin through the WordPress admin Plugins menu = Requirements = * WordPress 5.0 or higher * Contact Form 7 plugin installed and activated * PHP 7.4 or higher == Frequently Asked Questions == = Does this plugin slow down my website? = No! The plugin uses asynchronous (non-blocking) requests, meaning it doesn't wait for the webhook response. Your forms submit normally while the webhook data is sent in the background. = What data format is sent to the webhook? = All form field data is sent as JSON in the request body. The Content-Type header is set to "application/json; charset=UTF-8". = What happens if my webhook URL is down? = Nothing happens to your form functionality. Since the plugin doesn't wait for responses, webhook failures won't affect your Contact Form 7 submissions or user experience. = Can I use multiple webhook URLs per form? = Currently, each form supports one webhook URL. If you need multiple endpoints, consider using a webhook relay service or setting up your webhook to forward data to multiple destinations. = Is the webhook data secure? = The plugin sends data exactly as submitted through your contact form. Ensure your webhook endpoint uses HTTPS and implements proper security measures on your end. = Can I customize the data sent to the webhook? = The plugin sends all form field data as submitted. For custom data manipulation, you can modify the webhook endpoint to process the received JSON data as needed. == Screenshots == 1. Webhook settings panel in Contact Form 7 admin 2. URL validation in action 3. Simple configuration interface == Changelog == = 1.0.3 = * Improved URL validation with real-time feedback * Enhanced admin interface styling * Added proper error handling for invalid URLs * Updated documentation and code comments = 1.0.2 = * Added URL validation * Improved error handling * Fixed admin notice display = 1.0.1 = * Initial bug fixes * Improved code documentation = 1.0.0 = * Initial release * Basic webhook functionality * Contact Form 7 integration == Upgrade Notice == = 1.0.3 = This version includes improved URL validation and better error handling. Update recommended for all users. == Developer Information == = Hooks and Filters = The plugin provides several hooks for developers: * `wpcf7_editor_panels` - Adds the webhook panel to CF7 admin * `wpcf7_save_contact_form` - Saves webhook settings * `wpcf7_submit` - Sends webhook data after form submission = Code Example = ```php // Example webhook endpoint (PHP) $json = file_get_contents('php://input'); $data = json_decode($json, true); // Process form data foreach($data as $field => $value) { // Handle each form field error_log("Field: $field, Value: $value"); } ``` = Support = For technical support, feature requests, or bug reports, please visit: https://kainoto.com == Privacy Policy == This plugin does not collect, store, or transmit any personal data beyond what is explicitly submitted through Contact Form 7. All data handling is controlled by your webhook endpoint configuration.