vb.org Archive - Create checkbox group at your hack's options (usergroup selection for example)

vb.org Archive (https://vborg.vbsupport.ru/index.php)

- vBulletin 3 Articles (https://vborg.vbsupport.ru/forumdisplay.php?f=187)

- - Create checkbox group at your hack's options (usergroup selection for example) (https://vborg.vbsupport.ru/showthread.php?t=187470)

Create checkbox group at your hack's options (usergroup selection for example)

Hello.

In this article I will show how to create a checkbox group in your hack's options. It's easy. Just do the following:

1. Create an option. Datatype validation type = free.

2. Enter the following code to Option code:

Code:

" . eval('$options=""; 

$fritems = array(

        "Test1Code" => "Test option checkbox",

        "Test2Code" => "Another test option checkbox",

);

foreach($fritems AS $fritem_id => $fritem_name)

{

        $options .= "\\t\\t<label for=\\"setting[$setting[varname]]$fritem_id\\" title=\\"item id: $fritem_id\\"><input type=\\"checkbox\\" tabindex=\\"1\\" name=\\"setting[$setting[varname]]"."[]\\" id=\\"setting[$setting[varname]][$fritem_id]\\" value=\\"$fritem_id\\"" . iif(strpos(",$setting[value],", ",$fritem_id,") !== false, \' checked="checked"\') . iif($vbulletin->debug, " title=\\"name=&quot;setting[$setting[varname]]&quot;\\"") . " />$fritem_name</label><br />\\n";

}

return "<span class=\\"smallfont\\">\\n$options\\t</span>";') . "<input type=\"hidden\" name=\"setting[$setting[varname]][]\" value=\"-1\" />

3. Save option. Now you will see your group of checkboxes. You can add more items to $fritems array. Array key will be the code of the option. Array value is the text to display near checkbox. Please note: all strings added to $fritems array should be double-quoted (because all there is inside single-quoted eval function) or, if you need single-quotes, escape them.

4. Now create a admin_options_processing hook with the following code:

PHP Code:


		
			
if (is_array($settings['my_setting_name']))

{

    $settings['my_setting_name'] = implode(',', $settings['my_setting_name']);

}

5. That's all. Now $vbulletin->settings['my_setting_name'] will be a string like "Test1Code,Test1Code" depending on what user checked at options page.

A little moment on option text localization. Instead of

PHP Code:


		
			
$fritems = array(

    "Test1Code" => "Test option checkbox",

    "Test2Code" => "Another test option checkbox",

);

you can write

PHP Code:


		
			
$fritems = array(

    "Test1Code" => $settingphrase["my_setting_phrase_name1"],

    "Test2Code" => $settingphrase["my_setting_phrase_name2"]

);

Just create phrases at VBulletin settings group with names my_setting_phrase_name1 and my_setting_phrase_name1:

Code:

<phrasetype name="vBulletin Settings" fieldname="vbsettings">

        <phrase name="my_setting_phrase_name1" date="1218041520" username="FractalizeR" version=""><![CDATA[Test option checkbox]]></phrase>

        <phrase name="my_setting_phrase_name2" date="1218040714" username="FractalizeR" version=""><![CDATA[Another test option checkbox]]></phrase>

</phrasetype>

Now a small example on how to list all usergroups and allow user to check some usergroups (take this text to Option code):

Code:

" . eval('$options =""; 

foreach($vbulletin->usergroupcache AS $usergroupid => $usergroup)

{

        $options .= "\\t\\t<label for=\\"setting[$setting[varname]]$usergroupid\\" title=\\"usergroupid: $usergroupid\\"><input type=\\"checkbox\\" tabindex=\\"1\\" name=\\"setting[$setting[varname]]"."[]\\" id=\\"setting[$setting[varname]]$usergroupid\\" value=\\"$usergroupid\\"" . iif(strpos(",$setting[value],", ",$usergroupid,") !== false, \' checked="checked"\') . iif($vbulletin->debug, " title=\\"name=&quot;setting[$setting[varname]]&quot;\\"") . " />$usergroup[title]</label><br />\\n";

}

return "<span class=\\"smallfont\\">\\n$options\\t</span>";') . "<input type=\"hidden\" name=\"setting[$setting[varname]][]\" value=\"-1\" />

All comments are welcome!

Just what i been looking for, shame I havent got a clue..lol..:(

cool tut tho' :)

Can you provide a screenshot of how this would look?

/bookmarked

this is handy to have!

Fractalizer, very nice! I am wondering however why you don't just loop through each usergroup and call vbulletin's print_checkbox_row() function to handle the checkbox creation. It's located within adminfunctions.php :)

Quote:

Originally Posted by Antivirus (Post 1605225)

I am not sure :) May be because this method was extracted from one hack a long time ago. And after some time I extended it a bit and decided to publish a how-to.

Thanks for this tutorial.

in step 4 i.e.

PHP Code:


		
			
if (is_array($settings['my_setting_name']))
{
    $settings['my_setting_name'] = implode(',', $settings['my_setting_name']);
}

What to write in place of "my_setting_name"and how to check which options are checked from within php page.

I also wanted to know how to use this option code
bitfield:nocache|allowedbbcodesfull

This bitfield type code automatically generates a set of check boxes of allowed bbcodes to choose from. Now how to implement onto our page.

Thank you

my_setting_name is the setting name you provided when creating setting. As for bitfield - I am not sure it is supported. Where is this example from?

thanks for your reply !

alright so $settings['my_setting_name'] is the field setting name, fine.

1. And in the option code I see "setting[$setting[varname]", does varname needs to be replaced by something ?

2. How do I check for the checked options from the php page ? Like for boolean we do :-

PHP Code:


		
			
if($vbulletin->options['mysetting_enable']

{

        enabled = true;

}

else

{

        enabled = false;

}

How to achieve similar for checkbox ?

3. umm.. not sure what you mean by bitfield supported. See in admincp->Social Group Options and Album Options and Visitor Message options. They all have a setting of "Allowed BBCODES", their option code is set to bitfield:nocache|allowedbbcodesfull and it automatically outputs a set of checkboxes of bbcodes.
I did the same and it works but as in my 2nd ques, how do I check it ?

Thank you

Quote:

Originally Posted by veenuisthebest (Post 1629125)

1. And in the option code I see "setting[$setting[varname]", does varname needs to be replaced by something ?

No, leave it as is. This is for VBulletin Debug mode.

Quote:

Originally Posted by veenuisthebest (Post 1629125)

2. How do I check for the checked options from the php page ? Like for boolean we do :-

PHP Code:


		
			
if($vbulletin->options['mysetting_enable']

{

        enabled = true;

}

else

{

        enabled = false;

}

How to achieve similar for checkbox ?

Your $vbulletin->options['my_setting_name'] will contain comma delimited list of checked options. explode it and use.

Quote:

Originally Posted by veenuisthebest (Post 1629125)

3. umm.. not sure what you mean by bitfield supported. See in admincp->Social Group Options and Album Options and Visitor Message options. They all have a setting of "Allowed BBCODES", their option code is set to bitfield:nocache|allowedbbcodesfull and it automatically outputs a set of checkboxes of bbcodes.
I did the same and it works but as in my 2nd ques, how do I check it ?

Thank you

This is VBulletin internal feature I never used.

Thanks for your replies.

Can you please tell me what to do after creating the plugin at admin_options_processing hook.

Is this correct ?

PHP Code:


		
			
if(explode(',', $vbulletin->options['show_settings']))

{

        $showchecked = true;

}

else

{

        $showchecked = false;

}

What I want to achieve is quite simple but i am not able to figure it out.

See.. I am showing 3 radio buttons via template. Simple !

Now.. I have created 3 checkboxes (corresponding to radio buttons) so that whichever is checked THAT radio button would show. How do I achieve this ? What should I wrap around my radio button code in template so that the corresponding one shows only when it is allowed (checked in admincp).

Thank you

PHP Code:


		
			
$radioboxesToShow = explode(',', $vbulletin->options['my_radioboxes_to_show']);
if(isset($radioboxesToShow['radio_1'])) {
   $show['radio_1'] = true;
}

Something like this I think. Emded all your radios in templates surrounded by if condition="show[radio_1]"

oh i still can't get it to work. See this is all what I had done:-

1. I created a setting $vbulletin->options['vin_mysetting'], Free datatype, with the following option code:-

Code:

" . eval('$options=""; 

$fritems = array(

        "option1" => "First Radio",

        "option2" => "Second Radio",

        "option3" => "Third Radio",

);

foreach($fritems AS $fritem_id => $fritem_name)

{

        $options .= "\\t\\t<label for=\\"setting[$setting[varname]]$fritem_id\\" title=\\"item id: $fritem_id\\"><input type=\\"checkbox\\" tabindex=\\"1\\" name=\\"setting[$setting[varname]]"."[]\\" id=\\"setting[$setting[varname]][$fritem_id]\\" value=\\"$fritem_id\\"" . iif(strpos(",$setting[value],", ",$fritem_id,") !== false, \' checked="checked"\') . iif($vbulletin->debug, " title=\\"name=&quot;setting[$setting[varname]]&quot;\\"") . " />$fritem_name</label><br />\\n";

}

return "<span class=\\"smallfont\\">\\n$options\\t</span>";') . "<input type=\"hidden\" name=\"setting[$setting[varname]][]\" value=\"-1\" />

2. Then I created a hook at admin_options_processing with the following code:-

PHP Code:


		
			
if (is_array($settings['vin_mysetting']))

{

    $settings['vin_mysetting'] = implode(',', $settings['vin_mysetting']);

}

3. Then in my file.php I did this (taking just "option1" for now.) :-

PHP Code:


		
			
$radioboxesToShow = explode(',', $vbulletin->options['vin_mysetting']);

if(isset($radioboxesToShow['option1'])) {

   $show['option1'] = true;

}

4. Then at atlast, in the associated template, I did this:-

HTML Code:

<if condition="$show['option1']">

        <input type="radio" name="radiotype" value="0"/>My First Radio<br />

</if>

It never shows up now, whether checked or unchecked !

Thank you

Thanks for the info, Ive been in need of this type of info... now I just need to figure out how to create options in the UserGroup and User settings

X vBulletin 3.8.12 by vBS Debug Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (4)bbcode_code_printable (1)bbcode_html_printable (10)bbcode_php_printable (4)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)post_thanks_navbar_search (1)printthread (15)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages:

Phrase Groups Available:

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.01488 seconds Memory Usage 1,806KB Queries Executed 10 (?)
More Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (4)bbcode_code_printable (1)bbcode_html_printable (10)bbcode_php_printable (4)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)post_thanks_navbar_search (1)printthread (15)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: