Goals: Two way user sync Two way post sync Two way comment sync This guide is suitable for site with existing WordPress installation and want to integrate XenForo as a forum solution. Also, it is suitable for site with existing XenForo installation and want to integrate WordPress as a portal solution. The WordPress XenForo bridge consists of a WordPress plugin and a XenForo add-on, both were developed by the team at https://xfrocks.com. Resources | XFROCKS xfrocks.com Prerequisite: XenForo 1.2+ WordPress 3.5+ XenForo add-on: [bd] API 1.2+ WordPress plugin: XenForo API Consumer 1.0+ Site addresses and paths assumption: XenForo is installed at path /www/xenforo XenForo can be accessed at address http://domain.com/xenforo/ WordPress is installed at path /www/wordpress WordPress can be accessed at address http://domain.com/wordpress/ These paths are used in the HOWTO to give detail instruction. You are not required to have XenForo and WordPress installed in the same path and address structure. In fact, you can have them install in different servers. Or you can even have more than one WordPress site. Steps: Step 1. Setup XenForo add-on Step 2. Install WordPress plugin Step 3. Setup WordPress (for single blog, for network)
Step 1. Setup XenForo add-on 1. Install XenForo add-on as per instruction. 2. Grant permission "[bd] API: Create Client" for you/your group. 3. Go to http://domain.com/xenforo/index.php?account/api/client-add. 4. Enter information for WordPress site, they should match WordPress General Settings. The most important field is the "Redirect Uri", this field should be the same as WordPress "Site Address (URL)". 5. Click "Save". 6. Take note of the API Key and Secret.
Step 2. Install WordPress plugin 1. Extract the package. 2. Copy folder "xenforo-api-consumer" to /www/wordpress/wp-content/plugins.
Step 3a. Setup WordPress Blog 1. Go to http://domain.com/wordpress/wp-admin/plugins.php and click "Activate" under the plugin name. 2. Go to http://domain.com/wordpress/wp-admin/options-general.php?page=xfac to configure the plugin. Enter http://domain.com/xenforo/api for API Root. Then copy the key and secret from step 1 for "API Key" and "API Secret". Finally, click "Save Changes". 3. If all goes well, you should see a long list of checkboxes like below. If they don't show up, that means WordPress could not connect to XenForo, you will need to double check the three API configuration above.
Step 3b. Setup WordPress Network For WordPress Network site, you can setup the plugin blog by blog (with different XenForo sites) or setup up once (all blogs connect to the same XenForo site). If you want the former, follow step 3a. If you need the later, read on. To avoid confusion, the WordPress Network is installed at /www/wp-network and can be accessed at http://domain.com/wp-network/. 1. Go to http://domain.com/wp-network/wp-admin/network/plugins.php and click "Network Activate" under the plugin name. 2. Go to http://local.dev/wp-network/wp-admin/network/settings.php to configure the plugin. Enter the configuration similar to step 3a. If the configuration is correct, a message will show up to indicate the successful connection attempt. 3. For each blog in the network, blog admin will find a new section under Settings > XenForo API Consumer to further configure the plugin for each blog. Blog admin will not be able to change API Root if the plugin is network-activated (only network admin can do that).