Troubleshooting Common FMC Issues

Settings Not Saving: #

If FMC settings appear to save but revert when refreshing the page, this typically indicates a JavaScript or AJAX error. Open your browser’s developer console (F12) and attempt to save settings while watching for error messages. Common causes include: plugin conflicts (try deactivating other plugins temporarily), theme JavaScript conflicts (switch to a default theme like Twenty Twenty-Four to test), or server configuration issues blocking AJAX requests. Ensure your WordPress installation meets minimum requirements (PHP 7.4+, WordPress 5.8+) and that your hosting environment allows AJAX POST requests to admin-ajax.php.

Credits Not Awarding Automatically: #

If automatic credit awards fail to trigger on expected actions (posts, comments, votes), verify several configuration points. First, confirm settings specify non-zero credit amounts for the relevant actions in FMC → Settings. Second, ensure the user performing the action is logged in–guest actions never trigger credit awards. Third, check that WordPress action hooks are firing correctly by temporarily adding debug logging to the FMC plugin. If using a page builder or custom theme, verify it triggers standard WordPress hooks like ‘publish_post’ and ‘comment_post’ that FMC monitors.

MetaMask Connection Issues: #

MetaMask integration problems usually stem from network mismatches or browser extension conflicts. Ensure users are connected to Ethereum Mainnet (not testnets like Goerli or Sepolia) as FMC defaults to mainnet verification. Check that the MetaMask extension is updated to the latest version and that users have approved the connection request in the popup window. Browser privacy extensions like Privacy Badger or uBlock Origin may block Web3 injections–whitelist your site to allow wallet connections. For persistent issues, use the manual wallet address entry fallback while troubleshooting the MetaMask integration.