axew3.com

WordPress phpBB integration

Fast, easy, light and secure

Install and how to

If you let users to login register and change email only into WordPress (or phpBB, if you do not care about updates at same time into WP when an user for example change the email in phpBB) there is no need to install the phpBB extension.

NOTE: IT IS REQUIRED Php version 7.2 or better

NOTE: be sure that for the WP admin user that’s activating the plugin, there is an user with same email in phpBB (if the user is not the WP user ID 1).

NOTE: the WP user ID 1 and the phpBB user ID 2 (if they are existent) are excluded: they are not affected by the integration code.

WordPress phpBB integration by email.

This plugin use cookies, and do not change nothing into phpBB or WordPress files or db: it only update user’s sessions, the email, password (and eventually the user URL), and add users into the linked CMS when they register. Require 6/7 db rows on the WP db options table to work (search with a regexp sql the option_name text w3all into the options table to see).

It is MANDATORY that users can change email/password and register, only into WordPress OR phpBB, if the phpBB extension is not installed into phpBB. It is possible to let users to update their email and register on both WP and phpBB, only if the phpBB WordPress extension has been installed into phpBB. It is maybe recommended to install the phpBB WordPress extension even if you let the users to register and update email only in phpBB, because if not, when users will register or update their profile in phpBB, the same will not happen at same time in WordPress, until the same user will not login or will visit the WordPress side as logged. Remember! This is a WordPress plugin that only run when WordPress pages loads!

See how to use and download the phpBB integration extension here: phpBB WordPress common tasks integration extension

Note that it is maybe required to transfer all old existent WordPress users into phpBB using the WP to phpBB transfer process before to start the integration. Follow the required steps to be up and running in short, or existent old WP users will be added into phpBB (if a same email/username do not exists into phpBB) when they will login into WordPress.

If you do not go to pair usernames/emails, remember that the ‘plugin login’ or the ‘profile update’, works by email, so an user with email me@you.us that login in WP, will be logged in phpBB like the user that own the same email. The same goes at contrary: a phpBB logged in user will be logged in WP as the user with the same email. If there are more users sharing same email in phpBB, then all those users will have the email updated to the new one when the WP user that own the same old email will go to update with a new one. If there are users sharing same email in phpBB, and the WP user with same email will login in WP and then will visit phpBB, will result to be logged in phpBB as the first user ID found by the SQL query that match the email. So that to login as others phpBB users that are sharing the same email, these users will have to login in phpBB or will never been logged through a WordPress login. To share same email between users is possible feature in phpBB, but never in WordPress.

It is also time to inform all the lovely and cool people about how bad is my English … i am sorry!

Setup phpBB as follow, then setup the db connection values into the plugin admin page, then maybe transfer WP users and fix issues if there are. You can setup the integration as NOT LINKED activating the related option until tasks have not been completed.

Configure WordPress and phpBB

WP MU-MS (Network installations) integration: before to follow, read how to activate this feature and how WP_w3all plugin is required to be configured on each sub-site: WP_w3all for WordPress MS MU (Network installations).

phpBB side settings

Limit username chars:

on ACP under
BOARD CONFIGURATION -> User registration settings -> Limit username chars:
choose Any letter, Number and Spacers, or Alphanumeric option.

So if you let users to register in phpBB, you’ll be sure they are added in WordPress with the same username or an existent phpBB username containing unwanted chars in WP, where possible, will be added into WordPress purged of these chars, or excluded if the resulting purged username will result to be empty.

Save settings.

Then into phpBB ACP under option Security settings:
Option:

Allow “Remember Me” logins set to: YES

“Remember Me” login key expiration length (in days):

may set it to 365 days (or another value)

Validate browser:
Enables browser validation for each session improving security: Set to YES

Save settings.

phpBB cookie SETTING

Set the phpBB cookies to be available all over the domain if it is not already:

Go under phpBB ACP admin -> Server Configuration -> Cookie Settings

Set the Cookie domain value as (for example):
.yourdomain.com

NOTE: if on localhost, may leave the value as is, localhost or empty value. If on subdomain, like mysub.mysite.com, set it using only the domain name so .mysite.com

now change the cookie name in something else or adding some char to it, so old cookies on user’s browsers will not be valid anymore and they will be forced to re-login.

Cookie path set as single fraction slash: /

Be sure to set correct values.

Save settings, logout, and log back into phpBB.

Based on how you are integrating WP and phpBB, and if using or not the integration extension installed into phpBB, you’ll have to choose to disable the registration in phpBB or WordPress and choose where user’s can update email/register.

Note: to disable the Edit account settings module in phpBB on
ACP -> System Tab -> Module management -> User Control panel
disable the Edit account settings module (where an user can change the email and update password in phpBB ucp).