Documentation
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.
If All files & documentation has been downloaded, then you need to unzip the file to get the installable WordPress Plugin ZIP file.
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.
First, log in to the Administration area of your Wordpress website and select Plugins then Add New.
Select Upload on the top of the page, browse the plugin ZIP file and click on the Install Now button.
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.
Find the Modal Survey plugin in the list. You can now configure your first survey.
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.
New surveys will be automatically displayed on the frontend area unless you turn OFF the Set Global Survey option in the General Settings
The plugin 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.
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.
These options provides the possibility to set question specific settings, like image, optional number of answers, etc.
Click on the plus sign at the end of the second answer and the new answer type can be selected from the window. You can add as many as you want, of course depends on the visibility possibilities.(eg.: 40 answer doesn't looks 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 answer can't be deleted. The plugin using Cookies to display the same Surveys only once for the same user. 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.
After you select the Add Answer icon, you will see the answer type selection screen, like on the screenshot on the left side.
Open Text Answers can be exported individually since hundreds or even thousands of answers can break the layout 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.
All special answer type has it's own individual color code on admin to help easily recognize when you compose the survey. The Open Text Answer's color is the yellow.
Date answers include the DatePicker automatically when the user click on the answer. This way the user will be able to specify an exact date as an answer. The Date type answers can be viewed and exported the same way as the Open Text Answers in the Answer Options by clicking on the gear icon at the left side of the answer.
All special answer type has it's own individual color code on admin to help easily recognize when you compose the survey. The Date Answer's color is the green.
List Answers display a select box in the answer area, which allows the user to click on it and choose the answer from the list. The values can be assigned by a comma separated list in the Answer Options List of values field (see on screenshot at the left) The answer of List Answer type can be viewed and exported the same way as the Open Text Answers in the Answer Options by clicking on the gear icon at the left side of the answer.
All special answer type has it's own individual color code on admin to help easily recognize when you compose the survey. The open text answer's color is the red.
Numeric answer offer the option to use a slider to select a numerical value between limits, that you can set in the Answer Options using the Minimum value, Maximum value and the Step fields. The Numeric answers can be viewed and exported the same way as the Open Text Answers in the Answer Options by clicking on the gear icon at the left side of the answer.
All special answer type has it's own individual color code on admin to help easily recognize when you compose the survey. The Numeric Answer's color is the blue.
Each answer has an own settings area, that allows you to customize the answer parameters. (image, score, etc.)
Simply click on the name of the survey on the survey edit screen, then an input field will be displayed. Change the name as you desired, then save the survey using the control bar on the right side of the screen.
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.
It is possible to assign categories to the answers, 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 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"]
Average score also available:
[survey_answers id="12345" style="barchart" data="average-score" uid="true" session="last"]
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.
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.
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.
Advanced Conditions provides much more freedom like the Simple Conditions since you are allowed to use AND or OR statements in the condition. Please keep in mind only one of them can be used in the same condition. Simply select the condition as you do it with the simple conditionsm, then click on the AND or OR button. It will be automatically added to the temporary statement and you can continue building the condition.
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)
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 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)
You can also use the Conditional Shortcodes in the Auto-Response message, that you can find here.
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.
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:
Read more about the shortcodes in the SHORTCODES section.
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.
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 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.
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.
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:
<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
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.
There are several ways to update the plugin, read the detailed informations about the process below.
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.
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.
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.
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.
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 Pie Chart 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>
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 Bar Chart 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>
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 Polar Chart 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>
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 Line Chart 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>
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 Radar Chart 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>
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 Doughnut Chart 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>
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 Line Bar 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>
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
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>
If you would like to display individual chart based on the current user's answers, you can choose it in the condition actions.
As a result, the participants will see the individual chart at the end of 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.
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.
Add width and align parameters to control the width and the position of the survey.
Shortcode:
[modalsurvey id="821776765" width="50%" align="right"]
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>
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.
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.
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)
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.
Include the current date to any page or post by adding the following shortcode:
[survey_datetoday]
Use the following shortcode to display the survey in modal mode with background like on the screenshot on the left:
[modalsurvey id="3556498" width="70%" align="center" boxed="#eee,30px,5px"]
The boxed parameter first value set the background color by HEX color code, following the padding and border-radius in pixels.
As you can see on the screenshot at the left side, you can easily specify different question background color by adding the questionbg parameter with HEX or RGB color code:
[modalsurvey id="3556498" width="70%" align="center" boxed="#eee,30px,5px" questionbg="rgb(247, 111, 111)"]
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.
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"]
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".
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"]
The color of most of the charts can be defined with a comma separated list (text or HEX format):
[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"]
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.
Specify custom HTML element as a container for the questions:
[survey_answers id="121234344" title="<h4 class='myheader'>"]
Default is <h3 class='survey_header'>.
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"]
The plugin provides the option to exclude any category or question from the results by adding to the filter parameter, like:
[survey_answers id="12345" style="radarchart" data="score" filter="marketing, sales"]
This shortcode will exclude all other elements, and it will display the marketing and sales categories in the results only.
The following example demonstrate how can you show the user's final score in plain text percentage format:
[survey_answers id="12345" data="score" style="plain" uid="true" max="500" session="last"]
In case the max parameter removed, it will show the real score.
Legend is a section with the colors and element names to help people recognize the values on the charts. It can be simply enabled by adding the legend="true" parameter to the results shortcode:
[survey_answers id="12345" style="radarchart" data="score" legend="true"]
The results can be set to show a specified number of top data only, just the number needs to be defined in the top parameter. It can be used in score based surveys:
[survey_answers id="12345" style="radarchart" data="score" top="3"]
This shortcode will display the top 3 elements only from the results.
For score based survey, it might be required to display each category scores individually. To do this, use the qid parameter to specify the category name:
[survey_answers id="12345" style="plain" data="score" qid="marketing" uid="true" session="last"]
This shortcode will show the current user's scores in marketing category only for the latest completion of the survey with ID 12345.
Like before, the current user's individual total score can be displayed the same way without the qid parameter:
[survey_answers id="12345" style="plain" data="score" uid="true" session="last"]
By adding the printable="true" to the results shortcode, the plugin display a PRINT button at the top-right corner. Clicking on the button show the print preview screen. Shortcode example:
[survey_answers id="1111111" style="barchart" printable="true"]

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.
It is possible to show a question based result based on the latest completion of the current user, like on the admin's Participant Page with the following shortcode
[survey_answers id="1262892631" style="plain" data="full" uid="true" session="last"]
It will include the results like this style:

The user selection rows marked with gray background. All other answers with the cumulative votes also displayed in the results to help making a quick comparison between the cumulative and the individual answers. In case, you would like to hide these information, it can be easily achieved by adding the following lines to the Custom CSS page under the Modal Survey admin navigation menu:
.ms-answer-row:not(.ms-answer-row-selected), .ms-answer-count, .ms-answer-percentage {
display: none;
}

As a result you will get something like this:

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:
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"]
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]
Setting up condition with value range
If you would like to use a condition when the score between a specific range, use the equal statement and define the range, like this:
[survey_conditions id="12345" condition="finalscore" relation="equal" value="10-20"]Using conditional shortcode for specific user
The uid and the session parameters can be also defined in these shortcodes. However, the default values are automatically uid="true" and session="last", you can overwrite them by adding your own, static values:
[survey_conditions id="12345" condition="finalscore" relation="higher" value="10" uid="123" session="1326348184"]Certainly, you can still use the session="last" parameter with this value to work with the latest completion of the user.
It is very similar as the default Conditional Shortcodes above, the only difference you can use AND or OR statements in the condition. You can use one of them, but without any limits. That means, you are free to use the following format:
[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]
You can use the same actions like in the simple conditions above such as:
Where X is a number and XY is a category text.
The following example display the overall scores for each questions with pie chart:
[survey_answers id="121234344" style="piechart" data="score"]
The Ranking Tables Add-On provides the option to show ranking list for score based quizzes on the admin and or the frontend area. It can be purchased individually on CodeCanyon, then you have to install it like any other plugin and it will integrated automatically to your Modal Survey admin area. After you installed this premium add-on, it will start collecting the data with each quiz completions. That means, it will show you blank table right after the installation, you have to finish any of your quiz to see your participation.
Find the admin ranking table under the Modal Survey admin navigation menu.
The ranking table can be also displayed on any of your pages or posts through shortcode:
[ms_ranking_table id="12345" style="table" limit="10" category="final" sort="desc" hide=""]
Parameter values could be:
Single Export Add-On provides the option to export all latest individual export to a single CSV file. It can be purchased individually on CodeCanyon, then you have to install it like any other plugin and it will be integrated automatically to your Modal Survey admin area.
Find the Single Export under the Modal Survey admin navigation menu.
The plugin compatible with WPML, therefore 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)
The plugin provides several hooks to extend it with your own actions. Find the full list below.
Usage: add_action( "modal_survey_action_participants_update", function_to_call );
Usage: add_action( "modal_survey_action_participants_create", function_to_call );
Usage: add_action( "modal_survey_action_admin_email", function_to_call );
Usage: add_action( "modal_survey_action_autoresponse", function_to_call );
Usage: add_action( "modal_survey_action_participant_vote", function_to_call );
Usage: add_action( "modal_survey_action_open_text_answer", function_to_call );
Usage: add_action( "modal_survey_action_init", function_to_call );
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
)
Usage: add_filter( 'modal_survey_filter_admin_email', function_to_call );
Usage: add_filter( 'modal_survey_filter_autoresponse_email', function_to_call );
First of all, make sure the Rest API support has been turned ON in the General Settings:

If you already turned ON, then the following End Points will be available on your site:
Get all details of a specific survey
http://yoursite.com/wp-json/modalsurvey/v1/survey/surveyid
Replace the surveyid at the end to your own survey ID.
Get the details of a specific Participant
http://yoursite.com/wp-json/modalsurvey/v1/user/userid
Replace the userid at the end with a numeric user ID
Get the list of multiple Participants
http://yoursite.com/wp-json/modalsurvey/v1/allusers/limit
Replace the limit at the end with a numeric data, eg.: 100 to display 100 results.
Get the cumulative results of a specific survey
http://yoursite.com/wp-json/modalsurvey/v1/surveyresult/surveyid
Replace the surveyid at the end to your own survey ID.
Get the individual result of a specific user and survey
http://yoursite.com/wp-json/modalsurvey/v1/userresult/surveyid/userid
Replace the surveyid at the end to your own survey ID and the userid with the desired user ID. (User ID means the numerical ID on the Participants Page under the Modal Survey admin navigation menu, it is not equal with the WordPress Profile ID)
It is necessary to configure the Rest API Privileges in the General Settings:

Then you have to install an Authentication Plugin on your site, that will help you with the authorization process. In this step-by-step guide, the following 3rd party softwares has been used:
Turn it ON in the settings:

Enable the necessary grant types in the Advanced Configuration tab:

First of all, add a new Client to your OAuth Server on your website's admin in the the OAuth Server/Clients page:

Make sure you assigned a user with administrator rights in the Client Credential Assigned User option as we selected the Administrator Permissions in the Modal Survey's General Settings page.
Enter the End Point URL, select OAuth 2.0 as Type, then click on the Get New Access Token button:

Set any Token Name, specify the Auth and Access Token URLs as on the screenshot below and copy/paste the Client ID and Secret of the Client from your site's OAuth Server:

Click on the Request Token button.
When you click on the Request Token button, a login page should appear. Log in with the same user, that has been assigned as Client in the OAuth server:

Then select the Token in the left window, click on the Use Token (that will modify the URL at the top) and finally click on the Send button:

Postman authenticating using the specified client with your website's OAuth Server and if it was successful, you will get the results:

You can double check the authentication is enabled correctly by calling the End Point URL in your browser:

That means, the End Point couldn't be reached without login and the Authentication working well through Postman.
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
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.



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.
Simply add [noclose] to the 'Thank you message' or set to display [noclose] in the Conditions.
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.
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
Please turn ON the Display once per Filled Out option in the General Settings.
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.
Page updated: 15.02.2026