Troubleshooting
Forum index returns 404
The /forum/ page is auto-created on activation. If a previous install removed it, go to OForum, Settings and resave; the page is recreated on the next page load. Then visit Settings, Permalinks once to flush rewrite rules.
New threads do not show up
Check the thread's room is public and the user's trust level meets the room's posting threshold. Mod-only rooms reject thread creation from low-trust accounts silently.
Notifications never appear
The bell reads from wp_of_notifications. Two common causes:
- The thread/room is not actually followed - confirm by checking
wp_of_subscriptionsfor a row with the user's ID. - Email delivery is failing (separate from in-forum delivery). Test WordPress mail with a SMTP plugin.
Reactions disappear after a page reload
Reactions are written via the /wp-json/oforum/v1/reactions endpoint. If the AJAX request returns 403, the REST nonce has expired or the user is not logged in. Re-login and retest.
Cron-driven digests do not send
OF_Digest runs on WP-Cron, which only fires when there is traffic. On low-traffic sites set a real cron job to wp-cron.php every five minutes, or disable DISABLE_WP_CRON.
Uninstall leaves rows behind
The uninstall handler deletes CPTs in batches of 200 to avoid timeout. On very large forums you may need to run uninstall multiple times, or run a cleanup SQL DELETE FROM wp_posts WHERE post_type IN ('of_room','of_thread','of_reply').