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 initially released this hack for vB3.0 - 3.5 before I ported it to 3.6 - 3.8 outstanding work by him.

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:

1. 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.
2. 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.


Please click Install if you have installed this mod.


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

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.beta-tester.co.uk/iphone/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.8

Translations:-
Arabic - patch developer

[TimberFloorAu]

Instructions are incorrect:

In instructions above it says:

* Copy survey.php to your main forum directory
* Copy the survey directory into your forum directory (cannot change the directory name)

In instructions with hack, it says:

Copy survey.php to your main forum directory
Copy the survey directory below your forum directory (cannot change the directory name)

[TimberFloorAu]

We get errors.

Warning: require(survey/classes/main.class.php) [function.require]: failed to open stream: Permission denied in [path]/survey.php on line 8

Fatal error: require() [function.require]: Failed opening required 'survey/classes/main.class.php' (include_path='.:/usr/local/lib/php') in /home/oursite/public_html/forum/survey.php on line 8

Installed as per VB instruction set not your txt version with download.

[jazz_aaf]

how to limit the number of times a user can take a survey?

[Spikeman]

Originally Posted by jazz_aaf

how to limit the number of times a user can take a survey?

Find this line in survey/classes/survey.class.php around line 129, comment these lines out.

$check = $this->_CheckAccess($sid,TAKE_PRIV,"survey.php?sid=$sid");

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

        if (!$check) print_no_permission();

That should do it

[Spikeman]

Originally Posted by TimberFloorAu

Instructions are incorrect:

In instructions above it says:

* Copy survey.php to your main forum directory
* Copy the survey directory into your forum directory (cannot change the directory name)

In instructions with hack, it says:

Copy survey.php to your main forum directory
Copy the survey directory below your forum directory (cannot change the directory name)

My bad will change file in download.

Originally Posted by TimberFloorAu

We get errors.

Warning: require(survey/classes/main.class.php) [function.require]: failed to open stream: Permission denied in [path]/survey.php on line 8

Fatal error: require() [function.require]: Failed opening required 'survey/classes/main.class.php' (include_path='.:/usr/local/lib/php') in /home/oursite/public_html/forum/survey.php on line 8

Installed as per VB instruction set not your txt version with download.

1.This is caused by permissions
2.ensure that you set the permissions correctly
3.some servers will be a pain!, try a 777 chmod on the survey folder and included directories and file
4. Also verify that all files were uploaded, this has happened before when files were missing and it throws an error, this is normally caused by the server and not user/admin.

[TimberFloorAu]

Will see what others say, and then give it another go. Many thanks for prompt response.

Watching

[silly rabbit]

Spikeman, just wanted to say 'nice job', adaptation to vB, working great on 3.8.2

I added the "custom url" redirect at survey end back in, it seems to be working fine after limited testing. To accomplish in "\survey\templates\Default\edit_survey_properties. tpl":

Find:

<input type="radio" name="redirect_page" value="results"{$data.redirect_results}> Survey Results Page <span class="example">(Results Access should be Public)</span><br />

After Add:

<input type="radio" name="redirect_page" value="custom"{$data.redirect_custom}> Custom URL <span class="example">(If URL does not start with http:// or https://, it is assumed to be a relative URL from {$conf.html})</span><br />
        <div style="margin-left:20px">
          URL: <input type="text" name="redirect_page_text" value="{$data.redirect_page_text}" size="50" maxlength="255">

Everything else seems to be intact, working fine!

Thanks! Rabbit

[jazz_aaf]

how to sort results based on the total for each answer?

[fred13]

I downloaded it and there is no admin cp modual.

[Spikeman]

Originally Posted by jazz_aaf

how to sort results based on the total for each answer?

I am looking into a better reporting module to break down results, which will be accessible in Admin CP

Originally Posted by fred13

I downloaded it and there is no admin cp modual.

go to Admin CP - vB options - Survey System Settings