Authentication System
Roster 1.6
Authentication System v 1.2
Requirements:
addonAdmin
The authentication system is a bridge between the popular Content Management System/Forums (I will use the term CMS for both) and the roster. Its sole purpose, without modification, is to supply addons with the character name of the currently logged in user.
It enables addons to offer individualized services to users as demonstrated in my addons.
This may well be one of the most unstable addons due to great amount of variables such as PHP version, MySQL version, Roster version, server setup, operating system and the most uncertain variables of version & settings of the CMS used (not to mention modifications to CMS and/or Roster).
I have made the best effort to keep this addon up to date and added flexibility wherever possible.
This version is a major milestone as I have redeveloped almost every CMS’s auth routine and had much constructive feedback from those willing to beta test this version on their own servers. I’d like to thank you all for that.
There are currently auth routines for the following CMS:
e107 v6xx
e107 v7xx
PHPBB2
PHP Nuke
Post Nuke
Dragonfly
Woltlab Burning Board
Invision Power Board
vBulletin
Unclassified News Board
PHPFusion
Simple Machines Forum
MiniBB
Tikiwiki
Is
the Roster database separate from your CMS database?
Extra
char name field, that’s where your users can put their WoW main char name:
It is assumed that addonAdmin is already installed.
Unzip the zip into the addons folder, which should create and fill the “authenticationSystem” folder.
Use the [Install] link in addon Admin to install this addon.
Configuration
Use the [Configure Addon] link in addon Admin to start the configuration process.
Step 1
Is the Roster database separate from your CMS database?
Select [Yes] if your roster tables are in a different database as your CMS’s tables.
This will ask you to enter credentials for your CMS’s database on the next page.
Select [No] if your roster tables are in the same database as your CMS’s tables.
This will use the same credentials as the roster to access the CMS’s tables.
Step 2 [No]
If [No] was your answer, you will now be asked to select your CMS from a dropdown list.
CMS table prefix:
Enter the table prefix including the underscore _
Example:
phpbb_ is the prefix
Extra char name field, that’s where your users can put their WoW main char name:
Select the field in which you will put your main char’s name if it’s not in your username already. This setting is only explicitly followed by a few auth routines; most search all of these fields (and a few more, depending on CMS) for a char name.
Step2 [Yes]
If [Yes] was your answer, you will now be asked to enter all details necessary to connect to your MySQL server and CMS database.
First, select your CMS from the dropdown list.
CMS DB User Name:
That is the username to your MySQL server account (or your CMS database if your security is tight)
CMS DB Password:
That is the password to your MySQL server account (or your CMS database if your security is tight)
CMS DB Name:
That is the name of your CMS’s database
CMS DB Host:
That is the name of your MySQL host, usually localhost, could also be an IP like 127.0.0.1 (same as localhost) or a URI/IP to a remote host.
CMS table prefix:
Enter the table prefix including the underscore _
Example:
phpbb_ is the prefix
Extra char name field:
Select the field in which you will put your main character’s name if it’s not your username already. This setting is only explicitly followed by a few auth routines; most search all of these fields (and a few more, depending on CMS) for a char name.
It is an alternate field besides the username to put the main char’s name.
Step 3
There are a few necessary or optional settings for certain CMS’s that have to be set before the configuration is complete. If your CMS is one of them this page will come next, otherwise you will see the summary page.
UNB - Unclassified News Board
You are asked to enter the Program ID, which can be found in the board.conf.php file which is located in the folder where you installed your UNB forum into.
Open that file and search for prog_id= , enter the value you find after the = into this textbox.
MiniBB
Since MiniBB is minimalist by design it doesn’t provide the means to configure the board internal settings trough a website. That means that you have to open the file setup_options.php which is located in MiniBB’s main folder.
1. Search for $cookiename=
and set it to: $cookiename=\'miniBBsite\';
2. Search for $cookiepath= and set it to: $cookiepath=\'/\';
Save and close the file.
Cookie Prefix
If your CMS is capable of changing its cookie name or prefix trough the admin panel then you should see a message for your CMS, telling you that you should enter the cookie name/prefix into the text field. It also tells you what the default cookie name/prefix is, in case you didn’t change anything in your CMS (be sure to check, your host might have set the script for your CMS’s creation to include custom cookie names/prefixes).
Summary Page
Here you see the settings listed as they are stored in the database.
The button [Reset all settings] will delete all settings from the database and start the configuration process over.
Notes
The included zip file 2992.zip includes a mod for phpbb2 boards that allows them to add character details to their profiles. This is really optional.
The reason why its here is because the main char’s names in those profiles are being read by the phpbb2 auth routine, so that’s an alternative place to put the main’s name.