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]

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

This was already mentioned in my earlier posts.

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

It was setup for guests until my last post to stop spammers inputting thier rubbish to 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?

this has been enabled for guests again

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

was not aware that I needed to get permission to get a hack to work, if i were indeed to release this as a new port I would ask tamarian and include all the necessary credits, to be fair i really do not care about the credit I just want to get it working, If there is a problem then I shall leave it, after all it works on my site

Ok guests can now view and create survey url here
http://www.internetwatchers.co.uk/forums/survey.php

[Datenpapst]

hmm the example andinternetwatchers survey are the same? so tells me the site. hmm its not storing all of the answers and also does not show me every question.

[Spikeman]

Originally Posted by Datenpapst

hmm the example andinternetwatchers survey are the same? so tells me the site. hmm its not storing all of the answers and also does not show me every question.

Yes those 2 surveys are the same, all i did was to create a new survey using an existing survey to test that function.

I could not replicate your other error, I get all the questions and can see the results after survey.

[DS MrSinister]

I hope i don't piss off anyone here!! No credit here.

You must have this install before upgrading to 3.6.X this is want is missing to make it work....Not sure if this a 100% fix good luck with it..

add new template called

vbsurvey

$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
<title>$vboptions[bbtitle] - $vbphrase[report_bad_post]</title>
$headinclude
</head>
<body>
$header
$navbar
$body
<div class="smallfont" align="center">
<BR />
      Powered by <a href="http://www.bigredspark.com/survey.html">UCCASS  1.8</a>. Copyright &copy; 2004 <a href="http://www.bigredspark.com/">John W. Holmes</a>, All Rights Reserved <!-- YOU MAY NOT REMOVE THIS COPYRIGHT NOTICE WITHOUT PERMISSION FROM THE UCCASS AUTHOR -->
</div>
$footer
</body>
</html>

[Spikeman]

Well that template is already installed on the installation, or it did on my install, it probably failed to install on your install, so there must have been a problem in the config somewhere.

[StarBuG]

It does not seem to work propaly

If I want to take a survey as a guest I get

"You have already completed the requested survey."

also guests should not be able to create new surveys.
Is this controlled via the permission system?

[Spikeman]

Originally Posted by StarBuG

It does not seem to work propaly

If I want to take a survey as a guest I get

"You have already completed the requested survey."

Normally, you can only complete a survey once, the same as polls, but i did not think this applied to guests in this case, have you already taken the survey once on my site?

Originally Posted by StarBuG

also guests should not be able to create new surveys.
Is this controlled via the permission system?

The only reason guests are allowed to create surveys on my site is so you guys can test it, i changed the perms to allow for the testing

[4yBak]

does this work correctly on vB 3.6.x ?

[ChurchMedia]

I finally got mine working on 3.6.1. I had this installed on 3.5, so if you try a fresh install on 3.6.x I think you will get some database errors. The install script needs to be re-written for 3.6.x.

To get it working I had to:

1) Upload the survey directory to the main forums directory
2) AND ALSO upload the survey directory to the /forums/include directory (that's where it was looking for the templates for some reason)
3) chmod both survey directories and everything in them to 744
4) chown both survey directories to nobody.nobody (might be apache.apache for some people)

And presto! It works great

[StarBuG]

Originally Posted by Spikeman

Normally, you can only complete a survey once, the same as polls, but i did not think this applied to guests in this case, have you already taken the survey once on my site?

No I did not