===Just another survey tool=== Contributors: Li xintao Donate link: Tags: survey, questionnaire, interactive, feedback Requires at least: 3.5.1 Tested up to: 3.8 Stable tag: 0.9.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html JAST supply a simple way to let your site interactive with the visitor. It's easy to use, but can still do complicate survey questionnaires. == Description == Just another survey tool is a plugin which you can add survey questionnaire to wordpress based web site. Visitors can do the questionnaire by popup window or normal post page, the results will store in database. Other remarkable features include:

Easy to use, can add a questionnaire in 5 minutes. But still can handle very complicate questionnaire.
Chart and table mode to show survey results.
Post writers can quote realtime survey result in posts by chart.
Flexible css design, can customize to compliant with any theme.

Visite Just another survey tool to get more information. == Installation == JAST can be installed via the WordPress.org plugin directory. You can download the package from here, and upload the files to your server. Or you can open Plugins -> Add new menu in Wordpress backend and search for "Just another survey tool" and install the first result item. After activating JAST, you need add some css rules which can altered later to your theme's style.css to make the questionnaire show correct. You can do this by two ways:

Add "@import url('../../plugins/jast-another-survey-tool/public/assets/css/public.css');" (no quotation marks) to style.css, must before any other rules.
Copy the content in wp-content/plugins/jast-another-survey-tool/public/assets/css/public.css to style.css, and copy wp-content/plugins/jast-another-survey-tool/public/assets/css/ajax-loader.gif to your theme's directory.

Then you are able to improve your web site by supply professtional questionnaires. == Work with JAST == You can get more information at Work with JAST. = Design the questionnaire. = JAST add a new post type Survey in wordpress, you can add a questionnaire by add a new Survey post. It's just like a normal post, you can write anything and use css to style it. Also you use shortcode lxt_jast_qust to define survey questions. The content between shortcode tags is the question's title, and the shotcode also have a few properties which are:

name - A key to indentify the question, must supply.
type - Html 5 input element type, select and textarea element, mostly used are radio\checkbox\text\textarea. Use "text" when not supply.
class - Css class, not required. Use when you need diffrent question layout.
option - Question answer options separate by a semi-colon.

Below is an example Survey post content.

[lxt_jast_qust name="1" type="checkbox" option="Business site;Personal blog;Have a try;"]1. What do you use Wordpress for?[/lxt_jast_qust]
[lxt_jast_qust name="2" type="radio" option="Yes;No"]2. Do you need a survey tool for Wordpress?[/lxt_jast_qust]
[lxt_jast_qust name="4" type="select" option=";Chrome;Fire fox;Opera;IE"]3. What's your favourite broswer?[/lxt_jast_qust]
[lxt_jast_qust name="3" type="textarea"]4. What is the most important function a survey tool needed?[/lxt_jast_qust]
[lxt_jast_submit value="Done>>"]

You can copy the code to Survey post editor and edit it to see the effect. At the end of a questionnaire you need add shotcode lxt_jast_submit, which will add a submit button the vistor can submit his answer. The example above showed how to use it. There are four property of lxt_jast_submit:

value - Text of the button.
afterurl - Redirect url after submit the answer when show questionnaire as normal page, default is previous page.
class - Css class, not required. Use when you need diffrent question layout.
message - Greeting text showed after submiting the answer, don't show greeting when not supply.

= Let visitors do the questionnaire. = Visitor can view and do the questionnaire by two ways, by popup window or normal page. I recommend popup window for small questionnaire which have less than 5 questions. One can put a popup window link by widget which fixed on the site or by shortcode which showed within post or page. The plugin have a widget called Survey, it will contain a link which popup the survey you selected. Sometimes a survey relate with a post's subject, it make sense to put the survey's link within the post. One can do this by shortcode lxt_jast_survey. It has a property named title, whose value is the title of the survey want to popup. Below is an example of how to use it.

[lxt_jast_survey title="Survey about WordPress"]

For some survey more complicate and serious, vistor can view it by a normal page. Survey posts don't show on the front page by default. You need add a link to the survey page manually at where you want the link display.The link URL can be get by Get shortlink button at survey edit page. = View and use the survey results = Administrator can view the survey results at Survey results page which under the Survey menu. The operation on this page is straightforward, just select the survey and question by combo-box to see the result. Sometimes we need show the survey results to the reader, shortcode lxt_jast_result will do that, it display a realtime result chart in post or page. For example:

[lxt_jast_result title="Survey about WordPress" name="2"]

This shortcode has three properties:

title - title of the survey post, must not null.
name - which indicate the question, when not supply, it will show the chart of all questions which have option answer.
type - indicate the chart type, can be pie and bar, when not supply, it will use pie for radio type question and bar for checkbox type question.

You can get more information at Work with JAST. == Frequently Asked Questions == = Why the survey post dosn't show correct? = This my happen when content of public.css dosn't merge to style.css of current theme. If use @import to merge the CSS, pay attention to the single quotes which surrounding thr url of public.css. = How could change the permalink of Survey post type = You can set *Survey* post type slug at *Settings -> Survey*. = Why my *Survey* post type slug dosn't work = After you change the permalink structure, you need to re-active the plugin to flush the rewrite rule. == Screenshots == 1. A popup survey questionnaire 2. Post quoted survey result chart 3. Show survey result in table 4. Get the url of Survey page 5. Set up the Survey widget == Changelog == = 0.9.0 = The first version. == Upgrade Notice == No upgrade needed now.