|
This area covers the basic parameter
information
Note: Items in red are supported only in the
full version.
Heading_Image
Background_Image
Background_Color
HiLite_Color
Loading_Color, Loading_Text_Color
InputFile
Previous, Next, Answer, Submit Buttons Customization
MaxTextBoxSize
Submit_URL
Border
Copyright Parameter
Automatic Resizing (I.e., ability to change dimensions simply through applet width/height parameters)
SCRIPTING
Comments
Checkboxes
Drop Down Boxes
End Of Pages
Line Breaks
Labels
Lists
Images
'No question'
Text Blocks
Text Lines
SPECIAL NOTES (MUST READ THIS TO USE)
Background_Image |
This is the background image to show for ABPollMaster. (Basically, you can customize
the look and feel of what it should look like on the borders.) For example,
<PARAM name=BACKGROUND_IMAGE value="background.jpg">
|
Heading_Image |
This is the image that you would like displayed on every 'page' of your
survey/quiz/presentation. It is always displayed at the top of each page.
For example,
<PARAM name=HEADING_IMAGE value="title.jpg">
|
Background
Color |
This is the background color of the software. For example,
<PARAM name=BACKGROUND_COLOR value="#8F8FFF">
|
Hilite_Color |
This is the color that text should become when someone presses the 'answer' button.
(For example, if the 'hilite_color' was white, then, if you had a bunch of checkboxes, and
someone wanted to find out what the answer was, they would click on 'answer', and the text
would change color, indicating the correct answer.
For example,
<PARAM name=HILITE_COLOR value="#FFFFFF">
|
LOADING_COLOR,
and LOADING_TEXT_COLOR |
This is the background color when the software is loading/initializing. (I.e., when it
says "100% Complete" while it is loading, and the progress bar is shown).For example,
<PARAM name=LOADING_COLOR
value="#FFFFFF">
LOADING_TEXT_COLOR is simply the color that the text should be while loading.
|
INPUTFILE |
This is the name of the survey file that should be loaded.For example,
<PARAM name=INPUTFILE
value="ABPollMaster.txt">
|
Previous,
Next, Answer, Submit Buttons |
These parameters allow you to control what the various buttons look like.
(If you do not include these parameters, then they will not show up)For example,
<PARAM name=PREVIOUS
value="<<">
<PARAM name=NEXT value=">>">
<PARAM name=ANSWER value=" Answer ">
<PARAM name=SUBMIT value="Submit!">
Makes a previous button appear as "<<" that allows you go to the
previous entry. The ">>" allows you to go to the next item, " Answer
" makes the answer button (that provides the answer to the current question sheet),
and 'submit' submits the information to the URL that you specify (in the 'submit_url'
parameter).
|
MAXTEXTBOXSIZE |
This controls the maximize size that the text boxes can be. I.e., the text boxes
automatically resize depending on how much text you have. But if you want it to say, not
go farther than 5 lines (because it might not fit), you would enter a value of 5. For
example,<PARAM
name=MAXTEXTBOXSIZE value="5">
|
SUBMIT_URL |
This is the URL where information should be passed to (all the answers that the user
selected). It is of the format q#a#, where q# is the question page (i.e., page 1, page 2,
page 3, etc), and a# is the answer on that page (i.e., if you had four text boxes, on page
2, it would be q2a0=__value, q2a1=___,q2a2=___,q2a3=___. For example, <PARAM name=SUBMIT_URL
value="process.php3">
Check boxes have values of either 'true' or 'false'.
Text boxes have the text value that was entered.
Drop down boxes have the text value that was selected
List boxes (in which more than one item can be selected) are text, and separated by
commas. For example, if someone filled out the sheet as (on the first page, after the
intro page), it would be:
|
Border |
This is the margin (height and width) of where the actual 'quiz'/'survey' should be
centered in. (I.e. you have a background image to customize the look/feel. This allows you
to place the 'quiz/survey' on top of this).<PARAM name=BORDER value="10">
|
Copyright
Parameter |
This parameter must always appear, and is as follows (note: it should be one line
in your HTML files, with no line break):<param
name="copyright" value="http://www.wyka-warzecha.com">
|
For the script File
Comments:
If you wish to have comments in your datafile (i.e., perhaps for testing purposes), simply
put "//" (without the quotes) in front of the text line.
I.e.,
// These are comments.
Checkboxes:
To add a checkbox, simply do the following. If it is a 'true' value (i.e., if you are
using it for a quiz, and the answer should be true/checked), then you would have:
;[checkbox true]My checkbox question here
If it was false, it would be:
;[checkbox false]My checkbox question here
Drop Down Boxes:
Simply start it off with ;[dropdown box] plus the first item. For every item after that,
separate it with a "`". (**NOTE**, this is a 'backwards' apostrophe (located in
the upper left hand corner of most computer keyboards). For example,
;[dropdown box]Michael Jordan
`Charles Barkley
`*Tim Duncan
`Shaquille O'Neal
Put an asterisk (*) beside the answer that should be 'true' (i.e., when someone
wants to find out the 'correct' answer).
End of Pages:
When you want to finish a page, (i.e., in a quiz), you must include (exactly) this
line:
---[end of page]---
Line Breaks
If you want to have a line break (spaces between lines) simply add this in your
text <linebreak>. For example, if you had the text:
This is a test<linebreak>And this is a second
line
It would appear as:
This is a test
And this is a second line
Labels
To include a lable (i.e., display a message above say a text box, or a checkbox)
you would type in:
;[label] This is my label!
Lists:
Creating a list consists of four parts.
The first part is the ;[list] parameter.
The second part is how many lines (how large) it should be.
The third line indicates whether the user can make 'multiple' selections, or
'single' selections.
And finally, the fourth part consists of the actual text, separate by reverse
apostrophes (usually located on the left hand side of your keyboard, right below a tilde
(~)). And, if the value is correct (i.e., for a quiz), simply put an asterisk beside it
(*).
For example,
;[list]
`4
`multiple
`*Wilt Chamberlain
`Michael Jordan
`Bill Russel
`Kareem Abdul-Jabar
`Grant Hill
`Pat Riley
Images:
If you wish to have an image (which is displayed at the top
of the page, below the header if you have one, simply include the ;[image] followed by the
image name. I.e.,
;[image]question.gif
Text Line
If you want someone to be able to enter text, simply include
a parameter that starts with ;[text line], for example:
;[text line]6
'No Question'
If you don't want a page to be counted as part of the questions, simply add the parameter:
;[no question]
Text Blocks
If you want a block of text (that is resized automatically for
display only), simply put in the ;[textblock] parameter followed by the text you want. For
example,
;[textblock]Who has scored the most points all-time in the
NBA?
Special Notes:
MAKE SURE when you write your scripting code, that you do not have 'empty lines' in
between. I.e., make sure there is text on every single line in the data file, otherwise it
will not work correctly. I.e., You can have:
;[textblock]
Welcome to the ABPollMaster!
<linebreak>
<linebreak>
---[end of page]---
But CANNOT have (note that there is an extra empty line in
between "Welcome to the ABPollMaster!" and "<linebreak>":
;[textblock]
Welcome to the ABPollMaster!
<linebreak>
<linebreak>
---[end of page]---
|