Interactive quizzes are a great way to educate, inform, or entertain. Quizzes can be configured
in countless ways using the advanced properties in the control panel. Most quizzes use simple text
to display the question. However, you may choose to use images instead. Using images as questions
can be fun and useful in many situations. If you configure the question text and use an image, the text
will appear on top of the image. If you're using images for questions, it's generally best to include
the images in the project itself and not use image URL's. If you do want to pull the images from URL's,
be careful not to use image URL's that take a long time to download, users don't like this! If you're
using images URL's, be sure they are optimized to download quickly (small file size).


IMPORTANT: This plugin is not designed to run in landscape mode. Portrait mode is the only orientation
support.


iOS Project
------------------------
3 Objective-C classes, 14 images, and 1 sound effect file are included in the plugin folder.
SR_TrueorFalseQuiz.m and .h handle all the logic.
SR_photo.m and .h is used if the quiz questions use images.
SR_imageDecompress.m and .h are used by BT_photo

SR_TrueorFalseQuiz.m is a UIViewController with many methods used to control the quizzes behavior.


Version History
-----------------

v1.0, Initial Release


JSON Data
------------------------

Most folks use the control panel to configure the JSON data for this plugin but it's useful to
see what it may look like. This is how the JSON will look if you don't use a dataURL to
provide the quiz questions.

{
     "itemId":"1111",
     "itemType":"BT_screen_quiz",
     "navBarTitleText":"My cool quiz",
     "childItems":[
          {"itemId":"question1UniqueId", "itemType":"BT_quizQuestion", "questionText":"Question 1 text", "correctAnswerText":"Correct", "incorrectText1":"Wrong"},
          {"itemId":"question2UniqueId", "itemType":"BT_quizQuestion", "questionText":"Question 2 text", "correctAnswerText":"Correct", "incorrectText1":"Wrong"}
     ]

}

If you provide questions data from a remote file there is no childItems array in the screen
definition in the BT_config.txt file. Instead, the quiz questions are pulled from a remote file.

{
     "itemId":"1111",
     "itemType":"BT_screen_quiz",
     "navBarTitleText":"My cool quiz",
     "dataURL":"http://www.domain.com/theQuizQuestions.php"
}
     
In this case the questions would come from a backend script at the dataURL. Loading
the dataURL in your browser would produce output like this....

{
     "childItems":[
          {
               "itemId":"question_uniqueId_1",
               "itemType":"BT_menuItem",
               "questionText":"This is question 1",
               "correctAnswerText":"Correct answer",
               "incorrectText1":"Wrong"
          },
          {
               "itemId":"question_uniqueId_2",
               "itemType":"BT_quizQuestion",
               "questionText":"This is question 2",
               "correctAnswerText":"Correct answer",
               "incorrectText1":"Wrong"
          },
          {
               "itemId":"question_uniqueId_3",
               "itemType":"BT_quizQuestion",
               "questionText":"This is question 3",
               "correctAnswerText":"Correct answer",
               "incorrectText1":"Wrong"
          }
     ]
}