The Arcive of Official vBulletin Modifications Site.It is not a VB3 engine, just a parsed copy! |
|
First Look at vBulletin 4 Template Variables
Reposted from my site at www.vbcodex.com Actually, Scott's blog was the first look but I am going to talk about vBulletin 4's Template Variables today. Back in the beginning, it was decided that vBulletin needed an easy to use template system. This also required that we allow PHP variables that could be evaluated and displayed to the end user in order to get the data out. This was simple and easy since PHP at its beginning was just a simple templating engine itself. However over time, it became apparent that we needed our own structures in order to coax HTML along and present dynamic data to the user while allowing the designer/site owner control and not requiring knowledge of PHP. With that the <if> and <phrase> tag constructs were developed in 3.0 and there was much rejoicing. Later it became apparent that programmers wanted to be able to easily inject their own code into the templates without bothering the site owner. At first they used regular expressions and other replacement techniques. However as templates were updated or changed, they could break these techniques so the concept of Template Hooks were born. Now developers could assign their code to a specific variable and have it appear without the site owner doing anything. Unfortunately, template hooks aren't used as widely as they could be so the above techniques are still used. The problem though with template hooks, <if> conditionals and <phrase> tags is that it made it very difficult to work with templates in tools like Dreamweaver and Go Live!. Syntax highlighting was off, variables didn't render and preview was a general mess. With the move to an object oriented template system in vBulletin 4, this would have become even worse over time. So the developers decided to move vBulletin's proprietary tags to their own namespace and create a better way of presenting variables within the templates. For variables, they adopted a 'curly node' syntax that moves away from the traditional PHP variable system and tells the system how to process each type of variable. vBulletin 4 will ship with support for a variety of these variables for different purposes. The variable name tells vBulletin how to process the output. Today, I want to go over some of these. Variable format: Code:
{vb:type value.key} Examples: Code:
$bbuserinfo[userid] => {vb:var bbuserinfo.userid} $bbuserinfo[musername] => {vb:raw bbuserinfo.musername} $vbphrase[welcome] => {vb:rawphrase welcome} $stylevar[imgdir_misc] =>{vb:stylevar imgdir_misc} Code:
{vb:var variable} If your variable outputs HTML code, then you'll want to use raw instead. RAW Code:
{vb:raw variable} PHRASE Code:
{vb:phrase phrase, param1, param2...} If the phrase includes HTML code, you should use rawphrase instead. RAWPHRASE Code:
{vb:rawphrase phrase, param1, param2...} STYLEVAR Code:
{vb:stylevar variable} Summary These are just some of the variables being used. There are other types that I will cover later. These include the previously mentioned link but also include date, time, number, if, escapejs, urlencode, and math. To finish today, I will leave you with a template example. HTML Code:
<vb:if condition="$show['bbcodephp']"> <div class="block bbcodeblock"> <h2 class="blockhead">{vb:rawphrase php_code}<a name="php"></a></h2> <div class="blockrow"> <h3 class="blocksubhead">{vb:rawphrase php_tag_performs}</h3> <ul class="codeblock"> <li class="blockrow floatcontainer"> <div class="desc">[php]<span class="highlight">{vb:rawphrase value}</span>[/php]</div> <div class="title" width="20%">{vb:rawphrase usage}</div> </li> <li class="blockrow floatcontainer"> <div class="desc">[php]<br /> $myvar = 'Hello World!';<br /> for ($<i></i>i = 0; \$i < 10; \$i++)<br /> {<br /> echo $myvar . "\n";<br /> }<br /> [/php]</div> <div class="desc">{vb:rawphrase example_usage}</div> </li> <li class="blockrow floatcontainer"> <div class="desc">{vb:raw specialbbcode.php}</div> <div class="title" width="20%">{vb:rawphrase example_output}</div> </li> </ul> </div> </div> </vb:if> |
#12
|
|||
|
|||
can anyone help solve this problem
i want to include the following within a template PHP Code:
|
#13
|
|||
|
|||
I can't convert my custom pages until i know how to access and loop with templates again. It is nice to know how to access one single var or single var in an array but how to loop? I did try my luck with ... (but without any success, yet ...)
Template i need to loop for output PHP Code:
And the template that should display the whole looped conteend PHP Code:
$data is an array like PHP Code:
My "NAMES" template looks like this ... Code:
<div>{vb:raw names_loop}</div> My "names_loop" template looks like this ... Code:
<div style="magin: 10px; padding: 10px;"> <div>{vb:raw names.name}</div> <div>{vb:raw names.age}</div> </div> Can anyone help, please? Thanks. |
#14
|
|||
|
|||
I'm trying to use a variable in SHOWTHREAD, but it's not showing for some reason.
Hook Location: showthread_start variable: $msgbox template variable: {vb:raw msgbox} What can be wrong? |
#15
|
||||
|
||||
Quote:
Try this example: 1. Add a new custom template with the following contents: Product: vBulletin (or if you are creating a mod, choose your product id) Style: Style of your choice Title: mytemplate HTML Code:
<div id="pagetitle" class="pagetitle"> <h1>Thread: <span class="threadtitle">{vb:raw msgbox}</a></span></h1> </div> Product: vBulletin (or if you are creating a mod, choose your product id) Hook Location: showthread_complete Execution Order: Leave as default Plugin PHP Code: PHP Code:
|
#16
|
|||
|
|||
Thanks, it's working now
|
#17
|
|||
|
|||
Does anyone know how to get forumIDs and bbuserinfo from this new system?
I'm trying to use it as follows, but it doesn't work... Code:
header.php?fid={vb:var forum.forumid}&pid={vb:var bbuserinfo.field9} I'm trying to use this in the HEADER template. It seems that you can no longer call forum and user information in the header template. So it seems forcing specific headers to specific forums is IMPOSSIBLE in VB4. |
#18
|
|||
|
|||
i have a template i wish to add to the navbar template
i called it template2 i want to place my custom template above Code:
<div id="breadcrumb" class="breadcrumb"> <ul class="floatcontainer"> Code:
{vb:raw navbar2} Code:
{vb:raw navbar2} <div id="breadcrumb" class="breadcrumb"> <ul class="floatcontainer"> |
#19
|
|||
|
|||
How would we use $vbulletin->options in this?
I am trying to use {vbptions media_thumb_dir} but its not working... |
#20
|
|||
|
|||
So basically the variables were changed for no reason just so that non-coders could understand it? Those new variables look a lot more confusing to me.
|
#21
|
||||
|
||||
Not sure why it was changed, but Jaxel:
{vb:raw vboptions.media_thumb_dir} |
|
|
X vBulletin 3.8.12 by vBS Debug Information | |
---|---|
|
|
More Information | |
Template Usage:
Phrase Groups Available:
|
Included Files:
Hooks Called:
|