vB Survey (UCCASS Survey app integration)

What this hack does:

This hack will add a full featured survey application system to your forum.

Credits: John W. Holmes: Author of UCCASS Survey.

Application Features: See the UCCASS site for full details. After testing several survey apps, this one is the best:

http://www.bigredspark.com/survey.html

The UCCASS offers some advanced features such as branching conditionals (allows hiding/displaying questions based on specific answers), result filtrations and much more.

Integration features:
Replaced authentication with VB's user database
Set permissions per usergroup, for admin/edit/create/take and view results priviliges.
Replaced config files with vB admin settings
Applied vB style to the UCCASS templates (it uses Smarty)

vB Survey added features:
Added anonymity option. If a survey is not anonymous, members can see how other members answered.
Added Hide/unhide survey option
Added Date answer types (D), with dropdown lists for day, month, year to ensure correct date entry.
Added REGEX control for new answer types, to control the answer format.
Added size control for single like text answers and REGEX answers.

Liscense: The original UCCASS Survey application is released under a modified GPL Liscense (Aferro GPL) : http://www.bigredspark.com/survey/license.txt (or look under the /docs directory in the zip file)

Installation difficulty:
o File changes: None
o DB changes: No changes, 19 new tables

Installation:

• Unpack the included file
• Copy vbsurvey_install.php to your admincp directory
• Copy survey.php to your main forum directory
• Copy the survey directory below your forum directory (cannot change the directory name)
• run the vbsurvey_install.php script in the admincp directory
• Go to AdminCP => vBulletin Options => vB Survey (UCCASS) and set the toptions for acess and other settings
• If you get permission errors, change file permissions for the survey directory and its contents to 744, and the owner/group to apache:apache (or, some servers are setup to nobody:nobody):

cd /path/to/main/forum
chown -R apache:apache survey
chmod -R 744 survey

Added in v1.5.4 (October, 17, 2005
Now checks primary and secondary permisisons.

Added in v1.5.3 (August 26, 2005
Don't show edit box unless user has permission.

Added in v1.5 (June 7th, 2005

• Added a new answer type R, for Regular Expressions (REGEX). This will allow new types to be defined for answers, with controlled format. If the question is required, users will receive an error messages, until they enter the proper format. If the question is optional, the users will only get an error if they try to answer the question, but with the wrong format.
  Note: You can disable REGEX type questions by editing the templates.
• The Size of type 'S' (Sentence) can now be changed, and no longer hardcoded as 50 characters.
• To upgrade, you will need to run the upgrade option in the installation script and re-upload all the files.

Added in v1.3 (June 5th, 2005

• Added a new answer type D, for Dates. This will show 3 dropdown lists for day, month, year, to ensure a uniform formate for dates entered by the user, instead of a text box.
• Fixed a bug in the anonymous message display. It would state survey is not anonymous, when it actually is.
• To upgrade, just re-upload the files (classes and templates directories)

Added in v1.2 (June 4th, 2005)

• Removed the "Previous page" button, if the page is the first page of a survey.
• Answers in the new/edit answer page are sorted by the numeric value. This allows you to add a later value, but set the order higher, without re-editing the whole list to arrange it.
• Fixed a bug in quotes and escapes in the answer types edit.
• Upgrade instructions: Just re-upload the classes directory.

Added in v1.1 (June 4th, 2005)

• Added anonymity option. This is decided when creating the survey. Once set, it cannot be changed. If the survey is not anonymous, users will see on the survey intro a message that they survey is not anonymous, and that their usernames will show in the results table. The results table will show the usernames and a link to their profile.
• Added Hidden option: By default, all active surveys show up on the main page as available surveys. If you set the survey propert to hidden, the survey can still be active, but not show up for members. This can be useful if you want to email the link to a selected user group. Admins and the survey author will still be able to see hidden surveys.
• Navbar update to list the various locations in the survey pages.
• The previous version showed the "no permission" to guests. Now you can allow guests to view the surveys and results by putting usergoup 0 in the admin panel in usergroups who may see the results. But other priviliges will be ignored.
• A couple of bug fixes
• Upgrade instructions: Just re-upload all the files, including survey.php

Notes:
1. If you use FTP to upload the survey directory, you might have problems with subdirectories under /survey/smarty/template_c due to the directory names with % signs. In this case, you can delete all the directories under template_c (but not the template_c directory itself). Those subdirectories will be recreated automatically when the templates are read.

2. The "do not remove" comment on the copyright link in the footer is from the original UCCASS footer template. You may contac the original author, John W. Holmes, for permission to remove the copyright notice, he's willing to talk according to their support forum.

[subnet_rx]

Another quick question. I have certain surveys marked as hidden and inactive, yet they still show up for everyone on the Edit Survey menu. Is there a way to hide this entire menu if the usergroup doesn't have permission to edit any surveys?

[tamarian]

Originally Posted by subnet_rx

Another quick question. I have certain surveys marked as hidden and inactive, yet they still show up for everyone on the Edit Survey menu. Is there a way to hide this entire menu if the usergroup doesn't have permission to edit any surveys?

Open classes/survey.class.php and find:

PHP Code:

        $this->smarty->assign_by_ref('show',$show); 


Add befor it:

PHP Code:

        if($this->_hasPriv(EDIT_PRIV))
        { $show['edit_survey'] = TRUE; }
        else
        { $show['edit_survey'] = FALSE; } 


then open templates/Default/available_surveys.tpl and find:

	<tr>
		<td class="panelsurround" align="center">
		<div class="panel">
		<div style="width:{$stylevar.formwidth}" align="{$stylevar.left}">
			
				<fieldset class="fieldset">
					<legend> Edit Surveys </legend>
					<table cellpadding="0" cellspacing="{$stylevar.formspacer}" border="0" width="100%">
					<tr>
						<td>  
                                                <form class="indented_cell" method="get" action="{$conf.html}/survey.php?do=edit_survey">
                                                        <input type="hidden" name="do" value="edit_survey">
                                                        <input type="hidden" name="s" value="{$session.dbsessionhash}" />
                                                        Survey:&nbsp;
                                                        <select name="sid" size="1">
                                                        {section name="as" loop=$survey.all_surveys.sid}
                                                        <option value="{$survey.all_surveys.sid[as]}">{$survey.all_surveys.name[as]}</option>
                                                        {/section}
                                                        </select>
                                                        &nbsp;<input type="submit" name="submit" value="Edit Survey">
                                                </form>                                           
						</td>
					</tr>
					</table>
				</fieldset>                                
			</div>
		</div>
		</td>
	</tr>

And replace with this:

        {section name="create_link" show=$show.edit_survey}        
	<tr>
		<td class="panelsurround" align="center">
		<div class="panel">
		<div style="width:{$stylevar.formwidth}" align="{$stylevar.left}">
			
				<fieldset class="fieldset">
					<legend> Edit Surveys </legend>
					<table cellpadding="0" cellspacing="{$stylevar.formspacer}" border="0" width="100%">
					<tr>
						<td>  
                                                <form class="indented_cell" method="get" action="{$conf.html}/survey.php?do=edit_survey">
                                                        <input type="hidden" name="do" value="edit_survey">
                                                        <input type="hidden" name="s" value="{$session.dbsessionhash}" />
                                                        Survey:&nbsp;
                                                        <select name="sid" size="1">
                                                        {section name="as" loop=$survey.all_surveys.sid}
                                                        <option value="{$survey.all_surveys.sid[as]}">{$survey.all_surveys.name[as]}</option>
                                                        {/section}
                                                        </select>
                                                        &nbsp;<input type="submit" name="submit" value="Edit Survey">
                                                </form>                                           
						</td>
					</tr>
					</table>
				</fieldset>                                
			</div>
		</div>
		</td>
	</tr>
        {/section}

[subnet_rx]

that worked great, I'd recommend that fix for future releases.

[subnet_rx]

Guess I have yet another question. I have survey questions that are two dependencies deep. Meaning if they answer yes to one, the next is shown, and a yes to that, then the next is shown. Only, the third is shown whether the second is a yes or no. Any idea what could be going on? I have the third question setup on the dependency that the second is a yes.

[tamarian]

Originally Posted by subnet_rx

Guess I have yet another question. I have survey questions that are two dependencies deep. Meaning if they answer yes to one, the next is shown, and a yes to that, then the next is shown. Only, the third is shown whether the second is a yes or no. Any idea what could be going on? I have the third question setup on the dependency that the second is a yes.

No idea, as I have not used dependencies. Best thing is to check the docs, or post in the UCCASS forum:

http://www.bigredspark.com/forums/

[eljeffe]

Aside from me going into the database and updating the vb3_vbsurvey_completed table by hand, is there a way I can flag surveys that can be taken multiple times?

We have a situation where we want to survey multiple instances of the same event. In our example, we want to survey the owner each time a certain component fails. Since we have some users who have had multiple failures of this component, we would like to get their survey information for each failure. Currently, the survey only allows a user to take it once.

I can update the table manually, but I didn't know if there was a mechanism that I am missing, or an untapped feature that is not enabled to allow for this.

Thanks!

This is one of our favorite hacks!

[tamarian]

Originally Posted by eljeffe

Aside from me going into the database and updating the vb3_vbsurvey_completed table by hand, is there a way I can flag surveys that can be taken multiple times?

We have a situation where we want to survey multiple instances of the same event. In our example, we want to survey the owner each time a certain component fails. Since we have some users who have had multiple failures of this component, we would like to get their survey information for each failure. Currently, the survey only allows a user to take it once.

I can update the table manually, but I didn't know if there was a mechanism that I am missing, or an untapped feature that is not enabled to allow for this.

Try this, in survey/classes/survey.class.php delete or comment this line:

PHP Code:

        if($check === ALREADY_COMPLETED) eval(print_standard_error("You have already completed the requested survey.", 0)); 


I haven't tried it, but it should allow a user to take the survey multiple times.

[eljeffe]

Originally Posted by tamarian

Try this, in survey/classes/survey.class.php delete or comment this line:

PHP Code:

        if($check === ALREADY_COMPLETED) eval(print_standard_error("You have already completed the requested survey.", 0)); 


I haven't tried it, but it should allow a user to take the survey multiple times.

Thanks, man! That worked! As always, you've got the answers!

[SirJonathan]

Hey there!

I've been using Erwin's hack for almost a year now to accept 'Membership Applications' and post them to an Admin only viewing area. From there we would approve or deny the applications and grant access to the members.

The trouble with that is that it doesn't post for an alarmingly high amount of applicants.. They hit submit, and for some reason or another it just doesn't post!

So I'm wondering if the results from this survey tool as each user fills out the 'application' could be posted as a new thread in a private forum?

Thanks! I'm really anxious to find a solution .

-Jonathan

[tamarian]

Originally Posted by SirJonathan

So I'm wondering if the results from this survey tool as each user fills out the 'application' could be posted as a new thread in a private forum?

It's doable/hackable, but not streight forward.