Integration with vBulletin - MediaWiki/vBulletin Single Sign-On

Overview:
This hack provides single sign-on capability for MediaWiki using your vBulletin users. You must ensure your cookie path in Admin CP is set to '/' for this to work. Also, I have not tested this if your wiki and your forums are on different subdomains - but as long as your have your cookie domain set properly it *should* work. This is not a user bridge - it is a complete single sign-on using your vBulletin user repository.

The install process has been extremely simplified in version 2.x of this product. You only have to edit LocalSettings.php, import a product, and change a setting in your Admin Control Panel. It's been completely packaged as a vBulletin product - unlike the previous hacked up version, heh. I didn't originally plan to release this so I designed it so it worked - not so it could be redistributed. I searched high and low for a functional MediaWiki bridge - almost bought NuHIT's product, and then realized it had been abandoned for over a year.

This hack no longer requires an edit to class_core.php.

I'll do my best to support it, but I can make no promises.

This thread is for discussion of this mod on vB 3.7.x. For vB 3.8.x, please use the MediaWiki/vBulletin Single Sign-On 3.8 thread

Demo of plugin in action: MyMMOGames - Multiplayer Gaming and Media Community

Also, if you use memcached - ensure you do not cache sessions. If you do, restart it at least once a week. If you don't, you'll end up with invalid session errors out of MediaWiki.

Requirements:
MediaWiki Version: 1.11.0-1.14.0
vBulletin Version: 3.6.9-3.8.2

Features:
- Provides single sign on capability between vBulletin and Mediawiki. vBulletin user repository is used
- Configurable sysop/bureaucrat groups
- Configurable disallowed user groups
- Configurable "Who's Online" display
- Counts users viewing wiki in vBulletin's "Who's Online"

Installation/Upgrade:
Please read the included "readme.txt" file in the "docs (do not upload)" folder.

Options:
Admin Control Panel->vBulletin Options->MMOG Wiki Options

Change Log:
1.0.0.0 - Sep 18, 2008
- Initial Release

1.0.3.0 - Sep 29, 2008
- Bugfix: Incorrect redirects for login/logout

2.0.0.0 - Sep 30, 2008
- Feature: Streamlined installation procedure
- Feature: Wiki path set in ACP
- Bugfix: Forum paths no longer hardcoded

2.1.0 - Oct 4, 2008
- Feature: ACP option to use MediaWiki Short URLs
- Feature: ACP option to set sysop groups
- Feature: ACP option to set bureaucrat groups
- Feature: ACP option to disallow login to certain groups
- Feature: ACP option to change WOL display text

2.2.0 - May 1, 2005
- Bugfix: Users are not logged out when logging out of the forum
- Bugfix: No longer requires modification to class_core.php
- Feature: Mediawiki 1.13.0+ supported (verified on 1.14.0 also)

If you like it, please click "mark as installed" The more people that use this, the more time I will make to try and support/update it.

Been pulling your hair out looking for this as long as I have? Nominate it for Mod of the Month =]

AuthPlugin was inspired by and modified from this existing MediaWiki Extension:

http://www.mediawiki.org/wiki/Extension:QISSingleSignOn

[NoeJeko]

To do it as I did, you have to modify an existing wiki skin or create your own. It's a fair amount of work since MediaWiki uses absolute positioning and that's outside the scope of this plugin. Sorry, but I just don't have time for requests such as this.

[leonnix]

I can try to do it on my own ! I just need your tips on this; cause I don't know where to begin !

[NoeJeko]

Sorry but I really don't know what to tell you - you can just do what I did and modify one of the existing MediaWiki skins. I used MonoBook.

It's possible, but unlikely, that this could develop into a full integration (skin/users/etc) one day but I'm really not inclined to do that as it works as I have it. Hopefully the vB team will take my request into consideration so I can just package this as one product and one wiki plugin.

[BRotondi]

Thanks for this Addon! It is really, what I searched for ... and I also almost bought vbWiki Pro.

I also changed the following, which perhaps also helps other users:
a) Before each Forum description I add a Link "wiki" which referrs to the wiki page oft this forum

• ACP -> Foren -> before each description <a href="../wiki/index.php?search=TITLE&go=Seite">Wiki</a>&nbsp;&nbsp;

b) Added a wiki-Button in the Editor with a customized BB-Tag (save to images/editor/wiki.gif)

• ACP -> BB-Codes
  • BB-Code [wiki=Thema]Beschreibung[/wiki]
  • HTML-Code <a href="../wiki/index.php?search={option}&go=Seite">{param}</a>
  • Image: wiki.gif

This is my part to say thanks

Are there other interesting MediaWiki-Integration-Hacks?

Thanks!
Bruno

[BRotondi]

In your Readme some things are unclear:
STEP 3
Edit LocalSettings.php.
-> Do you mean the one on the wiki-root?

Add this line after DefaultSettings
-> do you mean after require_once( "includes/DefaultSettings.php" );?

Now, change/add this setting:
$wgGroupPermissions['*']['createaccount'] = false;
-> do you mean after require_once( "$IP/includes/AuthPlugin_vBSSO.php" );
STEP 4
Edit class_core.php
-> do you mean [vB]/includes/class_core.php

STEP 5
Import the product
-> do you mean ACP -> Addons&Plugins -> Addons -> Upload from your Computer

Edit the plugin "MMOG Wiki: Online Location Hack"
-> This I do not understand at all...

I'm new in Hacks, but perhaps not the only one, so perhaps also others are unsure on what to do...
But anyway 1001 Thanks for the Hack!!

Bruno

[BRotondi]

I skipped the red step above and tested what I've done yet:
- vBulletin still works
- wiki first not, but the problem was obvious:

_________________________________
Warning: require_once(/sinnimleben.net/forum/global.php) [function.require-once]: failed to open stream: No such file or directory in /home/.lukey/br_noreply/sinnimleben.net/wiki/includes/AuthPlugin_vBSSO.php on line 257

Fatal error: require_once() [function.require]: Failed opening required '/sinnimleben.net/forum/global.php' (include_path='/home/.lukey/br_noreply/sinnimleben.net/wiki:/home/.lukey/br_noreply/sinnimleben.net/wiki/includes:/home/.lukey/br_noreply/sinnimleben.net/wiki/languages:.:/usr/local/php5/lib/php:/usr/local/lib/php') in /home/.lukey/br_noreply/sinnimleben.net/wiki/includes/AuthPlugin_vBSSO.php on line 257
_________________________________

I realized that the FTP-Path seems not to be the same like the server path. So I changed in STEP 1
define( VB_SYSTEM_PATH, '/sinnimleben.net/forum' );
to
define( VB_SYSTEM_PATH, '/home/.lukey/br_noreply/sinnimleben.net/forum' );

Now Wiki works , have to test the Hack itself

But this is also unclear: Now my users will have to register only in wiki or only in VB?

Thanks!
Bruno

[BRotondi]

(Sorry for all these messages, but with 45 downloads and 15 installs perhaps it's written really a little complicated...)

Now I cannot logoff in wiki any more, after pressing "log off" (or "sign out", here I have only german...) I got this error:
The requested URL /login.php was not found on this server.

I installed wiki to /home/.lukey/br_noreply/sinnimleben.net/wiki
and vB to /home/.lukey/br_noreply/sinnimleben.net/forum

The Link under "logout" points to http://www.sinnimleben.net/login.php?do=logout&...
which of course is false... must try to find out where I have to fix that...

Thanks for any help!
Bruno

[NoeJeko]

Wow.. that's a lot of questions and many of which I thought were ... rather obvious but I'll do my best to answer them.

Originally Posted by BRotondi

In your Readme some things are unclear:
STEP 3
Edit LocalSettings.php.
-> Do you mean the one on the wiki-root?

There should only be one LocalSettings.php and yes it is located on the wiki root.

Originally Posted by BRotondi

Add this line after DefaultSettings
-> do you mean after require_once( "includes/DefaultSettings.php" );?

Yes, there should be only one reference to DefaultSettings in that file and that's it.

Originally Posted by BRotondi

Now, change/add this setting:
$wgGroupPermissions['*']['createaccount'] = false;

Originally Posted by BRotondi

-> do you mean after require_once( "$IP/includes/AuthPlugin_vBSSO.php" );

Wherever in LocalSettings that the other account permissions are set. Look for the other similar lines and add it there. I can't give you an exact line number because your LocalSettings will be different than mine.

Originally Posted by BRotondi

STEP 4
Edit class_core.php
-> do you mean [vB]/includes/class_core.php

There should be only one class_core.php and yes, this is where it is located.

Originally Posted by BRotondi

STEP 5
Import the product
-> do you mean ACP -> Addons&Plugins -> Addons -> Upload from your Computer

Yes.

Originally Posted by BRotondi

Edit the plugin "MMOG Wiki: Online Location Hack"
-> This I do not understand at all...

I'm new in Hacks, but perhaps not the only one, so perhaps also others are unsure on what to do...
But anyway 1001 Thanks for the Hack!!

Bruno

ACP->Edit Plugins->MMOG Wiki: Online Location Hack

Originally Posted by BRotondi

(Sorry for all these messages, but with 45 downloads and 15 installs perhaps it's written really a little complicated...)

Yes, that's why I said it was cumbersome. I explained why it was complicated in the first post.

Originally Posted by BRotondi

Now I cannot logoff in wiki any more, after pressing "log off" (or "sign out", here I have only german...) I got this error:
The requested URL /login.php was not found on this server.

I installed wiki to /home/.lukey/br_noreply/sinnimleben.net/wiki
and vB to /home/.lukey/br_noreply/sinnimleben.net/forum

Thanks for any help!
Bruno

[S]You didn't properly follow step 2 of the instructions if you're getting this error.[/S]

My mistake - this will be caused if you didn't properly set $vbsso_forumpath in AuthPlugin_vBSSO.php.

[BRotondi]

I still need your help:

Originally Posted by NoeJeko

Wherever in LocalSettings that the other account permissions are set. Look for the other similar lines and add it there.

Sorry, I do not understand, what you mean... There is no line with Permissions or account (see Attachement)

Originally Posted by NoeJeko

this will be caused if you didn't properly set $vbsso_forumpath in AuthPlugin_vBSSO.php.

AuthPlugin_vBSSO.php seems correct:
define( VB_SYSTEM_PATH, '/home/.lukey/br_noreply/sinnimleben.net/forum' );
$vbsso_forumpath = '/forum';

and also Userlogin.php, which already was set up correct:
$vbsso_forumpath = '/forum';
$vbsso_wikipath = '/wiki';

Originally Posted by NoeJeko

ACP->Edit Plugins->MMOG Wiki: Online Location Hack

I changed nothing since /wiki/ ist correct...

Thanks for further helps!
Bruno

[NoeJeko]

You can skip that step; however users will show up in your "Who's Online" list as "Unknown Location" for moderators and "Viewing Index" for users.

Also, there was an error in the original AuthPlugin_vBSSO.php - a global variable was not declared as global. I have updated the plugin as necessary; please download the latest copy of it and make the required changes. Only AuthPlugin_vBSSO.php and the MMOG Wiki plugins were changed; there is no need to update Userlogin.php. I visited your forum and was able to register an account - then go to the wiki and edit my User:talk page without creating a new wiki account so it's working. This should give you the logout link functionality.

Thanks for helping me find this bug!