The Arcive of Official vBulletin Modifications Site.

amcd · #**672** 04-03-2008, 04:28 AM

Quote:

Originally Posted by lukemax

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.

lukemax · #**673** 04-03-2008, 04:31 AM

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.

amcd · #**674** 04-03-2008, 04:58 AM

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.

lukemax · #**675** 04-03-2008, 06:28 AM

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?

dfc005 · #**676** 04-03-2008, 10:15 AM

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!

lukemax · #**677** 04-03-2008, 04:22 PM

GOT it, thanks

asandhanam · #**678** 04-03-2008, 09:50 PM

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

acegames · #**679** 04-05-2008, 02:05 PM

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

CrashPush · #**680** 04-05-2008, 07:20 PM

Quote:

Originally Posted by acegames

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?

amcd · #**681** 04-05-2008, 07:51 PM

Quote:

Originally Posted by dfc005

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
Page Generation 0.11000 seconds Memory Usage 2,370KB 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
Messages:

The Arcive of Official vBulletin Modifications Site.

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