Skip to main content

Troubleshooting

For more information on troubleshooting platform errors, please take a look at the Troubleshooting section of XLink here.

WordPress theme displaying no styling​

No XLink Platform link has been established, the previous platform link has been deleted or the XPress or XLink XenForo add-on is unavailable (disabled/uninstalled). Please ensure both add-ons are active and configured.

XenForo Resources are not loading (Icons, Fonts, Images)​

This issue is usually accompanied by dozens of Cross-Origin errors in the browser console and happens when XenForo and WordPress are run on different subdomains.

In order to run XPress in a subdomain setup, the Cross-Origin mode in the XLink platform settings has to be enabled, and the server has to be configured to allow resource sharing between both subdomains. Your server host should be able to resolve the situation with the errors logged in the browser console.

User is not automatically logged in on WordPress on subdomain​

When running XenForo and WordPress on different subdomains, XenForo cookie domains have to be configured in a way that cookies are available on both subdomains, otherwise session information cannot be shared.

WordPress homepage works, but posts lead to XenForo 404 pages​

This issue usually happens when WordPress is installed in a subfolder within your XenForo installation. The given problem is that your server is passing the request to the first index.php file that accepts it, starting at the root folder (XenForo). As XenForo accepts any arbitrary request, and doesn’t understand the request, it throws a 404 page. Your server host should be able to change the server configuration to have it pass the request to the subfolder first.

JavaScript of WordPress plugins not working​

WordPress plugins that rely on jQuery usually load an older version of jQuery, which will be overwritten by XenForo’s jQuery version later on, subsequently eliminating the already loaded version and hence crashing the JavaScript of your plugins. Enabling the JavaScript Wrapper mode in the XLink platform settings will normally resolve this issue.

WordPress dashboard is inaccessible​

  1. Connect to your server via FTP or use the file manager of your server’s control panel.
  2. Head to your WordPress installation directory.
  3. Go into wp-contents/themes and delete or rename the wp-xpress-theme folder.
  4. Go into wp-contents/plugins and delete or rename the wp-xpress-plugin folder.

XenForo Admin Control panel is inaccessible​

  1. Connect to your server via FTP or use the file manager of your server’s control panel.
  2. Head to your XenForo installation directory.
  3. Go into src and download your configuration file.
  4. Add $config['enableListeners'] = false; to the end of the configuration file, save and re-upload it.
  5. Head to your XenForo admin control panel and disable the XPress plugin.
  6. Repeat step 1 to 3, remove the line added in step 4, save and re-upload your configuration file.