Nothing works, where's the documentation?

[artreus]

I have setup the API correctly:

https://imgur.com/BkZxbpQ

However, I am not sure where to go from there... and sadly there is no user guide that I can find.

1. Comments
I want to replace my Wordpress comments. I have the settings below. However, my Wordpress comments are still there... and there is no sign of any Xenforo stuff.

https://imgur.com/OWMqhDd

2. User syncing
To test, I tried to sync my WP users to XF. Even though the plugin reports it green, none of the users are inserted into my Xenforo DB.

https://imgur.com/TquyvGd

3. Thread tools
I don't understand the difference between "Connect to thread" and "Reply to thread" in the WP post editor. There is no documentation on what these mean... Reply to thread is easy enough, what is connect? Where is the option to create a brand new thread? I do not see that even though I have set it up...

https://imgur.com/96HDRu5

https://imgur.com/xdWwUoK

4. What is the "usergroups" tab?

As I said, it is disappointing that there is zero user documentation and that we are meant to figure this all out by ourselves.

 

[Alex]

Hi @artreus you can find the XFtoWP documentation under the "Support" tab on the website:

XFtoWP Plugin Documentation

There is a troubleshooting guide here on common connection issues:

XenForo API Setup & Troubleshooting Guide

XFtoWP offers a simple interface to setup and manage your API connection. To start syncing data to first-time installations and create a secure API user, follow this guide. Go to: XenForo Admin >…

xftowp.com

1. Comments
I want to replace my Wordpress comments. I have the settings below. However, my Wordpress comments are still there... and there is no sign of any Xenforo stuff.

After you have configured these settings you can connect a thread from the WP post editor, where these settings will be honored on your actual comments area.

Here is an explanation of how you can connect, reply, and create a thread.

How to show XenForo forum threads as WordPress blog comments

Masterfully connect forum threads and blog posts together with XFtoWP's Thread comments tools. Create & connect threads, make post replies, and use thread replies as blog comments.

xftowp.com

3. Thread tools
I don't understand the difference between "Connect to thread" and "Reply to thread" in the WP post editor. There is no documentation on what these mean... Reply to thread is easy enough, what is connect? Where is the option to create a brand new thread? I do not see that even though I have set it up...

https://imgur.com/96HDRu5

In order to create a thread, XFtoWP has to recognize the forums you have entered into the settings in your screenshot. After you enter the forum ID(s) and save, then click the "Refresh data" button to sync that forum data to your site and you will then be able to create a thread in the destination forum. That is why the "Create thread" option is currently missing.

2. User syncing
To test, I tried to sync my WP users to XF. Even though the plugin reports it green, none of the users are inserted into my Xenforo DB.

Here it does look like something is still missing, and see if the troubleshooting guide I linked to helps you. I suggest you try to connect a user manually first. Create a test WP and XF user, then go edit the WP user and scroll to the bottom where the XenForo settings are. Enter the XF test user and see if they sync together.

 

[artreus]

Thanks @Alex

I fixed it myself, because I realised if you have setup a custom forum ID then your plugin won't recognise it.

I also discovered that none of the API will work if the forums are in maintenance mode.

Maybe update your documentation to reflect those 2 points. It would have saved me over 1 hour.

Comments and thread tools are working correctly now.

However, user syncing is sill not working at all, even with the manual method. It says "user with name/email xxx is not registered" - even though they are. It's like it can't read the forum users, even though the API permissions are valid.

Are any special settings needed in this section of the plugin?

Also, What is the "usergroups" tab?

 

[Alex]

I fixed it myself, because I realised if you have setup a custom forum ID then your plugin won't recognise it.

What do you mean by a "custom forum ID"? A forum outside the traditional Nodes settings in XenForo?

I also discovered that none of the API will work if the forums are in maintenance mode.

Admittedly, I did not know this and I apologize for the inconvenience. I have updated the Troubleshooting guide to reflect this point.

However, user syncing is sill not working at all, even with the manual method. It says "user with name/email xxx is not registered" - even though they are. It's like it can't read the forum users, even though the API permissions are valid.

Can the API user on your forum itself modify users? Say for example it were a real user and went into the Admin CP to edit a user—can they do it?

Also, What is the "usergroups" tab?

The Usergroups tab is an additional user syncing feature that allows you to add and remove usergroups on various WordPress actions. Similar to the way you enter forum IDs, enter usergroup IDs and sync them into this settings area to select them in other XFtoWP settings.

The most simple example is to add a "Premium" usergroup to a newly registered user when they purchase a product through one of the supported eCommerce plugins. This will automatically add the usergroup of your choice to their XenForo user which of course can have special permissions and access to your forum.

 

[artreus]

What do you mean by a "custom forum ID"? A forum outside the traditional Nodes settings in XenForo?

I mean the "URL portion" setting

Can the API user on your forum itself modify users? Say for example it were a real user and went into the Admin CP to edit a user—can they do it?

Do you mean that my "Super User" needs to be a moderator or admin role? Right now they are just a registered user. This person is just a registered user...

 

[Alex]

Do you mean that my "Super User" needs to be a moderator or admin role? Right now they are just a registered user. This person is just a registered user...

They may remain a registered user but must have the bare minimum Administrator capability to Edit Users and Moderators. You can selectively enable this by going to XenForo Admin > Groups & permissions > Staff > Administrators > Add Administrator and check:

 

[artreus]

Thanks @Alex I will check that out. Maybe put that in documentation too?

Also, I just tried to "create a thread" when making a new Wordpress post. It comes up with this error:




PS: Even though my site is HTTPS (and I specify HTTPS in plugin settings, I see this screen in Xenforo admin. It thinks my site is non-HTTPS for some reason... I think because I have DNS SSL via Cloudfront. I want to let you know this in case your plugin is trying to access the HTTP version or something...

They may remain a registered user but must have the bare minimum Administrator capability to Edit Users and Moderators. You can selectively enable this by going to XenForo Admin > Groups & permissions > Staff > Administrators > Add Administrator and check:

View attachment 4202

Thank you - that fixed it. Please put this in documentation. BUT, now I have new problem. Bulk export of WP user to XF works... But when I go into a user profile in Wordpress, and try to sync them with a XF user, it does not save and does nothing.

 

[Alex]

Also, I just tried to "create a thread" when making a new Wordpress post. It comes up with this error:

Try going to WP admin > XFtoWP > Save settings and try again. Specifically, check the XFtoWP > Thread connect > Create thread > Post to default forum setting to make sure it has a forum selected, then try again after saving the settings.

PS: Even though my site is HTTPS (and I specify HTTPS in plugin settings, I see this screen in Xenforo admin. It thinks my site is non-HTTPS for some reason... I think because I have DNS SSL via Cloudfront. I want to let you know this in case your plugin is trying to access the HTTP version or something...

As long as your site is HTTPS there should be no issue. The only URL the plugin will access is the one you give it in the Board URL settings.

Thank you - that fixed it. Please put this in documentation

Great! I have included this in the documentation but I can understand why it may not be so visible. I just included the screenshot to hopefully help in the future.

 

[artreus]

Try going to WP admin > XFtoWP > Save settings and try again. Specifically, check the XFtoWP > Thread connect > Create thread > Post to default forum setting to make sure it has a forum selected, then try again after saving the settings.

Thanks, it is working now!!

Great! I have included this in the documentation but I can understand why it may not be so visible. I just included the screenshot to hopefully help in the future.

Sorry, I have one last issue, I edited this post above...
BUT, now I have new problem. Bulk export of WP user to XF works... But when I go into a user profile in Wordpress, and try to sync them with a XF user, it does not save and does nothing.

 

[Alex]

BUT, now I have new problem. Bulk export of WP user to XF works... But when I go into a user profile in Wordpress, and try to sync them with a XF user, it does not save and does nothing.

What does the "XenForo" box on the Edit WP user screen look like? Do the XFtoWP > Logs show synced users accurately? The only thing you will visually see change when manually refreshing a user is the "last sync date" at the bottom of the XenForo box.

 

[artreus]

What does the "XenForo" box on the Edit WP user screen look like? Do the XFtoWP > Logs show synced users accurately? The only thing you will visually see change when manually refreshing a user is the "last sync date" at the bottom of the XenForo box.

It looks like that when I do the "Bulk Actions" one.

But, then I deleted the users it imported into Xenforo and disconnected the user in the WP profile (ie start from scratch).

Then, I go to the user WP profile and type in their forum name or email used, and click "Update Profile" OR "Sync users" and it just does nothing.

This is demo video: