Having trouble connecting the FooEvents Check-ins apps to your store?
Common Issues: #
- Was your URL entered correctly?
- Did you enter the correct username and password?
- Do you have the latest plugin installed?
- Does the WordPress user have appropriate permissions?
- Do you have any security plugins installed?
- Do you use a CAPTCHA plugin?
- Is REST API accessible?
- Is your site installed in a subdirectory of another WordPress site?
- Do you have a WordPress.com site instead of a self-hosted WordPress site?
1. Was your URL entered correctly? #
Ensure that your website URL is entered exactly as it appears in your web browserโs address bar.
- Did you specify the correct protocol (includingย http://ย ORย https://)?
- Does your website URL start with โwwwโ or does itย excludeย โwwwโ?
- Does your website URL have a trailing slash at the end (/)?
You can find the exact URL that you need to enter in yourย WordPress admin area.
Go toย Settingsย >ย Generalย >ย WordPress Address (URL)
2. Did you enter the correct username and password? #
The FooEvents Check-ins apps use the same WordPress username and password that you use to log in to your website. Please ensure that you entered your username and password correctly and that you did not enter your FooEvents Accountย login details instead.
3. Do you have the latest plugin installed? #
Check that you definitely have theย latest versionย of theย FooEvents for WooCommerce pluginย installed on your website and the latestย FooEvents Check-insย appย installed on your device
4. Does the WordPress user have appropriate permissions? #
By default, only users with the role of โAdministratorโ in WordPress will have access to the Check-ins app. This article explains how to assign roles to different WordPress users without necessarily giving them admin access to your website:ย User Roles, Capabilities and Permissions
5. Do you have any security plugins installed? #
FooEvents uses an API to connect to your WordPress site. It is very possible that your security plugin is blocking API access to your site. To test if this is the case, temporarily disable any securityย related plugins such asย Wordfenceย andย iThemes Securityย to see if it is blocking access.
If your security plugin is blocking access to FooEvents, please try whitelisting the IP address of your tablet device.
If you are still experiencing problems, please also make sure that two-factor authentication (2FA) is not enabled.
6. Do you use a CAPTCHA plugin? #
If you are using aย CAPTCHAย plugin, please ensure that CAPTCHA is not applied to WordPress logins.
If you are using theย Advanced noCaptcha & invisible captcha Settingsย plugin, you can disable CAPTCHA on the login form via the plugins settings. Login to yourย WordPress admin area, go toย Settingsย >ย Advanced noCaptcha & invisible captcha Settingsย >ย Enabled Formsย >ย Login Formย and ensureย Login Formย is not checked.
7. Is REST API accessible? #
Make sure that your websiteโsย REST API is accessible by entering the following address in your web browser: โwww.yourwebsite.com/wp-json/fooevents/v1โ
You should see a screen that displays code which starts withย {"namespace":"fooevents\/v1","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 you site is installed in the subfolder of another WordPress site, please proceed toย section #8.
If you are using the “Plain” permalink structure please consider one of the other options instead. The “Plain” permalink structure uses a different REST API path which the Check-ins app does not currently support. You can change this setting if you go to Settings > Permalinks and choose e.g. “Post name” instead.
If the REST API is not accessible and the app tries to fallback to the less preferred XML-RPC connection, please check that your xmlrpc.php file is accessible. Enter โwww.YOURSITE.com/xmlrpc.phpโ in your web browser. You should see the following message if the xmlrpc.php file is accessible: โXML-RPC server accepts POST requests only.โ
Please also contact your web host and ask them to do the following:
- Whitelist the rule triggered by the IP address of your mobile device
- Disable theย Mod_securityย rule for your domain
8. Is your site installed in a subdirectory of another WordPress site? #
If your site is installed in a subdirectory of another WordPress site, then the .htaccess files of your subdirectory might cause permalinks conflict making the REST API unaccessible.
Example:
- Main WordPress ite https://www.example.com/
- Your test WordPress site: https://www.example.com/testsite/
To solve this, you need to edit the .htaccess file in your subdirectory WordPress install. Replace the code inside your .htaccess file with the following code:
# BEGIN WordPress RewriteEngine On RewriteBase /your-subdirectory/ RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /subdirectory/index.php [L] # END WordPress
Ensure that you replaceย /subdirectory/ย with your own subdirectory name.
9. Do you have a WordPress.com site instead of a self-hosted WordPress site? #
The FooEvents Check-ins app can only work with a self-hosted WordPress site and not on a WordPress.com site. You would either need to move to a self-hosted WordPress setup or you can consider using the FooEvents Express Check-in plugin extension instead.
If you have tried all the troubleshooting steps above and you are still experiencing a connection issue, please contact FooEvents Technical Support and provide as much detail as possible so we can get back to you with other possible solutions.