[Billspaintball]

Edit: This usage and trouble shooting guide has been updated as of 24th of April 2007


Usage

The hack is pretty useless without some usage instructions so here they are.

We can use conditionals to hide or display depending on a number of things such as
Logged in or out status,
or restrict to members of a specific usergroup.

We do this by using conditionals in php tags where the normal content of a webpage would go.


If you want something only accessable to a certain usergroup, use this code in your webpage. This example is only visible to members of usergroup 6.

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

You can use a simple variation of this to restrict entire pages to a certain usergroup.
For example,

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

You can of course use multiple usergroups by just modifiying the if statement a little.
For example:

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

Another use is to display different content to users depending on if they are logged in or not. For example

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

Another use is to restrict advertising to people who are not logged in.
For example

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

Of course you can play around with conditionals to do a whole range of things, these are just brief example snippets.



Troubleshooting

If your reading this chances are you are having problems.

Here are some common causes and fixes.

1. Headers already sent or cookies already sent errors. Chances are that there is something, even just a space before the 4 lines of code in part 1. Edit this and ensure that there are no spaces before it.
   
   
   
2. Path problems are the next biggest problem. Your paths must be exact else it will not work. Double check that all paths are correct.
   If you are unsure what the path is place the following code in a page all by itself.
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   Name this file something like path.php then upload it to your website, browse to it and it will show you the exact path to your sites root.
   
   
   
3. Appears to login ok, but wont show you as logged in
   Often caused by the vB cookie path setting.
   To fix log into you vB admin area;
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   
   
4. Subdomains and cross site logins
   This is a known issue with many scripts (not just this one), sometimes fixable sometimes not. Its caused by vB, PHP and your hosts security measures.
   
   First change your "cookie domain" settings.
   vB Admin > Control Panel > Cookies and HTTP Header Options > Cookie Domain
   Change it from being blank to
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   You may need to set a post referrer in your whitelist.
   vB Admin > Control Panel > General Settings > Post Referrer Whitelist
   Instructions on what to enter are listed where you change this setting.
   
   That should fix it if your forum is a subdomain.
   
   If that fails then,
   Open your /forum/login.php file and look for this code:
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   Below that add
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   Now save this and overwrite the file on the server with this one.
   
   A further reported work around is to make a copy of the required Forum Forum files on your second Server. Then you must set in the config.php on the second server to use the ip of the server with which the VB-Database is running.
   
   
   
5. 404 Error on expiring passwords
   Cause - When redirected for expired password you are redirected to the directory that your login script is located in, not your forums root.
   
   Fix - Edit phrase called
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   Your current phrase should be
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   change it to
   
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   where ../forums/ is your forums directory.
   
   
   
6. Still got problems?
   It may be a conflict with somthing already in your site.
   To check this we can just make a simple page.
   Call it test.php and use just this code in it.
   (Make sure there is no whitespace before the 1st line)
   
   

   Block Disabled:      (Update License Status)
   Suspended or Unlicensed Members Cannot View Code.

   
   Naturally, change paths to fit your forums, then upload it.
   Browse to it and run it.

[thepub]

thanks!

[projectego]

Great work. Thanks!

[JamieLee2k]

Any chance of seeing a demo of some kind, I am wanting a login page for my homepage in which users can see there info on the homepage like PM's new posts, etc....

[Billspaintball]

Originally Posted by JamieLee2k

I am wanting a login page for my homepage in which users can see there info on the homepage like PM's new posts, etc....

Use my 3.5 hack - (also works fine on 3.6) for that
See my sig for link to it.

[JamieLee2k]

But if I am using 3.6 why do I need to use 3.5 if the hack is pretty much the same, if not the same?

Also I want the hack for HTML pages, if thats possible

[Billspaintball]

Originally Posted by JamieLee2k

But if I am using 3.6 why do I need to use 3.5 if the hack is pretty much the same, if not the same?p

The 3.5 deluxe version http://www.vbulletin.org/forum/showthread.php?t=108026 has the extra stuff that you wanted like PM's
It also works fine with all versions of vB 3.6

Also I want the hack for HTML pages, if thats possible

No. It only works on PHP pages.

[Gastongr]

Awesome work!, thanks so much.

[mathias]

i've got it working, but only when i remove my other script that i have to call which is require_once('./vBExternal.php'); for another add-on....how do i stop the top part of the login code

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

from conflicting with the vBExternal? i found this is the only way i can do it.... otherwise the main page doesn't remember the user if i put the full url to the .php that includes the login page code with the

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

[Billspaintball]

Originally Posted by mathias

from conflicting with the vBExternal? i found this is the only way i can do it

Yes there is a conflict between this and vB external.
We tried to track it down with an earlier release of this but with no luck.

A workaround others have used is use vBexternal for the front page and this hack on the rest to provide access control.

[mathias]

Originally Posted by Billspaintball

Yes there is a conflict between this and vB external.
We tried to track it down with an earlier release of this but with no luck.

A workaround others have used is use vBexternal for the front page and this hack on the rest to provide access control.

np, thanks for that

[unit3029]

Just what the docotor ordered Great hack

Thanks

[Osterling]

It works great! I have one question however, how can I display the username?

[Billspaintball]

Originally Posted by Osterling

It works great! I have one question however, how can I display the username?

To display the username just put

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

in the page where you want it.