Poll address

Poll addresses are similar to addresses of wikipage section: Pagetitle#poll_id. "Title part" before the dash sign can be omitted to specify the address of the poll located at current page. However, the part after the dash sign is not a section. It's an ID of some poll declared at the page Pagetitle, specified as <qpoll id="poll_id">. Poll addresses are currently used as value of address and dependance attributes (see just below) and in qpuserchoice parser function.

Mode definition poll attributes

• id attribute switches poll definition into declaration / voting mode. It defines string identifier of the poll at the current wikipage. It must be unique on the wikipage. The identifier with the same name might be re-used only at another wikipage. This is because polls cannot be remotely voted at another pages. Please note that id value should be specified without the preceding dash sign, for the very same reason. Non-ASCII id's are possible, just place the value of attribute in quotes (an example in Russian):

<qpoll id="алмаз1">...</qpoll>

• address attribute switches the poll definition into statistical display mode. The value of attribute specifies short or full address of the poll, whose statistical data should be displayed. For example, it's very handy to create a page or column of the page, where the results of different polls from different pages will be shown. To display statistics of user voting for <qpoll id="poll2"> declared at Page1 and <qpoll id="poll5"> declared at Page2, one can use the following code (just replace question attributes with real question attributes, or with empty set of attributes {} ):

<qpoll address="Page1#poll2">
{question attributes}
{question attributes}
</qpoll>
<qpoll address="Page2#poll5">
{question attributes}
{question attributes}
</qpoll>

Only common question_attributes can be specified in this poll mode, one question header per line, enclosed into the curly braces.

Declaration / voting mode

This mode was the only mode available before v0.6.0. Make sure that poll / question attributes are compatible to that mode, otherwise you should get syntax error messages. There are some common attributes which are applicable to any mode, see below.

Every poll may contain an one or multiple question(s):

<qpoll poll_attributes>
{common_question
|question_attributes}
metacategories
categories
...

{common_question
|question_attributes}
metacategories
categories
...

{common_question
|question_attributes}
metacategories
categories
...
</qpoll>

• common_question : Common question describes the purpose of the question at whole. It's not mandatory and thus can be blank. Questions are automatically numbered from the number one. Since v0.8.0 questions also may have names defined via question "name" attribute to simplify their usage in interpretation scripts.
• question_attributes : xml-style list of question attributes.
• metacategories : optional source line, containing the row of cells, separated by special character ("|" or "!"). Every cell is either a name of metacategory or is an empty one. Empty cell(s) before a cell with the name of metacategory define the count of categories, placed into the group (metacategory). The groups make a "subquestions" in the question of "single" category selections type (see Question attributes). In the source code these are referred as "category spans". Real metacategories are separated with "|". It is also possible to create "fake" metacategories, which serve the purpose as comments to categories and don't create real subquestions. In such case "!" character should be used as a cells separator. Wikilinks and templates can be used in metacategory names (since v0.4.1), though beware of posting non-existing templates, you'll get unexpected category names. Define your templates before submitting the poll.
• categories : mandatory source line, containing the row of cells, separated by "|" character. Defines the list of categories (columns) in the question table. Categories are the "possible answers", internally numbered from zero. Wikilinks and templates can be used in category names (since v0.4.1), though beware of posting non-existing templates, you'll get unexpected category names. Define your templates before submitting the poll.
• ... : mandatory list of proposals (one or more source lines). For the types of question "()", "unique()", "[]" (see Question attributes) these lines contain just the list of proposal texts, one proposal per line. For the type of question "mixed" (since v0.4.0), proposal text is preceeded by list of input types, one element per category defined:

[]()<> proposal text

The above proposal line defines three input fields, the first is a checkbox, the second is a radiobutton, the third is a text field. Proposals are internally numbered from zero.

• Since v0.8.0 proposals of "text" question type can be named, multi-line and to have their text mixed in-between with various types of categories.

_{Note that category spans, metacategories, category groups are just a different description of the same logical category grouping. Grouping can be applied only to radiobuttons (for example, a group of two radiobuttons is a logical equivalent of checkbox).}

_{Metacategories (category groups) are unavailable for the types of question "[]", "mixed".}

_{Internal numbering of questions, categories and proposals is important because they might be addressed later as a parameter of the extension's #qpuserchoice parser function.}

Poll attributes

Version 0.6.0 of extension introduces two separate modes of polls: declaration/voting mode and statistical display mode. These modes are selected by choosing appropriate poll attributes:

• specifying id attribute causes the poll definition to use declaration/voting mode (the only mode available prior to v0.6.0)
• address attribute causes the poll definition to use statistical display mode, which should be used to display the results of the polls at any wikipage - without the forms used to submit the polls.

The modes are mutually exclusive, so no both id and address attributes can be used together in one poll definition. Also, while some of poll attributes have sense in both modes, many of poll attributes can be used exclusively in one mode. However, nothing prevents the user to define the poll and to show it's statistical results at the same page - just define the poll twice - once with id attribute, another time with address attribute.

Question attributes

"text" type of question

Since v0.8.0 new "text" type of question was introduced. Similar to "mixed" question type described just above, it allows to mix various input types but in a more flexible and powerful ways. Definition of proposal is not separated from definition of category inputs. Instead, categories are embedded directly into proposal text. Due of that, categories (possible choices) are enclosed into tag-like angle braces <...>. In addition to radiobuttons defined as <()> and checkboxes defined as <[]>, it allows to define text inputs of various types.

:|proposal_attributes|proposal_and_category_definition

:|name="age" emptytext="no"|Age* <<::width=2>>

:|name="ethnic_origin" emptytext="no" catreq=1|Ethnic origin<sup>*</sup> <<Russian|Tatar|Ukrainian|Bashkir>> or (''arbitrary'') : <<>>

:|name="short_text"|A duck is a type of <<|fish|mammal|bird>>.<br />Hi! My <<|name|country|city>> is Andrew. How are you?<br />Today is Sunday. Tomorrow is <<|Friday|Saturday|Monday>>.