XFtoWP 1.2 Beta Testing Guide and Features Tour

Are you ready to start syncing users between WordPress and XenForo? Well, you’re in luck because the first public beta of XFtoWP 1.2 is now available for download!

The star of this release is the widely requested user syncing feature which XFtoWP 1.2 beta comfortably delivers to your WordPress admin panel.

Alongside user syncing, this new release brings many helpful refinements across the entire user interface that makes XFtoWP an even more professional plugin.

In this guide I will walk you through what’s new in XFtoWP 1.2 beta, what you need to know to best test the plugin, and an ask to help me finish the rest of this version by providing your feedback!

First, let’s understand exactly what the idea of user syncing means.

What is XFtoWP User Syncing?

The first pillar to understand is that XFtoWP functions from your WordPress website, meaning it listens to actions performed on the WordPress side and changes them in XenForo, but not vice-versa.

At its core, the following critical actions can be synced once performed from WordPress to XenForo:

  • User registration
  • Change user email address
  • Change user password
  • Delete user

These are the important fundamentals necessary to create a tight integration and best create a truly unified user experience across your websites.

To keep the integrity of these details consistent across websites it is important to ensure the above actions are only performed from WordPress. That means disabling registrations and password/email updates in XenForo, which I will show you later in this article.

Let XFtoWP to be the bridge that keeps your user’s important account details in sync across websites, and with a slight change in admin and user workflows you can now easily achieve this with User syncing.

Why? We want our users to jump from our main website to our forums effortlessly, and that is the core promise of XFtoWP’s user syncing.

With the primer out of the way let’s now see what other new workflows and user management controls are available in XFtoWP 1.2 beta.

New API user capabilities and usergroups syncing

Can you believe I am starting this exciting features tour with such a nerdy term like API? Well, it’s important to know that before trying these new features that you first upgrade your API user’s permissions respectively.

As you will also see in the Site Setup section, the following API permissions are needed for all of XFtoWP’s user syncing features to be fully functional:

  • alert:write
  • auth:login-token
  • conversation:write
  • user:delete
  • user:read
  • user:write

It is also important to note that you must use a Super User API Key to:

  • Send alerts (alert:write)
  • Generate auto-login links (auth:login-token)

Also keep in mind that your API user can only perform the actions the account you assign it from the forums can do.

For example, an API user who is not an admin and does not have any user editing capabilities in XenForo cannot create new users with XFtoWP.

XFtoWP site setup options

Finally, as a best security practice it is recommended to only give your API user the permissions you require for the features you need. To best reflect this practice, XFtoWP will adapt to your current API user’s capabilities and only show you what controls you can actually use.*

*This statement does not yet fully apply to XFtoWP1.2 beta.

The keen among you will also notice the new “Usergroups” tab which allows you to add the usergroups from your XenForo site you wish to place user’s intro upon registration and account sync.

XFtoWP usergroup creation

The usergroup IDs must match the usergroup as created in XenForo, and you should only add the groups you wish to add and remove user’s from in WordPress. The group name can be labeled however you choose, and it is recommended to keep the names the same for good housekeeping.

As of writing, there is no way to automatically import user groups so this manual process has been created.

How to Enable User Syncing

The workflow of syncing user data across websites can be quite sensitive, so the major user actions listed above can be enabled or disabled individually to best match your needs from the new User Actions settings panel:

XFtoWP user action settings panel

Maybe most importantly, if you don’t require or are not yet ready for these capabilities on your website then you don’t have to turn anything on.

You can trust XFtoWP will not overstep its boundaries by performing actions you don’t need, and this interface gives you the power to configure the full range of features on an as-needed basis.

Now that we’re warmed up, let’s really see what XFtoWP 1.2 beta can do.

Create Automation Workflows with User Actions

With the incredibly powerful User Actions settings you will now save countless hours manually promoting, demoting, and messaging user’s as your WordPress website will now do the heavy lifting for you.

The screenshot above illustrates what action should be performed on user registration. In this case the user will be promoted to the Customer usergroup in XenForo and will also start a new conversation sent from the API user.

Do you see how this is starting to all come together?

In the first beta release of XFtoWP 1.2 you will be able to capture the following actions:

  • User registration
  • User email change
  • User password change

With your feedback we will be able to expand the array of actions with different eCommerce and membership plugins, so start thinking of what automation you would like to see and share them in the comments!

Examples:

  • Promote user to secondary group upon purchasing product
  • Promote user to secondary group upon completing course
  • Send user a conversation X days before license expires
  • Send user an alert when you publish a new post
  • Remove user from secondary group when license expires

As you can see, the possibilities of user actions are endless and can vastly make a difference in getting your forum user’s over to your main website.

While user actions are great for capturing actions, it is important that you have the right administration capabilities of your own and that is where we will look next in the Edit User screen in WordPress.

User Management and Sync Controls

Now when you edit any user in WordPress you will see a new XenForo Profile section which gives you an overview of the current user’s XenForo account information, and a few helpful admin actions for yourself.

As fast as a user can connect their account, you can quickly take it away with the disconnect button!

Furthermore, if account info on the XenForo side gets out of date for any reason you can use the “sync user” button to push the account information from WordPress over to XenForo.

It’s important to know if you do not enable the “Sync edit email and password” option from the User Actions panel the email and password will not change in XenForo when you sync a user.

For your convenience, you may also manually connect an existing WordPress user by entering one or more details about an existing XenForo user:

Manually connect users from XenForo to WordPress

Now, for that one more thing…

Keep Track of All Synced Data with the Connections Panel

Between XFtoWP’s famous Thread comments feature and now user syncing, it is important you are able to somehow keep track of all of the data being passed between your websites.

That’s why there was so much detail put into the new Connected data page which gives you an at a glance overview of which items are connected to what, and quick links to take you where you need to go.

See connected forum users and threads

You just have to see it to appreciate the convenience of this panel, and I plan to add more controls here in later versions of XFtoWP.

Other Notable Changes in XFtoWP 1.2

  • Access the “Edit strings” and “Connected data” settings pages from the XenForo admin menu
    Xenforo admin links
  • Fixes a bug where the Thread comments meta box stopped working when moved out of the right hand sidebar in the WordPress Blocks Editor
  • A massive rewrite of the XFtoWP Requests API was done for better code organization and far easier access to request methods

Use Syncing Tips

  • It is strongly recommended you do not allow user’s to change their email and password in XenForo if you are using XFtoWP’s user syncing. I had a small addon developed called Disable Email and Password Edit which makes this easy to implement to your community.
  • There is a setting that will automatically log users in to XenForo from the WordPress login form. Enable in User Actions > Settings and ensure the auth:login-token API permission is active across sites.

How to Save WordPress User Data to XenForo

The primary focus of this plugin is to sync information about XenForo users to WordPress, and in the event of any XenForo-first integration being introduced to the market it may be worth syncing data about each connected WordPress user into their XenForo profile now.

This step is totally optional but by setting up a few Custom User Fields in XenForo, you can save and keep current the following info:

  • WordPress user ID (wp_user_id)
  • WordPress user roles (wp_roles)
  • Account first sync date (wp_first_synced)
  • Account last sync date (wp_last_synced)

In the example below I went to XenForo Admin CP > Users > Custom user fields > Add field. Use the list above to populate the Field ID value with the exact key name in parenthesis, and the following recommendations:

  • Field type: Single-line text box
  • General options: Uncheck all boxes

Known Beta Issues

XFtoWP 1.2 beta is fairly stable, but is still possible to throw error messages, have incomplete or changing functionality, and even some embarrassing typos. Here are the currently known issues:

  • Changing user groups may perform inconsistently in some actions
  • Some features are still active even when API permissions are not set
  • Some error messages are thrown when API permissions are not set

If you find any error messages whether on your test site or in the server logs, please report them here even if they seem to be in line with the above known issues.

If you are unclear about what a feature does or it does not function as you expect, please make a note here and I will advise the next best step.

How to Test a Beta Plugin

It is important you do not use XFtoWP 1.2 beta on a live site, or even a future live site, and keep your testing limited to a throwaway WordPress and XenForo installations.

Follow these steps to setup your test environment:

  • Install a fresh copy of WordPress to a main directory*
  • Install a fresh copy of XenForo to a sub-directory*
  • Create an admin API user from XenForo with all scopes access**
  • Create 1-2 test user groups in XenForo
  • Create custom user fields (optional)
  • Install Disable Edit Email and Password addon (optional)
  • Disable registrations from XenForo (optional)
  • Allow anybody to register from WordPress admin > Settings
  • Install the XFtoWP 1.2 beta plugin to WordPress
  • Apply API key and Super User ID to Site Setup settings in XFtoWP
  • Add Usergroups info to Site Setup settings in XFtoWP
  • Save XFtoWP settings and click “Refresh forum data”
  • Enable all User Actions settings and setup a user action for “user registration”
  • Create a new user from WordPress admin > Users > Add new
  • Edit the user profile in WordPress and ensure the “XenForo profile” section is correctly filled in
  • Check to see if user was created in XenForo admin > Users
  • Check XenForo profile information to see if email and custom user fields (optional) were correctly filled in
  • Login as user on the frontend of XenForo with username/email and same password combination
  • Change user password in WordPress, and ensure you are logged out in XenForo
  • Make sure you can login again with the same username/email and new password combination
  • Delete user from WordPress and ensure it is also deleted from XenForo
  • Create new user in WordPress
  • Edit the WP user and disconnect the XenForo forum account
  • Manually connect the XenForo account back
  • Go to WP admin > XenForo > Connected data > Users and ensure the correct account information is listed
  • Log out of WP admin and go to https://domain.com/wp-login.php to register an account (use a real email address)
  • Go to your email to find the password reset email WordPress sends on every frontend registration
  • Set your password and login
  • Make sure you can also login with the same credentials in XenForo. If the auto login redirect option is set, you should be redirected to XenForo and logged into your new account after logging in from WordPress
  • Logout of the WordPress account and go back to wp-login.php
  • Reset your password and follow the instructions
  • Make sure you can also login to XenForo with your new password

*There are no restrictions to how you install these software, this is just a suggestion use case.
**Initially it is easiest to start testing with the most powerful admin account and narrow your permissions down after you have tested the full scope of XFtoWP user syncing

By completing these steps you will have thoroughly tested the major features of XFtoWP 1.2 beta. If Again, if you find any errors or unexpected behaviors in these steps or any alternative steps you take please report them!

Next Steps For XFtoWP 1.2 Beta

Currently, XFtoWP’s new features only work with the default WordPress user registration system and admin controls.

Any eCommerce and membership plugins you use to register users will have to be evaluated for support into the user syncing, which I have anticipated and will be easy to support many plugins.

Let your voice be heard and tell me about your user registration setup on your WordPress site! From there we can work out the best answer to keeping your users in sync.

Finally, XFtoWP 1.2 beta has been developed to exceed at syncing user’s individually, one at a time.

Before working out any kind of “mass import” solution for existing forum and WordPress sites, I’d like to hear about your own website’s configuration, how many user’s you have, and how you’d ideally like to get existing users into this system.

Naturally, I am using XFtoWP’s Thread comments feature to sync the discussion from the MD Forums to this article, so please keep your replies over there the best you can.

I hope you enjoy XFtoWP 1.2 beta, and with your help we can get to the full stable release quickly!

Loading new replies...

Will beta versions be made available to active subscribers? As we've discussed on Xenforo forum, I'm nearly ready to migrate from MyBB to Xenforo and the one thing I'm waiting on is the sync option that will be available soon in this plugin.

And I'll echo others here and in the thread on Xenforo that I'd prefer the Xenforo registration over Wordpress, but at the moment I'll take what I can get. :)

And while registration is done through WP, would an add-on like this for Xenforo still be usable, not for registration but for multiple account detection?

Thanks.

Reply Like

click to expand...

Thanks for posting here @thunderclap82, glad to have you here. I am aiming to have the beta version using the built-in WP register system by next week and from there I intend to gather more feedback about what other plugins people are using to register on the WP site.

And I'll echo others here and in the thread on Xenforo that I'd prefer the Xenforo registration over Wordpress, but at the moment I'll take what I can get. :)

I can understand the demand and since this is a WP plugin it will have to be handled through WordPress as you know. With eCommerce and membership platforms I personally see this being the more valuable use case but I'd love to hear the case for the alternative.

And while registration is done through WP, would an add-on like this for Xenforo still be usable, not for registration but for multiple account detection?

For the more serious use cases of user sync I would recommend disabling registration on the XenForo side and handling it solely through WordPress, where the plugin will send new account and account update information. I specifically handle duplicate account checks on the WordPress and XenForo side in the plugin so that addon may not be necessary.

Reply Like

click to expand...

Just looking for a status update on the beta. Thanks!

Reply Like

Just looking for a status update on the beta. Thanks!

So close! I am just tidying up some permission notices in the beta and will be doing a writeup and video walkthrough to help you navigate the beta features.

Reply Like

So close! I am just tidying up some permission notices in the beta and will be doing a writeup and video walkthrough to help you navigate the beta features.

Can't wait!

Here's a question while we wait for the imminent release: does syncing happen in both directions, or will all user moderation need to be handled on the WP side? More specifically, if users are pruned in Xenforo will they be pruned in WP, or will WP see they are missing and add them back?

Reply Like

The best is stable enough that I will be able to release it in a few hours and give you guys time over the weekend to play with it. There are still some very minor quirks but overall the user sync functions have come out better than I thought.

Here's a question while we wait for the imminent release: does syncing happen in both directions, or will all user moderation need to be handled on the WP side? More specifically, if users are pruned in Xenforo will they be pruned in WP, or will WP see they are missing and add them back?

Think about it like this: anything that happens on the XenForo side will require the WP side to sync it, so no actions applied from XF will automatically apply over to WP. It may require you to change a few things about how you edit users and the recommended workflow for certain actions will be (if using all of the plugin's feature to the fullest extent):

  1. Change email from WP side
  2. Change password from WP side
  3. Delete users from WP side

Anything else doesn't matter and can remain on the XF side. Even if you do end up changing these things from the XF side there is a handy sync user button that will allow you to capture those details in one click in case a user is having any trouble:

View image at the forums

The beta plugin will excel in syncing individual users manually from user self-registration, manual admin registration, and syncing existing accounts individually. The thing I want to work out with XFtoWP customers during the beta period is how we can best scale these actions to work with existing user bases and mass syncing with different configurations.

Reply Like

click to expand...

Use this thread to report any bugs, suggestions, and other discussions about XFtoWP 1.2 beta.

Read the beta announcement post and features tour for more details on how to get started.

Reply Like

I tried making a post in support but it wouldn't let me saying I'm not authorized.

I installed the WP plugin and created the Xenforo API and as far as I can tell everything is configured properly yet the API user has no API permissions and I can't link anything. Can you point me in the right direction to fix this?

Reply Like

The plugin works perfectly when creating new Wordpress users; however, I am still not able to bridge with MemberPress.

Reply Like

I tried making a post in support but it wouldn't let me saying I'm not authorized.

Those forums are for customers of the Marketers Delight theme. Use this forum to post anything related to XFtoWP.

I installed the WP plugin and created the Xenforo API and as far as I can tell everything is configured properly yet the API user has no API permissions and I can't link anything. Can you point me in the right direction to fix this?

Are you seeing any error messages? Do Thread comments still work, and can you try using the manual sync controls when you edit a user?

Reply Like

The plugin works perfectly when creating new Wordpress users; however, I am still not able to bridge with MemberPress.

That's great feedback! Currently the focus of this beta is to ensure the standard WordPress registration and login forms work. Once a couple more details are ironed out we will begin testing the big three integrations: WooCommerce, LearnDash, and MemberPress hopefully as early as a beta 3 release.

Reply Like