See what’s new in XFtoWP 1.5

The long-awaited XFtoWP 1.5 is finally open for beta testing. This major new release brings powerful new user syncing tools and the ability to perform bulk actions across both sites.

As of writing, XFtoWP 1.5 is still in beta and is not recommended for use on live sites. If you want to be a part of the beta testing phase, please create staging sites to test these new features as they can perform major database changes.

1. Introducing Bulk Actions

Sync users across XenForo and WordPress

The star of the show in XFtoWP 1.5 is the new Bulk actions panel which is your new portal to conducting mass syncing actions across your websites.

Whether starting your site from scratch, or bridging together existing sites, you can now perform the following bulk actions to get your sites in-sync from the convenience of your WordPress dashboard:

  • Import WP users to XF
  • Import XF users to WP
  • Refresh connected users
  • Disconnect users
  • …more coming soon

The job of bulk syncing can be a performance headache, especially when you are dealing with two separate site databases across a REST API!

With this in mind, the bulk actions tool has been designed to only make cross-site requests when necessary and never waste potentially expensive API requests for users that already meet the criteria of any given action.

This new tool will make managing cross-site content the easiest its ever been, and is the perfect complement to the battle-tested user syncing and thread creation tools that have been introduced to XFtoWP over the years.

2. Streamlined Admin Logging

When you are linking content together across sites it can be useful to have an at-a-glance view of which content is linked together for easy management.

XFtoWP logs syncing has been available since version 1.2, but for sites with thousands of linked content the data format of these many logs just wasn’t working well at scale.

In version 1.5 the Logs system has been migrated to the new xfwp_logs database table, which will save and access your logs data in a far more scalable and efficient way.

If you are one of those sites with thousands of connected users or threads, you will find it far easier to browse through your sync logs and can even use fancy pagination links to jump across pages:

User syncing logs with pagination.

3. Seamless User Syncing Tools

As you’ve just seen, it is no longer an impossible task to sync your users across WordPress and XenForo! Now, the next challenge is to create a seamless login experience once those users are connected.

Why login twice when you should only do it once? That’s the next biggest problem XFtoWP solves with its Login actions tools.

Based on your ideal user low, you have three helpful options to create a seamless login experience without relying on unreliable cookies and session storage:

1. Redirect and login to XenForo from WordPress

The ability to redirect and auto-login to XenForo from WordPress has been available since XFtoWP 1.2, and it is the go-to for ensuring a seamless single login every time.

Simply enable this option from XFtoWP > User syncing > Redirect to XenForo after login and users will auto-login and redirect to your forum after successfully logging in from WordPress.

2. Generate auto-login URLs

As of XFtoWP 1.5 you can create a special page that redirects to an auto-login authorization link securely generated after successfully logging into WordPress.

Clicking this link will redirect the user to your forum and auto logged-in with the synced XenForo user account, no additional login details required!

If a user is already logged-in, this link will safely just redirect to the forum index.

To create this page, go to WP admin > Pages > Add new and create an empty page with your preferred permalink. After you publish this new page, copy the page ID from the URL.

Example URL from WP admin:

Next, go to WP admin > XenForo > User sync > Settings > Forum login page ID and paste the page ID into this text field.

After, save the XFtoWP settings.

It is recommended you link to this page anywhere you would normally link to your forums URL in WordPress—even your nav menus.

Try it! Follow these steps to setup a test auto-login link:

  1. Add the new redirect page as the “Forums” URL in your menu
  2. Find a WP user who is already synced to an XF user
  3. Log out of WP and XF
  4. Login to WP and click the “Forums” URL
  5. Success – you should be redirected and logged in to your XenForo forum!

3. Sync XF passwords to WP accounts

NOTE: As of XFtoWP 1.5 beta 1, this is still experimental functionality

This is a more niche tool for those of you who import XF users into WordPress. Due to different security practices and password encryption methods there is no easy way to ensure the same password can be imported to a new WP account.

That means that after importing XF users into WP using the bulk actions tool, users won’t be able to immediately login to your WordPress site with the same credentials they first registered with on your XenForo site.

…unless you enable this option from XFtoWP > User syncing > Settings > Login actions.

Once enabled, XFtoWP will perform a check from the WP login page to see if the entered username/email + password combination works on an XF account and then quickly updates the linked WP account to use the same password.

It’s a fully seamless process and your users will never know the difference. Again, this option is only recommended for site owners who primarily used XenForo for their main database and just imported users into WordPress.

4. Introducing the Register XF to WP companion addon

Depending on the needs of your site setup, you may still want to accept user registrations from XenForo.

As a bonus to the XFtoWP 1.5 release you can now download a new companion addon that ensures all users who register to XenForo will also be registered to WordPress.

Download this free XenForo addon here.

Paired with XFtoWP 1.5, all users who register from XenForo will be synced to your WordPress website automatically. This includes syncing custom user fields and filling out the XenForo profile options in WordPress, like so:

Sync users from XenForo to WordPress.

Try out XFtoWP 1.5 today

As of writing, XFtoWP 1.5 is still in beta. This release could have been marked as 2.0 due to the amount of changes and substantial new features added, but we are going to stay humble and pay homage to the legendary XenForo 1.5 series (RIP).

You should know that XFtoWP 1.5 beta is fairly stable, but will still receive minor development to smooth out all the details of this large release.

Due to the nature of the large scale database changes this plugin is capable of it is strongly recommended you test XFtoWP 1.5 beta on staging sites.

This isn’t one of those “wink wink” moments, you really shouldn’t risk a live site with this beta version. If you do, ensure you have a full backup of your websites, especially WordPress.

How to upgrade to XFtoWP 1.5

If your test site was already running an earlier release of XFtoWP the only thing you need to do is migrate your old logs data to the new format. This is important as you won’t be able to use any functionality without the proper logs in place.

Luckily this requires little effort on your part. Simply navigate to the new Bulk actions tab in your XFtoWP settings and the only actions available to you will be the user and thread logs migrate actions (if necessary).

Yes, the bulk actions tool is using itself to upgrade itself. Neat.

Upgrade logs data

You only need to perform these migrations once based on which connected data you have. After the logs migration is complete the plugin will be fully operational and you can use any bulk action as needed.

XFtoWP 1.5 Release Candidate 2

XFtoWP 1.5 is nearly ready to be marked stable. Download RC1 now from your account area.