vBulletin Setup

[Brandon Sheley]

vBulletin is an excellent product that gives the admin amazing control over their vBulletin Forum directly from the templates themselves. You can use PHP if conditionals directly within the template system thanks to vBulletin.

There are too many possible ways to use conditionals to be able to list every single way but we can tackle some of the most popular ones.

I will first explain what the conditional is doing and then list the conditional below it.

If Viewer is a Member
--------------------------------------------------
If you want to show a link only to registered members you would use this conditional.

<if condition="$show['member']"></if> 

If Viewer is in the Following Usergroups Array. Enter the Usergroup Number(s) Seperated by a Comma
--------------------------------------------------
If you want to show an advertisement to viewers that are unregistered, registered members and awaiting email confirmation you would use the usergroup ids 1,2,3 within the array.

<if condition="is_member_of($vbulletin->userinfo, 1, 2, 3)"></if> 

If This Script Is or Is Not XXX
--------------------------------------------------
If this script is index (as used in the example below) then it will show the code within the conditional. You can use it to show a piece of code only on Forumhome if you have to put it in a template that is global such as the header. To find out what the script is per page open up the php file that loads the page like for instance showthread.php and look for

PHP Code:

define('THIS_SCRIPT', 'showthread'); 


and the showthread part is what you would use.

<if condition="THIS_SCRIPT == 'index'"></if> 

and here you can show information on every page but the index page by using this conditional

<if condition="THIS_SCRIPT != 'index'"></if> 

If this user equals or does not equal xxx
--------------------------------------------------
What this conditional will do is only show certain information if the person viewing the page has the same userid as defined within the conditional. So if you put userid 667 inside the conditional below and put a link inside the conditional tags only the user that has the userid 667 will see that link.

<if condition="$bbuserinfo['userid'] == 667"></if> 

and it works the opposite way as well if you do not want information to show for 667 but you want it to show for everyone else you would use

<if condition="$bbuserinfo['userid'] != 667"></if> 

Display Information To Guests Only
--------------------------------------------------
The following conditional will display information only to guests and no one else. This is helpful in displaying a welcome message that you only wish for guests to see.

<if condition="$show['guest']"></if> 

Display Information On a Per Forum Basis
--------------------------------------------------
This conditional allows you to display information on a per forum basis. This can be helpful if you wish to display different advertisements depending on what forum that the user is in. You would simply replace X with the forum id that you wish the information to appear in.

<if condition="$forum[forumid] == X"></if> 

and on the other hand you can use the ! to do the opposite and display the information in every forum but the id you list

<if condition="$forum[forumid] != X"></if> 

or if you have multiple forums you wish to include something with you can use an array such as this

<if condition="in_array($forum['forumid'], array(1,2,3,6))"></if> 

If Usergroup Is or Is Not X
--------------------------------------------------
If the user is a member of the x usergroup then show the code

<if condition="$post['usergroupid'] == 6"></if> 

and then you can use the ! to tell it to not show it to the x usergroup but show it to everyone else.

<if condition="$post['usergroupid'] != 6"></if> 

If Users Birthday is Less Than or Greater Than XXXX-XX-XX Do Something
--------------------------------------------------
Just to show the power of vBulletin here is a cool conditional that will show information based on the birthday of the user. The one below will show "Too Young" if they were born after 01-01-1980.

<if condition="$bbuserinfo['birthday_search'] > '1980-01-01'">Too Young</if> 

and this one will show you "Too Young" if the user was born before 01-01-1980

<if condition="$bbuserinfo['birthday_search'] < '1980-01-01'">Too Young</if> 

If Thread is or is not in X Forum Execute Code
--------------------------------------------------
For instance if you want a piece of code to appear within thread in a particular forum you can do so with this conditional.

<if condition="$thread['forumid'] == X"></if> 

If you want to show the piece of code on every new reply on every thread but 1 forum you can use this which says if thread is in forum x do not show the code but show it for all the other threads out side of forum x.

<if condition="$thread['forumid'] != X"></if> 

and of course you can define multiple forum ids with the array

<if conditional="in_array($thread['forumid'], array(1,2,3,6))"></if> 

Is user moderator of any forum?
--------------------------------------------------
If the user is a moderator execute code.

<if condition="can_moderate()"></if> 

Is user moderator of current forum?
--------------------------------------------------
If the user is a moderator of the current forum execute code

<if condition="can_moderate($forum['forumid'])"></if> 

Is user moderator of x Forum?
--------------------------------------------------
If the user is a moderator of x forum execute code.

<if condition="can_moderate($forum['x'])"></if> 

Note: can_moderate() may add queries to your page.

Is user the thread starter?
--------------------------------------------------
Is the user the thread creator? If so execute code.

<if condition="$threadinfo['postuserid'] == $bbuserinfo['userid']"></if> 

Is user the thread starter?
--------------------------------------------------
If the thread is closed execute code.

<if condition="!$show['closethread']"></if> 

Place Information After First Post
--------------------------------------------------
Useful for adding a advertisement or other information after the first post on every page.

<if condition="!$GLOBALS['FIRSTPOSTID']"></if> 

Place Information After x Post On Every Page
--------------------------------------------------
This will add your code directly after the post number you define on each page. If you put 2 in place of x the code will appear on every page after the second post.

<if condition="$post['postcount'] % $vboptions['maxposts'] == x"></if> 

Using If Else in Templates
--------------------------------------------------
You can also use If Else conditionals within your templates. The below shows you how to correctly do this.

<if condition="$show['guest']">
    Show Guest This Message
<else />
    Show Everyone but guests this message
</if> 

Contributors:
- Chroder
- SirAdrian

Other Useful Sources:
- vBulletin Manual - Template Conditionals
- vBulletin Community Forum - View Single Post - How to do 3 if conditionials?

[SirAdrian]

Nice list... I'm just going to post a few minor corrections / improvements:

Instead of

<if condition="in_array($bbuserinfo[usergroupid], array(1,2,3,5,6))"></if>

You should use

<if condition="is_member_of($vbulletin->userinfo, 1, 2, 3)">

or

<if condition="is_member_of($vbulletin->userinfo, array(1, 2, 3))">

The is_member_of() function will return true if you are a primary or secondary user of any of the included groups.

Second one... [more of a lecture] you should quote your array keys in these conditions. Most people think that because it's inside a template, quoting them will cause errors, but inside of template conditions is another story. Without the quotes, the interpreter will first check if they are constants and then issue an E_NOTICE. Generally this isn't a big deal since vBulletin hides them anyway, but it's good practice to do it this way. An example of this would be

<if condition="$vbulletin->userinfo[userid] == 1">

This should be replaced with

<if condition="$vbulletin->userinfo['userid'] == 1">

One good example of this is vbJournal; it completely killed it for PHP5 because of the 'private' field (PHP 5 keyword).

The final reason for this, and though it's mainly theoretical, it's a bit disturbing. You can kill about 50% of hacks by using this code:

PHP Code:

define('userid', 'whatever');
define('forumid', 'whatever');
define('usergroupid', 'whatever');
define('postid', 'whatever');
define('threadid', 'whatever');
// etc 


-- you can merge the changes into your post and delete this one if you'd like

[mike]

Appreciate the additional information siradrian. I really love having these conditionals all narrowed down to one easy to find location.

Thanks for these tips I will add them to my post.

Thanks for the great resource.

Within the newreply template, neither of these would work:

<if condition="$forum[forumid] == X"></if>
<if condition="in_array($thread['forumid'], array(1,2,3,6))"></if> 

I found a work around. This works!:

<if condition="$forumid == 41"> 

What confuses me is that I can't get this to work:

<if condition="in_array($forumid, array(1,2,3,6))"></if> 

Does anyone have any ideas on making the last one work?

[sinjix_media]

im trying to show something if its the forumhome and no other index page
is there a conditional forum forumhome?

[Brandon Sheley]

Originally Posted by Brent

Try using this one

<if condition="THIS_SCRIPT != 'arcade' AND != 'adv_index'"></if> 

Parse error: parse error, unexpected T_IS_NOT_EQUAL in /home/content/r/s/o/rsoto23/html/includes/adminfunctions_template.php(3593) : eval()'d code on line 26

I think the client is just going to remove the column

thanks anyways

That is odd why that isnt' working

[SirAdrian]

<if condition="THIS_SCRIPT != 'arcade' AND THIS_SCRIPT != 'adv_index'"></if>

[Brandon Sheley]

After looking at it, I think there was some code in the header and on the actual portal templates too ?
either way, it's looking like they want now, thanks for the help both of you

[SirAdrian]

Sorry I just noticed a typo that a few of you have quoted. I updated post #9

missed the array( ... ) around the list of items.

Originally Posted by SirAdrian

<if condition="!in_array(THIS_SCRIPT, array('arcade', 'adv_index'))"> ... </if>

You just helped me out a bunch.

[Brandon Sheley]

okay, I have another question for the pros

a client has a side column and would like to she the 5 newest post to show.

is there an easy variable or code that we can place in the column and it'll show the 5 newest post ?

thank you

-Brandon

RSS would be the best way to do that wouldn't it?

I need a conditional that will only show an item on the first page of the thread.

I have a stupied question where do i put these codes you guys are posting for example the ones in the very first post?

Originally Posted by devil dawgg

I have a stupied question where do i put these codes you guys are posting for example the ones in the very first post?

In any template where you want them to take effect.

nice list brent! It's a good collection which I have been referring to lately. Thanks.

Thanks and welcome to the site

hi,
found a link for this article via vb.org
really needed this thanks!

I tried using:

<if condition="$post['usergroupid'] != 25">
<img src="yadayada.com/12.gif">
</if>

To display a banner to everyone except that user group.

However even that usergroup sees the banner.

I think the problem is being caused because it is not a primary usergroup, but an additional one.

Can someone kindly guide me how I would use an IF statement to check if the person is a member of the additional usergroup or not?

Thanks
aku

[RedMatrix]

Maybe try the long way:

<if condition="is_member_of($vbulletin->userinfo, 1, 2, 3, 4, 5, 6, 7, ... 24, 26, 27 .. N)">
 <img src="yadayada.com/12.gif">
</if> 

Just put all the other user group numbers that you use except 25 and see if that works.

[sinjix_media]

I'm using

<ul>
    <li <if condition="THIS_SCRIPT != 'index'">id="current"</if>><a href="$vboptions[bburl]">Home</a></li>
    <li <if condition="THIS_SCRIPT != 'index'">id="current"</if>><a href="$vboptions[bburl]">Forums</a></li>
    <li <if condition="THIS_SCRIPT != 'ppindex'">id="current"</if>><a href="$vboptions[bburl]">Gallery</a></li>
    <li <if condition="THIS_SCRIPT != 'usercp'">id="current"</if>><a href="$vboptions[bburl]/usercp">Profile</a></li>
    <li <if condition="THIS_SCRIPT != 'Tags'">id="current"</if>><a href="$vboptions[bburl]/tags/">Tags</a></li>
  </ul>

It's not working.
What am I doing wrong?

[Brandon Sheley]

I see 2 ">>" and you want all links to point to the forum ?

[Michael Biddle]

test
test
test

[Michael Biddle]

vBulletin is an excellent product that gives the admin amazing control over their vBulletin Forum directly from the templates themselves. You can use PHP if conditionals directly within the template system thanks to vBulletin.

There are too many possible ways to use conditionals to be able to list every single way but we can tackle some of the most popular ones.

I will first explain what the conditional is doing and then list the conditional below it.

If Viewer is a Member
--------------------------------------------------
If you want to show a link only to registered members you would use this conditional.

<if condition="$show['member']"></if> 

If Viewer is in the Following Usergroups Array. Enter the Usergroup Number(s) Seperated by a Comma
--------------------------------------------------
If you want to show an advertisement to viewers that are unregistered, registered members and awaiting email confirmation you would use the usergroup ids 1,2,3 within the array.

<if condition="is_member_of($vbulletin->userinfo, 1, 2, 3)"></if> 

If This Script Is or Is Not XXX
--------------------------------------------------
If this script is index (as used in the example below) then it will show the code within the conditional. You can use it to show a piece of code only on Forumhome if you have to put it in a template that is global such as the header. To find out what the script is per page open up the php file that loads the page like for instance showthread.php and look for

PHP Code:

define('THIS_SCRIPT', 'showthread'); 


and the showthread part is what you would use.

<if condition="THIS_SCRIPT == 'index'"></if> 

and here you can show information on every page but the index page by using this conditional

<if condition="THIS_SCRIPT != 'index'"></if> 

If this user equals or does not equal xxx
--------------------------------------------------
What this conditional will do is only show certain information if the person viewing the page has the same userid as defined within the conditional. So if you put userid 667 inside the conditional below and put a link inside the conditional tags only the user that has the userid 667 will see that link.

<if condition="$bbuserinfo['userid'] == 667"></if> 

and it works the opposite way as well if you do not want information to show for 667 but you want it to show for everyone else you would use

<if condition="$bbuserinfo['userid'] != 667"></if> 

Display Information To Guests Only
--------------------------------------------------
The following conditional will display information only to guests and no one else. This is helpful in displaying a welcome message that you only wish for guests to see.

<if condition="$show['guest']"></if> 

Display Information On a Per Forum Basis
--------------------------------------------------
This conditional allows you to display information on a per forum basis. This can be helpful if you wish to display different advertisements depending on what forum that the user is in. You would simply replace X with the forum id that you wish the information to appear in.

<if condition="$forum[forumid] == X"></if> 

and on the other hand you can use the ! to do the opposite and display the information in every forum but the id you list

<if condition="$forum[forumid] != X"></if> 

or if you have multiple forums you wish to include something with you can use an array such as this

<if condition="in_array($forum['forumid'], array(1,2,3,6))"></if> 

If Usergroup Is or Is Not X
--------------------------------------------------
If the user is a member of the x usergroup then show the code

<if condition="$post['usergroupid'] == 6"></if> 

and then you can use the ! to tell it to not show it to the x usergroup but show it to everyone else.

<if condition="$post['usergroupid'] != 6"></if> 

If Users Birthday is Less Than or Greater Than XXXX-XX-XX Do Something
--------------------------------------------------
Just to show the power of vBulletin here is a cool conditional that will show information based on the birthday of the user. The one below will show "Too Young" if they were born after 01-01-1980.

<if condition="$bbuserinfo['birthday_search'] > '1980-01-01'">Too Young</if> 

and this one will show you "Too Young" if the user was born before 01-01-1980

<if condition="$bbuserinfo['birthday_search'] < '1980-01-01'">Too Young</if> 

If Thread is or is not in X Forum Execute Code
--------------------------------------------------
For instance if you want a piece of code to appear within thread in a particular forum you can do so with this conditional.

<if condition="$thread['forumid'] == X"></if> 

If you want to show the piece of code on every new reply on every thread but 1 forum you can use this which says if thread is in forum x do not show the code but show it for all the other threads out side of forum x.

<if condition="$thread['forumid'] != X"></if> 

and of course you can define multiple forum ids with the array

<if conditional="in_array($thread['forumid'], array(1,2,3,6))"></if> 

Is user moderator of any forum?
--------------------------------------------------
If the user is a moderator execute code.

<if condition="can_moderate()"></if> 

Is user moderator of current forum?
--------------------------------------------------
If the user is a moderator of the current forum execute code

<if condition="can_moderate($forum['forumid'])"></if> 

Is user moderator of x Forum?
--------------------------------------------------
If the user is a moderator of x forum execute code.

<if condition="can_moderate($forum['x'])"></if> 

Note: can_moderate() may add queries to your page.

Is user the thread starter?
--------------------------------------------------
Is the user the thread creator? If so execute code.

<if condition="$threadinfo['postuserid'] == $bbuserinfo['userid']"></if> 

Is user the thread starter?
--------------------------------------------------
If the thread is closed execute code.

<if condition="!$show['closethread']"></if> 

Place Information After First Post
--------------------------------------------------
Useful for adding a advertisement or other information after the first post on every page.

<if condition="!$GLOBALS['FIRSTPOSTID']"></if> 

Place Information After x Post On Every Page
--------------------------------------------------
This will add your code directly after the post number you define on each page. If you put 2 in place of x the code will appear on every page after the second post.

<if condition="$post['postcount'] % $vboptions['maxposts'] == x"></if> 

Using If Else in Templates
--------------------------------------------------
You can also use If Else conditionals within your templates. The below shows you how to correctly do this.

<if condition="$show['guest']">
    Show Guest This Message
<else />
    Show Everyone but guests this message
</if> 

Contributors:
- Chroder
- SirAdrian

Other Useful Sources:
- vBulletin Manual - Template Conditionals
- vBulletin Community Forum - View Single Post - How to do 3 if conditionials?
- vBulletin Setup - Thanks

[Brandon Sheley]

I don't know how many times I've came to this list to figure out how to hide something

Thanks for posting it Mike

[Norman]

Thanks!

[StupiDeity]

Hi

I am almost a n00b with vB. I've been trying to find the conditional for the user join date but have been unsuccessful till now.

Anybody know how I can get to that piece of user data?

Cheers!

[Ross]

$vbphrase[join_date]: <strong>$userinfo[datejoined]</strong>

That is what I am using

Hope this helps,

Ross

[StupiDeity]

Hey thanx dude!

I will try it out tonight.

May the forks be with you

Cheers!

[Norman]

Nice list! Thank you.