How can I know when a form was submitted in WordPress?

Knowing when a form is submitted in WordPress is crucial for various tasks, such as tracking submissions, triggering actions, or displaying confirmation messages. Here's how you can achieve this using different methods:

1. Using WordPress Hooks (Recommended):

- WordPress provides hooks that allow you to tap into the form submission process. The specific hook you use depends on the form plugin or method you're using.

- For Contact Form 7: Use the wpcf7_mail_sent hook. This hook is triggered after the email is successfully sent.

- For Gravity Forms: Use the gform_after_submission hook. This hook is triggered after a form is submitted.

- For other form plugins: Check the plugin's documentation for specific hooks.

2. Example Code for Contact Form 7:

function custom_contact_form_submission() {
  // Your code here to handle the submission
  error_log('Contact Form 7 submitted!'); // Example: Log the submission
}
add_action('wpcf7_mail_sent', 'custom_contact_form_submission');

3. Example Code for Gravity Forms:

function custom_gravity_form_submission($entry, $form) {
  // Your code here to handle the submission
  error_log('Gravity Form submitted! Form ID: ' . $form['id']); // Example: Log the submission with form ID
}
add_action('gform_after_submission', 'custom_gravity_form_submission', 10, 2);

4. Using JavaScript (Less Reliable):

- You can use JavaScript to detect form submissions, but this method is less reliable because it can be bypassed if JavaScript is disabled or if the form is submitted through other means.

- You can use the submit event listener on the form element.

5. Example JavaScript Code:

document.addEventListener('DOMContentLoaded', function() {
  const form = document.querySelector('form'); // Select your form
  if (form) {
    form.addEventListener('submit', function(event) {
      console.log('Form submitted!'); // Example: Log the submission
    });
  }
});

6. Best Practices:

- Always use WordPress hooks when possible for reliable form submission detection.

- Avoid relying solely on JavaScript for critical actions related to form submissions.

- Check the documentation of your specific form plugin for the correct hooks and methods.

By using these methods, you can effectively detect when a form is submitted in WordPress and perform necessary actions based on the submission.

Learn more about this