Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
vB Survey: Add a full-featured survey tool to your forum Details »
vB Survey: Add a full-featured survey tool to your forum
Mod Version: 1.00, by tamarian (Member) tamarian is offline
Developer Last Online: Mar 2016 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.5.0 Rating: (6 votes - 4.83 average) Installs: 183
Released: 14 Jun 2005 Last Update: 26 Aug 2005 Downloads: 228
Not Supported Template Edits Additional Files  

A 3.6.x version by spikeman is posted here:
http://www.vbulletin.org/forum/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.

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	1.jpg
Views:	2622
Size:	192.6 KB
ID:	27046   Click image for larger version

Name:	2.jpg
Views:	2403
Size:	91.6 KB
ID:	27047   Click image for larger version

Name:	3.jpg
Views:	2540
Size:	140.1 KB
ID:	27048   Click image for larger version

Name:	4.jpg
Views:	2452
Size:	124.7 KB
ID:	27049  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Major Additions vB Survey: Add a full-featured survey tool to your forum Spikeman vBulletin 3.6 Add-ons 251 25 Sep 2015 05:00
vB Survey (UCCASS Survey app integration) tamarian vBulletin 3.0 Full Releases 101 31 Jul 2006 18:25

  #31  
Old 07 Aug 2005, 01:19
tamarian tamarian is offline
 
Join Date: Oct 2001
Originally Posted by Drakah
I did, I changed it to 744 and didnt work, and when I did try and do that command for apache, my ftp program did not recognize the command.
Yes, 744 won't work unless you change the file owner. Not sure how to do this with FTP. Anyway, glad you got it working, enjoy
Reply With Quote
  #32  
Old 07 Aug 2005, 01:33
Drakah Drakah is offline
 
Join Date: Jan 2003
Thanks I love this
__________________
Regards,

Brian K Haines
Drakah - shakahr.com
Reply With Quote
  #33  
Old 07 Aug 2005, 14:04
Drakah Drakah is offline
 
Join Date: Jan 2003
Just a small comment, visual idea... I deleted a survey and the next page said "Survey #2 does not exist.". Would like to see maybe the next screen asking me if "Are you sure you want to delete Survey #2: (title of survey here)?" If not a confirmation box, perhaps just "Survey #2: (title of survey here) has been deleted - Click here to go back to the Survey Listings". ... or something.

Oh and a little type I found
"Anonymous Survey?
Select no, if you want to displaye the usernames in the results next to their answers."
__________________
Regards,

Brian K Haines
Drakah - shakahr.com

Last edited by Drakah; 07 Aug 2005 at 14:17.
Reply With Quote
  #34  
Old 07 Aug 2005, 15:04
Drakah Drakah is offline
 
Join Date: Jan 2003
Got a problem.

I went to edit an answer type.
Choose Answer Type [ Edit Answer Type] [ View Answer Types ]

And when I clicked on the button for Edit Answer Type, it just refreshed the listing and did not allow me to actually edit anything.
__________________
Regards,

Brian K Haines
Drakah - shakahr.com
Reply With Quote
  #35  
Old 07 Aug 2005, 15:50
tamarian tamarian is offline
 
Join Date: Oct 2001
Originally Posted by Drakah
Got a problem.

I went to edit an answer type.
Choose Answer Type [ Edit Answer Type] [ View Answer Types ]

And when I clicked on the button for Edit Answer Type, it just refreshed the listing and did not allow me to actually edit anything.
Yes, I was able to reproduce it. Will make an update later today
Reply With Quote
  #36  
Old 07 Aug 2005, 16:18
tamarian tamarian is offline
 
Join Date: Oct 2001
Originally Posted by Drakah
Got a problem.

I went to edit an answer type.
Choose Answer Type [ Edit Answer Type] [ View Answer Types ]

And when I clicked on the button for Edit Answer Type, it just refreshed the listing and did not allow me to actually edit anything.
O.k., download the new version, 1.7, and just upload survey.php to replace the old one.
Reply With Quote
  #37  
Old 07 Aug 2005, 20:20
Drakah Drakah is offline
 
Join Date: Jan 2003
Thank you much
__________________
Regards,

Brian K Haines
Drakah - shakahr.com
Reply With Quote
  #38  
Old 07 Aug 2005, 21:53
hydrostatic hydrostatic is offline
 
Join Date: Jun 2005
How do you do that apache command? I can't seem to get it working. It always says no permission.

It won't work at all if CHMOD to 744, it works when I CHMOD to 777.

Last edited by hydrostatic; 07 Aug 2005 at 22:00.
Reply With Quote
  #39  
Old 07 Aug 2005, 22:02
Drakah Drakah is offline
 
Join Date: Jan 2003
Originally Posted by hydrostatic
It won't work at all if CHMOD to 744, it works when I CHMOD to 777.
Same thing with me, had to do the 777 and it worked fine.

Though I found another bug, yay me!

I get this error when I click on the "Values" link.
".../forums/display_answers.php?sid=28
could not be found."

See screenie
Attached Images
File Type: gif values.gif (19.6 KB, 28 views)
__________________
Regards,

Brian K Haines
Drakah - shakahr.com

Last edited by Drakah; 07 Aug 2005 at 22:04.
Reply With Quote
  #40  
Old 07 Aug 2005, 23:08
Drakah Drakah is offline
 
Join Date: Jan 2003
The setting for when users complete the page, I clicked on the [?] and the document told me there is a place to put in your own URL as a thank-you page. Where is the field to add this?

Also, I would like to figure out how to have a "If Statement" to display on the home page whether they have taken the survey or not. I am thinking of creating a survey graphic to display on my CMPS (vbadvanced) portal home page saying to take the survey, and when they do, it would disappear. Any ideas?
Attached Images
File Type: gif completion.gif (28.7 KB, 17 views)
__________________
Regards,

Brian K Haines
Drakah - shakahr.com

Last edited by Drakah; 07 Aug 2005 at 23:10.
Reply With Quote
  #41  
Old 07 Aug 2005, 23:29
tamarian tamarian is offline
 
Join Date: Oct 2001
Originally Posted by Drakah
I get this error when I click on the "Values" link.
".../forums/display_answers.php?sid=28
could not be found."
The "values" link opens a popup windows with a list of possible values of the answers. What was the actual link? It should link to the main survey.php page.

Originally Posted by Drakah
The setting for when users complete the page, I clicked on the [?] and the document told me there is a place to put in your own URL as a thank-you page. Where is the field to add this?
It's one of the options when creating a survey.

Also, I would like to figure out how to have a "If Statement" to display on the home page whether they have taken the survey or not. I am thinking of creating a survey graphic to display on my CMPS (vbadvanced) portal home page saying to take the survey, and when they do, it would disappear. Any ideas?
This will require a query each time the main page is loaded, so I wouldn't recommend it. But it isn't hard. The only problem is which survey you want to check. If you have only one survey, say #28, you can query it like this:

$TookSurvey = $DB_site->query_first("SELECT uid FROM " . TABLE_PREFIX . "vbsurvey_completed_surveys WHERE uid = $bbuserinfo[userid])
Reply With Quote
  #42  
Old 07 Aug 2005, 23:41
Drakah Drakah is offline
 
Join Date: Jan 2003
Originally Posted by tamarian
The "values" link opens a popup windows with a list of possible values of the answers. What was the actual link? It should link to the main survey.php page.
No it doesn't. Somehow it is looking for a display_answers.php file and not looking in the survey folder in any rate, and there is no such PHP file in the survey files, although there is a tpl file I think. The actual link pointed to my forum home directory and not the place where it needs to look. Seems like the only link that really didn't work for me.


Originally Posted by tamarian
It's one of the options when creating a survey.
I don't see that option when creating or even in the edit survey area, as per screenshot. I looked in the TPL file and there is no reference to a field in making a URL as the redirect.



Thanks for your help
__________________
Regards,

Brian K Haines
Drakah - shakahr.com
Reply With Quote
  #43  
Old 08 Aug 2005, 02:22
hydrostatic hydrostatic is offline
 
Join Date: Jun 2005
Also, when you go to Edit Survey, the top of the page doesn't say anthing. It just says:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Reply With Quote
  #44  
Old 08 Aug 2005, 02:36
TTG's Avatar
TTG TTG is offline
 
Join Date: May 2004
All seemed to be working well until I installed the new 1.7 survey.php .. now I just get a blank page !?
Reply With Quote
  #45  
Old 08 Aug 2005, 12:58
tamarian tamarian is offline
 
Join Date: Oct 2001
I don't see that option when creating or even in the edit survey area, as per screenshot. I looked in the TPL file and there is no reference to a field in making a URL as the redirect.[/QUOTE]

It's the "Completion Redirect Page" section in the survey properties. It has two choices, back to the main survey page, or to the results page.
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 22:16.

Layout Options | Width: Wide Color: