AUTOJOIN - Auto-entry in membergroup via field in profile

Here's a little something to give back to this community that has been of such help to me.

With this plugin, you can have a user entered into or removed from a secondary usergroup according to several types of controls that can be placed in the user's profile via custom fields. This acts only on SECONDARY usergroups and will not affect the user's PRIMARY usergroup.

At each login, the plugin will check for the appropriate setting in the user's profile, then add or remove the user from the specified membergroup as appropriate. Note that this does not act instantaneously upon entry of the data in the profile, but requires a new login for this to take effect. [Starting with vB 3.6.4 (maybe earlier, I didn't install anything between 3.5.4 and 3.6.4) this will take effect with one or two page reloads.]

Controls currently available:

1) Password for single usergroup
2) Yes/No choice for single usergroup via radio button
3) Choose one of several usergroups via radio buttons
4) Choose any of several usergroups via multiple checkboxes

Note that you may write your own additional controls and use the two included functions to do the actual insertion into, and removal from, the target usergroups.

Tested with vB 3.5.4, 3.6.4, 3.6.7-PL1, 3.8.7PL3 only.

Full instructions are in the downloadable text file autojoin.txt.

Update log:

• 1.00 - Initial release
• 1.01 - Sorts output membergroups numerically plus a few other small changes
• 1.02 - Rewritten using defined functions for adding to, and removing from, memberbgroups. This should make it easier to follow the logic and to adapt the code for other situations (e.g.checkboxes or radio buttons instead of text profile fields)
• 1.03 - InGroup() and OutGroup() functions rewritten to make them more useful when dealing with other situations than the somewhat restricted application of entry/exit of specific membergroup via stored password.
• 1.03.1 - Additional tweaking of InGroup() and OutGroup() functions. Tested extensively and seem to be working as intended. Tested examples of using via radio buttons instead of text field added.
• 1.04 - Added protection against doing anything re user's current PRIMARY usergroup in secondary usergroup list. Functions renamed to IntoGroup() and OutOfGroup().
• 19 April 2006 - all code moved from this thread into the downloadable text file.
• 1.05 - Added control for using multiple checkboxes to choose any of several usergroups.
• 22 May 2007 - tested with vB 3.6.7-PL1
• 24 Sep 2012 - tested with vB 3.8.7-PL3

[makaiguy]

Amazing. It worked right out of the box with no debugging at all. Must have held my mouth just right while coding, or something. Anyhow, here's what to use as the control in place of the ones in the downloadable autojoin.txt file:

PHP Code:

// Add or remove user from secondary usergroup
// according checkboxes selected in user's profile
// Ver 1.4

global $vbulletin;

// Enter values in the strings below for your forum
  // number of the custom field containing your checkboxes
        $boxes_field = 'fieldX';
  // Usergroup number for FIRST checkbox option
        $ug[0] = 'X';                     
  // Usergroup number for SECOND checkbox option 
        $ug[1] = 'Y';                     
  // add additional checkbox options as needed 

// You need make no changes below here
                         
// Derive additional needed variables
  // userid of user
        $userid = ($vbulletin->userinfo['userid']);                           
  // current usergroups as array
        $ugarr = explode(',' , (''.$vbulletin->userinfo['membergroupids']));  
  // boxes selected
        if ($vbulletin->userinfo[$boxes_field] == '')
        {
           $fieldval = 0;
        }   
        else
        {
           $fieldval = $vbulletin->userinfo[$boxes_field];
        } 

// Do the work
$iii = 0;
foreach ($ug as $value) 
{
   if ($fieldval & pow(2, $iii))
   {
      $ugarr = IntoGroup($ugarr, $ug[$iii], $userid);
   } 
   else
   {
      $ugarr = OutOfGroup($ugarr, $ug[$iii], $userid);      
   } 
   $iii++; 
} 


.. then just add in the code for the two functions as in the downloaded autojoin.txt file.

I'll get this added to the autojoin.txt file real soon now ...

[Edit:] Has now been added to the downloadable autojoin.txt file, as version 1.05.

[cavyspirit]

I really need this in 3.6. First attempt isn't working.

[makaiguy]

Originally Posted by cavyspirit

I really need this in 3.6. First attempt isn't working.

I haven't updated my board to 3.6 yet. But since this hack is very important to my board's operation, you can be sure I'll be updating it to work with 3.6 in the near future.

[cavyspirit]

I now need to make this work on the regular Birthday field.

I want one secondary user group assigned if the member is under 16 and another secondary user group assigned if the member is under 21. Is this possible? Can someone suggest the code change?

Thanks

[RFViet]

Originally Posted by The Chief

screen shots?

The same question !!

[makaiguy]

Originally Posted by RFViet

The same question !!

The same answer: There are no screen shots because nothing is displayed onscreen. It just sets the user's secondary usergroups when he logs on, according to whatever you have set up.

[Cocko]

any product scripts .xml out for 3.6x ?

[makaiguy]

I've finally started playing with getting my board updated to 3.6 (3.6.4, actually).

AutoJoin has continued to work for me without modification to the original 3.5.4 installation.

[salata]

can you have them not enter the password at every login in? basically have them choose what usergroup they belong to at registration, I.E. if i had separate sections for men and women

[makaiguy]

Originally Posted by salata

can you have them not enter the password at every login in? basically have them choose what usergroup they belong to at registration, I.E. if i had separate sections for men and women

The idea of this addon is that you create a special field in their profile. They enter the required value in this field in the profile one time, and on every subsequent login it checks for the required value in that profile field, and puts them into or out of the specified secondary user group.

[Edited to add] Code is provided to do this via several different formats for the custom profile field. You may do it as:

1. Password for single usergroup (alternative to password-protected forum where user must enter password for every session - this way they only enter into their profile one time. Set your forum persmissions to only admit members of the specified usergroup.)
2. Yes/No choice for single usergroup via radio button
3. Choose one of several usergroups via radio buttons
4. Choose any of several usergroups via multiple checkboxes