View Full Version : vBulletin Variables List

20 May 2008, 18:30
vB variables list comes in handy now. Should be useful to all. Credits to vBulletinsetup.com (http://www.vbulletinsetup.com)

Site Statistics:-

$totalthreads - Displays the total number of threads in the forum
$totalposts - Displays total number of posts in the forum
$numbermembers - Display total number of members in the forum
$totalonline - Displays the number of total users currently online
$numberregistered - Displays the number of total registered users currently online
$numberguest - Displays the number of total guests currently online
$recordusers - Displays the number of most users ever online
$recorddate - Displays the date on which most users were ever online
$recordtime - Displays the time on which most users were ever online
$activeusers - Displays a list of currently active/online Users (i.e. logged in)
$activemembers - Displays the number of members who are active in the forum
$newusername - Displays the username of the newly registered user
$birthdays - Displays list of users whose birthday is today
$upcomingevents - Displays list of upcoming events

$BBuserinfo Array, this can show anything thats stored in the user table

$bbuserinfo[username] - Username
$bbuserinfo[userid] - User ID number
$bbuserinfo[posts] - Users postcount
$bbuserinfo[signature] - Users signature
$bbuserinfo[email] - User Email Address
$bbuserinfo[homepage] - Users homepage in profile
$bbuserinfo[msn] - Users MSN address from profile
$bbuserinfo[yahoo] - "" Yahoo ""
$bbuserinfo[icq] - "" ICQ ""
$bbuserinfo[usertitle] - Users custom usertitle

$VBoptions Array, these are the options stored in the settings table, i.e things that you configured from vbulletin AdminCP>>vbulletin Options.

$vboptions[forumactive] - Status of whether forum is turned on/off
$vboptions[bbclosedreason] - Reason why forum turned off
$vboptions[bbtitle] - Forum title
$vboptions[bburl] - Forum URL
$vboptions[hometitle] - Site homepage Title
$vboptions[homeurl] - Site homepage URL
$vboptions[copyrighttext] - Site copyright text
$vboptions[privacyurl] - URL to forum privacy statement
$vboptions[webmasteremail] - Webmaster email address
$vboptions[contactuslink] - contact us URL
$vboptiions[enablehooks] - Status of plugin/hook system
$vboptions[imagetype] - Determine if using GD or Imagemagick
$vboptions[timeoffset] - forum time offset
$vboptions[cookiepath] - forum cookie path
$vboptions[legacypostbit] - Determine if using legacy (side) postbit or new horizontal postbit
$vboptions[use_smtp] - If SMTP mail is enabled
$vboptions[smtp_host] - SMTP hostname
$vboptions[smtp_port] - SMTP port number
$vboptions[allowregistrations] - Determine if new users can register
$vboptions[welcomemail] - Determine if welcome mail is sent on registration
$vboptions[avatarenabled] - Check if avatars are enabled
$vboptions[reputationenable] - Check if reputation system is enabled

$stylevar Array, this contains all the paths to forum images and other style variables that are editable in the Styles and templates >> Stylevars

$stylevar[titleimage] - Path/filename for top banner
$stylevar[outertablewidth] - The width of your forum
$stylevar[spacersize] - Spacing betwen main body and content
$stylevar[cellspacing] - Inner border width
$stylevar[cellpadding] Table cell padding
$stylevar[formwidth] - Form width in pixels
$stylevar[imgdir_buton] - Path for forum buttons
$stylevar[imgdir_statusicon] - Path for status icons
$stylevar[imgdir_attach] - Path for attachment icons

$css array, this is where all the CSS attributed can be located

$css variables[body][background] - Body background colour
$css[body][color] - Body text colour
$css[body][LINK_N][color] - Body normal links
$css[body][LINK_V][color] - Body visited links
$css[body][LINK_M][color] - Body link hover colour
$css[.page][background] - Page background colour
$css[.page][color] - Page text colour
$css[.tborder][background] - Table border background colour
$css[.tborder][color] - Table border font colour
$css[.tcat][background] - Category strip background/colour
$css[.tcat][color] - Category strip font colour
$css[.thead][background] - Table header background gradient/colour
$css[.thead][color] - Table header background colour
$css[.tfoot][background] - Table footer background colour/gradient
$css[.tfoot][color] - Table footer text colour

Ad Location Template variables:-

$ad_location[ad_footer_end] - Displays content of ad_footer_end template
$ad_location[ad_footer_start] - Displays content of ad_footer_start template
$ad_location[ad_forumdisplay_afterthreads] - Displays content of ad_forumdisplay_afterthreads template
$ad_location[ad_forumdisplay_afterforums] - Displays content of ad_forumdisplay_afterforums template
$ad_location[ad_header_logo] - Displays content of ad_header_logo template
$ad_location[ad_header_end] - Displays content of ad_header_end template
$ad_location[ad_navbar_below] - Displays content of ad_navbar_below template
$ad_location[ad_showthread_beforeqr] - Displays content of ad_showthread_beforeqr template
$ad_location[ad_showthread_firstpost] - Displays content of ad_showthread_firstpost template


$notices - Used to display notices (for 3.7 onwards)
$notifications_total - Used to display total number of unread notifications (for 3.7 onwards)

Source: http://tech6.com/f51/vbulletin-variables-list-t123/

21 May 2008, 21:53
Thanks for sharing.

21 May 2008, 22:48
Thank you tons :)

22 May 2008, 00:24
Thanks very much for sharing. :)

07 Jul 2008, 15:22
thank you, is there some variable that makes the subforum it was reported? i want to use it to the report titles post...

Brandon Sheley
07 Jul 2008, 15:35
wasn't this posted already?

thanks either way :D

07 Jul 2008, 18:30
ya it was !! and it shows now ..

08 Jul 2008, 01:18

08 Jul 2008, 04:43
What about the total number of members of a usergroup?

say usergroup 37

20 Aug 2008, 12:01
Also where do I get the current users styleid that they have set?

26 Aug 2008, 04:52
What would I use if i wanted to show an image if a curtain user is online and if they are off show a different one.

30 Dec 2008, 21:58
What about trying to get themt o display in two different spots, when I have them both in the forumhome template and in the footer template, it won't display in the footer one, is there something I need to do to make it display?

05 Feb 2009, 20:22
Thanks ...
I doubt I can use it anywhere in my vb

28 Feb 2009, 20:08
Is there a variable that contains the name of the current page? I can't seem to find one.

05 Mar 2009, 02:35

But it's a constant, not a variable, so don't use $

11 Mar 2009, 21:52
One more that should be added to the BBuserinfo list is $bbuserinfo[usergroupid]

This one is really useful, so I think it should be added.

24 Mar 2009, 20:27
How do I use THIS_SCRIPT in a conditional to check if on the forum index page?
This is what I have right now but it's not working:

<if condition="THIS_SCRIPT != 'index.php'">
<td class="forumbitforumlevel1post">$forum[lastpostinfo]</td><!-- -->
<td class="forumbitforumlevel1post">$forum[threadcount]</td><!-- -->
<td class="forumbitforumlevel1post">$forum[replycount]</td><!-- -->

I've placed it inside the forumbit_forum_level1_post as I want the thread and post info displayed in tabular form in the displayforum page but not on the homepage.
I've tried using the $vboptions[homeurl] and $vboptions[bburl] to no avail.

--------------- Added 1237927008 at 1237927008 ---------------

I've just found the answer to my question here:

In other words it should be this:
<if condition="THIS_SCRIPT != 'index'">


04 Apr 2009, 08:44
What would i use to make a "Home" buton that links to each persons OWN profile.?

Thanks :)

04 Apr 2009, 11:11
What would i use to make a "Home" buton that links to each persons OWN profile.?

Thanks :)
<a href="member.php?$session[sessionurl]u=$bbuserinfo[userid]">Home</a>

05 Apr 2009, 00:53
This is what is there now..so i will need to make some adjustments for the button, etc..
<a href="$vboptions[forumhome].php$session[sessionurl_q]" class="home">Home</a>

This has the info i need though thanks. :)

21 Apr 2009, 15:51
Thank you so much, really useful!

22 Apr 2009, 13:19
Oh this is going to be very helpful.

04 May 2009, 16:50
how can I get the first post's title of a thread?

24 Jun 2009, 20:39
how can i use it in templates ? please

22 Sep 2009, 14:17
I wanted to use some of the site statistic variables in a side column but I noticed that some don't show up on the showthread page. Any idea how to get them to show up?

30 Sep 2009, 19:45
How can I show the user(s) rank? Using the $bbuserinfo one?

Digital Jedi
01 Oct 2009, 05:04
$post[rank] inside the postbit.
$bbuserinfo[rank] outside the postbit.

01 Oct 2009, 19:47
Neither of them worked for me, but thanks for trying to help.

Digital Jedi
02 Oct 2009, 01:34
Neither of them worked for me, but thanks for trying to help.
How and where did you implement them?

02 Oct 2009, 23:06
Is there a tutorial or easy way to learn how to use these and design with them, as in pulling certain elements up to the front page? Seems very powerful!!!

13 Oct 2009, 04:45
What do we have to do to make these available in a custom product or script?

I see that $vbulletin->userinfo works, but when I try to use $bbuserinfo it's not there.

17 Oct 2009, 11:58
That's a very nice list! Thank you very much I can definitely put this to some use I guess :-P

22 Oct 2009, 07:03
What do we have to do to make these available in a custom product or script?

I see that $vbulletin->userinfo works, but when I try to use $bbuserinfo it's not there.

Have you tried making $bbuserinfo global?

29 Oct 2009, 12:51
# $vboptiions[enablehooks] - Status of plugin/hook systemThis is true?
& Thank you!!!

lord eriol
06 Nov 2009, 15:40
which variable for Styleid number?

lord eriol
13 Nov 2009, 16:59
which variable for Styleid number?

any help?

05 Dec 2009, 05:16
thanks mate, handy stuff

08 Jan 2010, 05:50
Variable for Version #?

11 Dec 2010, 21:18
Hi... is there a variable for what template group the current template is in?

I'm trying to figure out if a template is a Custom Template or not.

Digital Jedi
11 Dec 2010, 22:03
Hi... is there a variable for what template group the current template is in?

I'm trying to figure out if a template is a Custom Template or not.
What's the name of the template? We could probably just tell you.

30 Dec 2010, 22:52
Is there one (or a way) to list all users form a specific usergroup?

12 Apr 2011, 05:21
Now that's a usefull article,

Thank you

10 Jan 2012, 18:27
can someone give me a basic example of how to use this in vbulletin HTML ad code?

I seem to be retarded.

11 Jan 2012, 07:41
Those are PHP variables and cannot be used in Templates (which the ad code basically is). Try using template conditionals and variables (and make sure you use the vb4 syntax).

08 Apr 2012, 11:16
the best variables library for editing forum templates

12 May 2012, 18:03
It installs fine but when you click on the letters A, B, C does nothing any solution?

12 May 2012, 20:55
There's nothing to install in this article, and what A B C are you talking about? Are you sure you're posting in the right thread?

03 Jul 2012, 06:38
Thank you for share

21 Aug 2012, 23:37
This did help me a lot, Thank you very much

06 Jan 2013, 13:50
$bbuserinfo[usertitle] in PHP?

09 Jan 2013, 17:11
Thanks ..