Create pages for the AdminCP

[Dream]

I was going to spend some time researching this, so I figured I could help some people save time by writing it down.

This is not a full tutorial, more of a kick-off, and its aimed at developers.


How to add a link to the AdminCP left side navigation:

Please refer to KirbyDE's [How to] Add entries to AdminCP Navigation Menu (in 3.5) (https://vborg.vbsupport.ru/showthread.php?t=82698) thread.


Basic AdminCP page code:

<?php
// ######################## SET PHP ENVIRONMENT ###########################
error_reporting(E_ALL & ~E_NOTICE);
@set_time_limit(0);

// #################### PRE-CACHE TEMPLATES AND DATA ######################
$phrasegroups = array('style');
$specialtemplates = array('products');

// ########################## REQUIRE BACK-END ############################
require_once('./global.php');
require_once(DIR . '/includes/adminfunctions_template.php');

print_cp_header();









print_cp_footer();
?>


This is the basic code. Its already password protected, so if you create a myscript.php with that code and upload to the "admincp" folder, you can call it from a browser and it will ask for the admin password.

You can use "ignore_user_abort(true);" as described in this post (https://vborg.vbsupport.ru/showpost.php?p=667189&postcount=4).

You can use can_administer() to check for admin permissions, 'canadminstyles' in this case:

// ######################## CHECK ADMIN PERMISSIONS #######################
if (!can_administer('canadminstyles'))
{
print_cp_no_permission();
}

(gonna add the permissions list here)

(to-do: describe print_cp_header() optional parameters title, onload, headinsert, marginwidth and bodyattributes defined in adminfunctions.php)

You can put anything you like inside the html page. vBulletin has a good number of standard functions that builds the html code for you. These functions can be found in "admincp/adminfunctions.php" (thanks Zero Tolerance for pointing it out). Im going to describe them in this how-to as time lets me.



Creating a message box with a "go back" link: example image (https://vborg.vbsupport.ru/attachment.php?attachmentid=27194)

print_cp_message('This is a control panel message box.');

Creating a redirection message: example image (https://vborg.vbsupport.ru/attachment.php?attachmentid=27195)

In this example the page will be redirected to Google in 10 seconds.
print_cp_message('This is a control panel message box.', 'http://google.com',
10);




Creating a table: example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27302)

The standard table has 2 columns.

print_table_start();
print_table_header("Table Title");

echo '<tr><td class="alt1" colspan="2">table content</td></tr>';

print_table_footer(2, '', '', 0);

An empty "print_table_footer" adds a "</form>" after closing the table.


Function "print_table_footer" parameters (from adminfunctions.php)

Prints a closing table tag and closes the form tag if it is open

* colspan integer Column span of the optional table row to be printed
* rowhtml string If specified, creates an additional table row with this code as its contents
* tooltip string Tooltip for optional table row
* echoform boolean Whether or not to close the <form> tag

function print_table_footer( colspan, rowhtml, tooltip, echoform )




Creating a form:

vBulletin has standard functions to build forms. You call "print_form_header()", which opens the form and table tags, call a few functions to build the form inputs, and then close the form with a submit button row.

An empty form example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27301)

print_form_header('myscript');
print_table_header('Empty Form');

# table rows

print_submit_row("Submit!");

Function "print_form_header" parameters (from adminfunctions.php)

Prints the standard form header, setting target script and action to perform

* phpscript string PHP script to which the form will submit (ommit file suffix)
* do string 'do' action for target script
* uploadform boolean Whether or not to include an encoding type for the form (for file uploads)
* addtable boolean Whether or not to add a <table> to give the form structure
* name string Name for the form - <form name="$name" ... >
* width string Width for the <table> - default = '90%'
* target string Value for 'target' attribute of form
* echobr boolean Whether or not to place a <br /> before the opening form tag
* method string Form method (GET / POST)

function print_form_header( phpscript, do, uploadform, addtable, name, width, target, echobr, method )




Input functions for a table:

Here I'll use common examples, but each function has a set of parameters that should be read in "admincp/adminfunctions.php" if you are going to use them.

Text input example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27142)

print_input_row('Type your name', 'inputname');

Text area example (http://attachment.php?attachmentid=27190)

print_textarea_row('This is a textarea row', 'inputname');

Yes / No radios example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27144)

print_yes_no_row('Should I finish this how-to', 'radioname');

Yes / No / other radios example (http://attachment.php?attachmentid=27275)

print_yes_no_other_row('What you think', 'inputname', 'maybe');

"Yes" radio example (http://attachment.php?attachmentid=27276)

print_yes_row('Want it', 'inputname', 'nah', 0);

Multiple radios example (http://attachment.php?attachmentid=27273)

print_radio_row('This is a radio row', 'inputname', array( 'ya' => 'ya',
'nah' => 'nah' ));

Select example (http://attachment.php?attachmentid=27189)

print_select_row('This is a select row', 'inputname', array(
'value1' => 'option1', 'value2' => 'option2'));

Single checkbox example (http://attachment.php?attachmentid=27270)

print_checkbox_row('This is a checkbox row', 'inputname');

Password example (http://attachment.php?attachmentid=27272)

print_password_row('This is a password row', 'inputname');

Date example (http://attachment.php?attachmentid=27274)

print_time_row('Date');



Other functions to use inside tables:

Description row example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27187)

print_description_row('This is a description row', 0, 2, 'thead');

Two cell row example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27188)

print_label_row('Left cell content', 'Right cell content');

Horizontal rule row example (https://vborg.vbsupport.ru/attachment.php?attachmentid=27271)

print_hr_row();

Get next alternating row class (alt1/alt2)

fetch_row_bgclass();



Submit / Reset buttons row:

This closes the form and table tags, so you don't have to use "print_table_footer" with it.

Submit and reset buttons example (http://attachment.php?attachmentid=27143)
print_submit_row("Submit!");

Submit only
print_submit_row("Submit!", 0);








seems I underestimated the ammount of work. should I bother finishing this? gotta work on this more later anyway.

trying to keep the second post for myself... nope automerges

not sure the best formatting... playing around...

[Marco van Herwaarden]

Thanks,

Just 1 comment, "ignore_user_abort(true);" is not needed/wanted for most scripts.

[Dream]

Thanks,

Just 1 comment, "ignore_user_abort(true);" is not needed/wanted for most scripts.

what does it do?

[Andreas]

what does it do?
http://www.php.net/manual/en/function.ignore-user-abort.php

In other words: If this is set to true the script will continue to run until it's normal end even if the user gets disconnected (network outage, hit stop in browser, etc.)

[Ron1n]

whats the diff between print_cp_message and print_stop_message?

[Dream]

print_stop_message is just to get an error phrase name as parameter and call print_cp_message

from admincp/adminfunctions.php (3.5 beta 2)

Halts execution and shows a message based upon a parsed phrase

After the first parameter, this function can take any number of additional
parameters, in order to replace {1}, {2}, {3},... {n} variable place holders
within the given phrase text. The parsed phrase is then passed to print_cp_message()

Note that a redirect can be performed if CP_REDIRECT is defined with a URL

* phrasename string Name of phrase (from the Error phrase group)
* param_2 string 1st variable replacement {1}
* param_3 string 2nd variable replacement {2}
* param_n string Nth variable replacement {n}

function print_stop_message( phrasename )


these images have nothing to do with this post

[Rich]

Edit: Figured it out.

[jim6763nva]

Dream,

Thank you very much for taking the time to put this tutorial together! This is a huge help to getting started making custom pages for the admincp. Hopefully you will continue adding more information to this.

Kudos! :)

Jim

[Antivirus]

Dream, this is a huge help, thanks! I am stumped however, on how to include 1 or more wysiwyg inputs in an admincp page. I know this is an unusual request, but for my next hack, it's required to enter content this way. Can you add this info to the tutorial please, or possibly write another tutorial dedicated to the wysiwyg?

[Reven]

It's great, but a lot of the links to the example images are being parsed as off-site links, such as http://attachment.php?attachmentid=whatever, instead of https://vborg.vbsupport.ru/attachment.php?attachmentid=whatever. Really annoying. Other than that, a great tutorial, which I will surely use at some point.

[hangoutforums]

to view the examples you can just view the attachments at the bottom of dream's post.

This is a really useful tutorial, thanks

[antialiasis]

Does anybody have a guide like this for making Mod CP pages? I'm a bit confused...

[melefire]

thanks, very useful

[-=Sniper=-]

excellent, try to keep it updated :)

[rogersnm]

Hey can anybody answer this?

https://vborg.vbsupport.ru/showthread.php?t=116382

[Kirk Y]

Is it just me, or does adminfunctions.php not exist?

[Adrian Schneider]

Is it just me, or does adminfunctions.php not exist?
It is in the /includes directory.

[Kirk Y]

Ah-ha! Thanks. Is there some easier way to get the information that Dream got from adminfunctions.php without having to read through all the file's code?

[Quarterbore]

HOW TO ADD CHECK BOXES!

Disclaimer: There may be better ways to do this but I searched quite a bit and finally hacked this together using some basic PHP!

About this example: In this example I am going to work with results from a database query. This is a worst case example (I think) so anybody should be able to figure it out for a simpler case.

Page 1: This is the form that the Admin Adds the data to!



$cell[1] = 'This is a Demo!<dfn> Imagine you had a list of options (usergroups perhaps).</dfn>';

//Following is an example of data already saved (perhaps called back from a database)
$selected_OPTIONS = 'Radio|Power Brakes|V8|4x4';

//Following is a query to get a list of ALL options that are possible
$checkboxs_get = mysql_query("
SELECT option, optionid, display
FROM " . TABLE_PREFIX . "demo
ORDER BY display

//Need to Start to Build the Checkbox DIV
$checkbox_options = '<div align="left">';

//Loop through the Possibilities from the database
while ($checkbox = mysql_fetch_array($checkboxs_get))
{
// If the checkbox was selected before, we need to define $checkboxselected
if (in_array(trim($checkbox[option]), $selected_types))
{ $checkboxselected = "checked=\"checked\""; }

// Need to create this option for the checkbox list
$checkbox_options .='<input type="checkbox" name="option[]" value="' . $checkbox[optionid] . '"' . $checkboxselected . '>' . $checkbox[option] . '<br />';

// Need to clear the $checkboxselected for the next pass!
$checkboxselected ='';
}

// Need to Close the Checklist DIV
$checkbox_options .='</div>';

$cell[2] = $checkbox_options;

print_cells_row($cell);



Page Two - This is the page that receives the data!


foreach($_POST['option'] as $value) {
$selected_options .= $value;
$selected_options .= '|';
}
// From Here you would likely want to save the data in your database!

$vbulletin->db->query_write("UPDATE " . TABLE_PREFIX . "demo SET options = '$selected_options' WHERE some_field = $something");

[jerudc]

you can use can_administer() to check
the following bitfield permissions

[ismoderator] => 1
[cancontrolpanel] => 2
[canadminsettings] => 4
[canadminstyles] => 8
[canadminlanguages] => 16
[canadminforums] => 32
[canadminthreads] => 64
[canadmincalendars] => 128
[canadminusers] => 256
[canadminpermissions] => 512
[canadminfaq] => 1024
[canadminimages] => 2048
[canadminbbcodes] => 4096
[canadmincron] => 8192
[canadminmaintain] => 16384
[canadminupgrade] => 32768
[canadminplugins] => 65536

[Naxon]

ok, Thank's, But how can I save it into the DB and use it on the tamplates? (Like FORUMDISPLAY).

[cassis2k]

excellent, thank's

[Mythotical]

Is there a way to add an image to the right of an input row some how?

Here is my input row:
print_input_row("Image", "image", $sponsors['image'], $htmlise = true, $size = 35, $maxlength = 100, $direction = '', $inputclass = false);

This is the code I need to show next to that:
echo '<tr><td><img src="/sponsors/' . $sponsors['image'] . '"></td></tr>';

Thanks
Steve

[aggiefan]

is there a way to restrict a dropdown to one part of the "print_cells_row"?

I'm looking to create a row with a few dropdowns in it...I can't seem to find anywhere where it says you can do that. Looks like you can only stack dropdowns on rows.

[foxfirediego]

first thank you very much for this article.. really handy!!

and some of the link attachment images are broken, check out wich one:
Text area -> attachment.php/?attachmentid=27190
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27190

Yes / No / other radios -> attachment.php/?attachmentid=27275
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27275

"Yes" radio -> attachment.php/?attachmentid=27276
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27276

Multiple radios -> attachment.php/?attachmentid=27273
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27273

Select -> attachment.php/?attachmentid=27189
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27189

Single checkbox -> attachment.php/?attachmentid=27270
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27270

Password -> attachment.php/?attachmentid=27272
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27272

Date -> attachment.php/?attachmentid=27274
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27274

Submit and reset buttons -> attachment.php/?attachmentid=27143
https://vborg.vbsupport.ru/attachment.php/?attachmentid=27143

[Dream]

Thanks, this article is so old I can't remember how to do pages for the admincp anymore :P

j/k, but I have no intention of updating the images. they should be in this thread somewhere.

[foxfirediego]

Ok, sorry for that...
also, just for those that wonder, here is the code for hidden fields:
construct_hidden_code('hiddeninputname', $variable);

[Dream]

No problem, glad it was of help.

Anyone can take this article and redo it, add more info and repost it if they want. I won't be updating it.

[WhaLberg]

print_description_row('This is a description row', 0, 2, 'thead');
Just an additional note, you can also use this as:
print_description_row('phrase', 1, 2, optiontitle);

[vuiveclub]

Where will the rows INSERT to?

[Opserty]

Where will the rows INSERT to?

They don't insert any where....they just "print" (display) stuff.

[Vi3t4Lov3]

I have a list about 10000 title ...I want to made 20titles/ per ... how can I write it? can you help

[Dream]

sorry I did this two years ago, I don't remember.

[Vi3t4Lov3]

:( anyone can help me ...?

[Opserty]

:( anyone can help me ...?

Look in the PHP files that vBulletin does it in you answer will be in them.

[ZomgStuff]

Is there a way to add things to the mod cp?

[The-Ensemble]

Great article I'm going to find this VERY useful for hacks in the future, could you maybe update some of the links the ones to attachment.com dont work anymore.

[C Braithwaite]

awesome guide - really helped me! im sure there is more to learn, but i know exactly which direction to head now!

[Vaupell]

Thank you wery much for this article. :up:

[TalkVirginia]

Is there a function to show a row of 1 or more radio buttons, or do I need to control that manually?

[TalkVirginia]

how would you handle the formatting of a string with commas? Also how would you word wrap a long label, such as the function print_input_row?

[Davidinh]

i need insert a field for file upload (in admincp custom page)
so, what code do i use (let it show browser button)
it upload into database as blob stype
i already tried print_input_row but it's missing a browser button (unable to load file from computer)

any help or suggestion will be appreciated

Sincerely,

Never mind, i found it from images.php
it uses the code as
print_upload_row("upload file", 'images');

hope someone needed .... but that for the template in admincp page .... about coding for file upload that it's up to you or you own your way :))