Plugins: Misc

This category contain plugins that cover wide range of specific tasks.

1. Time Access Restriction Plugin - Allow or restrict access to your survey or form depending on the time of day.
2. Score Calculator Plugin - Calculates score of the designated questions.
3. Responses Signature Plugin - Is used to track whether respondents change their answers after first submit.
4. Respondent Tracker Plugin - Tracks when respondents submit or partially submit your survey or form and sends HTTP request to a third-party application.
5. Respondent Location by Phone Number Plugin - Tracks respondents location coordinates by their phone number.
6. Respondent Location by City and Country Plugin - Tracks respondents location coordibates by their city and country.
7. Respondent ID Saver Plugin - Assigns unique identifier to respondents and then is used to track them.
8. Remote Validator Plugin - Allows to validate text responses via a third-party application.
9. Name Validator Plugin - Validates respondent's name and prevents entering random characters.
10. Logical CSS Plugin - Different CSS is applied depending on the repondents answer to a certain question.
11. Email Validation Plugin - Validates the respondents' email addresses and prevents from entering incorrect emails.
12. Day Access Restriction Plugin - Allows opening survey or form to respondents during particular weekdays.
13. Circular Progress Bar Plugin - Is used to to apply custom circular progress bar to a multi-paged survey or form instead of the default one.
14. Captcha Validation Plugin - Prevents filling your survey or form by a computer bots.
15. Autofiller for 3D Matrix Questions Plugin - Prepopulates question of the '3D Matrix' type.
16. Action Logger Plugin - This plugin is used to log all respondents' activities when they fill your survey or form.

Time Access Restriction - Using this plugin you can set time interval when your survey or form will be accessible by respondents. To insert this plugin adjust the following parameters:

1. Timezone - Indicate the timezone for plugin to work, use ISO format (GMT, EST, PST, etc). This can be yours or your respondents location timezone. Deafult value is GMT.
2. *Time Range - Use the hh-hh format to indicate time range when your survey or form will be accessible for respondents. For example, if you select EST (eastern standard time) and 5-17, the survey will be accessible from 5am until 5 pm eastern time.
3. *Alert Message - To notify those who enters your survey or form when it is closed, use this field for the warning message. For example: "Sorry! You are allowed to access this survey from 5 a.m till 5 p.m only".

Score Calculator - As a part of the Education Package feature, this plugin can be used to calculate and save total score only for separate question or questions section. Assign values to answer choices using Branch on Range feature and adjust the following parameters:

1. First Question in Section - Indicate number of the first question in section to calculate score, for example: 4.
2. Last Question in Section - Indicate number of the last question in section to calculate score, for example: 10.
3. *Question to score score - Create new or use existing question of Single Line type as a holder fo the calculated score. Use the Qx.Ay notation to reference to this question and calculated score will be saved within this question.
   
   Note: question that saves respondents' scores should be placed on a new page only after the block of questions it calculates a score for.


4. Question to store maximum - this parameter shows maximum score that respondent could get upon submitting the survey. Use the Qx.Ay notation to reference to a Single Line question to save results.
5. Question to store percent - Based on the maximunm score and the actual score that respondents got, this parameter calculates percentages from the maximum score. For example: if maximum score is 100 points and respondent's result is 71, this parameter's value will be 71%. Use the Qx.Ay notation to reference to a Single Line question to save results.

Responses Signature - This plugin assigns signature (unique identifer) to the survey response after it is submitted. Then when previewing By Respondent report system checks this unique identifier and if it remains the same you can view the report for such respondent. Otherwise it means that respondent has changed the answers.
To apply this plugin create new question or reference to the existing question of the 'Single Line' type. It will be used to store respondents signatures (unique identifiers). You can either keep it visible to respondents or hide it.

1. *Signature Field - Reference to a question in your survey of form to store respondents signatures. Use Qx.Ay notation, where:
   x - question sequence number;
   y - answer choice number.
   For example: Q2.A1"

Respondent Tracker - This plugin is used to track new respondents in your survey or form and then send request in HTTP or HTTPS form to a third-party application. Thus you can have an up-to-date information on new respondents without logging to the web application.

1. *Notify URL - Specify the URL to send a request when respondents submit or update their results. The following parameters can be used:
   <surveyId> - survey or form unique identifier.
   <respondentID> - respondent unique identifier.
   <start_date> - the date when respondent opens the survey or form.
   <linkId> - unique survey or form link.
2. *Type of Response - this parameter defines group of respondents, which will be tracked.
   Completed - notification request will be sent when respondents click the Submit button.
   Abandoned - notification request will be sent when respondents click the Next or Back button. This is applicable for the surveys or forms that have more than one page.

Respondent Location by Phone Number - If you ask respondents to provide their personal details within the survey or form, you can retrieve respondents geographical location using phone numbers they enter.

1. *Phone Number Question - Reference to a question in your survey of form asking respondents their phone number. Use Qx.Ay format, where:
   x - question number;
   y - answer choice number.
2. Country Question - You can use the same question to keep the country information or create new question. Use the Qx.Ay notation.
3. City Question - You can use the same question to keep the city information or create new question. Use the Qx.Ay notation.

Respondent Location by City and Country - If you ask respondents to provide their personal details within the survey or form, you can retrieve respondents geographical coordinates using city and country information they enter.

1. Country Question - Reference to a question in your survey of form that asks respondents their country. Use Qx.Ay format, where:
   x - question number;
   y - answer choice number.
2. City Question - Reference to a question in your survey of form that asks respondents their city. Use Qx.Ay format.
3. State Question - Reference to a question in your survey of form that asks respondents their State or region. Use Qx.Ay format.
4. ZIP Code Question - Reference to a question in your survey of form that asks respondents their ZIP code. Use Qx.Ay format
5. *Latitude Question - You can use the same question to keep respondent's latitude coordinates or create new question. Use the Qx.Ay notation.
6. *Longitude Question - You can use the same question to keep respondent's longitude coordinates or create new question. Use the Qx.Ay notation.
7. *Output Type for Coordinates - Choose the way you want latitude and longitude coordinates values are displayed:
   DD for degrees;
   DDMM for degrees and minutes;
   DDMMSS for degrees, minutes and seconds.

Respondent ID Saver - When respondents participate in your survey or form they are assigned with the unique system identifiers which can be retrieved by means of this plugin. Create new or use existing question of 'Single Line' type as a holder fo the respondent ID and then reference to this question using the following parameter:

1. *Respondent ID Question Reference - Use Qx.Ay format, where:
   x - question number;
   y - answer choice number.

You can also reference to a Multiline type of question using the Qx.A1 notation as this type of question proproses only one answer choice and to the 'Comment' field of the Pick One or Other type of question using the Qx.Ay notation.

Remote Validator - This plugin is used to validate responses of a text questions through a third party applications. Response is automatically sent to a third party application, then response request is sent back immediately. If this response request matches the request code, respondents are allowed to submit their survey or form. Otherwise they will be prompted with a warning message.

1. *Answer to validate - Reference to a Single Line, Multiline or Numeric Allocation question to validate text responses. Use the Qx.Ay notation, where:
   x - question number;
   y - answer choice number.
2. *Remote URL - Indicate a third-party application URL to which the validation request will be sent. Use the following format: http://domain.com/
3. *Positive Response Code - Indicate the response code that a third party application will generate if answer validation passed successfully. If indicated code matches third party application response code respondents will be allowed to move further.
4. *HTTP Request Method - Select the request method which will be used to access a third-party application. It is recommended to use the 'POST' method if the URL is very long or has some non-ASCII characters. Use 'GET' if the target form is idempotent (usually a pure query form).
5. *Alert Message - If a response from the remote server does not match the Positive Response Code, this message will be displayed to respondents.
6. *Validation Parameter - Input validation parameter that is used in a third-party application, for example: param.

Name Validator - This plugin is commonly used when you collect respondents' personal data, such as names, email addresses and others. To make sure respondents provide correct names instead of random characters, apply this plugin. Respondents will be allowed to enter only symbols of alphabet, as well as single apostrophe or hyphen.

1. *Name Field - Use the Qx.Ay notation, where:
   x - question number;
   y - answer choice number.

Example of names that will be validated and names that will not be accepted:
Valid names: Robert, William Brown, Nate.
Invalid names: wwwwwwww, fren283=, !!!!!.

Logical CSS - In case you need to deploy the same survey to the different groups of people so each group faces its particular survey design this plugin should be used. Before applying plugin create different survey styles using CSS, save them locally as a .css files and upload these files to your Web site or any other hosting provider site. Thus the link to the CSS should looks as following: http://yourwebsite.com/custom.css.
You can also use one of the styles available on the Layout page of your survey. Please click the Live Support link at the right top or email at support@worldapp.com and our Support team will assist with retrieving pre-defined survey styles.

When this is done and links to the survey design files are retrieved, adjust the following plugin parameter:

1. *Expression and CSS URL - Indicate logical expression upon which survey must be applied with the specific CSS.
   Expression format is the following: Qx.Ay -> http://website.com/file.css, where:
   x - question number;
   y - answer choice number.
   You can also use AND and OR logical operators to built complex logical expressions.

Use new line to set multiple logical conditions for multiple styles of your survey. Thus respondent whose answer will meet indicated condition will see the survey with the specific design.

Email Validation - This plugin is commonly used to validate respondents' email addresses they provide in your survey or form. Respondents who entered syntactically incorrect email address or address with non-existing domain name will not be able to proceed further or submit.

1. *Email Field - Enter reference to a question where you ask respondents for their email address. Use Qx.Ay format, where:
   x - question number;
   y - answer choice number.

Day Access Restriction - It may appear that you want your respondents access their survey of form only during particular days in a week. Using 'Day Restriction' plugin you can accomplish this without adjusting Start and End survey dates on the Launch page of your survey or form each time you want to open or close it for voting.

1. Timezone - Indicate time zone for plugin to be applied. This can be your location's time zone or a time zone of your respondents if different, for example EST (Eastern Standard Time, GMT -5h). The dafault value is GMT (Greenwich Mean Time)
2. *Weekdays Range - Select days of the week when plugin should be applied. To select more than one item hold down CTRL key and left-click using mouse (COMMAND + mouse click for MAC OS).
3. *Access Allowed/Prohibited - Adjust this parameter to allow or restrict access during the selected days of the week.
4. *Alert Message - Enter the alert message to your respondents if the time of their access to survey or form is out of the indicated period.

Circular Progress Bar - If your survey has more than one page you can apply progress indicator on the Rules page of your survey or form. In case standard bar graph does not meet your requirements, you can apply circular progress indicator and adjust its color to the color scheme of your survey or form.

1. Border Color - Indicate color for the border of the circular progress indicator. Use the rgb(x,y,z) format, for example:
   rgb(255,0,0) - red;
   rgb(0,0,255) - blue;
   rgb(0,0,0) - black.
2. Fill Color - Indicate color to fill the progress indicator using rgb(x,y,z) format.

CAPTCHA Validation - Use this plugin to ensure your survey or form is submitted by real respondents instead of computer bots. Insert new question of the 'Single Line' type at the beginning of your survey or form and ask respondents to enter code for validation. You can also reference to the existing question. Then go to the plugin's edit page and reference to this question using the following parameter:

1. *Question Reference - Enter reference to a new question where you ask respondents for the validation code. Use Qx.Ay format, where:
   x - question number;
   y - answer choice number.

Autofiller for 3D Matrix Questions - If you prepopulate your survey or form using the Autofill feature it is is not possible to prepopulate questions of '3D Matrix' type, until you use this plugin. More details:

Action Logger - Use this plugin to log all respondents' actions during the voting process. This is commonly used if your survey or form has complex structure and multiple pages to control correct respondents and survey behaviour. It is also used if you perform Salesforce.com integration. Firstly create new question of the 'Single Line' or 'Multiline' type to store logs, hide this question so it is not visible to respondents and adjust following parameters:

1. *Log Question - Enter reference to a new question where you want to keep responses. Use Qx format to reference to the 'Multiline' type of question or Qx.Ay format to reference to the 'Single Line' type, where:
   x - question number;
   y - answer choice number.