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

[dutchbb]

Hm so since there are no phrases , where can we translate most of the system please?

[Spikeman]

Originally Posted by dutchbb

Hm so since there are no phrases , where can we translate most of the system please?

The admin phrases are easy enough todo, the UCCASS system uses smarty templates which can be edited to suit your language.

[dutchbb]

Can't find the right files though

edit: Nevermind I found it

[StarBuG]

Hi

I need to know where to define the background for the survey itself and the results page.

My forum uses a background image but on long surveys this breaks the design, so I need to replace it with a color.

Also it seems that guests can't take the survey, even though I have set permissions to allow usergroup 1 (not registered) to take surveys.

Any ideas?

[Spikeman]

Originally Posted by StarBuG

Hi
I need to know where to define the background for the survey itself and the results page.
My forum uses a background image but on long surveys this breaks the design, so I need to replace it with a color. Can i ask where you normally define the image?

vBsurvey uses smarty templates that are located at survey/templates/Default there is also the vbsurvey template within the style manager if you have added your background as a custom style. However your default color that is defined within vB should be displayed?

Originally Posted by StarBuG

Also it seems that guests can't take the survey, even though I have set permissions to allow usergroup 1 (not registered) to take surveys.

If you take a look 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;

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;

That should work

[StarBuG]

Hi

If I change that, I can't admin nor take the survey anymore.

It uses the css definitions for the background of the survey, but that is the problem.
I need to define the color by hand in this place because the background image from css breaks if the survey is to long.

Any idea where the background is defined?

Great hack by the way.
Thank you for getingit to run on 3.6

StarBuG

[Spikeman]

Originally Posted by StarBuG

Hi
If I change that, I can't admin nor take the survey anymore.

I had to play with those setting to get guests set up to test the survey, although it is not foolproof as some guests still get refused. The problem with letting guests take a survey is they could keep taking the same survey and you would not get accurate results.

Originally Posted by StarBuG

It uses the css definitions for the background of the survey, but that is the problem.
I need to define the color by hand in this place because the background image from css breaks if the survey is to long.
Any idea where the background is defined?

Ok, I understand now, leave it with me and let me see if i can find a solution.

[Spikeman]

Originally Posted by StarBuG

Hi
I need to define the color by hand in this place because the background image from css breaks if the survey is to long.
Any idea where the background is defined?

I belive the best approach would be to add an additional css definition, then do a search in your smarty template files for "panel" and replace with new, example:- "surveypanel" with you new color declared in "surveypanel" to test I would edit display_answers.tpl first.

[drdeathuk69]

i have an admincp folder with nothing in it is that right?

[hoangminh]

Thank you very much. I have waited for this for long time.

Love you!