Description
A broken contact form shows no error to you. After an update, a changed mail setting or an expired SMTP login, visitors may still see “Thank you for your message” while no email reaches you, and you find out when someone asks why nobody replied.
Until then, every enquiry is lost: quote requests, bookings, job applications. Paid ads keep sending visitors to a form that does nothing, and customers who never heard back assume you ignored them. Site owners in the Contact Form 7 support forum describe forms that had not sent a single email for months.
FlatLineForm tests your form once a day, the way a visitor uses it, and emails you when something fails:
- the page or the form did not load,
- the form rejected the test or never answered (the button that just spins),
- WordPress could not send the email (“There was an error trying to send your message”),
- WordPress reported the email as sent, but our copy of it never arrived.
Each step is reported separately, so a thank-you message is never mistaken for a delivered email. You sign up at https://flatlineform.com, free during the launch period. No check can catch every fault, but a daily one means you are not the last to know.
How it works
FlatLineForm is the WordPress side of the FlatLineForm monitoring service. The service opens your form pages in a real browser, fills in clearly labelled test data and submits the form, the same way a visitor would. This plugin lets the service:
- see which Contact Form 7 forms exist, which fields they have and which published pages show them,
- report the WordPress, PHP and Contact Form 7 versions and whether they are compatible,
- prepare short-lived, signed test runs,
- learn what happened to a test submission: the Contact Form 7 result and whether WordPress reported that the mail function succeeded.
Only submissions that carry a valid, signed and unexpired test marker (a cookie set by the service’s browser) are treated as tests. Every test run can be used exactly once. Ordinary visitors are not affected in any way.
During a test run the plugin adds a blind copy (Bcc) of the form’s primary email to a test address owned by the service, plus an X-FlatLineForm-Run header. This lets the service confirm that the test copy arrived. The copy is added only to the test submission, never to real messages.
Please note what the checks can and cannot prove. A “thank you” message on the page does not prove that email was delivered. That WordPress reports a successful mail call does not prove that your inbox received the message. A received test copy only proves that the copy arrived.
The plugin:
- does nothing until an administrator enters a connection code under Tools FlatLineForm,
- adds nothing to the public site (no links, scripts, styles or advertising),
- never stores or forwards the content of form messages or visitor details,
- does not modify Contact Form 7 or any other plugin (the optional CAPTCHA exemption only removes Contact Form 7’s own reCAPTCHA/Turnstile check during a valid test request, through Contact Form 7’s documented
wpcf7_spamfilter).
Limitations: forms with file uploads, multi-step or payment fields are reported as not supported. Forms protected by CAPTCHA, quiz, reCAPTCHA or Turnstile are checked up to the send button and reported as blocked, because an automated test cannot solve them.
Optional CAPTCHA exemption for tests: on the Tools FlatLineForm page an administrator can let signed test messages skip Contact Form 7’s built-in reCAPTCHA and Turnstile checks. It is off by default. When it is on, the check is removed for one request at a time, and only for a submission that carries a valid, signed, single-use test marker for that form. Everyone else, including bots, still has to pass the CAPTCHA, and other spam filters such as Akismet still run. Results of such tests say that the CAPTCHA was skipped and not tested. CAPTCHA plugins from other vendors are not affected.
This plugin has not been reviewed or approved by WordPress.org.
External services
This plugin connects to the FlatLineForm service. The service address is entered by the administrator on the Tools FlatLineForm page (or set with the FLATLINEFORM_SERVICE_URL constant). Nothing is sent before an administrator connects the site.
What is sent, and when:
- When an administrator clicks “Connect”: the one-time connection code, the site’s home URL, and the plugin, WordPress, PHP and Contact Form 7 versions are sent to
<service>/api/plugin/connect. - When an administrator clicks “Rotate keys”: a signed request to
<service>/api/plugin/rotateand<service>/api/plugin/rotate/confirm, containing only a rotation id. - When an administrator clicks “Disconnect”: a signed request to
<service>/api/plugin/disconnectwith an empty body.
After the site is connected, the service calls this site’s REST API (namespace flatlineform/v1) with signed requests. The plugin answers with versions and compatibility, the list of Contact Form 7 forms (id, title, field names, field types and options, defined choices for select/radio/checkbox/acceptance fields, and the URLs and titles of published pages that show each form), and the status of test runs (status codes and timestamps only).
During a test run, the test submission’s primary email is also sent as a blind copy to a test address owned by the service. That test submission contains only synthetic test data entered by the service’s browser.
The plugin never sends real form submissions, visitor data or email addresses of your visitors to the service.
Terms of use and privacy policy of the service (here <service> is the service address you connect to; the same links are shown on the Tools FlatLineForm page):
- Terms of use:
<service>/terms - Privacy policy:
<service>/privacy
Installation
- Upload the
flatlineformfolder to/wp-content/plugins/, or install the ZIP file under Plugins Add New Upload Plugin. - Activate the plugin. Activation does not contact any external service.
- Make sure Contact Form 7 is active.
- In the FlatLineForm service, add your site and create a connection code.
- Go to Tools FlatLineForm, enter the code (and the service address), and click Connect.
FAQ
-
My form says the message was sent, but no email arrives. Will FlatLineForm catch that?
-
Yes, as far as it can be seen from outside your inbox. The plugin adds a hidden copy of each test email to an address of ours, so the service can tell whether WordPress only reported the email as sent or whether it actually left your site. Whether it then landed in your inbox or your spam folder is something only you can see; you confirm that step yourself.
-
Contact Form 7 stopped working after an update. How would I find out?
-
From the next daily check. A problem found before the form was sent is checked again after 10 minutes, and you get an email if it is still there. A problem after the form was sent is reported at once.
-
Will the test messages bother anyone?
-
Once a day, one test message goes through your form to the form’s normal recipient, like a real enquiry. It is clearly labelled as an automated test enabled by the site owner and includes a check id, so it is easy to filter. You can pause at any time.
-
Do I need an account? Is it free?
-
Yes, you need an account at https://flatlineform.com. The service is free during the launch period; paid plans may come later and you will be told in advance. The plugin itself has no locked features.
-
Does the plugin change how my forms behave for visitors?
-
No. Without a valid test marker the plugin does nothing. With an invalid, expired or already used test marker the submission is not mailed and is not recorded.
-
What happens when I uninstall the plugin?
-
The plugin’s own database tables, options and scheduled event are removed. Contact Form 7 and your forms are not touched.
-
Does the plugin store form messages?
-
No. For each test run it stores only the run id, form id, the test copy address, status codes and timestamps. Test run records are deleted after 7 days.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“FlatLineForm – Contact Form 7 Monitoring” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “FlatLineForm – Contact Form 7 Monitoring” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Optional setting that lets signed test messages skip Contact Form 7’s built-in reCAPTCHA and Turnstile checks (off by default). Results report when the CAPTCHA was skipped.
1.0.0
- First version.
