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

A 3.6.x version by spikeman is posted here:
https://vborg.vbsupport.ru/showthread.php?t=131650


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.

Application Features: See the UCCASS site for full details. After testing several survey apps, I find this one to be 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: (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:
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

Upgrade Instructions:
If you are upgrading from vB 3.0.x to vB 3.5 and already had this hack installed, all you need to do is download the zip file, and re-uploade all the files to over-write the old ones.

Added in v1.7.1 (August 26th, 2005

• Hide edit menu if user not allowed to edit surveys.

Added in v1.7 (August 7th, 2005

• Bug fix in editing answer types.

Added in v1.6 (June 12th, 2005

• Upgraded for vB 3.5 beta
• Upgrad instructions: If you already have vB Survey 1.5 installed, you just need to upload all files, but no need to run the upgrade script.

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:
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.

Please click Install if you have installed this mod.

[Spikeman]

Well I got this running on 3.6.2 which seems very strange after reading most of the posts here. Everything seems to be working, including the export feature.

I could do with a few people hitting the survey on my site and see if they can break it or check for bugs. The only problem is I cannot seem to get the unregisterd users to access it.

The other problem I have is in the ACP, although all the values are there, no actual titles prefix the values! I am working on this right now so I will see if I can get it fixed.

I am not going to release the how I done it yet, as I do not want to be respondsible for anyone that uses it and breaks thier own board, So hit my board and break that instead. Link is in sig, survey is located on left menu under website survey. I have not creasted a new survey yet just using the old default ones and another that I renamed and copied.

[Spikeman]

I think I have fixed the need to be registered on my site to take survey! Need some feedback on this before I can spend more time on it and hopefully move it to 3.6.2 mod.

[Datenpapst]

really like this mod and would need it for 3.6.2 maybe as a plugin?

[Datenpapst]

please transfer it =)

[allanh]

Originally Posted by Spikeman

I think I have fixed the need to be registered on my site to take survey! Need some feedback on this before I can spend more time on it and hopefully move it to 3.6.2 mod.

hi, is the 3.6.2 version update available yet? I can't wait to try it out

[Datenpapst]

nope no update there

[StarBuG]

Hi

Will this hack be ported to 3.6?
I realy would need this feature on my medical forum too

StarBuG

[Spikeman]

I have been working on this for 3 or 4 days now and all seems good on my site. I did however ask that people help me out and test the survey on my site.

Now either something is wrong and the db is not storing the data that you guys have input or nobody has tested it! I have certainly not had any feedback to how it performed or any errors! The survey was setup to allow guests to take survey, so no need to register on site.

Well this means it just takes longer for me to test it before I am happy to release it without errors.

And there I was thinking people actually wanted this?

[Datenpapst]

the problem is, that i cant even get on your site

/e: ah now it seems to work... o_0

/e2: hmm it seems like i have to register

[StarBuG]

@Spikeman

You should include a link to your test survey into one of your post
Make it font size 5 and bold and tell people to test because you are trying to port it to 3.6.2

I have simply missed that you are working on this

If I go to http://www.internetwatchers.co.uk/fo...?do=new_survey
I am required to register in order to see the survey

If you can't get the guest option to work why not create a test account on your forum for us
so that we can start testing untill you figured out how to allow guests as well to take the survey?

Ahh and did you get permission from "tamarian" to port this hack?