The FooSales iPad and Android tablet apps connect to your store using REST API (primary) or WordPress XML-RPC (secondary). REST API is the preferred connection method as it is generally more stable and secure than XML-RPC. In certain server environments, you might not be able to use the REST API and your web host or a WordPress security plugin might block or restrict XML-RPC for security reasons which will cause a “Connection Error” in FooSales.
Here are a few things you can try if you find yourself in this situation:
Make sure that your website’s REST API is accessible by entering the following address in your web browser: ‘www.YOURWEBSITE.com/wp-json/foosales/v2’
You should see a screen that displays code which starts with {"namespace":"foosales\/v2","routes":
as opposed to an error page such as 404 file not found which indicates that something is wrong with your server configuration or the REST API is blocked.
If the REST API is not accessible, the app will try to connect using XML-RPC as a fallback which might get blocked.
If you have a CAPTCHA plugin or security related plugin installed on your website such as Wordfence or iThemes Security, please temporarily disable it and try to connect to the FooSales app again. If you are able to connect, then the plugin was blocking access and will need to be permanently disabled or configured differently.
If you don’t have a security related plugin installed on your website, ask your hosting company to advise if the IP address of your device has been blocked from accessing the site. If this is the case, you can request your ISP to do the following:
- Whitelist the rule triggered by your IP address
- Disable the Mod_security rule for your domain
If this doesn’t solve the problem, you can try the following:
- Rename ‘xmlrpc.php‘ in the root folder of your website to ‘rpc_requests.php‘
- Download, install and activate this plugin which caters for the renamed ‘xmlrpc.php’ file
NB: We recommend that you download ‘xmlrpc.php’ to your local machine, rename it to ‘rpc_requests.php’ and then upload it again so that both files exist on your site and you don’t overwrite the original file.