Go Back   vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 3 Articles
Reload this Page How to create your own vBulletin-powered page! (uses vB templates)
FAQ Community Calendar Today's Posts Search

Reply
Page 68 of 140 « First 18586667 68 697078118 Last »
 
Thread Tools
How to create your own vBulletin-powered page! (uses vB templates)
Gary King's Avatar
Gary King
Join Date: Jan 2002
Posts: 2,046

 

Show Printable Version Email this Page Subscription
Gary King Gary King is offline 03-03-2004, 10:00 PM
Want to create your very own vBulletin powered page which includes the header, footer, and the user permissions system as well?

Well now you can

Want to know how it will look? Take a look at the attached screenshot below!

Now includes the Who's Online modification!
Also, instructions included on how to create your own pages that are integrated with current vBulletin files!

I'm going to give you a generic page but you can easily modify the contents of the page by changing the template

So here we go

Instructions:

Create a new file, whatever you want to call it (let's say test.php).
Open up test.php and add the following (replace TEST with whatever template you want to show):
PHP Code:
<?php

// ####################### SET PHP ENVIRONMENT ###########################
error_reporting(E_ALL & ~E_NOTICE);

// #################### DEFINE IMPORTANT CONSTANTS #######################
define('NO_REGISTER_GLOBALS', 1);
define('THIS_SCRIPT', 'test'); // change this depending on your filename

// ################### PRE-CACHE TEMPLATES AND DATA ######################
// get special phrase groups
$phrasegroups = array(

);

// get special data templates from the datastore
$specialtemplates = array(
    
);

// pre-cache templates used by all actions
$globaltemplates = array(
    'TEST',
);

// pre-cache templates used by specific actions
$actiontemplates = array(

);

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

// #######################################################################
// ######################## START MAIN SCRIPT ############################
// #######################################################################

$navbits = array();
$navbits[$parent] = 'Test Page';

$navbits = construct_navbits($navbits);
eval('$navbar = "' . fetch_template('navbar') . '";');
eval('print_output("' . fetch_template('TEST') . '");');

?>
Be sure to change 'TEST' to the actual template name, and change 'test' to the filename. Also, change 'Test Page' to whatever you want to show in the navbar, such as 'Viewing Member Profile' (just an example).

Now create the template, called TEST with the following content:
HTML Code:
$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
<title>$vboptions[bbtitle]</title>
$headinclude
</head>
<body>
$header

$navbar

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
    <td class="tcat">Title</td>
</tr>
<tr>
    <td class="alt1">Text</td>
</tr>
</table>

$footer
</body>
</html>
All done
Now check it out by going to test.php

Who's Online Modification

Now if you want to show who is browsing this new page of yours, just open up includes/functions_online.php and find:
PHP Code:
    case 'bugs.php':
        $userinfo['activity'] = 'bugs';
        break; 
Below, add:
PHP Code:
    case 'test.php':
        $userinfo['activity'] = 'test';
        break; 
(Be sure to change the values to your own!)

Then find:
PHP Code:
        case 'modcplogin':
            $userinfo['action'] = $vbphrase['moderator_control_panel_login'];
            break; 
Below add:
PHP Code:
        case 'test':
            $userinfo['action'] = 'Viewing Test Page';
            break; 
All done!

----------------------------------

Also if you want to create your own pages 'within' current vBulletin files, do the following:

Open the file you want, and then right before the final ?> in the source code, add the following:

PHP Code:
if ($_REQUEST['do'] == 'xxx')
{
    eval('print_output("' . fetch_template('TEMPLATE_XXX') . '");');
} 
Replace 'xxx' with whatever you want ?do= in the query string to be (for example, replace 'xxx' with 'showprofile' so then someone would type in example.php?do=showprofile to view this template.) Then of course, change TEMPLATE_XXX to your template name, it's that simple!


edit by Lynne: If running 3.8.4 or above, see this post to take care of the PHP 5.3.0-related problems - https://vborg.vbsupport.ru/showpost....postcount=1171
Attached Images
File Type: jpg template_test.jpg (62.5 KB, 0 views)
Reply With Quote
  #672  
Old 04-03-2008, 04:28 AM
amcd amcd is offline
 
Join Date: Oct 2004
Posts: 218
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Originally Posted by lukemax View Post
is this what you used http://www.vbulletin.com/docs/html/m..._externalfiles ?

What hook location did you use?
Thanks...

--------------- Added [DATE]1207200276[/DATE] at [TIME]1207200276[/TIME] ---------------

Also, did you create a custom template, like this tutorial?
That approach is different. It is suitable for cases where you want to include a bit of your own stuff in the default vbulletin pages, and where you are unable to modify the other php file.

This thread is about creating a completely new page using the vbulletin framework, with vbulletin's header, navbar and footer.
Reply With Quote
  #673  
Old 04-03-2008, 04:31 AM
lukemax lukemax is offline
 
Join Date: Oct 2006
Posts: 83
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
I'm trying to import this table (like your countries one)
http://www.lvasp.com/providers_hook.php
into
http://www.lvasp.com/forum/providers.php

--------------- Added [DATE]1207200883[/DATE] at [TIME]1207200883[/TIME] ---------------

What tutorial did you follow to create your page then? (cause thats what I'm trying to emulate)
Thanks, and sorry for being thick-headed.

--------------- Added [DATE]1207201020[/DATE] at [TIME]1207201020[/TIME] ---------------

I'm looking at the vbulletin manual and I cant seem to find a tutorial for a page like yours.
Reply With Quote
  #674  
Old 04-03-2008, 04:58 AM
amcd amcd is offline
 
Join Date: Oct 2004
Posts: 218
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
I followed this tutorial to create the countries page. Hooks did not exists when this article was written (March 2004). Therefore, you can be certain that hooks are not needed for the page itself (apart from the fact that I am telling you).

The article tells you to edit original php files for "Who's online". In newer vbulletin versions, we can do this through hooks.


Your provider.php is fine. I suppose you are following test.php from the article in this file. Note the part where it says "START MAIN SCRIPT". The code from providers_hook.php will go here.

How are you displaying the output from providers_hook.php? The vbulletin method is to calculate all the variables and then call a template. In the article, the template is called test. Everything between $navbar and $footer in this template is your custom stuff.

If there are any loops in the page (such as a table with multiple rows, like my countries page), then you have to create an additional template - the bit template. Default vbulletin has many examples of this - postbit, threadbit, reputationbit, forumbit etc etc. Within your php code, you must have a loop and within that you call the 'bit' template and store the result into a variable. In the main template for the page, you just put the variable where you want that table.

Here is my countries template for reference (I call it countries_countries, meaning that its the main template of the countries page).
Code:
$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
$headinclude
<title>$vboptions[bbtitle] - $pagetitle</title>
</head>
<body>
$header
$navbar

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" align="center">
<tr>
    <td class="tcat">
        Country Code
    </td>
    <td class="tcat">
        Currently Online
    </td>
    <td class="tcat">
        Country Name
    </td>
    <td class="tcat">
        Continent
    </td>
</tr>
$showlistbits
</table>

$footer
</body>
</html>
And here is the countries_countrybit template.
Code:
<tr>
    <td class="$altclass">
        $country[country]
    </td>
    <td class="$altclass">
        $country[tot]
    </td>
    <td class="$altclass">
        $country[printable_name]
    </td>
    <td class="$altclass">
        $country[continent]
    </td>
</tr>
The code from countries.php looks like this:
Code:
<?php
/*======================================================================*\
|| #################################################################### ||
|| # countries.php                                                    # ||
|| # ---------------------------------------------------------------- # ||
|| # for displaying a list of number of logged in users by country    # ||
|| # ---------------------------------------------------------------- # ||
|| # by GodFather                                     15-October-2007 # ||
|| #################################################################### ||
\*======================================================================*/

// ####################### SET PHP ENVIRONMENT ###########################
error_reporting(E_ALL & ~E_NOTICE);

// #################### DEFINE IMPORTANT CONSTANTS #######################
define('THIS_SCRIPT', 'countries');

// ################### PRE-CACHE TEMPLATES AND DATA ######################
// get special phrase groups
$phrasegroups = array();

// get special data templates from the datastore
$specialtemplates = array();

// pre-cache templates used by all actions
$globaltemplates = array(
    'countries_countries',
    'countries_countrybit'
);

// pre-cache templates used by specific actions
$actiontemplates = array();

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

// #######################################################################
// ######################## START MAIN SCRIPT ############################
// #######################################################################

// ### STANDARD INITIALIZATIONS ###
$showlistbits = '';
$altclass = 'alt1';

// ############################### show list of countries ###############################
$countries = $db->query_read("
    SELECT s.country, count(*) as tot, c.printable_name, c.continent 
    FROM " . TABLE_PREFIX . "session s 
    JOIN " . TABLE_PREFIX . "country c ON s.country=c.iso 
    GROUP BY s.country
    ORDER BY printable_name ASC
");
while ($country = $db->fetch_array($countries))
{
    $altclass = ($altclass=='alt1') ? 'alt2' : alt1;
    eval('$showlistbits .= "' . fetch_template('countries_countrybit') . '";');
}

$navbits = array();
$navbits[$parent] = "Who's Online by Countries";
$navbits = construct_navbits($navbits);
eval('$navbar = "' . fetch_template('navbar') . '";');
eval('print_output("' . fetch_template('countries_countries') . '");');

/*======================================================================*\
|| ####################################################################
|| # 
|| ####################################################################
\*======================================================================*/
?>
Hope that helps.


p.s.: The code above is unaltered, but its not usable because you also need supporting code which stores the countries data in the session table.
Reply With Quote
  #675  
Old 04-03-2008, 06:28 AM
lukemax lukemax is offline
 
Join Date: Oct 2006
Posts: 83
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
ok (thanks soo much for your help thus far) Here is my PROVIDERS template
Code:
$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
<title>$vboptions[bbtitle]</title>
$headinclude
</head>
<body>
$header

$navbar

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
<td class="tcat">Providers</td>
</tr>
<tr>
<td class="panelsurround">
<div class="panel">
<table width='70%' cellpading=7 border=1 bordercolor='black' rules='rows' align='center'>
<tr><th width='120px' class='tcat'>Thumbnail</th>
<th align='left' class='tcat'>Name</th></tr>
$providers_providerbit
</table>
</div>
</td>
</tr>
</table>

$footer
</body>
</html>
Here is the providers_providerbit template
Code:
if(empty($provider[featured_pic])) {
$thumb_nail = "<img src='/images/ASP_Images/thumbs/default.jpg' border='0' />";
} else {
$thumb_nail = '<img src="'.$provider[featured_pic].'" alt="'.$provider[Name].'" border="0" />';
}
<tr>
<th class="$altclass">
<a href="/provider_page.php?ID=$provider[ID]">$thumb_nail</a>
</th>
<th class="$altclass" align="left">
<a href="/provider_page.php?ID=$provider[ID]" class="link">$provider[Name]</a>
</th></tr>
Lastly, heres my providers.php
Code:
<?php

// ####################### SET PHP ENVIRONMENT ###########################
error_reporting(E_ALL & ~E_NOTICE);

// #################### DEFINE IMPORTANT CONSTANTS #######################
define('NO_REGISTER_GLOBALS', 1);
define('THIS_SCRIPT', 'providers'); // change this depending on your filename

// ################### PRE-CACHE TEMPLATES AND DATA ######################
// get special phrase groups
$phrasegroups = array(

);

// get special data templates from the datastore
$specialtemplates = array(
    
);

// pre-cache templates used by all actions
$globaltemplates = array(
    'PROVIDERS',
	'providers_providerbit'
);

// pre-cache templates used by specific actions
$actiontemplates = array(

);

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

// #######################################################################
// ######################## START MAIN SCRIPT ############################
// #######################################################################

// ### STANDARD INITIALIZATIONS ###
$showlistbits = '';
$altclass = 'alt1';

//is it ok to include these variabl;es here
// how many rows to show per page
$rowsPerPage = 20;

// by default we show first page
$pageNum = 1;

// if $_GET['page'] defined, use it as page number
if(isset($_GET['page']))
{
    $pageNum = $_GET['page'];
}
// counting the offset
$offset = ($pageNum - 1) * $rowsPerPage;

// ############################### show list of providers ###############################
$providers = $db->query_read("
    SELECT Approve, ID, Name, featured_pic 
	FROM provider 
 	WHERE Approve = '1'
	ORDER BY rand() 
	LIMIT $offset, $rowsPerPage
");
while ($provider = $db->fetch_array($providers))
{
    $altclass = ($altclass=='alt1') ? 'alt2' : alt1;
    eval('$showlistbits .= "' . fetch_template('providers_providerbit') . '";');
}

$navbits = array();
$navbits[$parent] = 'Providers';

$navbits = construct_navbits($navbits);
eval('$navbar = "' . fetch_template('navbar') . '";');
eval('print_output("' . fetch_template('PROVIDERS') . '");');
?>
Did I make an error?
Reply With Quote
  #676  
Old 04-03-2008, 10:15 AM
dfc005 dfc005 is offline
 
Join Date: Mar 2008
Posts: 198
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
amcd, thanks for that. Makes complete sense.

Reckon you could give us the heads up on how we do the hooks for "Who's online"?

Cheers!
Reply With Quote
  #677  
Old 04-03-2008, 04:22 PM
lukemax lukemax is offline
 
Join Date: Oct 2006
Posts: 83
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
GOT it, thanks
Reply With Quote
  #678  
Old 04-03-2008, 09:50 PM
asandhanam asandhanam is offline
 
Join Date: Oct 2007
Posts: 57
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
I'm trying to create a page within a folder called 'template' in the forum root.
[root]/template/test.php. I tried this method, it worked fine as long as the pages were in the root. What changes do i need to do to make it work when inside 'template' folder in the root.?
Reply With Quote
  #679  
Old 04-05-2008, 02:05 PM
acegames acegames is offline
 
Join Date: Jan 2006
Location: UK
Posts: 132
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Is there an update for 3.70 I need to add online location
Reply With Quote
  #680  
Old 04-05-2008, 07:20 PM
CrashPush's Avatar
CrashPush CrashPush is offline
 
Join Date: Feb 2007
Location: New York
Posts: 106
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Originally Posted by acegames View Post
Is there an update for 3.70 I need to add online location
You want to show the page the user is viewing in the 'Who's Online' page?
Reply With Quote
  #681  
Old 04-05-2008, 07:51 PM
amcd amcd is offline
 
Join Date: Oct 2004
Posts: 218
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Originally Posted by dfc005 View Post
amcd, thanks for that. Makes complete sense.

Reckon you could give us the heads up on how we do the hooks for "Who's online"?

Cheers!
hook online_location_process:
Code:
switch ($filename)
{
    case 'countries.php':
        $userinfo['activity'] = 'countries';
        break;
// add more cases here if you have more than one custom page. no need for multiple plugins. one plugin can handle all.
}

hook online_location_unknown
Code:
switch ($userinfo['activity'])
{
    case 'countries':
        $userinfo['where'] = '<a href="countries.php?'.$vbulletin->session->vars[sessionurl].'">Viewing the countries page</a>';
        $userinfo['action'] = "Who's Online by Country";
        $handled = true;
        break;
// add more cases here if you have more than one custom page. no need for multiple plugins. one plugin can handle all.
Reply With Quote
Reply
Page 68 of 140 « First 18586667 68 697078118 Last »

« Previous Thread | Next Thread »

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 Jump


All times are GMT. The time now is 07:15 PM.

Contact Us - Archive - Top

Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2024, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.05699 seconds
  • Memory Usage 2,380KB
  • Queries Executed 26 (?)
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
  • (8)bbcode_code
  • (1)bbcode_html
  • (6)bbcode_php
  • (3)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
  • (4)pagenav_pagelink
  • (4)pagenav_pagelinkrel
  • (11)post_thanks_box
  • (5)post_thanks_box_bit
  • (11)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (1)post_thanks_postbit
  • (11)post_thanks_postbit_info
  • (10)postbit
  • (1)postbit_attachment
  • (11)postbit_onlinestatus
  • (11)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