Add-On Releases - Online Gaming Recruitment Application System

This is a modification originally developed for 3.6.x for websites wishing to use an application, although originally designed for world of warcraft it can be used for any game.

This Mod only officially works with 3.6... but since this is open code. anyone can take the code and make it work for 3.7 and re-publish it... with credits ofcourse.

I have had this modification for a long time and only today decided to release it to the public hoping somebody might want to carry on its developement because i just dont have time, so feel free to modify the code and re-release it under a different name but please give credit.

Install

• Unzip "product-vgat" from the "OTD Application System" folder.
• Navigate to "Plugins & Products" in your vbulletin control pannel and then "Manage Plugins"
• Upload the "product-vgat" plugin

Your product is now installed and ready for configuration.

Main Configuration (refresh website after plugin installation first)

• from your vbulletin admin panel go into your Vbulletin options and scroll down to "Guild Application Form Options"
• configure "form url" and "forum location" to your own preference

Field checking has not really been fully tested or developed so you may encounter bugs while using "Non Empty Fields", "Numeric Fields", "Boolean Fields", The rest is fully tested and operational!!!!

How To Configuring Your Application Questions
The thing that makes my application system good is that its VERY easy to add and delete questions by yourself with minimal programming knowlege, mostly just copy and paste and change the question

• go into "Style & Templates" and then into "Style Manager" and "Edit" the template you will be using.
• scroll down to "vgat_form" and double click

This is were you add, edit and delete all your questions which will be required when a visitor fills out their application, I will try my best to explain how to add the following questions: Radio Button, CheckBox, Single Line Text Box, Multiline Text Box, Drop-Down Menu

Radio Button Question Example

<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
		<tr>
			
			
				<td class="alt1 wowsl" valign="center" width=50%>
				I Am a Human
				</td>
				<td class="alt1 wowsc" valign="center" width=50%>
				<center>
					<input type="radio" name="q_Human" value="No"  /> No 
					<input type="radio" name="q_Human" value="Yes"  /> Yes 
				</center>

				</td>
			
		</tr>
</table>

Question = "I Am a Human"
Question Name = q_Human You need to write down the "Question Name" for EVERY question you make because you will need it later when we design your output tmplate which gets posted on your forum
Input Type = radio Indicates that this question is a Radio Button

Check-Box Question Example

<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
		<tr>
			
			
				<td class="alt1 wowsl" valign="center" width=50%>
				What is your favurite colours:
				</td>
				<td class="alt1 wowsc" valign="center" width=50%>
				<center>
					<input type="checkbox" name="q_colour_red" value="red"  /> red 
					<input type="checkbox" name="q_colour_green" value="green"  /> green
					<input type="checkbox" name="q_colour_blue" value="blue"  /> blue
					<input type="checkbox" name="q_volour_pink" value="pink"  /> pink
				</center>

				</td>
			
		</tr>
</table>

Drop-Down Menu Question Example
"q_ConnectionType" is your name in this instance, which you will need later

<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
	
			<tr>
				<td class="alt1 wowsl" valign="center" width=50%>	
				What type of Internet Connection do you use:
				</td>
				<td class="alt1 wowsc" valign="center" width=50%>
				<center>
				<select name="q_ConnectionType">
				<option value="--" ></option>
				<option value="Dialup" >Dialup</option>
				<option value="ISDN" >ISDN</option>
				<option value="DSL" >DSL</option>
				<option value="Cable" >Cable</option>
				<option value="Faster than Cable" >Faster than Cable</option>
				</select>

				</center>
				</td>
			</tr>
</table>

Single Line Text Box Question Example

		<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
				<td class="alt1 wowsl" valign="center" width=50%>	
				What is your Character name?
				</td>

				<td class="alt1 wowsc" valign="center" width=50%>
				<center>
				<input type="text" size="25" value="" name="q_CharacterName" />
				</center>
				</td>
			</tr>
		</table>

Multi-Line Text Box Question Example

		<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
			<tr>
				<td class="alt2 wowpl" valign="center">	
				Please describe what you like about the game and your character.
				</td>
			</tr>
			<tr>

				<td class="alt1 wowsc" valign="center">
				<center>
				<textarea rows="5" cols="70" name="q_LikeAboutTheGame"></textarea>
				</center>
				</td>
			</tr>
		</table>

Now i will explain how to configure your output file which will be posted on the forums.

• Go back in to your "Guild Application Form Options" panel
• Scroll down to the "Thread Body" panel

Example Code

[ size=5][ color=#87F717][ b]Character Information[/b][/color][/size]


[b ][u ][ color=#B1FB17]Armory Link[/color][/u][/b] - {{q_ArmoryLink}}
[b ][u ][ color=#B1FB17]Recent WWS Report[/color][/u][/b] - {{q_WWS}}


[b ][ color=#CCFB5D]Character name:[/color][/b] {{q_CharacterName}}
[b ][ color=#CCFB5D]Character Class:[/color][/b] {{q_CharacterClass}}
[b ][ color=#CCFB5D]Character Level:[/color][/b] {{q_CharacterLevel}}

As you can see the Names of the questions i told you to write down are done like "{{q_CharacterName}}" between {{}}.

You can also have thread titles look like the following:

Application from {{q_CharacterName}} Class: {{q_CharacterClass}}

::Making the application system work with 3.7.x::

• Access Admin Panel and navigate to your Style Manager and edit the style you use.
• Scroll down to "vgat_form" and Access

Find Line:

<input type="hidden" value="1" name="agree" />

Below it Add:

<input type="hidden" name="s" value="$session[sessionhash]" />
<input type="hidden" name="securitytoken" value="$bbuserinfo[securitytoken]" />

SAVE....

Scroll down the list again and find "vgat_rules" and Access.

Find Line

<input type="hidden" name="s" value="$session[sessionhash]" />

Below it Add:

<input type="hidden" name="securitytoken" value="$bbuserinfo[securitytoken]" />

SAVE....

Done

This Mod only officially works with 3.6... but since this is open code. anyone can take the code and make it work for 3.7 and re-publish it... with credits ofcourse.

Thats about it and im sure you can figure the rest out for yourselves.. i will try and help with any questions you may have.

Enjoy!!

[Gooner]

To add the option via control pannel to dynamically change and add any question would be alot of coding, but i have uploaded an easy to edit template with questions...

Every question is between <Table ---> and ----> </table> so anything between the <Table> code you can delete or just edit to your own question... also i have just added another extra code to try and fix the token error.... download and try>>

"Application System (Different Layout) + 3.6.x-3.7.x.zip "


Example::::

		<table class="tborder" cellpadding="6" cellspacing="0" border="0" width="100%" align="center">
				<td class="alt1 wowsl" valign="center" width=50%>	
				What is your Character name?
				</td>

				<td class="alt1 wowsc" valign="center" width=50%>
				<center>
				<input type="text" size="25" value="" name="q_CharacterName" />
				</center>
				</td>
			</tr>
		</table>

That is 1 question which you can delete or change because it is in between the "Table" coding.

[KURTZ]

i got this now: XML Error: Empty document at Line 1 when i try to install or overwrite ...

[Freddie]

Originally Posted by Gooner

Make sure you have set up the configuring in your Vbulletin Admin panel, you need to create the BBCode output file and choose the forum were you want the application to be posted... and make sure you have the permissions set on that forum to allow registered members to create new threads.

The BBcode is explained in my original post above.

I followed your tutorial indication but it is still doing the way I explained im my previous post

I configured the options, choosing to not send the PMs, the I wrote both Thread body and Thread title with correct field names but nothing happens except resetting fields.
I specified as output forum a registered-only forum.

What am I doing wrong?

Thanks for you help Gooner

[Gooner]

Originally Posted by KURTZ

i got this now: XML Error: Empty document at Line 1 when i try to install or overwrite ...

ok... try download the new XML file i uploaded and follow the "Making it work with 3.7" in the original post which i have just added... i tried it on my forum and i got no errors.. hopefully it will be the same for you.

[Gooner]

Originally Posted by Freddie

I followed your tutorial indication but it is still doing the way I explained im my previous post

I configured the options, choosing to not send the PMs, the I wrote both Thread body and Thread title with correct field names but nothing happens except resetting fields.
I specified as output forum a registered-only forum.

What am I doing wrong?

Thanks for you help Gooner

Are you sure your clicking the "Submit" buttona dn not the "Reset" button?? because i dont see any reason why your form should be resseting unless your triggering it to do so... make sure you click "Submit" and not use your enter key or missclick the Reset button.

[KURTZ]

Originally Posted by Gooner

ok... try download the new XML file i uploaded and follow the "Making it work with 3.7" in the original post which i have just added... i tried it on my forum and i got no errors.. hopefully it will be the same for you.

no way Gooner, it doesn't work ... still Xml line 1 error ...

[Gooner]

Originally Posted by KURTZ

no way Gooner, it doesn't work ... still Xml line 1 error ...

it must be something else specifically to do with 3.7.x then because i have those lines added on my 3.6 board and it works error free... and im unable to troubleshoot it because my lisence has expired and i cannot installed 3.7 untill i pay again... im sure another coder wth 3.7 will be able to solve the issue rather easy though.

[KURTZ]

Originally Posted by Gooner

it must be something else specifically to do with 3.7.x then because i have those lines added on my 3.6 board and it works error free... and im unable to troubleshoot it because my lisence has expired and i cannot installed 3.7 untill i pay again... im sure another coder wth 3.7 will be able to solve the issue rather easy though.

but the first version that you released ran, with the security issue, but ran ...

[Freddie]

Originally Posted by Gooner

Are you sure your clicking the "Submit" buttona dn not the "Reset" button?? because i dont see any reason why your form should be resseting unless your triggering it to do so... make sure you click "Submit" and not use your enter key or missclick the Reset button.

I'm not as good as you in writing Vbulletin hacks but also not so stupid to click a wrong button instead of the correct one
Joking aside, yes, I'm clicking the "Submit" button but nothing happens but a reload with all fields resetted.
I was taking a look into your XML file and I see there is only a management for the !OnError, so maybe I'm getting some error but is not shown.

I'll try to do some attempts with changes I have in mind, but if you have some suggestion to solve this case I would appreciate it a lot

Thanks again.

[Gooner]

Originally Posted by KURTZ

but the first version that you released ran, with the security issue, but ran ...

I changed the template arrangement which might of had some error in it.. but i just uploaded the old original one that definatly works on 3.6 so in theory all you should need to do is add the token error code to both vgat_form & vgat_rules and it should work...