The Arcive of Official vBulletin Modifications Site.

vB Survey (UCCASS Survey app integration) · **Released**: 06-01-2005

What this hack does:

This hack will add a full featured survey application system to your forum.

Credits: John W. Holmes: Author of UCCASS Survey.

Application Features: See the UCCASS site for full details. After testing several survey apps, this one is 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:
Added anonymity option. If a survey is not anonymous, members can see how other members answered.
Added Hide/unhide survey option
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

Added in v1.5.4 (October, 17, 2005
Now checks primary and secondary permisisons.

Added in v1.5.3 (August 26, 2005
Don't show edit box unless user has permission.

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

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

tamarian · #62 08-22-2005, 09:00 PM

Quote:

Originally Posted by eljeffe

I installed this hack and ran the install process. Everything seemed to install just fine. Went to run the hack at http://www.mydoman.com/forums/survey.php and the browser just hangs.

Any ideas?

You have posted this twice, in the 3.0 version, and the 3.5 version, so I don't know which hack you installed.

Second, the link you posted shows that the file was not there, so you may not have uploaded it, or uploaded it to the wrong location.

eljeffe · #63 08-22-2005, 10:13 PM

Quote:

Originally Posted by tamarian

You have posted this twice, in the 3.0 version, and the 3.5 version, so I don't know which hack you installed.

Second, the link you posted shows that the file was not there, so you may not have uploaded it, or uploaded it to the wrong location.

Sorry, I accidently posted in the 3.5 forum. I thought I deleted it.

Anyway it's the 3.0 version (1.5 vBSurvey).

The URL is just an example. I'll PM you the URL when I get it reinstalled again.

eljeffe · #64 08-26-2005, 03:25 AM

Quote:

Originally Posted by eljeffe

Sorry, I accidently posted in the 3.5 forum. I thought I deleted it.

Anyway it's the 3.0 version (1.5 vBSurvey).

The URL is just an example. I'll PM you the URL when I get it reinstalled again.

I got it to work. For some reason, it doesn't like running on a NFS mounted volume. Every time I tried to access the survey.php file, it would hang at the first function call and create a .nfs<string of 9 numbers> file in the template/Default directory. I've got no idea why, but that is the behavior that is being exhibited.

The work around was to create the survey directory on the local disk and create a symbolic link to that directory in the /home/www/mydomain.com/forums directory.

I've created my first survey and it works great.

A couple questions:

1. Is there a modification or hack to the survey that will make Multiple Choice Single Selection into a dropdown listbox instead of a bunch of radio select buttons?

2. I'd like to only display the "Edit Survey" box only when a user has the permissions to do so. Have you got anything to do that?

Thanks. Works great -- very flexible, very powerful!!!

tamarian · #65 08-26-2005, 11:57 AM

Quote:

Originally Posted by eljeffe

I got it to work. For some reason, it doesn't like running on a NFS mounted volume. Every time I tried to access the survey.php file, it would hang at the first function call and create a .nfs<string of 9 numbers> file in the template/Default directory. I've got no idea why, but that is the behavior that is being exhibited.

The work around was to create the survey directory on the local disk and create a symbolic link to that directory in the /home/www/mydomain.com/forums directory.

Glad you got it to work

Quote:

1. Is there a modification or hack to the survey that will make Multiple Choice Single Selection into a dropdown listbox instead of a bunch of radio select buttons?

It's already available. Just edit the multiple choice question, change it from vertical to dropdown, then it will become a select box allowing multiple picks.

Quote:

2. I'd like to only display the "Edit Survey" box only when a user has the permissions to do so. Have you got anything to do that?

I've overlooked this, but it does make sense. Download the new zip file, and just upload 2 files:
1. survey/templates/Default/available_surveys.tpl
2. survey/classes/survey.class.php

eljeffe · #66 08-26-2005, 02:53 PM

Quote:

Originally Posted by tamarian

Glad you got it to work

It's already available. Just edit the multiple choice question, change it from vertical to dropdown, then it will become a select box allowing multiple picks.

I've overlooked this, but it does make sense. Download the new zip file, and just upload 2 files:
1. survey/templates/Default/available_surveys.tpl
2. survey/classes/survey.class.php

You are DA-MAN!!!

Thanks.

BTW, I added the following to survey.php to keep people who didn't belong in the survey page in the first place completely out:

Find:

PHP Code:


			
require("./global.php");

require('survey/classes/main.class.php');

Paste After:

PHP Code:


			
// enabled check

        if (!$vboptions['enablememberlist'])

        {

                eval(print_standard_error('error_nomemberlist'));

        }



// permissions check

        if (!($permissions['forumpermissions'] & CANVIEW) OR !($permissions['genericpermissions'] & CANVIEWMEMBERS))

        {

                print_no_permission();

        }

pachitalk · #67 09-02-2005, 03:40 PM

Looking forward to using this! Installed fine, changed the survey folder to 744 and all subfolders. Did the Admincp changes. Using vb 3.07

Getting Warning: main(survey/classes/main.class.php): failed to open stream: Permission denied in /survey.php on line 8

Line 8 is require('survey/classes/main.class.php'); CHMOD is 744

What am I missing?

Did I delete my install file too soon?

tamarian · #68 09-02-2005, 03:45 PM

Quote:

Originally Posted by pachitalk

Looking forward to using this! Installed fine, changed the survey folder to 744 and all subfolders. Did the Admincp changes. Using vb 3.07

Getting Warning: main(survey/classes/main.class.php): failed to open stream: Permission denied in /survey.php on line 8

Line 8 is require('survey/classes/main.class.php'); CHMOD is 744

What am I missing?

Did I delete my install file too soon?

For this error, no need to re-install, just check the ownership on the directories.

pachitalk · #69 09-02-2005, 03:51 PM

Thanks for the quick reply, is that setting through my FTP program?

tamarian · #70 09-02-2005, 03:59 PM

Quote:

Originally Posted by pachitalk

Thanks for the quick reply, is that setting through my FTP program?

I don't think so, I usually set it from the command line through SSH.

But to confirm that it's an ownership issue, chmod to 777, and see if it works. With FTP, make sure you give it enough time to recursively change all files and directories.

pachitalk · #71 09-02-2005, 04:10 PM

Okay, 777 allows it to work. So??? The 744 isn't sticking? Or is it's the SSH?

My parent folder "forums" is set to 755. Could that be interfering?

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.08175 seconds Memory Usage 2,333KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (2)bbcode_php (9)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!