SurveyManager - v0.8
Author: Benjamin Birney/Tilson Technology Management
PostNuke Version: PostNuke Phoenix .760
Category: Content
pnAPI Compliancy:
Yes
pnRender Compliancy:
Yes
Description:
SurveyManager can be used for traditional surveys, but it's also a great tool for simpler feedback/contact forms. No technical knowledge (beyond the ability to install a PostNuke module and do some basic file permissions) is required. Unlike the popular Formicula module, there is no need to mess with Xanthia templates to get custom questions. The administrative interface takes care of everything for you.
Version 0.8 adds a "Quick Survey Wizard" that lets you create and edit one-page surveys from a single, easy-to-use interface.
System Requirements:
PHP 5.2 (May work with 4.x) Ajax Support Package
Support Information:
I maintain a support page and installation guide for SurveyManager here: http://www.tilsontech.com/Page-42.html
Supported Languages:
English
Change Log:
0.1:
*Codebase imported from StepStore
0.2:
*Added "values" column to questions table
0.3:
*Added "thankyou" column to surveys table
*Added "status" column to responses table
0.4:
*Added "alt_thankyou" column to surveys table
0.5:
*Added "parent_sid" column to responses table
0.5.0.1:
*Fixed several CSS/XHTML validation bugs
0.5.0.2:
*Fixed a display bug in admin_modify_response()
0.5.0.3:
*Fixed a bug in data prep for email
0.5.0.4:
*Removed extraneous functions from utils.php
0.5.1:
*Added $can_admin template variable to user_display()
*Fixed bug deleting questions
0.5.1.1:
*Fixed typo in admin_create_question();
*Require ACCESS_EDIT on ::Admin to see "Manage Surveys"
0.6:
*Added recipients for individual surveys
0.7:
*Added several new kinds of fields
*Added setting of respondant name and email in survey data
*Added ability for administrators to change response data
*Added "Featured responses" and public interface
*Added CAPTCHA option using protectwebform.com
0.7.0.1:
*Minor cosmetic fixes on CAPTCHA
0.7.0.2:
*Fixed caching problem in display_featured()
0.7.1:
*Added BMBStatTracker integration
0.7.2:
*Added $detail_response to the template vars for user_display_featured.htm
0.7.2.1
*Caused "Used featured responses" option in config to correctly disable use featured checkbox in response viewing screen.
0.7.3:
*Put register_title into some standard user display templates
0.7.3.1:
*Prepped source for distribution
0.7.3.2:
*Fixed broken images in PN installs not in the main web root
*Assorted cosmetic fixes
*Fixed major error in pninit.php.
0.7.3.3:
*Fixed some script paths that wouldn't for installs not in the main web root
0.7.4:
*Made FCKeditor and ben_utils internal to the module, so you don't have to install them separately.
0.7.4.1:
*Fixed bug in featured_response block that caused script crash when creating any new block
0.7.5:
*Added the ability to disable FCKeditor from all interfaces for accessibility compliance.
0.7.5.1:
*Set up a more reasonable default configuration for the FCKeditor file manager
0.7.5.2:
*Made 'fck' the default value for 'visual_editor' on initialization.
0.7.5.3:
*Updated to ben_utils 1.15.5
0.7.5.4:
*Fixed a regexp syntax error in modifier.linebreaks that caused extra linebreaks to be inserted when they shouldn't have been
0.7.6:
*Added an auto-generated survey on cold installation
0.7.6.1
*Fixed incorrect reference to the utility package in modifier.linebreaks.php
0.7.6.2:
*Fixed error in pnuser.php which caused global recipients to not receive notifications of new responses if a survey did not also have individual recipients.
0.7.7:
*Added "No response" as an option in the featured_response block
0.7.7.1:
*Cosmetic cleanup on display page
0.7.7.2:
*Fixed bug in export code that always exported the first survey.
0.7.8:
*Added additional featured response browing mechanism: view_featured()/detail_featured() in addition to display_featured()
0.7.9:
*Added redundant ordering control for view_responses display
0.7.9.1:
*Fixed ID reference error in pnadminapi.php
0.7.10:
*Cosmetic cleanup in administrative interface
*Added view link in administrative interace
0.7.10.1:
*Fixed privacy issues with featured response interfaces identified by open source community member Emmanuel PROT
0.7.10.2:
*Fixed bug reported by Tor Nichols referencing FCKeditor files from non-root installs of PostNuke
0.7.10.3:
*Improvement to modifier.linebreaks.php
0.8:
*Added Quick Survey Wizard

13 Comments so far
(Latest comments
)
1. mhalbrook wrote on Feb 20, 2007 at 03:19 AM
A much needed application, but a few questions:
1. What are "bens_utils" and why are they needed?
2. Why require FCKeditor there are modules for WYSIWYG and some people may not even want to use a WYSIWYG for their sites.
2. bbirney wrote on Feb 20, 2007 at 12:01 PM
Good questions, Michael. (Michael?)
SurveyManager is one of several custom modules that I have developed for various clients, of which this is my first public release. ben_utils is a common library of tools that they all share. Nothing awe-inspiring, just a little package to make common tasks easier.
I like FCKeditor because it has a very active development community and is a solidly designed tool. I found typetool, for instance, to be, well, not as good, to put it politely. FCK would only be seen by visitors to the site if the administrator chose to have a "Styled Text" -type question in his survey; otherwise it's only used in administrative interfaces.
3. markwest wrote on Feb 20, 2007 at 02:18 PM
Ben,It would be nice if fckeditor was available as a separate module to complement existing options. I agree typetool if poor - thats why its been dropped for PostNuke .8x. We already have xinha & scribite and there's a tinymce module in the .8x value addons pack.
I started a fckeditor editor project but have never had chance to work on it. The basic framework for fckeditor being usable across an entire site is there. All it needs is someone with the time to update and release it. Would you be interested? If so contact me off line (markwest at PostNuke dot com).
-Mark
4. bbirney wrote on Feb 21, 2007 at 04:20 PM
In response to Michael's (implicit) suggestion and problems I heard from other people who have tried to install SurveyManager, I've made FCKeditor and my utility package internal to the module, so you don't need to install them separately.
5. kaffeeringe.de wrote on Feb 21, 2007 at 08:53 PM
Scribite is a module that can hold several editor. Currently it supports Xinha and TinyMCE (IIRC) - so maybe you can simply put FCKeditor in there.6. bbirney wrote on Feb 22, 2007 at 12:35 PM
Fixed a bug in the featured_response.php block that caused a script crash when editing any new block. Updated version, 0.7.4.1, is available from my distribution page. Sorry about that.
http://www.bbirney.com/Page-33.html
7. daggon wrote on Feb 22, 2007 at 12:38 PM
Thanks for the SQL dump Ben.Have got this running on a box using MySQL 4.0.27 with no trouble at all.
Great module!
8. mhalbrook wrote on Feb 23, 2007 at 01:31 AM
Personally, I'd like to see WYSIWYG optional rather than required. I don't generally like those types of editors myself.
9. bbirney wrote on Feb 24, 2007 at 01:21 PM
Good point, Michael. Forcing it to be on was causing some accessibility problems as well. I've posted a new version that will let you disable FCKeditor. In fact, you can remove the whole "FCKeditor" directory from the SurveyManager module directory, and it will still run - it'll just replace the FCK screens with standard-issue HTML textboxes.http://www.bbirney.com/index.php?module=StaticContent&func=display&scid=33#installation_nofck
10. flic wrote on Mar 21, 2007 at 01:17 PM
After uploading all the files including the Ajax package into the appropriate folders, I regenerated my modules list and then attempted to initialize SurveyManager, but the initialization failed. Error message is: "You are not authorized to carry out this operation." Has anyone else run into this problem? Does anyone know how to resolve this issue? We've installed plenty of modules, but this is the first time this has happened? We are running pn.764 on a PHP5 enabled server.11. bbirney wrote on Mar 24, 2008 at 02:35 PM
Not sure if the modules database is actually updating; I submitted changes twice but got no feedback indicating they'd been accepted. Anyway, version 0.8 is out, and adds a "Quick Survey Wizard".
http://www.tilsontech.com/Page-42.html
12. espaan wrote on Mar 25, 2008 at 06:34 PM
Nice module.Can you indicate what the conceptual differences are with sendform, the new Polls module and e.g. formulica (you already said something about it).
Just so you know. Scribite supports 4 editors these days. Xinha, TinyMCE, FCKEditor and openwysiwyg. It might be a good idea check out scribite.
If you have scribite enabled I suppose one would want the editor of their choice throughout the whole site. In the Content module the FCKEditor was enforced at first and now is switched of if you have scribite enabled.
13. hilope wrote on Mar 26, 2008 at 04:15 PM
Perhaps the .8 version of your module can use the possibilities from scribite! v2.x ...There are a lot of useful hints in the developers doc