Go Back   vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 4 Articles
FAQ Community Calendar Today's Posts Search

Reply
 
Thread Tools
[HOW TO - vB4] Create your own vBulletin page
Lynne's Avatar
Lynne
Join Date: Sep 2004
Posts: 41,180

 

California/Idaho
Show Printable Version Email this Page Subscription
Lynne Lynne is offline 11-15-2009, 10:00 PM

This is an updated article on how to create your own vbulletin powered page. It's only for use with vB4.

This is NOT my work. I'm posting this from another thread where vB Style took the time to write this out. And his work is based on the article by Gary King here - How to create your own vBulletin-powered page! (uses vB templates)

Instructions to Create your Own Page:


1. Create the php page:
- 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 - WARNING: the template name is CASE SENSITIVE!!!):
Code:
<?php

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

// #################### DEFINE IMPORTANT CONSTANTS #######################

define('THIS_SCRIPT', 'test');
define('CSRF_PROTECTION', true);  
// 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 ############################
// if your page is outside of your normal vb forums directory, you should change directories by uncommenting the next line
// chdir ('/path/to/your/forums');
require_once('./global.php');

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

$navbits = construct_navbits(array('' => 'Test Page'));
$navbar = render_navbar_template($navbits);

// ###### YOUR CUSTOM CODE GOES HERE #####
$pagetitle = 'My Page Title';

// ###### NOW YOUR TEMPLATE IS BEING RENDERED ######

$templater = vB_Template::create('TEST');
$templater->register_page_templates();
$templater->register('navbar', $navbar);
$templater->register('pagetitle', $pagetitle);
print_output($templater->render());

?>
- Be sure to change 'TEST' to the actual template name (WARNING: the template name is CASE SENSITIVE!!!), and change 'test' to the filename or a unique name for the page. Also, change 'Test Page' and 'My Page Title' to whatever you want to show in the navbits, such as 'Viewing Member Profile' (just an example).

2. Create the Template:
- If you are in debug mode, create the template in your MASTER STYLE so it shows up in all your styles, otherwise make sure you create the template in the style you are using. If following the page above, call the template TEST (WARNING: the template name is CASE SENSITIVE!!!) with the following content:
HTML Code:
{vb:stylevar htmldoctype}
<html xmlns="http://www.w3.org/1999/xhtml" dir="{vb:stylevar textdirection}" lang="{vb:stylevar languagecode}" id="vbulletin_html">
  <head>
    <title>{vb:raw vboptions.bbtitle} - {vb:raw pagetitle}</title>
    {vb:raw headinclude}
    {vb:raw headinclude_bottom}
  </head>
  <body>
    
    {vb:raw header}
    
    {vb:raw navbar}
    
    <div id="pagetitle">
      <h1>{vb:raw pagetitle}</h1>
    </div>
    
    <h2 class="blockhead">Title</h2>
    <div class="blockbody">
      <div class="blockrow">
        Text
      </div>
    </div>
    
    {vb:raw footer}
  </body>
</html>
.
Instructions to Add your Page to the Who's Online List (WOL):
Create two plugins using the following hooks. Replace mypage and similar with your information.

1. hook location - online_location_process:
Code:
switch ($filename)
{
    case 'test.php':
        $userinfo['activity'] = 'mypage';
        break;
// add more cases here if you have more than one custom page. no need for multiple plugins. one plugin can handle all.
}
.
2. hook location online_location_unknown:
Code:
switch ($userinfo['activity'])
{
    case 'mypage':
        $userinfo['where'] = '<a href="test.php?'.$vbulletin->session->vars[sessionurl].'">My Page</a>';
        $userinfo['action'] = "Viewing My Page";
        $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.
}
.
The colored part in the code above shows what you need to change in the plugins (both reds should be the same and both blues should be the same, whereas green can be whatever you want).


Please see this article for help with rendering templates - [vB4] Rendering templates and registering variables - a short guide
Reply With Quote
  #1072  
Old 08-31-2014, 02:26 AM
Sarab Sarab is offline
 
Join Date: Oct 2007
Posts: 47
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by Lynne View Post
What version did you upgrade from and to? And are their errors in your error_logs (if you don't know where they are, ask your host)? And, what is the *exact* code you put into the plugins for the WOL online plugin? And, what is the link to the custom page?
Wow it seems it's just a problem I have xD
*a year thinking it's a change in vbulletin ="D*
I think the problem raised when I upgraded from 4.1.x to 4.2.1 (my current version )
the error log contain this:
Code:
[30-Aug-2014 00:25:38 UTC] PHP Parse error:  syntax error, unexpected T_ENCAPSED_AND_WHITESPACE, expecting ']' in /????/????/public_html/forum/includes/functions_digest.php(260) : eval()'d code on line 5
[30-Aug-2014 00:25:38 UTC] PHP Parse error:  syntax error, unexpected T_ENCAPSED_AND_WHITESPACE, expecting ']' in /????/????/public_html/forum/includes/functions_digest.php(260) : eval()'d code on line 5
[30-Aug-2014 00:25:38 UTC] PHP Parse error:  syntax error, unexpected T_ENCAPSED_AND_WHITESPACE, expecting ']' in /????/????/public_html/forum/includes/functions_digest.php(260) : eval()'d code on line 5
[30-Aug-2014 00:25:38 UTC] PHP Parse error:  syntax error, unexpected T_ENCAPSED_AND_WHITESPACE, expecting ']' in /????/????/public_html/forum/includes/functions_digest.php(260) : eval()'d code on line 5
[30-Aug-2014 00:46:14 UTC] die 4 false
[30-Aug-2014 00:56:18 UTC] die 4 false
[30-Aug-2014 00:58:53 UTC] PHP Fatal error:  Allowed memory size of 1073741824 bytes exhausted (tried to allocate 122880 bytes) in /????/????/public_html/forum/includes/functions.php(1939) : eval()'d code on line 60
[30-Aug-2014 01:37:55 UTC] die 4 false
[30-Aug-2014 01:54:07 UTC] die 4 false
[30-Aug-2014 02:55:33 UTC] die 4 false
[30-Aug-2014 04:20:47 UTC] die 4 false
[30-Aug-2014 06:57:53 UTC] die 4 true
[30-Aug-2014 07:24:25 UTC] die 4 false
[30-Aug-2014 07:24:26 UTC] die 4 false
[30-Aug-2014 08:16:48 UTC] PHP Fatal error:  Call to undefined method vB_Friendly_Url_Error::get_uri() in /????/????/public_html/forum/includes/init.php on line 358
[30-Aug-2014 09:35:16 UTC] die 4 false
[30-Aug-2014 10:06:08 UTC] die 4 true
[30-Aug-2014 10:06:09 UTC] die 4 true
[30-Aug-2014 10:06:09 UTC] die 4 true
[30-Aug-2014 10:06:09 UTC] die 4 true
[30-Aug-2014 10:06:10 UTC] die 4 true
[30-Aug-2014 10:06:10 UTC] die 4 true
[30-Aug-2014 10:06:10 UTC] die 4 true
[30-Aug-2014 10:34:00 UTC] die 4 false
[30-Aug-2014 10:35:39 UTC] die 4 false
[30-Aug-2014 10:37:12 UTC] die 4 true
[30-Aug-2014 12:11:03 UTC] die 4 false
[30-Aug-2014 12:39:17 UTC] die 4 false
[30-Aug-2014 12:39:17 UTC] die 4 false
[30-Aug-2014 14:30:35 UTC] die 4 false
[30-Aug-2014 14:30:35 UTC] die 4 false
[30-Aug-2014 16:11:53 UTC] die 4 false
[30-Aug-2014 16:11:53 UTC] die 4 false
[30-Aug-2014 16:11:53 UTC] die 4 false
[30-Aug-2014 17:08:35 UTC] die 4 false
[30-Aug-2014 17:26:19 UTC] die 4 false
[30-Aug-2014 17:26:19 UTC] die 4 false
[30-Aug-2014 17:26:21 UTC] die 4 false
[30-Aug-2014 17:26:21 UTC] die 4 false
[30-Aug-2014 18:20:12 UTC] die 4 true
[30-Aug-2014 18:35:50 UTC] die 4 false
[30-Aug-2014 18:35:51 UTC] die 4 false
[30-Aug-2014 18:38:58 UTC] die 4 false
[30-Aug-2014 18:39:01 UTC] die 4 false
[30-Aug-2014 18:39:30 UTC] die 4 false
[30-Aug-2014 18:39:30 UTC] die 4 false
[30-Aug-2014 18:39:38 UTC] die 4 false
[30-Aug-2014 18:39:38 UTC] die 4 false
[30-Aug-2014 18:39:47 UTC] die 4 false
[30-Aug-2014 18:39:47 UTC] die 4 false
[30-Aug-2014 18:39:57 UTC] die 4 true
[30-Aug-2014 18:40:42 UTC] die 4 false
[30-Aug-2014 18:40:42 UTC] die 4 false
[30-Aug-2014 18:41:07 UTC] die 4 false
[30-Aug-2014 18:41:07 UTC] die 4 false
[30-Aug-2014 18:41:21 UTC] die 4 true
[30-Aug-2014 18:42:17 UTC] die 4 false
[30-Aug-2014 18:42:17 UTC] die 4 false
[30-Aug-2014 18:42:34 UTC] die 4 false
[30-Aug-2014 18:42:34 UTC] die 4 false
[30-Aug-2014 18:42:45 UTC] die 4 false
[30-Aug-2014 18:42:46 UTC] die 4 false
[30-Aug-2014 18:44:31 UTC] die 4 false
[30-Aug-2014 18:44:31 UTC] die 4 false
[30-Aug-2014 18:44:40 UTC] die 4 false
[30-Aug-2014 18:44:40 UTC] die 4 false
[30-Aug-2014 18:44:55 UTC] die 4 false
[30-Aug-2014 18:44:56 UTC] die 4 false
[30-Aug-2014 18:45:11 UTC] die 4 false
[30-Aug-2014 18:45:12 UTC] die 4 false
[30-Aug-2014 18:45:15 UTC] die 4 false
[30-Aug-2014 18:46:34 UTC] die 4 false
[30-Aug-2014 18:46:36 UTC] die 4 false
[30-Aug-2014 18:46:45 UTC] die 4 false
[30-Aug-2014 18:46:46 UTC] die 4 false
[30-Aug-2014 18:47:02 UTC] die 4 false
[30-Aug-2014 18:47:02 UTC] die 4 false
[30-Aug-2014 18:47:10 UTC] die 4 false
[30-Aug-2014 18:47:10 UTC] die 4 false
[30-Aug-2014 18:47:23 UTC] die 4 false
[30-Aug-2014 18:47:23 UTC] die 4 false
[30-Aug-2014 19:55:07 UTC] PHP Fatal error:  Cannot redeclare construct_depth_mark() (previously declared in /????/????/public_html/forum/awards.php:98) in /????/????/public_html/forum/includes/adminfunctions.php on line 1922
the code for wol I put is:
Code:
switch ($filename)
{
    case 'PhantomGroup.php':
        $userinfo['activity'] = 'آل فانتوم';
        break;
// add more cases here if you have more than one custom page. no need for multiple plugins. one plugin can handle all.
}
Code:
switch ($userinfo['activity'])
{
    case 'فريق فانتوم':
        $userinfo['where'] = '<a href="PhantomGroup.php?'.$vbulletin->session->vars[sessionurl].'">فريق فانتوم</a>';
        $userinfo['action'] = "يشاهد صفحة آل فانتوم";
        $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.
}
the url to the page:
http://www.alphantom.com/forum/PhantomGroup.php

it seems the problem is picky, where some pages show fine and some not, like here:


Quote:
Originally Posted by tbworld View Post
I would have to know what version you were running and what version you upgraded to. What version of PHP are you now using?
from 4.1.x to 4.2.1, and the php version is: 5.3.27 =D
Reply With Quote
  #1073  
Old 09-06-2014, 05:40 AM
Sarab Sarab is offline
 
Join Date: Oct 2007
Posts: 47
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

="D no fix =")?
Reply With Quote
  #1074  
Old 09-06-2014, 08:45 AM
Mark.B Mark.B is offline
Senior Member
 
Join Date: Feb 2004
Posts: 1,354
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

The code for adding custom who's online entries has not changed at all.

My suspicion is that your issue may be related to the URLs people are actually using...why is there a trailing slash (/) after .php in your URLs?

index.php/ will report differently to index.php and thus may not be picked up by the custom WOL code you've entered.
Reply With Quote
  #1075  
Old 09-08-2014, 11:52 AM
doctorsexy's Avatar
doctorsexy doctorsexy is offline
 
Join Date: Mar 2011
Location: earth
Posts: 383
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Thank for this Lynne.. really easy to follow the instructions...
Reply With Quote
  #1076  
Old 11-01-2014, 01:09 PM
addamroy addamroy is offline
 
Join Date: Sep 2010
Posts: 352
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

This does not work correctly on mobile devices.

I couldn't figure out why my custom pages wouldn't load on my smart phone and would only work on a computer.

Once I turned off the designated style for mobile users via the vbulletin style settings, the pages load. But now I am unable to automatically assign the mobile style for mobile users which is a problem.

Is there a workaround for this lynne?

Either to turn off the mobile style for custom pages, or re-work the code so the custom pages are either mobile friendly, or load with a non-mobile style by default?

Essentially i get a blank white page if I visit one of these custom pages with a smart phone - Unless I DO NOT assign the mobile style to mobile users via the style settings in admincp.
Reply With Quote
  #1077  
Old 11-01-2014, 01:24 PM
cellarius's Avatar
cellarius cellarius is offline
 
Join Date: Aug 2005
Posts: 1,987
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

You did add your custom template to the mobile style, too, did you?
Reply With Quote
2 благодарности(ей) от:
addamroy, Lynne
  #1078  
Old 11-01-2014, 02:21 PM
addamroy addamroy is offline
 
Join Date: Sep 2010
Posts: 352
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by cellarius View Post
You did add your custom template to the mobile style, too, did you?
lmfao. No, I didn't.

That fixed the problem. (smacks forehead)

Thanks!
Reply With Quote
  #1079  
Old 01-28-2015, 10:26 AM
DoubleYou DoubleYou is offline
 
Join Date: Nov 2011
Posts: 4
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I am probably beeing extra dumb today, but I think I followed the instructions carefully. My template is called static and my page is called 404.php. Uploaded it to the directory of the vbulletin installation and get the following when I try to open the page:

Code:
'404 Seite')); $navbar = render_navbar_template($navbits); // ###### YOUR CUSTOM CODE 
GOES HERE ##### $pagetitle = '404 Fehlerseite'; // ###### NOW YOUR TEMPLATE IS BEING RENDERED
 ###### $templater = vB_Template::create('static'); $templater->register_page_templates(); 
$templater->register('navbar', $navbar); $templater->register('pagetitle', $pagetitle); 
print_output($templater->render()); ?>
Any hints are greatly appreciated.
Reply With Quote
  #1080  
Old 01-28-2015, 11:05 AM
Dave Dave is offline
 
Join Date: May 2010
Posts: 2,583
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

@DoubleYou, you literally see the PHP code on the screen? That means you forgot to put the code after a <?php tag.
Reply With Quote
  #1081  
Old 01-28-2015, 11:27 AM
DoubleYou DoubleYou is offline
 
Join Date: Nov 2011
Posts: 4
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

yes however not all of it. here is the code of the 404.php

Code:
<?php

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

// #################### DEFINE IMPORTANT CONSTANTS #######################

define('THIS_SCRIPT', '404');
define('CSRF_PROTECTION', true);  
// 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('static',
);

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

// ######################### REQUIRE BACK-END ############################
// if your page is outside of your normal vb forums directory, you should change directories by uncommenting the next line
require_once('./global.php');

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

$navbits = construct_navbits(array('' => '404 Seite'));
$navbar = render_navbar_template($navbits);

// ###### YOUR CUSTOM CODE GOES HERE #####
$pagetitle = '404 Fehlerseite';

// ###### NOW YOUR TEMPLATE IS BEING RENDERED ######

$templater = vB_Template::create('static');
$templater->register_page_templates();
$templater->register('navbar', $navbar);
$templater->register('pagetitle', $pagetitle);
print_output($templater->render());

?>
Reply With Quote
Reply


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 01:59 PM.


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.07561 seconds
  • Memory Usage 2,389KB
  • 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
  • (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
  • (3)pagenav_pagelinkrel
  • (11)post_thanks_box
  • (60)post_thanks_box_bit
  • (11)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (2)post_thanks_postbit
  • (11)post_thanks_postbit_info
  • (10)postbit
  • (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_display_complete
  • post_thanks_function_can_thank_this_post_start
  • pagenav_page
  • pagenav_complete
  • tag_fetchbit_complete
  • forumrules
  • navbits
  • navbits_complete
  • showthread_complete