qwester 0.0.2 → 0.0.3

data/README.rdoc

@@ -43,6 +43,19 @@ answers is given by:
 However, these can be modified and added to as you require. That is, each
 question has a unique set of answers that can be modified as required.
 
+=== Answer selection list helper
+
+The helper method qwester_answers_selection_list will output a set of form
+elements matching the answers for the given question, as an unordered list.
+The form elements will be radio buttons unless the question is marked as 
+'multi-answer', in which case check boxes will be used.
+
+    <%= qwester_answers_selection_list(question) %>
+
+The controller method update_qwester_answer_store can be used to manage the
+data submitted from these form elements. It will add the answers to the 
+current answer store.
+
 === Answer store
 
 Submitted answers are stored in an AnswerStore object. On creation, each 
@@ -50,6 +63,12 @@ answer_store is assigned a session_id that can then be used within session,
 to identify the current user's answer_store. In this way, questionnaire 
 submissions can be tracked across multiple submissions.
 
+By default the current answer_store.session_id is stored in 
+session[:qwester_answer_store]. If you wish to use a different session key,
+set Qwester.session_key in the qwester initializer:
+
+    Qwester.session_key = :your_preferred_key
+
 === Rule set
 
 Groups of answers can be matched to rule sets using:

data/lib/qwester/version.rb

@@ -1,3 +1,3 @@
 module Qwester
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/qwester.rb

@@ -24,4 +24,12 @@ module Qwester
     @active_admin_menu = menu
   end
   
+  def self.session_key
+    @session_key || :qwester_answer_store
+  end
+  
+  def self.session_key=(key)
+    @session_key = key
+  end
+  
 end

data/lib/rails/actionpack/lib/action_controller/base.rb

@@ -9,7 +9,7 @@ module ActionController
     end
 
     def get_qwester_answer_store(create_new = false)
-      if session[:qwester_answer_store]
+      if session[Qwester.session_key]
         current_qwester_answer_store
       elsif create_new
         new_qwester_answer_store
@@ -18,7 +18,7 @@ module ActionController
     helper_method :get_qwester_answer_store
 
     def current_qwester_answer_store
-      @qwester_answer_store = Qwester::AnswerStore.find_by_session_id(session[:qwester_answer_store])
+      @qwester_answer_store = Qwester::AnswerStore.find_by_session_id(session[Qwester.session_key])
     end
 
     def new_qwester_answer_store
@@ -27,7 +27,7 @@ module ActionController
     
     def set_qwester_answer_store(answer_store)
       @qwester_answer_store = answer_store
-      session[:qwester_answer_store] = @qwester_answer_store.session_id
+      session[Qwester.session_key] = @qwester_answer_store.session_id
       @qwester_answer_store
     end