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

[Spikeman]

Originally Posted by 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

Fixed in next release

[Skyrider]

When I click on values, I get:
The requested URL /display_answers.php was not found on this server.

PS, I'm getting the error as a Guest:

The following surveys are available. Click on a link to begin taking the survey. Some surveys may be restricted to specific groups:

There are no surveys available at this time.

I did selected that the Guest usergroup can take surveys. Please make it IP locked, should solve some issues that you already took the survey.

EDIT:
When I wish to preview a Survey I already made, I'm getting:

You have already completed the requested survey.

I love this plugin btw, thanks!

[Spikeman]

Originally Posted by FF|Skyrider

When I click on values, I get:
The requested URL /display_answers.php was not found on this server.

Check that that file has been uploaded to server.

PS, I'm getting the error as a Guest:

The following surveys are available. Click on a link to begin taking the survey. Some surveys may be restricted to specific groups:

There are no surveys available at this time.

I did selected that the Guest usergroup can take surveys. Please make it IP locked, should solve some issues that you already took the survey.

If you take a look in survey.php, this will allow guests to take surveys.

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;change to

Change to:-

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;

This will allow surveys to be taken more than once.

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

[Skyrider]

Thanks, I'll try. But I'm sorry, display_answers.php is not in the zip file you uploaded on this thread. I checked both.

EDIT:
Just edited survey.php and changed the 0 setting to 1 (even tried copy/pasting), and I still get:

The following surveys are available. Click on a link to begin taking the survey. Some surveys may be restricted to specific groups:

There are no surveys available at this time.

And yes, I checked "Available Survey", for registered people there is 1 available. I also added everyone within the usergroup list to the allow to take survey list.

PPS, the "admincp" folder you added within the zip file is empty.

[Spikeman]

pm me your site details and I will take a look.

[Nadeemjp]

wonderful mod.
installed and nominated for MOM.

please tell me what code should i add in the navbar to have this option display there as [survey]

thanx

[BlackJacket]

Originally Posted by Spikeman

pm me your site details and I will take a look.

Could i install this outside my forum directory?

www.mysite.com/survey.php

Thanks for the great mod.

[Spikeman]

Originally Posted by Nadeemjp

please tell me what code should i add in the navbar to have this option display there as [survey]

Add this to your navbar template where you want it to appear

<!-- Survey -->
<td class="vbmenu_control"><a href="survey.php$session[sessionurl_q]" rel="nofollow">Survey</a></td>
<!-- / Survey -->

[Spikeman]

Originally Posted by NittoMOD

Could i install this outside my forum directory?

www.mysite.com/survey.php

I have not tested it, however you will need to change the variables in survey.php to begin with and take it from there. If you need help on the changes let me know.

[Spikeman]

Originally Posted by FF|Skyrider

When I click on values, I get:
The requested URL /display_answers.php was not found on this server.

My bad i just re read this! There is no display_answers.php nor should there be, so I do not know how you are getting this as I cannot replicate the error.

Can you go to my demo and see if you get the same error from my board. http://www.beta-tester.co.uk/iphone/survey.php