[HOWTO] Complete WordPress XenForo Bridge setup

Discussion in 'WordPress' started by xfrocks, Mar 1, 2014.

Thread Status:
Not open for further replies.
  1. Have feature suggestions for the WordPress plugin? Post or vote here.
  1. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    #1 , Mar 1, 2014
    Last edited: Mar 21, 2014
    [​IMG]

    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:
    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:
     
    john_the_tester and Radouane like this.
  2. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    #2 xfrocks, Mar 1, 2014
    Last edited: Oct 3, 2014
    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.
    Screen Shot 2014-03-01 at 3.49.18 PM.png

    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)".
    Screen Shot 2014-03-01 at 3.48.51 PM.png
    Screen Shot 2014-03-01 at 3.48.37 PM.png

    5. Click "Save".

    6. Take note of the API Key and Secret.
    Screen Shot 2014-03-01 at 3.47.17 PM.png
     
  3. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    #3 xfrocks, Mar 1, 2014
    Last edited: Mar 13, 2014
    Step 2. Install WordPress plugin

    1. Extract the package.
    2. Copy folder "xenforo-api-consumer" to /www/wordpress/wp-content/plugins.
     
    Dadparvar and Radouane like this.
  4. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    #4 xfrocks, Mar 1, 2014
    Last edited: Mar 1, 2014
    Step 3a. Setup WordPress Blog

    1. Go to http://domain.com/wordpress/wp-admin/plugins.php and click "Activate" under the plugin name.
    Screen Shot 2014-03-01 at 3.43.28 PM.png

    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".
    Screen Shot 2014-03-01 at 3.44.37 PM.png

    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.
    Screen Shot 2014-03-01 at 3.54.58 PM.png
     
    Dadparvar and Radouane like this.
  5. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    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.
    Screen Shot 2014-03-01 at 4.00.13 PM.png

    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.
    Screen Shot 2014-03-01 at 4.06.30 PM.png

    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).
    Screen Shot 2014-03-01 at 4.15.22 PM.png
     
  6. xfrocks

    xfrocks XenForo rocks!
    Staff Member

    For other tips and tricks or questions, please refer to FAQ before asking.
     
    Dadparvar and Kaynil like this.
Loading...