Troubleshooting

Troubleshooting

Submissions return nonce verification failed

This usually means the page was cached and the embedded nonce expired. If you use full-page caching, exclude pages with forms from the cache, or enable per-request nonce regeneration in your cache plugin. As a quick test, clear the page cache and resubmit.

Admin notification emails never arrive

1. Check OForms -> Entries. If the entry is there but no email arrived, the form processed but mail failed.
2. If OMailer is installed, check OMailer -> Email Log for the send attempt and failure reason.
3. If OMailer is not installed, the site falls back to wp_mail(). Install an SMTP plugin (OMailer is recommended) - PHP's default mail() is usually blocked by shared hosts.
4. Verify the From address is on a domain you control. Most mail providers reject messages with a @gmail.com or @yahoo.com From address sent from your server.

Conditional logic doesn't hide fields on submit

Client-side hiding only affects display. The submit handler in OForms\Forms\Submission::process() re-evaluates conditions and discards values for fields that should be hidden. If you're seeing hidden field values in entries, double-check the rule operator: is_not_empty checks for any value, including empty strings.

File uploads fail silently

Check the field's max_size_mb against PHP's upload_max_filesize and post_max_size in php.ini. The lowest wins. If the PHP limit is the bottleneck, raise it in php.ini or .htaccess. Also verify /wp-content/uploads/ is writable (775 or 755 with correct owner).

Workflow om_subscribe action does nothing

The action runs via the of_process_queue cron. If WP cron isn't running (low-traffic site), submissions queue but never process. Hit wp-cron.php from a real cron job to force execution:

* * * * * curl -s https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null

Verify with wp cron event list | grep of_process_queue.