Actions

BeforeQuestionRender: Difference between revisions

From LimeSurvey Manual

(2.06 system)
mNo edit summary
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
TODO: This event is not completely compatible with 3.x yet.
'''When'''
'''When'''


This event happen when question part from template is displayed.
This event is triggered when a question part from the template is displayed.


'''Input'''
'''Input'''
Line 9: Line 11:
* ''surveyId'' the id of the current survey
* ''surveyId'' the id of the current survey
* ''type'' the code of the [[Question_types|question type]]
* ''type'' the code of the [[Question_types|question type]]
* ''code' the question code
* ''code'' the question code
* ''qid'' the id of the current question
* ''qid'' the id of the current question
* ''gid'' the id of the current group
* ''gid'' the id of the current group
* ''text' the question text
* ''text'' the question text
* "questionhelp" the question help (by admin user)
* ''questionhelp'' the question help (by admin user)
* ''class' the question css class
* ''class'' the question css class
* ''man_class' the mandatory css class (mandatory and/or missing or empty)
* ''man_class'' the mandatory css class (mandatory and/or missing or empty)
* ''input_error_class' the input error css class (input-error or empty)
* ''input_error_class'' the input error css class (input-error or empty)
* ''answers'' the complete HTML answers part  
* ''answers'' the complete HTML answers part  
* ''help'' the question help text, by LimeSurvey
* ''help'' the question help text, by LimeSurvey
Line 22: Line 24:
* ''valid_message'' the question validation HTML message (Expression Manager)
* ''valid_message'' the question validation HTML message (Expression Manager)
* ''file_valid_message'' the question validation HTML message for upload question type
* ''file_valid_message'' the question validation HTML message for upload question type
* ''aHtmlOptions'' The actual option for the question part (actually only style is set)
* ''aHtmlOptions'' The actual option for the question part in array


'''Possible output'''
'''Possible output'''
* ''text'' new text for the question : in template {QUESTION_TEXT}
* ''text'' new text for the question : in template :  <code><nowiki>{{ aQuestion.text | raw }}</nowiki></code>
* "questionhelp" : new question help {QUESTIONHELP}
* ''questionhelp'' : new question help {QUESTIONHELP}
* ''class'' new question css class for the question : in template {QUESTION_CLASS}
* ''class'' new question css class for the question : in template : <code><nowiki>{{ aQuestion.class }}</nowiki></code>
* "man_class" new question css class for the question : in template {QUESTION_MAN_CLASS}
* ''man_class'' new question css class for the question : in template {QUESTION_MAN_CLASS}
* "input_error_class" new question css class for the question : in template {QUESTION_INPUT_ERROR_CLASS}
* ''input_error_class'' new question css class for the question : in template <code><nowiki>{{ aQuestion.input_error_class }}</nowiki></code>
* ''answers'' new HTML for answer part rendering
* ''answers'' new HTML for answer part rendering : <code><nowiki>{{ aQuestion.answer | raw}}</nowiki></code>
* ''help'' new help text for the question : in template {QUESTION_HELP}
* ''help'' new help text for the question : <code><nowiki>{{ aQuestion.help.text | raw }}</nowiki></code>
* ''man_message'' new mandatory message (QUESTION_MAN_MESSAGE}
* ''man_message'' new mandatory message : <code><nowiki>{{ aQuestion.man_message        | raw }}</nowiki></code>
* ''valid_message'' new validation html message (QUESTION_VALID_MESSAGE}
* ''valid_message'' new validation html message : <code><nowiki>{{ aQuestion.valid_message        | raw }}</nowiki></code>
* ''file_valid_message'' new validation html message for upload question type (QUESTION_FILE_VALID_MESSAGE}
* ''file_valid_message'' new validation html message for upload question type : <code><nowiki>{{ aQuestion.file_valid_message        | raw }}</nowiki></code>
* ''mandatory'' HTML to produce for mandatory {QUESTION_MANDATORY}
* ''mandatory'' HTML to produce for mandatory <code><nowiki>{{ aQuestion.mandatory }}</nowiki></code>
* ''aHtmlOptions'' New wrapper html options (in array), id was replaced by core system and can not be added here <code><nowiki>{{ aQuestion.attributes }}</nowiki></code> {{newIn|3.5.5}}
 
'''Example'''
 
<syntaxhighlight lang="php">
// todo
</syntaxhighlight>
 
[[Category:Plugins events]]

Revision as of 09:08, 24 July 2018

TODO: This event is not completely compatible with 3.x yet.

When

This event is triggered when a question part from the template is displayed.

Input

The event receives the following information:

  • surveyId the id of the current survey
  • type the code of the question type
  • code the question code
  • qid the id of the current question
  • gid the id of the current group
  • text the question text
  • questionhelp the question help (by admin user)
  • class the question css class
  • man_class the mandatory css class (mandatory and/or missing or empty)
  • input_error_class the input error css class (input-error or empty)
  • answers the complete HTML answers part
  • help the question help text, by LimeSurvey
  • man_message the mandatory error message
  • valid_message the question validation HTML message (Expression Manager)
  • file_valid_message the question validation HTML message for upload question type
  • aHtmlOptions The actual option for the question part in array

Possible output

  • text new text for the question : in template : {{ aQuestion.text | raw }}
  • questionhelp : new question help {QUESTIONHELP}
  • class new question css class for the question : in template : {{ aQuestion.class }}
  • man_class new question css class for the question : in template {QUESTION_MAN_CLASS}
  • input_error_class new question css class for the question : in template {{ aQuestion.input_error_class }}
  • answers new HTML for answer part rendering  : {{ aQuestion.answer | raw}}
  • help new help text for the question : {{ aQuestion.help.text | raw }}
  • man_message new mandatory message : {{ aQuestion.man_message | raw }}
  • valid_message new validation html message : {{ aQuestion.valid_message | raw }}
  • file_valid_message new validation html message for upload question type : {{ aQuestion.file_valid_message | raw }}
  • mandatory HTML to produce for mandatory {{ aQuestion.mandatory }}
  • aHtmlOptions New wrapper html options (in array), id was replaced by core system and can not be added here {{ aQuestion.attributes }} (New in 3.5.5 )

Example

// todo