This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

This is a Django app that provides some generic building blocks for creating self-assessment questionnaires using Django CMS (2.4.x).

Quick Start

(assuming you already have a working Django CMS project)

  1. Install django-cms-saq and django-taggit using pip

    pip install django-cms-saq django-taggit

  2. Add cms_saq and taggit to your INSTALLED_APPS

    INSTALLED_APPS = ( … ‘taggit’, ‘cms_saq’, … )

  3. Add cms_saq.urls to your urls.py

    urlpatterns = patterns(”, … url(r’^saq/’, include(‘cms_saq.urls’), … )

  4. The django-cms-saq plugins should now be available to add to your CMS pages.

Available Plugins

Questions

The core of django-cms-saq is the question plugins. Each question is uniquely identified by its slug. Answers to questions are be stored with references to their slug and the users that submitted them.

There is no formal grouping of questions in the models, so there’s no concept of a questionnaire. Questions are merely plugins placed on pages. Where you need to aggregate answers to questions (eg. for average/total scores for a series of questions grouped on a page, or in a section), you can use tags.

Question Types

  • Single Choice Question

Displays a list of radio buttons, from which a user can select a single answer.

  • Multi Choice Question

Displays a list of checkboxes, from which a user can select one or more answers.

Scores for multi-choice questions will be the sum of the scores for all the chosen answers.

  • Free Text Question

Displays a text input box.

Free text questions are not scored. They are simply for collecting information about the user (eg. name / address / company details).

  • Drop-down Question

Displays a select box.

  • Grouped Drop-down Question

Displays a select box with optgroups.

Back / Next Buttons

This plugin contains the javascript code that submits answers to the cms_saq.views.submit view. This plugin must be included on each page of questions.

Sectioned Scoring

This is a simple analysis plugin. It displays aggregate total scores for questions grouped by tags. Scores are displayed as percentages of the maximum score available for each group.

Progress Bar

This simply adds a progress bar to any page that is part of the questionnaire. It displays the number of answered questions out of the total available in the entire tree. You can also filter out optional questions to show progress on required questions only (though this won’t count answers to optional questions, so might be misleading).

Bulk Answer

Useful for ‘skip this section’ type functionality, this allows the insertion of a button into the page that marks all single-choice questions with a given answer. It only works on questions where the given answer value is one of the options and disregards any other user input.

Adding your own analysis – how to access user submissions

Each user submission is stored in a cms_saq.models.Submission object, which references the user, the question and the answer(s), as well as containing a score calculated at submission. For some guidance on creating a plugin to display your own analysis (and how to query submissions by question tags), take a look at the source code for cms_saq.cms_plugins.SectionedScoringPlugin.

Integration with django-lazysignup

If you add SAQ_LAZYSIGNUP=True to your settings.py, the cms_saq.views.submit view will use the allow_lazy_user decorator from django-lazysignup.

See https://github.com/danfairs/django-lazysignup for more info on lazysignup.

Release History

Release History

0.2.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.28

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-cms-saq-0.2.3.tar.gz (38.1 kB) Copy SHA256 Checksum SHA256 Source Apr 25, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting