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!!

[FFTFTCEd]

I got mine working, or I should say one of my Admins got it working, the Thread Body text has to be edited to match your questions or it will return gibberish. Below is what he put in ours, which returns all the fields correctly;

PHP Code:

[size=5][color=#87F717][b]Character Information - {{user_name}} ( {{user_id}} ) [/b][/color][/size]

[b][color=#CCFB5D]Character name:[/color][/b] {{character_name}}
[b][color=#CCFB5D]Age:[/color][/b] {{your_age}}
[b][color=#CCFB5D]Time zone:[/color][/b] {{your_timezone}}

[b][color=#CCFB5D]Considered HCOs:[/color][/b]
{{considered_HCOs}}
[b][color=#CCFB5D]Likes PR:[/color][/b] {{like_pr}}
[b][color=#CCFB5D]Have Time:[/color][/b] {{have_time}}
[b][color=#CCFB5D]Team Management Experience PR:[/color][/b] {{team_mgmt_exp}}
[b][color=#CCFB5D]Personel Changes:[/color][/b] {{personel_changes}}
[b][color=#CCFB5D]Bridge Communications:[/color][/b] {{communication_bridge}}
[b][color=#CCFB5D]Previous Member of:[/color][/b] {{previous_communities}}

[b][color=#CCFB5D]Leadership Roles:[/color][/b] {{leadership_roles}}

[b][color=#CCFB5D]PR Likes:[/color][/b] 
{{pr_likes}}

[b][color=#CCFB5D]Purpose For Being General:[/color][/b]
{{purpose_general}}

[b][color=#CCFB5D]Other Comments:[/color][/b] 
{{other_comments}}

[b][color=#CCFB5D]Agrees to rules:[/color][/b] {{agrees_rules}} 


You will have to change the questions to what ever you put in the xml file, which also has to be edited for your needs. Open it with Dreamweaver or some other xml editor and change the questions to fit your needs, then edit the Thread Body to match, it should work.

I've also attached our xml file, you can compare it to the original sent to you by the mod maker, you can simple edit this one to fit your needs, add more questions, ect...

Hope this helps.

[FFTFTCEd]

I do have one question, I have mine set up to post applications for General, which it does fine. It post them in the Admin section of my forums, which is again what I want.

But.... it sends out an email to the person who submitted the form every time we comment on it with the details of that post, kinda like subscribing to this thread and getting an email every time some one makes a new post. I want my Admins to be able to post their comments without this information being sent back to the applicant.

How do I disable this feature??

[X672]

Just wanted to say thanks for this very nice mod

[Chat]

Wtb 4.03 update to this. Just sayin.

[JazM]

Yes wtb for 4.04 please!

[JasonReynolds]

I wonder, can you get this to change so that a user can have a application. Say like they register and sign up their guilds information on their guilds group they can have this application forum?

[sweede]

Originally Posted by JasonReynolds

I wonder, can you get this to change so that a user can have a application. Say like they register and sign up their guilds information on their guilds group they can have this application forum?

with a little bit of php knowledge it wouldn't be hard to do that. I won't make it a feature though, because it depends entirely on your custom setup for your site.