Skip to main content

Advanced WordPress Plugin Settings

There are some advanced settings that allow for greater control of some functionality, however these should be used with caution. Please do not change these settings other than for reasons explained below.

Always Use Defaults

This setting will remove the meta box on the post compose page, and will use the default values for all threads.

Thread ID meta key

If you have a pre-existing XenForo thread integration that has stored thread IDs in the postmeta table using a key other than “xf_thread_id”, you can enter the key here. This will allow Article and Forum Connect to use the existing linked thread data to save you having to re-link threads or rename the postmeta key value.

If you are using the Session Cookies integration method, and your XenForo forum has a customised cookie prefix instead of the default “xf_”, you can enter the prefix here. This will be required for the cookies to be read.

Audentio API Session Auth Client Key

When using the Session Cookies integration method, the session cookie is used to find the currently logged in user, but a Super-user API key is used to authenticate the actual API requests. If you have the Audentio API addon installed, you will be able to authenticate API requests using the session cookie directly on behalf of each user.

To set this up, create a Session Client at ACP > Setup > [Audentio] API > Authentication > Session authentication, and add an API key with the following scopes: thread:read, thread:write. Then, back on the WordPress plugin settings page, enter the API key into the “Audentio API Session Auth Client Key” setting.

You can then also use more restrictive XenForo API keys.

In the XenForo ACP, go to Setup > API Keys > Add API key. Enter a title, select “Guest key” as the type, and select the following scopes: node:read, thread:read. Make sure the API key is set to active, and then save.

Go back to Settings > Article and Forum Connect: XenForo and WP in WordPress, and enter the API you just created in XenForo to the “XenForo API key” field.

You will also need to create API keys for each user you wish to create threads as.

For each user, in the XenForo ACP, go to Setup > API Keys > Add API key. Enter a title, select “User key” as the type, search for the user to create the API key for, and select the following scopes: thread:write. Make sure the API key is set to active, and then save.

In WordPress, go to Users, find the user, and enter the API key into the XF API key field. This will then be used to create threads on behalf of the XF user the API key is linked to.