Major Additions - vB Survey: Add a full-featured survey tool to your forum

What this hack does:

This hack will add a full featured survey application system to your forum. You can survey your members opinions on various topics, or allow usergroups to create their own surveys.

Credits: John W. Holmes: Author of UCCASS Survey.
tamarian: Who originally made this a vB hack for vB 3.5

Application Features: See the UCCASS site for full details.

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: (some will be ported back to UCCASS)
Added anonymity option. If a survey is not anonymous, members can see how other members answered.
Added Hide/unhide survey option. This is useful to send surveys to specific users or usergroups.
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:
2 mins, all done via product file.

Installation:

* Unpack the included file
* Copy survey.php to your main forum directory
* Copy the survey directory into your forum directory (cannot change the directory name)
* Install the Product-Survey.xml
* The product file will also install all data for the 2 default surveys to get you started.
* Go to AdminCP => vBulletin Options => Survey System Options - and set the options for access 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

Notes:

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

Please click Install if you have installed this mod.

I personally do not claim credit for this hack, however this is what I have done to port over to 3.6.3 :-

1. All tables, templates, phrases etc are installed via product file.
2. Support for wol has been added.
3. Some bugs fixed with the UCCASS system

This hack is for 3.6.3 not 3.5, the 3.5 version can be seen and downloaded here this will not upgrade the 3.5 version.

I did obtain the permission from tamarian to port this to 3.6.

This is my first big hack here so I would grateful if you did click Install if you use it. Remember you only get notified of updates if you Install

Demo Here :- http://www.internetwatchers.co.uk/forums/survey.php please note the Demo may have restrictions as it is a live board. You may or may not be able to test the survey as a guest, this will not affect your sites as generally why would you want guests taking a survey on your site, you would never get a true survey result, I have only enabled this on my board so as to get the ball rolling and you guys can see it. you should all be able to see results page though.

If you have the older 3.5 Hack installed you MUST uninstall that before installing 3.6.3

vB Survey for vB 3.0 version by tamarian
vB Survey for vB 3.5 version by tamarian

[ivps-Samuel]

Hello,

I added usergroup 1 (Guest/Not Logged In) to answer survey questions but it still seems to require login when the survey is clicked on.

Any ideas?

[Spikeman]

Originally Posted by ivps-Samuel

Hello,

I added usergroup 1 (Guest/Not Logged In) to answer survey questions but it still seems to require login when the survey is clicked on.

Any ideas?

Please remember the point of a survey is to compile data across a given site to a set of people, however allowing guests the oppurtunity to take the survey would surely make for different results as they could retake the survey many times, therefore throwing your results out. That said here is what you need.

Find this code in survey.php

if ($vbulletin->userinfo['userid']==0) { // override permissions for guests, since userid zero is messy
                                // They can only see the results, if allowed in the admincp settings
        $vbulletin->userinfo['can_admin_surveys'] = 0;
        $vbulletin->userinfo['can_take_surveys'] = 0;
        $vbulletin->userinfo['can_create_surveys'] = 0;
        $vbulletin->userinfo['can_edit_surveys'] = 0;

You will need to change it to some like this:

if ($vbulletin->userinfo['userid']==1) { // override permissions for guests, since userid zero is messy
                                // They can only see the results, if allowed in the admincp settings
        $vbulletin->userinfo['can_admin_surveys'] = 0;
        $vbulletin->userinfo['can_take_surveys'] = 1;
        $vbulletin->userinfo['can_create_surveys'] = 0;
        $vbulletin->userinfo['can_edit_surveys'] = 0;

Once you have changed that you will need to allow guests to take survey more than once, otherwise guests will be informed that they have already taken the survey, so

Find this line in survey/classes/survey.class.php around line 127 either delete or comment the line out.

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

That should do it.

[Datenpapst]

I have got a problem with the survey. Its not showing the results afert I answered the questions. Dont know why

[Spikeman]

Originally Posted by Datenpapst

I have got a problem with the survey. Its not showing the results afert I answered the questions. Dont know why

Does this happen to all results you are trying to view or is this a new error? have you seen results before? what mySQL version are you running?

[Antivirus]

If i were to install the previous version on my vb 3.5.x boards, then upgraded vb to latest version (3.6.x), how much does upgrading this hack to the 3.6 version entail? I didnt see ay instructions for upgrading. is it simply an overwrite of the included files, or are there db changes, etc... does previous survey data get overwritten?

[Spikeman]

Originally Posted by Antivirus

If i were to install the previous version on my vb 3.5.x boards, then upgraded vb to latest version (3.6.x), how much does upgrading this hack to the 3.6 version entail? I didnt see ay instructions for upgrading. is it simply an overwrite of the included files, or are there db changes, etc... does previous survey data get overwritten?

This is not an upgrade from the previous releases, It is a new install, you must uninstall old version. When you upgrade to 3.6 some tables and some fields that were present in vB 3.5 were removed that were needed to allow the previous version of this hack to function. That said if you take a backup of your survey data you should be able to import it back into the new survey as no changes have been made to the Survey Tables.

Installing this hack is a 2 minute job

[Antivirus]

Originally Posted by Spikeman

It is a new install, you must uninstall old version.

so there is an uninstall script with the old version?

Thanks

[Spikeman]

Originally Posted by Antivirus

so there is an uninstall script with the old version?

Thanks

Yes just load up the previous install script and chose option to uninstall.

[Antivirus]

okie, thanks for clarifying.

[nanaimobar]

Installation went smoothly, hooks and vBulletin Options updated perfectly, but admincp shows no changes and no vbSurvey section is visible anywhere.

Suggestions?