Custom Administrator Permissions - Page 7

		vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 3 Articles
Custom Administrator Permissions

Page 7 of 7

« First

Thread Tools

Custom Administrator Permissions

Andreas

Join Date: Jan 2004

Posts: 6,863

Germany

Andreas

09-08-2005, 10:00 PM

Your Hack has an Admin Backend?
Then you should consider protecting it with custom Admin Permissions - not every Admin has to be able to control everything.

First of all, you have to decide on a uniqe Key for your Admin Permission, just like your Product ID.
In this example I will use canadminmyhack.

Go to your ACP File(s) and place the following Code below the Back-End requirement:

PHP Code:


			
// ######################## CHECK ADMIN PERMISSIONS #######################

if (!can_administer('canadminmyhack'))

{

    print_cp_no_permission();

}

In your ACP Navigation XML Files, add the Parameter permissions to your Navgroup:

Code:

<?xml version="1.0" encoding="ISO-8859-1"?>
<navgroups product="myhack">
	<navgroup phrase="myhack_settings" hr="true" permissions="canadminmyhack">
		<navoption>
			<phrase>demohack_foo</phrase>
			<link>demohack.php?do=foo</link>
		</navoption>
		<navoption>
			<phrase>demohack_modcp</phrase>
			<link>../{$vbulletin->config[Misc][modcpdir]}/foobar.php</link>
		</navoption>
	</navgroup>
</navgroups>

In order to display Text in the Admin Permissions Editor, you must create a Phrase in Phrasegroup Permissions:

Code:

Varname: can_administer_myhack
Text: Can Administer Myhack

Make sure that it is attached to your Product and inserted into GLOBAL Language!

As the Permissions Editor only takes care of standard Permissions, you must create 4 Plugins:

admin_permissions_form

PHP Code:


			
print_yes_no_row($vbphrase['can_administer_myhack'], 'customadminperms[canadminmyhack]', ($user['customadminperms'] & $vbulletin->bf_misc_customadminperms['canadminmyhack']));

customadminperms[canadminmyhack] must the Name of the Bit(field) you want to use, $vbulletin->bf_misc_customadminperms['canadminmyhack'] the Value of the Bit

You must also create a Plugin for the Administrator Datamanager
admindata_start

PHP Code:


			
$this->validfields['customadminperms'] = array(TYPE_UINT, REQ_NO);

$this->bitfields['customadminperms'] = $this->registry->bf_misc_customadminperms;

Now we need a Plugin to save our Permission setting after editing it:

admin_permissions_process

PHP Code:


			
$vbulletin->input->clean_gpc('p', 'customadminperms', TYPE_ARRAY_INT);

$admindm->set_bitfield('customadminperms', 'canadminmyhack', $vbulletin->GPC['customadminperms']['canadminmyhack']);

Now, finally, we need a Plugin to actually check this Permission

can_administer

PHP Code:


			
foreach($do AS $field)

{

    if ($admin['customadminperms']  & $vbulletin->bf_misc_customadminperms["$field"])

    {

        $return_value = true;

        return;

    }

}

Here again, $vbulletin->bf_misc_customadminperms['canadminmyhack'] must be the Value of your Bit.

As you can see, I used customadminperms as the Bitfield.
This is the Bitfield I will use for my Hacks, Bit 1 is already in use.
If others want to use it too (to avoid having to create there own (Bit)fields) - feel free to do so.
But please, first post here and state which Bit you are going to use and wait for an Okay so there won't be conflicts.

To use it, create an appropriate Bitfield XML File.

The following Install Code should be used then:

PHP Code:


			
require_once(DIR . '/includes/class_dbalter.php');

$dbalter = new vB_Database_Alter_MySQL($db);

$dbalter->fetch_table_info('administrator');

if (!$dbalter->fetch_field_info('customadminperms'))

{

    $dbalter->add_field(array('name' => 'customadminperms', 'type' => 'INT', 'length' => '10', 'attributes' => 'UNSIGNED', 'null' => false, 'default' => '0'));

    }

}

And this Uninstall-Code

PHP Code:


			
unset($vbulletin->bf_misc_customadminperms['canadminmyhack']);

if (empty($vbulletin->bf_misc_customadminperms))

{

    require_once(DIR . '/includes/class_dbalter.php');

    $dbalter = new vB_Database_Alter_MySQL($db);

    // Using 3.5.1+ calls

    $dbalter->fetch_table_info('administrator');

    if ($dbalter->fetch_field_info('customadminperms'))

    {

        $dbalter->drop_field('customadminperms');

    }

}

Bitfield Usage customadminperms (this will be updated if other Authors use it too)
1 - KirbyDE

#62

11-14-2016, 10:12 AM

X-or

Join Date: Nov 2005

Posts: 201

Благодарил(а): 0 раз(а)

Поблагодарили: 0 раз(а) в 0 сообщениях

Thanks for this guide although it is a bit rough for someone who isn't used to the vbulletin framework. Can someone elaborate on the rough parts near the end such as the bitfield xml file and install code? Thank you.

Page 7 of 7

« First

« Previous Thread | Next Thread »

Thread Tools
Show Printable Version Email this Page

Posting Rules
You may not post new threads You may not post replies You may not post attachments You may not edit your posts BB code is On Smilies are On [IMG] code is On HTML code is Off Forum Rules

Forum Jump

All times are GMT. The time now is 08:16 AM.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.03469 seconds Memory Usage 2,221KB Queries Executed 18 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (2)bbcode_code (7)bbcode_php (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_article (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (2)pagenav_pagelink (2)post_thanks_box (2)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (2)post_thanks_postbit_info (1)postbit (2)postbit_onlinestatus (2)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.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/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_postinfo_query fetch_postinfo fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!