www programming

w3all_wp_USERS_roles_switch( $phpbb_u_emails__wp_roles );

function w3all_wp_USERS_roles_switch( $phpbb_u_emails__wp_roles )

$phpbb_u_emails__wp_roles

$phpbb_u_emails__wp_roles = 'marco@mar.com[editor],thomas@thom.com[subscriber]';

$phpbb_u_emails__wp_roles = 'marco@mar.com[editor|administrator],thomas@thom.com[subscriber]';

$phpbb_u_emails__wp_roles = 'thomas@thom.com[subscriber|administrator|editor]';

function w3all_phpbb_USER_groupSwitch( $wpu_email_id = '', $phpbbGroupsAdd = '', $phpbbGroupDefault = '', $phpbbGroupsRemove = '' ){

     # required - $wpu_email_id - the WP user email or user id
     # required - $phpbbGroupDefault - The default phpBB user group ID which the user will be set to
     # required - $phpbbGroupAdd - phpBB Groups IDs where the user will be added (single or separated by comma phpBB Groups IDs)

     # $phpbbGroupRemove NOT USED, see below
     # $phpbbGroupRemove - phpBB Groups ids where the user will be removed from (single or separated by comma)

[size=200]2.9.0 > Functions [/size]

https://www.axew3.com/w3/2024/09/wordpress-roles-phpbb-groups-switches-functions/

[size=150][color=#BF0040]w3all_wp_USERS_roles_switch[/color][/size]
[size=120]this function works also like a little API: it can be fired using cURL with specific parameters, or can be used as internal function in WP, called into any action or filter[/size]

[code]w3all_wp_USERS_roles_switch( $phpbb_u_emails__wp_roles );[/code]

I realized after, that WordPress by default, remove the previous role and set the new. It do not allow by default to set multiple users Roles for an user.

It will be very easy to edit the function code so to fit any requirement where there are plugins that sets for the user multiple Roles, anyway by default the function that switch WP users Roles will follow WP default rules, and take only one param
[code]function w3all_wp_USERS_roles_switch( $phpbb_u_emails__wp_roles )[/code]
the
[code]$phpbb_u_emails__wp_roles[/code] explained with example, need to contain the following values, supposing it is called to change the Role for the user [b]Thomas[/b] (thomas@thom.com) to [i]subscriber[/i] and [b]Marco[/b] (marco@mar.com) to [i]editor[/i]:
[code]$phpbb_u_emails__wp_roles = 'marco@mar.com[editor],thomas@thom.com[subscriber]';[/code]

if multiple users, separated by comma, the param require:
[size=120][b]the user email followed by square brackets which must contain the name of the role to which the user must be assigned.[/b][/size]

As said, the function code is ready to set for the user/s multiple roles and could be easily done passing the param like this, supposing that instead, the function is called to add [i]marco[/i] to the editors and administrators roles:
[code]$phpbb_u_emails__wp_roles = 'marco@mar.com[editor|administrator],thomas@thom.com[subscriber]';[/code]

But actually, since the code will go to process before the role [b]editor[/b] and then [b]administrator[/b], the result will be that the user will result set as [i]Administrator[/i] because it is the second/last role processed (the previous one will be replaced by the next one).
Passing something like this so:
[code]$phpbb_u_emails__wp_roles = 'thomas@thom.com[subscriber|administrator|editor]';[/code]
the WP user with email thomas@thom.com, will be set as [b]editor[/b], the last passed param, and not to all the 3 Roles.
It is ready to be adapted and work with any other external plugin, we'll see after how to add the one and the other, multiple roles or not (or also something else) for users when it is required.


[color=#BF0040]
[size=150]w3all_phpbb_USER_groupSwitch[/size][/color]

[code]function w3all_phpbb_USER_groupSwitch( $wpu_email_id = '', $phpbbGroupsAdd = '', $phpbbGroupDefault = '', $phpbbGroupsRemove = '' ){

# required - $wpu_email_id - the WP user email or user id
# required - $phpbbGroupDefault - The default phpBB user group ID which the user will be set to
# required - $phpbbGroupAdd - phpBB Groups IDs where the user will be added (single or separated by comma phpBB Groups IDs)

# $phpbbGroupRemove NOT USED, see below
# $phpbbGroupRemove - phpBB Groups ids where the user will be removed from (single or separated by comma)[/code]

i tested that NOT removing all groups which the user belong to into the table [b]user_group[/b] (that's with no index) before to insert a new group, a duplicate record insertion occur.
It is really obscure at moment why (i noted the same into another contest, when wp_insert_user is used on 'similar loop scenario', but i do not have still reversed the thing: a specific bug into the custom WP ezSQL lib?) this happen, but anyway and by the way so:

the param [c]$phpbbGroupsRemove = ''[/c] will be ignored,
and the user, before to be added to the indicated/passed groups IDs
WILL BE REMOVED from any of the other existent old groups which the user belong to in phpBB.

This could be also easily done in different way, collecting all Groups which the user belong to, before to delete, then re-adding if the case (or removing some).
Let see this aspect before to release 2.9.0.
How would be better?
Collect then re-add old and news, if the case
OR just remove all olds Groups which the user belong to, and then adding only the news, as it is at this moment?

P.s think that as it is this in this moment maybe is the best. Because it is supposed (?) that is known, into which phpBB group/s the user need to be added to, based on actual WP roles or something else. Supposing this, the easy function will always work fine as is.

https://www.axew3.com/w3/2024/09/wordpress-roles-phpbb-groups-switches-functions/