Modal Survey for WordPress

Documentation


Table of Content

  • Item Name : Modal Survey for WordPress
  • Minimum Required : WordPress Version 3.9
  • Author by : Pantherius
  • Support via Email : Contact Link

Thank you for purchasing my plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here.

This plugin provide the opportunity to hear your visitors voice through this attention grabber survey. It has a lot of customization options, therefore I’m sure you won’t meet with the same survey on other websites. Thanks to the unlimited gradient color picker, you can create unlimited styles with this premium WordPress plugin.

Install Guide #back to top

If All files & documentation has been downloaded, then you need to unzip the file to get the installable WordPress Plugin ZIP file.


Upload via WordPress Admin

Use your WordPress Administration Page to browse and upload the plugin ZIP file. Pay attention to upload the correct ZIP, otherwise you will get an error message. If it happen, please unzip the downloaded file and upload the inner ZIP file since that will be the installable WordPress package.

Add New - #back to top

First, log in to the Administration area of your Wordpress website and select Plugins then Add New.

Browse - #back to top

Select Upload on the top of the page, browse the plugin ZIP file and click on the Install Now button.

Upload - #back to top

Click on the Activate Plugin link and the plugin will be active. After successful plugin activation, you will be redirected to the plugins' list page.

Activate - #back to top

Find the Modal Survey plugin in the list. You can now configure your first survey.

Upload via FTP

Unpack the plugin ZIP file to a folder, then copy all files with the modal_survey directory to your website wp-content/plugins folder.
Login to your administration area and activate the plugin.

How to Create Survey #back to top

New surveys will be automatically displayed on the frontend area unless you turn OFF the Set Global Survey option in the General Settings


The pugin has a simple, but very powerful options. You can add new survey with clicking on the Create Survey link on the left side under the Modal Survey main navigation menu. Alternatively, choose the Plugins and Installed Plugins, then select the Settings under the Modal Survey in the Plugin list page. Enter your survey name into the text field, then click on the New Survey button.




New Question - #back to top

Click on the New Question button on the right side and the new question will be immediately included. You can add as many as you want, but don't forget, too much questions can naturally make you website slower. The questions are sortable, so you can easily change the order. Delete the questions by clicking on the minus sign at the end of the question line. The first question can't be deleted.




Question Options - #back to top

These options provides the possibility to set question specific settings, like image, optional number of answers, etc.

  • Optional Answers: Set the number of answers that can be selected for the current question.
  • Required Answers: Set the number of answers that is required to select for the current question.



New Answer - #back to top

Click on the plus sign at the end of the second answer and the new answer immediately inserted. You can add as many as you want, of course depends on the visibility possibilities.(eg.: 40 answer doesn't look like good on the front side of your website). You can delete the answers by clicking on the minus sign at the end of the actual answer line. The first and the second answers can't be deleted. The plugin using Cookies to display the same Surveys only once for the same user. If you create more active Surveys, one user will get always new Surveys on every page reloading (if available). You can also insert download links to the Thank you message field, in this case, the plugin will detect that and the message won't be disappear until the user click on it.




Open Text Answer - #back to top

Open Text Answers can be exported individually since hundreds or even thousands of answers can break the layour of the general export file. You can view the answers in the Answer Options by clicking on the gear icon at the left side of the answer.




Answer Options - #back to top

Each answer has an own settings area, that allows you to customize the answer parameters. (image, score, etc.)

  • Answer Score: Set a score for this answer to create beautiful chart based on the scores.
  • Set as Correct: Mark this answer as correct answer in the question. You can create conditions based on the correct answers.
  • Add Image: Upload a custom image thumbnail to the answer.



Conditional Logic, Chained Answers and Questions- #back to top

The plugin provides the option to redirect the user to a specified question based on the answers. Simply define the question numeric ID (order) in brackets right after the answer text as the screenshot demonstrate on the left. In this example, when the user choose Asia as an answer, the next will be the third question, otherwise it will continue with the second question. To redirect to the Participants Form, add one to the last question number eg. If there are 21 questions, adding 22 would redirect to the Participants Form. The Participants Form must be enabled.






Assign Categories to Questions- #back to top

It is possible to assign categories to the questions, setting up scores in the Answer Options then display the results based on the category scores. Simply add the category name in brackets right after the question text.

Use the data="score" parameter in the result shortcode to display the global, cumulative results:

[survey_answers id="12345" style="barchart" data="score"]

If you add uid="true" and session="last" to the shortcode, it will show the individual results:

[survey_answers id="12345" style="barchart" data="score" uid="true" session="last"]






Assign Categories to Answers- #back to top

Categories can be added to the answers as well with the same way as to the questions. Simply add the category name in brackets right after the answer text. Comma separated, multiple categories are supported here. You can easily exclude the question text from the results and display the categories only by adding the minus sign in brackets right after the question text.

Use the data="score" parameter in the result shortcode to display the global, cumulative results:

[survey_answers id="12345" style="barchart" data="score"]

If you add uid="true" and session="last" to the shortcode, it will show the individual results:

[survey_answers id="12345" style="barchart" data="score" uid="true" session="last"]




Conditional Logic, Chained Answers and Questions- #back to top

The plugin provides the option to redirect the user to a specified question based on the answers. Simply define the question numeric ID (order) in brackets right after the answer text as the screenshot demonstrate on the left. In this example, when the user choose Asia as an answer, the next will be the third question, otherwise it will continue with the second question. To redirect to the Participants Form, add one to the last question number eg. If there are 21 questions, adding 22 would redirect to the Participants Form. The Participants Form must be enabled.














Configuration - #back to top

There are many custom options helps you to make your survey really unique. The settings in the Survey Options section will affect the entire survey display. The conditions allows to create actions based on the votes and answers. Existing email campaigns can be connected in the Campaigns accordion. Use the Tutorial button to start an interactive tutorial that will show you the basic informations about how to use the plugin.

  • Start Time: You can schedule the starting time of the Survey. Leave it blank to start it immediately.
  • Expiry Time: The expiration time of the actual Survey. The Survey never expire if you leave it blank.
  • Display Style: The surveys appears on the bottom part of the website by default, but you can select the top or the center area as well.
  • Mode: In most cases, just set the Default mode (you can overwrite it via the shortcode to make it embed). If you would like to add the survey automatically to the posts, set Embed - End or Embed - Start option, depends on the position of the survey in the post. In this case, you DON'T have to use any shortcode, the integration managed by the plugin automatically.
  • Text-Align: Define the horizontal position of the texts inside the survey.
  • Animation Easing: This is the full range of available easing effect for jQuery animations, choose the best you like. You can try out all of these with clicking on the Play Button on the right side.
  • Font Family: You can select from more than 650 Google Font Styles, if you would like to use your website default font settings, just leave it on the default value. You can also try out this option if you click on the play button and select different font family.
  • Border Width: The initial Border Width value is 1px, but you can reduce it to zero or increase. This setting is linked to the Border Color Picker.
  • Border Radius: It is possible to make rectangles or ovals. Check the changes in Play mode.
  • Font Size: The size of the texts on the Survey including the question, answers and the thank you message.
  • Padding: With this setting you can set the distance of the texts from the borders.
  • Line Height: Vertical distance of the texts related to the borders.
  • Animation Speed: The starting animation speed in seconds.
  • End Delay: Set the delay time at the end of the survey before disappeared.
    Set it to 0 to turn it off ( disable hide animation at the end )
    It can be specified in the shortcode as a parameter: [modalsurvey id=1841031562 enddelay="0"]
  • Thank you message: After the users answered al questions, this message will appear last. Generally, you can leave it on the default value, but you can translate or reword. Use the [score] tag to display the total score and [correct] tag to show the total correct answers.
  • Redirect URL: Redirect the browser after completing the survey.
  • Background Color Picker: The Gradient Background Color Picker provide a huge customization options. You can add color slider as many as you want. Choose the colors by clicking on the sliders.
  • Font Color Picker: The Font Color Picker allows you to choose the best font color you wish.
  • Border Color Picker: To see the results of this color picker, you have to set the Border Width settings to 1px or higher.
  • Global Survey: This setting is on by default. Choose this if you want to display the Survey on all pages.
  • Lock Screen: A transparent dark background lock the screen. You can combine this option with the Closeable setting.
  • Closeable: The users can close the Survey by clicking on the imageDisplay at bottom(x) or on the transparent background.
  • Display at bottom: The Survey animation is starting when the page is loaded by default. If you set this option to on, the Survey will appear when the user scrolled down to the bottom of the page.
  • Logged in only: The survey will appear for logged in users only.
  • Show Progress Bar: Including a progress bar that display the completion percentage of the survey.
  • List Layout: Show the answers below each other instead of the grid layout.



Conditions - #back to top

Conditions gives you the opportunity to make different actions at the end of the survey based on the user's answers. You can add as many conditions as you wish, but avoid creating conditions that has a conflicts with each other.

Example:

Condition1: If Correct Answers higher than 2 then redirect to http://yourwebsite.com/congratulations

Condition2: If Correct Answers higher than 0 then redirect to http://yourwebsite.com/good

If the user has 3 correct answers, then both of the conditions will be true, that can causing conflicts. (One of them won't be processed) As you can see on the following screenshot, you can choose the subject in the first select box. Then select the condition statement, then specify the action









Participants Form - #back to top

Enable or disable requesting name and email field at the end of the survey. It is possible to use only one field or use both of them together. The entered details can be saved to the Participants menu (when the Save Participants Votes is ON in the General Settings) or can be passed to your existing email campaign. (See more in Campaigns)

Auto Response - #back to top

It is possible to send automatic reply to the users with the Auto Response feature.
The editor allows to use smart tags in the email content:

[attachment] - the plugin automatically attach the PDF export of the votes
[score] - replaced with the current user\'s score
[correct] - replaced with the number of correct answers for the current user

Examples:

You scored [score] points in the survey.
You have [correct] correct answer.

The content can be different based on the answers. Just place condition shortcodes in the content:

[survey_conditions id="12345" condition="questionanswer_1" relation="equal" value="1"]
content displayed when the first answer has been selected in the first question
[/survey_conditions]


[survey_conditions id="12345" condition="finalscore" relation="higher" value="1"]
content displayed when the final score higher than 1
[/survey_conditions]


[survey_conditions id="12345" condition="correctanswers" relation="equal" value="2"]
content displayed when the number of correct answers are equal with 2
[/survey_conditions]


[survey_conditions id="12345" condition="questionscore_1" relation="lower" value="5"]
content displayed when the user get less than 5 score in the Question 1
[/survey_conditions]


[survey_conditions id="12345" condition="categoryscore_activity" relation="higher" value="30"]
content displayed when the user get more than 30 score in the activity category
[/survey_conditions]


[survey_conditions id="12345" condition="categoryscore_activity" relation="highest" value="30"]
content displayed when the user get the most scores in the activity category
[/survey_conditions]


The plain text result shortcodes are also usable in the content, excepts the visual elements (charts, bars):

[survey_answers id="12345" style="plain" data="answer_count" qid="1" aid="1"]
This shortcode will display how many users voted for the Answer 1 in Question 1 (read more in the Shortcode Section here)



Campaigns - #back to top

Find the integrated email list providers in this sections. The main checkbox next to the names used for activate or deactivate the newsletter implementation. Simply type your existing campaign details and the plugin will automatically pass the name and email parameters to the campaign.

Don't forget to enable the Participants Form and turn ON the Request Name and / or Request Email Address checkboxes.





Embed Survey - #back to top

Don't forget to disable the Global Survey option when using shortcode, otherwise it will be duplicated.

To Embed the survey to your page or post content, disable the Global Survey checkbox, then copy the shortcode to the editor or use the Shortcode Manager. This basic shortcode: [modalsurvey id="1234543"]
If you would like to use it as embed, add the style="flat" parameter, like this:

[modalsurvey id="1234543" style="flat"]




You can add further parameters to the shortcode:

  • style="flat" - With "flat" value, you can embed the survey to the page. Use "modal" value to display as a popup and "click" to open it with clicking on a link.
  • width="50%" - Specify the survey width in percentages
  • align="right" - Float the survey to the left, center or right when you using less than 100% width
  • textalign="center" - Align the texts in the survey to the left, right or center
  • message="You already filled out this survey" - Specify the message when 'Display Once per Filled Out' option is ON, the survey using embed mode (style="flat"), the user already filled out this survey and visits the survey page again
  • filtered="false" - With "true" value, the survey will displayed on pages and posts only. (Excluding archives, login and the other pages when you using the shortcode in a global text widget)
  • social="off" - If you previously enabled the Social Sharing in the Social Settings, then you can individually disable the social sharing buttons on the current survey.
  • visible="true" - Makes the survey instantly visible in flat mode. False value will display the survey when the user scroll down to the survey place only. (animated display)
  • sociallink="http://yourwebsite.com/" - Pass the URL manually to the sharing buttons (most of the Social Sites doesn't support)
  • socialimage="http://yourwebsite.com/path_to_the_image.jpg" - Pass the image URL manually to the sharing buttons (most of the Social Sites doesn't support it, but you can use it for Pinterest)
  • socialtitle="Title" - Pass the Title text manually to the sharing buttons (some of the Social Sites doesn't support, you can use it for Twitter)
  • socialdesc="Custom Text Description" - Pass the Description text manually to the sharing buttons (most of the Social Sites doesn't support, you can use it for LinkedIn)

Read more about the shortcodes in the SHORTCODES section.

Participants #back to top

Find the detailed stats about the participants and their votes on this page. The first view bring you a list about each completed surveys. Use the checkboxes on the left side to mark rows for deletion and delete them with the DELETE button below. Click on the ID or name to view the detailed stats about the chosen entry.




Feel free to change the chart type with the selector on the top of the screen. This page provides all available informations about the actual user and his votes and a comparison to the global resutls.





Filter Participants- #back to top

However, the participants can be filtered by simply typing some letters to the Search field at the top-right corner of the table, there are another way you can use to get a list about who selected a specified answer.

Simply open the survey edit screen of the chosen survey and locate the answer you would like to filter, then click on the answer as you can see on the screenshot on the left side.

General Settings #back to top

General Settings provides global configuration for the plugin and for all surveys.

The Set Global Survey option will automatically turn ON or OFF the Global Survey checkbox in a newly created survey. As a result, you can exactly control the new surveys are immediately displayed on your website (localhost or test environment) or not (live environment).

With Display Once per User you can set the surveys to display only the first time visit for each users. It will not displayed again the same survey when they return to your website even filled out the survey or not.

Display Once per Filled Out: If the user choose at least one answer, the survey won't be appear again for the same user.

IMPORTANT TO NOTE

Doesn't make sense to enable both of 'Once per User' and 'Once per Filled Out' since the first one will prevent to display the survey for the same user at the next visit. The plugin using Cookies to remember for the visitors for 1 year, deleting the cookies from the browser will allows the user to vote again.

  • Keep Settings after Uninstall: Set to On when you would like to install the updated version of the plugin. This option ensures your saved surveys will remains after the deletion of the plugin, then the new version can use the existing datas.
  • Minify Scripts: By default, the plugin using the minified JavaScript files. Some WEB Hosting automatically minify scipts, then it will be minified twice, that can causing issues. In this case you can set this option to OFF to use the original, unpacked files.
  • Save Participants Votes: The plugin will save the votes into the database, you can view the participants individually in the Participants page. If you are fine with anonymous votes, you can disable this option.
  • Remember Users: This is a special setting for mostly developers. The plugin recognizes all participants as a new one, therefore several features will be disabled with this option. Keep it enabled in most cases.
  • PDF Export Header Text: Custom header text to display at the beginning of the Survey export PDF file.
  • PDF Export Font Family: Custom Fonts to display the characters correctly in the exported PDF. FreeSans supports almost all type of characters.
  • Initialize plugin: Set the initialization hook for the plugin. Some Themes doesn't have a valid footer or header, in this case you can user 'when print the content' option, that works well in all cases.

Social Settings #back to top

Provides the Social Share configuration panel.

Always visible (Default Style):

Always visible (Clean Style):

Always visible (Default Large Style):

Visible at the end in the content:

  • Social Sharing: Enable or Disable the social sharing buttons on all survey. If you enabled, you can disable individually via shortcode parameter, like: [modalsurvey id=499137591 social="off"]
  • Embed Social Metas: Automatically include the following social meta tags and generate their values by the current post datas:

    <meta property="og:title" content="Post Title">
    <meta property="og:description" content="Excerpt of the post if available">
    <meta property="og:url" content="http://yourwebsite.com/">
    <meta property="og:image" content="http://yourwebsite.com/post_featured_image.jpg">
    <meta property="og:type" content="website">
    <meta property="og:site_name" content="Post Title">

    If this option is disabled, use third party plugin to generate the required metas that needs to the social sharing buttons.

It is possible to specify different social button style and position for each survey via parameters in the shortcodes.
The following example will display default buttons at the end of the survey:

[modalsurvey id=499137591 socialstyle="default" socialpos="end"]

Possible value for "socialstyle" parameter: default, default_large, clean, clean_large

Possible value for "socialpos" parameter: bottom, end, endcontent

Export & Import #back to top

Modal Survey offers various type of exports on the survey settings page. Locate the blue Export button, then choose from the CSV, JSON, PDF, XML, XLS or TXT options. The JSON export file can be imported directly, therefore this extension is the best for creating backup files from the surveys. In most cases, these exports contains the survey configuration, questions and answers.

Export

  • Step 1 - Move the mouse cursor over the blue Export button.
  • Step 2 - Choose the export type and wait for the result.
  • Step 3 - Right click on the link next to the button and save the export file to your computer.



Import

Only JSON Export can be imported, therefore you have to save the JSON Export file to your local computer.

  • Step 1 - Locate the previously exported JSON file from your computer.
  • Step 2 - Browse the JSON file.
  • Step 3 - Click on the Upload button.

Update #back to top

There are several ways to update the plugin, read the detailed informations about the process below.

Update via the built-in Updater - #back to top

Download the new version ZIP file, then browse it from your computer. It needs to be the valid plugin ZIP file, therefore pay attention to use the appropriate file, otherwise the updater will be unable to update the plugin. Click on the Update button, that will show you the changelog, including the latest changes. Click on the Start Update button to finish the process.


Update via the WordPress Installer - #back to top

Set the Keep Settings after Uninstall option to ON in the General Settings. Deactivate and delete the plugin, then install the new version. This method will also keep all of your surveys and configuration.


Update via FTP - #back to top

Overwrite the plugin file in your WordPress installation folder (wp-content/plugins/modal_survey) via FTP, then deactivate and activate back the plugin. The last step is required to apply all new changes that might provided with the new plugin version.

Default Charts #back to top

The plugin provides different types of charts and bars to visualize the results of the surveys. By default, it can be included with a simple shortcode using the WordPress WYSIWYG editor.

Pie Chart - #back to top

Use the following shortcode to include Pie Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="piechart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Pie Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="piechart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="piechart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="piechart"]</div>





Bar Chart - #back to top

Use the following shortcode to include Bar Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="barchart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Bar Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="barchart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="barchart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="barchart"]</div>





Polar Chart - #back to top

Use the following shortcode to include Polar Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="polarchart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Polar Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="polarchart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="polarchart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="polarchart"]</div>





Line Chart - #back to top

Use the following shortcode to include Line Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="linechart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Line Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="linechart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="linechart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="linechart"]</div>





Radar Chart - #back to top

Use the following shortcode to include Radar Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="radarchart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Radar Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="radarchart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="radarchart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="radarchart"]</div>





Doughnut Chart - #back to top

Use the following shortcode to include Doughnut Chart to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="doughnutchart"]

This type of shortcode will display a chart for all questions, that means you will see 5 Doughnut Chart, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="doughnutchart" data="question" qid="1"]

If you set scores to each answers, then you can display a cumulated chart, that will display all questions on the same chart based on the scores:

[survey_answers id="1111111" style="doughnutchart" data="score"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="doughnutchart"]</div>





Line Bar - #back to top

Use the following shortcode to include Line Bar to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="linebar"]

This type of shortcode will display a chart for all questions, that means you will see 5 Line Bar, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="linebar" data="question" qid="1"]

There are additional parameters available, see the full list in the Shortcodes Section

The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="1111111" style="linebar"]</div>





Progress Bar - #back to top

Use the following shortcode to include Progress Bar to the page / post (replace the numbers to your survey ID):

[survey_answers id="1111111" style="progressbar"]

This type of shortcode will display a chart for all questions, that means you will see 5 Progress Bar, if you have 5 questions in the survey. It is possible to show a specified question's chart, just it needs to be defined in the shortcode (first question):

[survey_answers id="1111111" style="progressbar" data="question" qid="1"]

There are additional parameters available, see the full list in the Shortcodes Section




Progress Circle - #back to top

This type of visualization can be used with individial and cumulated scores with max parameter. Use the following shortcode to include Progress Circle to the page / post (replace the numbers to your survey ID), that display the total percentage of the current user where the maximum score 100:

[survey_answers id="12345" style="plain" data="score" bgcolor="#719430,#ccc,#ccc,#000" progress="true" max="100" uid="true" session="last"]

The following type of shortcode will display a progress circle for the specified category, that means you will see the progress of the category test:

[survey_answers id="12345" style="plain" data="score" bgcolor="#719430,#ccc,#ccc,#000" progress="true" max="100" qid="test" uid="true" session="last"]

The bgcolor parameters contains the foreground color, background color, target color (outer circle) and the font color in order The size of the Progress Circle can be easily controlled by a parent element, that can be a DIV or any element with a specified width:

<div style="width: 50%;">[survey_answers id="12345" style="plain" data="score" bgcolor="#719430,#ccc,#ccc,#000" progress="true" max="100" qid="test" uid="true" session="last"]</div>




Individual Charts #back to top

If you would like to display individual chart based on the current user's answers, you can choose it in the condition actions.

Display Chart based on Score, Correct Answers or Ratings



  • Step 1 - Locate the Conditions accordion in the survey options.
  • Step 2 - Set Individual Chart as an action in the condition.
  • Step 3 - Leave empty the last input field to display radar chart or specify the chart type. (piechart, barchart, doughnutchart, linechart, polarchart, radarchart)

As a result, the participants will see the individual chart at the end of the survey.



Using Custom Titles instead of the Question Names


  • Step 1 - Enter the alternative name of question in brackets after the question.
  • Step 2 - Save the survey.

As a result, the participants will see the individual chart at the end of the survey with custom titles. It is possible to use the same title as a category name for different questions, then it will be represented as a summarized value.

Cumulated Charts #back to top

Cumulated chart display all questions on the same chart. This method could be the best option to visualize results based on scores or ratings. For example, a customer satisfaction survey will use the ratings:


Shortcode: [survey_answers id="821776765" style="linechart" data="rating"]

Cumulated chart based on scores should be great choice for Personality Tests, that summarize the participant characteristics to display it on a radar chart:


Shortcode: [survey_answers id="821776765" style="radarchart" data="score"]

Shortcodes #back to top

Use the shortcodes to display the survey on a specified page / post or show the results of the survey in various formats. First of all, find the survey ID in the survey settings page.


Default Shortcode:

[modalsurvey id="821776765"]

Alternatively, you can also find it in the Saved Surveys screen in the first column.



Default Shortcode to Embed the Survey:

[modalsurvey id="821776765" style="flat" visible="true"]

The visible parameter control the visibility of the survey. With false value, it will be displayed only, when the user scroll down to the place of the shortcode.

Width and Align

Add width and align parameters to control the width and the position of the survey.

Shortcode:

[modalsurvey id="821776765" width="50%" align="right"]

  • width: Numeric value in percentage.
  • align: left, center or right.

OnClick Event

This method will display the survey, when the user click on a specified link. Add style="click" to the shortcode, for example:

[modalsurvey id="121234344" style="click"]

You have to create a link with the survey id class:

<a class="121234344">Click here to start the Survey</a>

Custom Message

When someone filled out the survey, the link still be visible for that user (if you use it with onclick start or flat mode), therefore, you can create a message for those users like this:

[modalsurvey id="121234344" style="click" message="You already filled out this survey!"]

If you don't use this parameter, the initial value of the message will be the same like above.

Embed Mode - Flat Style

Add style=flat to the shortcode, for example:

[modalsurvey id="121234344" style="flat"]

This will embed the survey into the content of your page or post. The place, where you insert this shortcode is very important, because the Survey will appear on that place when the user scrolled down and reach that point. Don't forget to disable the Global Survey option in the survey settings.

Display All or Specified Number of Questions

You can display all questions on the same page in embed mode with the display="all" parameter:

[modalsurvey id="121234344" style="flat" display="all"]

It is recommended to use with maximum 10-20 questions, over this number the it can slow down the loading time of the page. The display parameter also accepts the number of questions to display at the same time. Eg.: if you specify display="2" then it will display 2 questions only at a time (divide the questions to sections)

Force Initialization

In some cases when the WordPress Theme you using doesn't provide valid header and footer, you can force to initialize the plugin in the shortcode:

[modalsurvey id="121234344" init="true"]

Use it when you add the shortcode and the survey doesn't displayed at all.

Display the Results #back to top

Default Shortcode

Use the following shortcode to display the default progress bar:

[survey_answers id="121234344"]

Specify it with adding custom parameters as you can read below.

Maximum Values

It is possible to define maximum values for Radar Chart, Line Chart and Bar Chart. Simply add the max=100 attribute to set 100 as a maximum:

[survey_answers id="121234344" max="100" style="barchart"]

Hide Counter

Progress Bar and Line Bar allows you to hide the exact number of votes with the hidecounter="yes" parameter:

[survey_answers id="121234344" hidecounter="yes"]

If you don't use this parameter, the initial value is "no".

Background and Font Colors (Progress Bar and Line Bar)

It is possible to specify the background and the font colors (in text or HEX format):

[survey_answers id="121234344" hidecounter="yes" bgcolor="red" color="#000000"]

You can also use the random attribute:

[survey_answers id="121234344" hidecounter="yes" bgcolor="random" color="random"]

Background Colors for Multi-Color Charts

Pie Chart, Doughnut Chart and the other similar type of charts contains multiple colors, therefore you can define them with a comma separated list (text or HEX format). The first one is the HOVER color, that displayed when you move the mouse cursor over the area:

[survey_answers id="121234344" style="piechart" bgcolor="red,green,blue"]

If the chart has 4 slices and you specified 3 colors only, then the remaining one will be shown with random color. Example with HEX color codes:

[survey_answers id="121234344" style="piechart" bgcolor="#5D5D5D,#FC0303,#CCCCCC"]

Background Colors for Single-Color Charts

Bar Chart, Line Chart, etc. using single color, but you can define the stroke color as well (in text or HEX format). The first color will be the main background color of the chart and the second one the stroke color:

[survey_answers id="121234344" style="barchart" bgcolor="red,green"]

If you add one color only, then the stroke color will be generated by random. Example with HEX color codes:

[survey_answers id="121234344" style="barchart" bgcolor="#FC0303,#CCC"]

Custom Header

Specify custom HTML element as a container for the questions:

[survey_answers id="121234344" title="<h4 class='myheader'>"]

Default is <h3 class='survey_header'>.

Set Order

Most of the charts and bars can be set to display the results in descending or ascending order based on the votes:

[survey_answers id="121234344" sort="desc"]

Or display in ascending order:

[survey_answers id="121234344" sort="asc"]

Display Individual Chart

Specify the numeric User ID (find it on the Participants page) in the uid parameter:

[survey_answers id="121234344" data="score" style="radarchart" uid="9"]

Hint: With uid="true" value, the plugin grab the User ID from the visitor's browser and display their own charts automatically. If the visitor browser doesn't provide a valid User ID (didn't filled out the survey yet), then it will display the cumulated chart.

Set Order

Most of the charts and bars can be set to display the results in descending or ascending order based on the votes:

[survey_answers id="121234344" sort="desc"]

Or display in ascending order:

[survey_answers id="121234344" sort="asc"]

Plain Text Format

You can use the results in articles with the exact parameters of the questions or answers. Get the question with this shortcode:

[survey_answers id="121234344" qid="1" style="plain" data="question"]

The qid means the numeric ID of the question. Define the answer ID to also get it like this:

[survey_answers id="121234344" qid="1" aid="1" style="plain" data="answer"]

To get the votes, use the answer_count and the answer_percentage values instead of the answer attribute in the data parameter:

[survey_answers id="121234344" qid="1" aid="1" style="plain" data="answer_count"] or [survey_answers id="121234344" qid="1" aid="1" style="plain" data="answer_percentage"]

Certainly, you can use more shortcodes on the same page, so composing articles from these informations could be easy.

Getting the Individual Participants Record in Plain Text Format

The following shortcode allows you to get one data from the individual result array. Certainly, you can use as many shortcodes as you wish. There are three levels in the individual result array. The first one provide the name, username and email address in case you enabled the Participants Form to record these details:

Example: [survey_records id="121234344" data="name"]

Just replace the id with your own survey ID and use name, username or email in the data parameter.

The second level provides the question data, that can be the title:

Example: [survey_records id="121234344" qid="1" data="title"]

Don't forget to specify the question ID in the qid parameter.

The lowest level brings you the answer data, that can be the following:

  • answer - gives back the answer in text format
  • votes - provide the total vote number for the selected answer
  • score - display the score of the answer
  • percentage - show the total votes of the answer in percentage

Example: [survey_records id="121234344" qid="1" aid="1" data="answer"]

If you would like to get the selected answer, then specify it in the aid parameter, like this:

Example: [survey_records id="121234344" qid="1" aid="selected" data="answer"]

All Questions on the Same Chart based on the Scores or Ratings

The following example display the overall scores for each questions with pie chart:

[survey_answers id="121234344" style="piechart" data="score"]



The following example display the overall ratings for each questions with radar chart:

[survey_answers id="121234344" style="radarchart" data="rating"]



It is also possible to specify alternative texts instead of the question titles easily, just create a comma separated list in the shortcode:

[survey_answers id="121234344" style="radarchart" data="score" titles="Like,Help,First Visit,Returning,Bookmarked,Search Engine,Google,Employed"]


Shortcode Manager

Most of the shortcodes are available in the Shortcode Manager, find it in the WYSIWYG Editor of any of your posts or pages (edit or add screen).



Select the survey name from the dropdown list, then you will see a popup window that allows to customize the shortcode.



Background color input accepts HEX color codes or the 'random' value. After you set the desired options and clicked on the OK button, you will get the shortcode included. At this stage, you can also make some additional customization on the shortcode with the text editor.

Localization#back to top

The plugin compatible with WPML, therefore it any text can be translated by the official way, using Poedit or any other 3rd party WordPress translator plugin, like Loco Translate. The language files (modal_survey.pot) can be find in the modal_survey/languages folder.

The new translation files must be in the following format: modal_survey-[language_code].po
like: modal_survey-de_DE.po and should be placed in the wp-content/modal_survey/languages directory. WordPress will use the translated file in case, the site language already switched to the same language. (eg.: german in this example)

Developers#back to top

The plugin provides several hooks to extend it with your own actions. Find the full list below.

Action Hooks

modal_survey_action_participants_update - Called after the plugin updated the current participant's details.

Usage: add_action( "modal_survey_action_participants_update", function_to_call );

modal_survey_action_participants_create - Called after the plugin created a new participant.

Usage: add_action( "modal_survey_action_participants_create", function_to_call );

modal_survey_action_admin_email - Called after the plugin sent out the admin email message.

Usage: add_action( "modal_survey_action_admin_email", function_to_call );

modal_survey_action_autoresponse - Called after the plugin sent out the Auto Response message to the participant.

Usage: add_action( "modal_survey_action_autoresponse", function_to_call );

modal_survey_action_participant_vote - Called after each votes passing the selection array.

Usage: add_action( "modal_survey_action_participant_vote", function_to_call );

modal_survey_action_open_text_answer - Called after the participant voted with open text answer.

Usage: add_action( "modal_survey_action_open_text_answer", function_to_call );

modal_survey_action_init - Called after the survey script has been initialized.

Usage: add_action( "modal_survey_action_init", function_to_call );

modal_survey_action_answer_init - Called after the survey answers script has been initialized.

Usage: add_action( "modal_survey_action_answer_init", function_to_call );

Example:

if( ! class_exists( 'pantherius_actiontest' ) ) {
	class pantherius_actiontest {
		protected static $instance = null;
		public function __construct() {
			add_action( "modal_survey_participants_update", array( &$this, 'msparticipants_update' ) );
		}
		public static function getInstance() {
			if ( ! isset( $instance ) ) {
				$instance = new pantherius_actiontest;
			}
			return $instance;
		}
		function msparticipants_update( $params ) {
			print( "<pre>" );
			print_r( $params );
			print( "</pre>" );
		}
	}
}
if ( class_exists( 'pantherius_actiontest' ) ) {
	$pantherius_actiontest = pantherius_actiontest::getInstance();
}

Result:

Array
(
    [name] => John Doe
    [email] => john@doe.com
)

Filters

modal_survey_filter_admin_email - Filter the admin message.

Usage: add_filter( 'modal_survey_filter_admin_email', function_to_call );

modal_survey_filter_autoresponse_email - Filter the auto response message.

Usage: add_filter( 'modal_survey_filter_autoresponse_email', function_to_call );

Support#back to top

Support for my items includes:
  • * Answer for questions related with the plugin
  • * Answering technical questions about item’s features
  • * Assistance with reported bugs and issues
  • * Help with included 3rd party assets
Item support does not include:
  • * Customization Services
  • * Installation Services

Please remember you purchased a very affordable plugin and you don't have to pay for a full-time web design agency for the developing. Occasionally, I will help with small tweaks, but these requests will be put on a lower priority due to their nature. Support is also 100% optional and I provide it for your convenience, so please be patient, polite and respectful.

Please visit my profile page or ask question in the plugin's the comments section

Before seeking support, please...
  • * Make sure your question is a valid Plugin Issue and not a customization request.
  • * Make sure you have read through the documentation before asking support on how to accomplish a task.
  • * Make sure you double checked the plugin's FAQs.
  • * Try disabling the other active plugins to make sure there isn't a conflict with any other plugins. If you found a conflict this way, you can let me know.
  • * If you have customized your plugin and now have an issue, back-track to make sure you didn't make a mistake. If you have made changes and can't find the issue, please provide me with your changelog.
  • * Almost 80% of the time we find that the solution to people's issues can be solved with a simple "Google Search". You might want to try that before seeking support. You might be able to fix the issue yourself much quicker than I can respond to your request.
  • * Make sure to state the name of the plugin you are having issues with when requesting support via CodeCanyon.

F.A.Q. #back to top

The survey doesn't saved, the circle just spinning and the admin-ajax.php gives 404 error page.

The issue caused by a server security configuration, that can be fixed by your hosting company. Please contact with them and ask about why the admin-ajax.php gives 404 error when you trying to use the admin of your website. They must see the problem in the server log and fix it.

Shortcode included, but the Survey doesn’t appear. How to solve it?
  1. Please try to deactivate all other plugins temporary, then check Modal Survey again. If it now works well, you can activate back the other plugins one-by-one. This way, you can see which one causing the conflict.
  2. Please make sure you using the latest WordPress and plugin version. The latest version of the plugin can be downloaded from your CodeCanyon Downloads page here.
  3. If you using the shortcode, please set OFF the Global Survey checkbox in the survey settings.
  4. Clear your cookies and turn OFF ‘Display once per User’ and ‘Display once per Filled Out’ checkboxes in the General Settings.
  5. If the form still doesn’t appears, check how does it work with turning ON the Global Survey checkbox. If it is works well, then verify the shortcode in your editor using the text view. Sometimes it contains illegal HTML tags, if you find similar unnecessary code in the shortcode, then remove it. You can also use the built-in Shortcode Manager to implement shortcodes. Search for the Modal Survey icon in your WYSIWYG editor.
  6. The plugin trying to initialize itself in the footer to avoid conflicts with other plugins. Some WordPress Theme’s doesn’t provides valid footer and header, therefore the initialization process stopped. You can change the initialization place of the plugin in the General Settings.
  7. If the issue still exists, please contact with me via my CodeCanyon profile page mail sender here.<>
Does the survey form allow chained questions?

You can redirect the user to a specified question by adding the question numeric ID right after the answer in brackets.

In the example above, when the user choose the Asia as an answer, it will be redirected to the third question, otherwise it will continue with the second question. With a non-existing high value (like: 9999) it will be automatically redirected to the end of the survey.

The survey automatically close itself after the completion, how can I prevent that?

Simply add [noclose] to the 'Thank you message' or set to display [noclose] in the Conditions.

How to update the plugin?

You can update it via FTP, the WordPress default installer and the plugin's built-in updater. Read more about the update process in the Update Section.

What should I do if I get: “The package could not be installed. No valid plugins were found.” error message during the installation?

Please unzip the downloaded file and use the second zip inside the first (next to the documentation folder) or download the Installable WordPress File Only

Version History ( Changelog ) #back to top

You can find the version history (changelog.txt) file in the plugin ZIP file: modal_survey-[version.number].zip inside the downloaded file or you can check the changelog on plugin's page here.

If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. With more general question relating to the plugins on CodeCanyon or with this plugin, you might consider visiting the comment section of this plugin, maybe somebody also faced with the same question.


Changelog

				
-----------------------------------------------------------------------------------------
Version 1.9.8.6
-----------------------------------------------------------------------------------------			
- added traditional checkbox and radio button style to the Hover Effects	
- minor improvements on the frontend
				
-----------------------------------------------------------------------------------------
Version 1.9.8.5
-----------------------------------------------------------------------------------------				
- fixed tooltip bug
- fixed allow continue bug
- additional minor CSS/JS improvements
				
-----------------------------------------------------------------------------------------
Version 1.9.8.4.2
-----------------------------------------------------------------------------------------				
- minor improvements
				
-----------------------------------------------------------------------------------------
Version 1.9.8.4
-----------------------------------------------------------------------------------------				
- added option to set the align of the image in answers and questions
- fixed Facebook share to display specific image based on the results
- added sample surveys
				
-----------------------------------------------------------------------------------------
Version 1.9.8.3
-----------------------------------------------------------------------------------------				
- added ability to set the image position in the questions and answers
- reworked Conditions on admin (added edit mode)
- added option to filter the individual result to a specified answer only by clicking on the answer under the Saved Surveys page
						
-----------------------------------------------------------------------------------------
Version 1.9.8.2
-----------------------------------------------------------------------------------------				
- minor improvements
				
-----------------------------------------------------------------------------------------
Version 1.9.8.1
-----------------------------------------------------------------------------------------				
- fixed Safari bug with open text answers
- fixed IE11 issue with multiple answers
- added option to display individual average category scores on charts: [survey_answers id="12345" style="barchart" data="average-score" uid="true" session="last"]
				
-----------------------------------------------------------------------------------------
Version 1.9.8
-----------------------------------------------------------------------------------------				
- minor bugfixes and improvements
				
-----------------------------------------------------------------------------------------
Version 1.9.7.9
-----------------------------------------------------------------------------------------				
- changed Auto-Complete option to disabled by default
- fixed minor bugs in conditional shortcodes and plain text shortcodes to display the category scores based on the latest completion from the same user
- improved user selections on the Participants Page
- added action hooks and filters
- added option to divide questions to sections in embed mode with display="question number in section", like [modalsurvey id="12345" style="flat" display="2"]
- added progress circle to display final and individual plain scores as percentage on a progress circle: [survey_answers id="12345" style="plain" data="score" bgcolor="#719430,#ccc,#ccc,#000" progress="true" max="10" qid="test3" uid="true" session="last"]
				
-----------------------------------------------------------------------------------------
Version 1.9.7.8
-----------------------------------------------------------------------------------------				
- several minor bugfixes and improvements	
				
-----------------------------------------------------------------------------------------
Version 1.9.7.7
-----------------------------------------------------------------------------------------				
- added custom fields to survey_records shortcodes, eg.: [survey_records id="12345" data="company"]
- scores, charts are now supports negative values
- open text field accepts pressing enter to go to the next question
- additional user selection improvements with open text answers
- added option to delete incomplete results on the Participants Page
				
-----------------------------------------------------------------------------------------
Version 1.9.7.6
-----------------------------------------------------------------------------------------				
- added option to set the Global Survey default status in the new surveys
- minor CSS improvements on the Participants Form

-----------------------------------------------------------------------------------------
Version 1.9.7.5
-----------------------------------------------------------------------------------------				
- minor improvements on rating questions
						
-----------------------------------------------------------------------------------------
Version 1.9.7.4
-----------------------------------------------------------------------------------------				
- added checkbox and HTML box options to the Participant Form
- fixed conflicts with some specific Visual Editors on the admin
				
-----------------------------------------------------------------------------------------
Version 1.9.7.3
-----------------------------------------------------------------------------------------				
- minor improvements and bugfixes
				
-----------------------------------------------------------------------------------------
Version 1.9.7.2
-----------------------------------------------------------------------------------------
- added option to use advanced conditions with shortcodes including AND OR parameters, eg: [survey_conditions id="12345" advanced="finalscore > 1 AND questionanswer_1 = 3"]Display content when final score higher than 1 and the 3rd answer has been selected for question 1[/survey_conditions]
- added fade animation
- improved charts
- added option to display category percentage by adding max parameter to the shortcode:
[survey_answers id="12345" style="plain" data="score" qid="test1" uid="true" max="30"]
- added custom fields feature to the Participants Form, updated exports, admin email and the participants page with the custom fields values
- added Hide Label option to Answer Options, that allows to hide the answer in case of using image instead of text answer (answer will be displayed in results and doesn't displayed in the survey)
- added option to enable Subscription Confirmation checkbox in the Campaigns
- browser now scroll to the missed answer instead of the top in case all questions has been displayed (display="all" in the shortcode)
- removed freesans font style from the available PDF export font styles
				
-----------------------------------------------------------------------------------------
Version 1.9.7.1
-----------------------------------------------------------------------------------------
- added option to show user percentage of total scores when the max parameter has been specified, eg.:
[survey_answers id="12345" data="score" style="plain" uid="true" max="500" session="last"]
- fixed duplicate survey issue
- fixed import JSON issue
				
-----------------------------------------------------------------------------------------
Version 1.9.7
-----------------------------------------------------------------------------------------
- several redesign and enhancements on the admin user interface
- added option to add multiple admin email address (comma separated list) in the Send Results to field on the survey edit screen
- added email and IP to the participant list view, that allows bulk export of the participants name, email and IP address
- added quiz timer, that can be used as question timer as well
- added condition in case the time is up
- added total score and required time to the export files
- added individiual records shortcode, that help you to get each detail from the individual result
- added specific classes to the question elements, that allows apply different custom CSS codes for even each questions
- added option to add comma separated category list right after the answer text in brackets
				
-----------------------------------------------------------------------------------------
Version 1.9.6.2
-----------------------------------------------------------------------------------------
- minor improvements & bugfixes
- fixed conditions issue in auto response message
- added option to add condition based on the answer in a specific question (condition="questionanswer")
				
-----------------------------------------------------------------------------------------
Version 1.9.6.1
-----------------------------------------------------------------------------------------
- minor improvements & bugfixes
						
-----------------------------------------------------------------------------------------
Version 1.9.6
-----------------------------------------------------------------------------------------
- admin UI improvements
- minor bugfixes
- reconstructed Answer & Question Options
- added option to continue interrupted surveys
- added option to enable Back Button, that can go back one step
- updated MailChimp API to V3
- added Aweber API
- added option to customize the individual PDF export
				
-----------------------------------------------------------------------------------------
Version 1.9.5
-----------------------------------------------------------------------------------------
- minor CSS improvements
- fixed missing participants votes
- improved update process
					
-----------------------------------------------------------------------------------------
Version 1.9.4
-----------------------------------------------------------------------------------------
- added option to display multilines textarea for open text answers instead of single text input
- added 6 rating question styles (numbers 1, numbers 2, trophy, soccer, smiley, coffee)
- added optional tooltip to display description for questions and answers
- minor improvements on the survey edit screen
- added individual views on the participants page to display each completion individually from the same person on the same survey
- added legend for pie chart, doughnut chart and polar chart (enable with legend="true" in the shortcode)
					
-----------------------------------------------------------------------------------------
Version 1.9.3
-----------------------------------------------------------------------------------------
- improved admin email notification
- increased open text answer character limit from 100 to 600
- fixed minor bugs
- placed new question button at the bottom
- added duplicate question function
- added missing translation texts
- added option to export the participant list to Excel, CSV, PDF, Print or Copy to the clipboard

-----------------------------------------------------------------------------------------
Version 1.9.2
-----------------------------------------------------------------------------------------
- minor CSS improvements
- fixed minor bugs

-----------------------------------------------------------------------------------------
Version 1.9.1
-----------------------------------------------------------------------------------------
- added option to disable remember the users from the same computer via cookie
- added option to display top results for score based charts (eg.: top="3")
- minor bugfixes

-----------------------------------------------------------------------------------------
Version 1.9
-----------------------------------------------------------------------------------------
- minor improvements
- fixed redirection issue with display="all" shortcode
- added custom answer to individual export PDF

-----------------------------------------------------------------------------------------
Version 1.8.9
-----------------------------------------------------------------------------------------
- fixed next button style doesn't applied issue
- fixed condition doesn't work in some rare cases issue

-----------------------------------------------------------------------------------------
Version 1.8.8
-----------------------------------------------------------------------------------------
- added Auto Responder feature to send message for the users who filled out the survey (custom shortcodes eg.: conditions, total score, correct answers, attachment)
- display category score in plain text format (specify the category name in the qid parameter like qid="activity")
- disable displaying aggregated results instead of the personal results in case of personal results doesn't exists with alternativedatas="false" in the survey result shortcode (solution for uid="true" type of shortcode)
- prevents members to vote again (using database validation)
- diplay once per filled out for each posts (add unique="true" to the survey shortcode)
- display scores and the total score in individual export CSV, XLS files and on the participants page
- hide answer on admin (eye icon) and exclude answers from the results
- option to display percentage values instead of votes or score (add percentage="true" to the result shortcode )
- option to add any text after the value displayed on the charts with after parameter, like after=" points"
- added option to select next button position (top or bottom)
- added option to always display next button (not for multiple answers only)

-----------------------------------------------------------------------------------------
Version 1.8.7
-----------------------------------------------------------------------------------------
- added option to display all questions in embed mode
- fixed End Delay admin saving bug
- added social title, social description and social image conditions to allow dynamic social sharing content for Facebook, Twitter, Pinterest and LinkedIn
- added score to PDF export
- added option to disable email validation
						
-----------------------------------------------------------------------------------------
Version 1.8.6
-----------------------------------------------------------------------------------------
- added init="true" option to shortcode to force initialization
- fixed minor MailPoet issue
- added export to participant page( CSV, JSON, PDF, XML, XLS, TXT )
- added option to display cumulated results on the individual chart with compare="true" parameter
- added End Content accordion to admin, that provides the option to display chart directly at the end of the survey
- added option to create categories by answer for score based surveys (add category name in brackets after the answer)
- added option to specify number-number (between) definition in conditions, just select equal with, then specify the numbers separated by minus sign
- added option to set the number of answers per row
- added option to set the close icon style and size
- added option to set cookie expiration time
- added option to send individual participant result to a specified email address
						
-----------------------------------------------------------------------------------------
Version 1.8.5
-----------------------------------------------------------------------------------------
- option to disable end message with empty value
- removed jQuery UI CSS from frontend
- added Display Timer to set display time for the survey
- added ability to use Custom CSS

-----------------------------------------------------------------------------------------
Version 1.8.4
-----------------------------------------------------------------------------------------

- limited Participants page to 10 000 results by default to keep performance
- added score queries to the plain style shortcode, eg.: get total, average, personal score and rating via text format
- added option to set conditions for highest and lowest category scores ( set highest or lowest as a category score value with equal condition )
- fixed background color issue for charts

-----------------------------------------------------------------------------------------
Version 1.8.3.1
-----------------------------------------------------------------------------------------

- fixed frontend spinning issue

-----------------------------------------------------------------------------------------
Version 1.8.3
-----------------------------------------------------------------------------------------

- added option to disable auto-close with adding [noclose] to the end content (thank you message or condition text)
- added option to set conditions by category scores
- fixed participants form auto-closing issue

-----------------------------------------------------------------------------------------
Version 1.8.2
-----------------------------------------------------------------------------------------

- added bbPress Support ( add survey to individual topics or add survey to all topics )
- added option to filter results in the shortcode by post / page ( postid="123" )
- added charts to posts / pages to show results by URL
- added average-score chart (data="average-score")
- fixed participant's personal answer to display multiple answers correctly on admin
- fixed dashboard charts visibility issue
- fixed progress bar visibility issue in FireFox
- improved and optimized voting process

-----------------------------------------------------------------------------------------
Version 1.8.1.1
-----------------------------------------------------------------------------------------

- fixed minor display bug with individual chart

-----------------------------------------------------------------------------------------
Version 1.8.1
-----------------------------------------------------------------------------------------

- added full WPML Support
- added ability to specify the chart colors via shortcode
- fixed Conditions issue with HTML code
- added option to display individual chart with uid parameter in the shortcode

-----------------------------------------------------------------------------------------
Version 1.8
-----------------------------------------------------------------------------------------

- added ability to exclude question from the chart with adding minus sign in brackets right after the question text, eg: [-]
- added ability to display the results in ascending or descending order based on the votes
- reconstructed admin UI
- added 11 preloaders
- added 9 hover effects
- added box-shadow property with horizontal, vertical, blur and spread parameters
- added title attribute to results shortcode to allow custom header for questions
- minor improvements with design
- added ability to specify the maximum value for line chart, bar chart and radar chart
- reconstructed and improved the entire documentation
- added Votes by Surveys and Votes by Day Dashboard Chart
- added Participants page with charts and stats
- added option to ask name and email address of the users
- added interactive tutorial to the survey settings page
- added Active Campaign
- added Benchmark
- added Campaign Monitor
- added Campayn
- added Constant Contact
- added Freshmail
- added GetResponse
- added MadMimi
- added MailChimp
- added MailPoet
- added MyMail
- added SimplyCast
- added YMLP
- minor improvements with social buttons
- added option to summarize more questions with the same group (specified with brackets) on the individual chart
- added option to specify the social sharing buttons position with parameter in the shortcode
- added option to specify the social sharing buttons style with parameter in the shortcode
- added option to specify 'enddelay' as a shortcode parameter
- added Social Share buttons ( Facebook, Google Plus, Twitter, Pinterest, LinkedIn )
- different mode, style and position for Social Share buttons
- added individual chart to display at the end of the survey based on the correct answers, ratings or scores
- added option to display all questions' cumulated results on one chart based on the ratings or the scores
- added 'End Delay' slider to the survey form options to set or disable the delay timer at the end of the survey
- added new conditions based on the user's score with the individual questions
- added option to delete the second answer
- added option to choose PDF Font Family, that allows to display special characters correctly (Chinese, Turkish, etc.)
- added Localization file
- use it as rating system
- classic list layout
- added optional score to answers
- added option to mark answers as correct
- added TXT export type for survey export
- added conditional system to display message or redirect the browser depends on the score and correct answers
- added optional progress bar
- ability to upload image to the question
- ability to upload image to the answers
- support WordPress Multisites
- added option to set the plugin initialization hook
- fixed open question and answer options issue in FireFox
- fixed Live Preview issue on admin
- fixed center horizontal alignment issue with flat style when the width less than 100%
- fixed minor bugs
- fixed Shortcode Manager issue with non-saved surveys
- fixed delete survey issue in rare cases
- fixed progress bar result shortcode issue
- fixed chart visibility conflict on frontend

-----------------------------------------------------------------------------------------
Version 1.7
-----------------------------------------------------------------------------------------

- added open text answer option with autocomplete
- minor improvements on style
- added option to redirect the browser after the user complete the survey
- added option to automatically embed surveys at the start / bottom of all pages / posts
- show questionnaire for logged in users only
- improved animations
- multiple instances to show surveys and the results on the same page
- option to use minified JavaScript files on frontend
- included text-align option
- display survey and survey results in sidebar widget
- include any number of survey results to the same page
- reconstructed and improved the entire admin panel
- added list view of saved survey with the ability of duplicate, edit, reset and delete
- added option to import survey from JSON
- added manual updater from ZIP
- added option to customize the PDF Header text
- fixed saving issue with multiple selection option on admin
- fixed display message for users those already filled the survey
- fixed display once and general options saving issues
- fixed minor SQL bug
- fixed shortcode issue with modal style
- fixed lock screen with shortcode

-----------------------------------------------------------------------------------------
Version 1.6
-----------------------------------------------------------------------------------------

- added option to make the survey instantly visible in embed mode
- reset button now allows all users to vote again
- added option to set possible number of answers
- added option to set required number of answers
- added Line Bar to the results shortcodes
- added Pie Chart to the results shortcodes
- added Bar Chart to the results shortcodes
- added Doughnut Chart to the results shortcodes
- added Line Chart to the results shortcodes
- added Polar Chart to the results shortcodes
- added Radar Chart to the results shortcodes
- added option to set on/off displaying the same survey for the users who already filled out
- added shortcode option to display the survey only on pages/posts (shortcode parameter: filtered="true")
- added option in embed mode to display message for users, who already filled out the survey
- added PDF export
- added CSV export
- added XLS export
- added JSON export
- added XML export
- added hide question text option to result shortcodes
- added shortcode manager to the posts/pages editor
- minor improvements on admin
- added support to link answers to questions (jump to a specified question)
- improved the display of the longer surveys on mobile devices
- fixed minor compatibility issue on admin with AJAX process
- fixed minor admin visibility issue in FireFox
- fixed display_once issue with shortcodes
- fixed bug when answers and survey included on the same page with shortcode

-----------------------------------------------------------------------------------------
Version 1.5
-----------------------------------------------------------------------------------------

- improved performance on admin and on the frontend
- added option to keep settings after deletion (provides quick update to the new version)
- added option to display the same surveys only once per user even filled out or not
- added screen preloader on admin
- restyled buttons, titles for better organized display

-----------------------------------------------------------------------------------------
Version 1.4
-----------------------------------------------------------------------------------------

- fixed Google Fonts issue on bold texts
- fixed database collations issue

-----------------------------------------------------------------------------------------
Version 1.3
-----------------------------------------------------------------------------------------

- fixed character encoding issue
- minor compatibility fix with WordPress 3.9

-----------------------------------------------------------------------------------------
Version 1.2
-----------------------------------------------------------------------------------------
- added option to reset survey answers' counts on admin

-----------------------------------------------------------------------------------------
Version 1.1
-----------------------------------------------------------------------------------------
- added align (left and right) and width (in percentages) parameters to the shortcode
- fixed returning user lock screen issue fixed