vb.org Archive - How to create your own vBulletin-powered page! (uses vB templates)

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

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

- - How to create your own vBulletin-powered page! (uses vB templates) (https://vborg.vbsupport.ru/showthread.php?t=62164)

Quote:

Originally Posted by lukemax (Post 1481638)

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.

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.

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.

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?

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!

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

Is there an update for 3.70 I need to add online location

Quote:

Originally Posted by acegames (Post 1483571)

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?

Quote:

Originally Posted by dfc005 (Post 1481843)

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.

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 (8)bbcode_code_printable (3)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (4)pagenav_pagelinkrel (1)post_thanks_navbar_search (1)printthread (10)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 pagenav_page pagenav_complete 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.04234 seconds Memory Usage 1,795KB 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 (8)bbcode_code_printable (3)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (4)pagenav_pagelinkrel (1)post_thanks_navbar_search (1)printthread (10)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 pagenav_page pagenav_complete bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: