Create pages for the AdminCP - Page 5

		vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 3 Articles
Create pages for the AdminCP

Page 5 of 5

« First

Thread Tools

Create pages for the AdminCP

Dream

Join Date: Oct 2001

Posts: 2,251

I?m only happy when it rains I?m only happy when it?s complicated And though I know you can?t appreciate it I?m only happy when it rains You know I love it when the news is bad Why it feels so good to feel so sad I?m only happy when it rains

Dream

06-14-2005, 10:00 PM

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) thread.

Basic AdminCP page code:

PHP 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.

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

PHP Code:


			
 // ######################## 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

PHP Code:


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

Creating a redirection message: example image

In this example the page will be redirected to Google in 10 seconds.

PHP Code:


			
print_cp_message('This is a control panel message box.', 'http://google.com', 
10);

Creating a table: example

The standard table has 2 columns.

PHP Code:


			
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)

Quote:

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

PHP Code:


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

# table rows

print_submit_row("Submit!");

Function "print_form_header" parameters (from adminfunctions.php)

Quote:

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

PHP Code:


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

Text area example

PHP Code:


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

Yes / No radios example

PHP Code:


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

Yes / No / other radios example

PHP Code:


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

"Yes" radio example

PHP Code:


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

Multiple radios example

PHP Code:


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

Select example

PHP Code:


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

Single checkbox example

PHP Code:


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

Password example

PHP Code:


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

Date example

PHP Code:


			
print_time_row('Date');

Other functions to use inside tables:

Description row example

PHP Code:


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

Two cell row example

PHP Code:


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

Horizontal rule row example

PHP Code:


			
print_hr_row();

Get next alternating row class (alt1/alt2)

PHP Code:


			
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

PHP Code:


			
print_submit_row("Submit!");

Submit only

PHP Code:


			
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...

Attached Images

	print_input_row.gif (1.2 KB, 0 views)
	print_submit_row.gif (2.0 KB, 0 views)
	print_yes_no_row.gif (1.4 KB, 0 views)
	print_description_row.gif (2.4 KB, 0 views)
	print_label_row.gif (1.1 KB, 0 views)
	print_select_row.gif (1.5 KB, 0 views)
	print_textarea_row.gif (2.4 KB, 0 views)
	print_cp_message.gif (8.3 KB, 0 views)
	print_cp_message_redir.gif (5.2 KB, 0 views)
	table_complete.gif (3.0 KB, 0 views)

#42

03-27-2009, 04:46 AM

TalkVirginia TalkVirginia is offline

Join Date: Oct 2008

Location: Virginia

Posts: 545

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

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

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?

#43

12-19-2010, 09:47 PM

Davidinh

Join Date: Apr 2005

Posts: 47

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

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

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

Code:

 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

)

Page 5 of 5

« 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 07:03 PM.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.08330 seconds Memory Usage 2,300KB 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 (1)bbcode_code (22)bbcode_php (2)bbcode_quote (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 (3)post_thanks_box (2)post_thanks_box_bit (3)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (1)post_thanks_postbit (3)post_thanks_postbit_info (2)postbit (10)postbit_attachment (3)postbit_onlinestatus (3)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_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 fetch_musername post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end post_thanks_function_fetch_thanks_bit_start post_thanks_function_show_thanks_date_start post_thanks_function_show_thanks_date_end post_thanks_function_fetch_thanks_bit_end post_thanks_function_fetch_post_thanks_template_start post_thanks_function_fetch_post_thanks_template_end postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment 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!