📄 index.html
字号:
This shows any <a href="#survey-editor-starting-date" class=pagelink>date restrictions</a> placed on the survey, such as a starting date, ending date or both. The survey will only be shown according to those dates when 'Active'.<br><br>
<li><b>Link to Survey</b><br>
This is the link visitors must follow in order to complete the survey. This is also the URL you can use in <? php tags in order to include() the survey into an existing page. Or use the portion of this URL after the domain name inside of a server side include call to import the survey into an existing page as well.<br><br>
<li><b>Public Results</b><br>
If you have chosen to <a href="#survey-editor-survey-results" class=pagelink>make survey results public</a>, a link to the public survey results will be made available here. You can use this to point your users to the results if you wish.
</ul><br>
You will notice that an image will appears next to the text "Survey Overview". This image is fetched from our system every time you login. Should we release a security fix or product enhancement, you will be notified via this image (and possibly via email as well). Simply click on the image if you notice there is an update waiting and you will be able to login and download the patch or new version. Otherwise, it will normally state that no updates or announcements exist for the current version.<br><br>
<a name="survey-editor"></a><span class=toctitle>3) Survey Editor</span><br><br>
The survey editor is where all modification and configuration of a specific survey is to be done. This is also where you should go if you wish to add a new survey, remove a survey or edit questions. At the top of the Survey Editor you will see a selection box allowing you to select the specific survey you wish to manage. It will appear something like:<br><br>
<a name="fig3-01"></a><center><table border=0 cellpadding=2 cellspacing=0 width=580><tr><td class=figureTable align=center><img src="images/3-01.gif" width=556 height=43 alt="Figure 3-01"></td></tr><tr><td align=right>Figure 3-01 - Survey Editor</td></tr></table></center><br>
Once a specific survey has been selected, the page will automatically refresh and you will see the:<br><br>
<a name="fig3-02"></a><center><table border=0 cellpadding=2 cellspacing=0 width=580><tr><td class=figureTable align=center><img src="images/3-02.gif" width=556 height=66 alt="Figure 3-02"></td></tr><tr><td align=right>Figure 3-02 - Survey Editor: Survey Selected</td></tr></table></center><br>
You now have access to the following actions which can be performed on this survey:<br><ul>
<li> <b>Edit Questions</b> - Click on this button to be taken to the <a href="#question-editor" class=pagelink>question editor</a>. From there you will be able to add, modify and delete any questions and answers from the survey you have created.<br><br>
<li> <b>Preview</b> - Clicking on this button will popup a new window that allows you to <a href="#survey-preview" class=pagelink>preview your survey</a> without actually submitting any results. Any question requirements are still enforced, so it will behave as would be expected for the final users. You can preview a survey when it is deactivated.<br><br>
<li> <b>Activate</b> or <b>Deactivate</b> - When your survey is created, it defaults to a Deactivated state. This allows you to fully complete and test the survey without users being able to access it. Once your survey is finalized and ready to go live, you should activate the survey by clicking the <a href="#survey-activate" class=pagelink>Activate</a> button. Any starting and ending dates will still be enforced on an active survey. You can stop any submissions on the survey by clicking the <a href="#survey-activate" class=pagelink>Deactivate</a> button on an active survey.<br><br>
<li> <b>Export</b> - You can <a href="#survey-export" class=pagelink>export a survey</a>, along with all questions, into a single file which will allow you to swap this file with another user of phpQ. That person can then <a href="#survey-import" class=pagelink>import the survey</a> using the form at the bottom of the Survey Editor. Survey Results will not be included in this export. If you wish to back those up, you should check out the Configuration tab.<br><br>
<li> <b>Delete</b> - To <a href="#survey-remove" class=pagelink>remove a survey</a> and all related questions and results, click on this button. You will be prompted with a JavaScript alert box, and if you click <b>OK</b> the survey will be removed from the system. <b>You cannot undo this action.</b>
</ul><br>
<a name="survey-add"></a><span class=toctitle>3.1) Adding or Modifying a Survey</span><br><br>
The next portion of the Survey Editor contains the form used for adding and modifying surveys within phpQuestionnaire. There are two interfaces for this form, both of which are shown below. The Basic interface gives you quick access to the most important details of survey creation. If you wish to take full advantage of all that phpQuestionnaire offers, you will definitely want to use the Advanced interface, however.<br><br>
<a name="fig3.1-01"></a><center><table border=0 cellpadding=2 cellspacing=0 width=580><tr><td class=figureTable align=center><img src="images/3.1-01.gif" width=556 height=199 alt="Figure 3.1-01"></td></tr><tr><td align=right>Figure 3.1-01 - Survey Editor: Basic Interface</td></tr></table></center><br>
<a name="fig3.1-02"></a><center><table border=0 cellpadding=2 cellspacing=0 width=580><tr><td class=figureTable align=center><img src="images/3.1-02.gif" width=562 height=881 alt="Figure 3.1-02"></td></tr><tr><td align=right>Figure 3.1-02 - Survey Editor: Advanced Interface</td></tr></table></center><br>
If a survey has been selected within the Survey Editor, the setup for that survey will be placed into the "Add/Modify a Survey" form and made available for modification. Once you have modified the setup, you can either click the "Add" or "Modify" button. Clicking "Add" will create a new survey with the values you have entered, while clicking Modify will simply update the existing survey with the new configuration. The setup in both basic and advanced mode is explained in detail below.<br><br>
<b>FIELDS APPEARING IN BASIC AND ADVANCED INTERFACES:</b><br><br>
<ul>
<a name="survey-editor-survey-name"></a><li><b>Survey Name</b><br>
This field is used within the phpQ admin to refer to the specific survey that you are creating or modifying.<br><br>
This value can also be substituted into survey templates using the marker <b>::SURVEYNAME::</b>. In the default phpQ template, this value appears in the title bar of the user's browser.<br><br>
<a name="survey-editor-template"></a><li><b>Survey Template</b><br>
This field allows you to select the template that you wish for this survey to appear in. You can download more templates for phpQ at <b>http://www.chumpsoft.com/products/phpq/</b>.<br><br>
The program checks in your phpQ/templates directory in order to determine what templates are available for use in your survey program. Removing the files from this directory will cause phpQ to stop functioning properly.<br><br>
The values you can use inside of your template that phpQ will recognize are:<br><br><ul>
<li> <b>::SURVEYNAME::</b> - phpQ will replace this text with the Survey Name. In the default template, this is placed in the <TITLE> tags.<br><br>
<li> <b>::CONTENT::</b> - phpQ will replace this text with the survey questions and answers. This tag is required in order to have the survey questions and answers appear on the page.<br><br>
<li> <b>::JSCRIPT::</b> - This will import any required JavaScript into the template. The only time this is needed is if your results are publicly viewable, so that the survey can popup extra results over the configured limit for textfields and other inputs. You are free to leave this out if you will not be offering public results in your template.<br><br></ul>
<a name="survey-editor-language"></a><li><b>Survey Language</b><br>
Starting with version 2.0, phpQ allows you to create surveys in different languages. If this select box appears on the survey editor page, then you have more than one language available for creating surveys. Simply select the language you wish to use for this survey from the list. Although you control almost all data input to define the language, selecting the appropriate language from this list will cause any error messages and buttons to appear in your language as well as select the correct character set for the browser to use.<br><br>
You may also wish to read about <a href="#languages" class=pagelink>creating your own translations</a> or to find more translations by users such as yourself, you can check <b>http://www.chumpsoft.com/products/phpq/</b>!<br><br>
<a name="survey-editor-user-restrictions"></a><li><b>User Restrictions</b><br>
These can be used to attempt to limit the number of submissions to one per user per survey. They are also effective in stopping accidental duplicate submissions and validating the user's e-mail address. They aren't, however, 100% effective and a determined user will still be able to make multiple survey submissions. You are allowed to select any of the following three options. Selecting none of them will allow any user to submit the survey as many times as they wish. You can select multiple restrictions to enforce multiple rules.<br><br><ul>
<li> <b>Unique IP Address</b> - You can use a user's IP address as one method of blocking multiple survey submissions from the same computer. This is not a 100% guaranteed method and it can be fooled. In some cases, it may deny a legitimate user the ability to complete the survey if two different users are on the same IP address, and in other cases a user could simply change computers to submit the survey twice. In any case, it does provide protection against accidental duplicate submissions or someone who is not intent on submitting the survey more than once.<br><br>
<li> <b>Cookies</b> - Using these restriction, phpQ will attempt to place a cookie in the user's browser each time they complete a survey. If phpQ detects they have already completed the survey, they will not be allowed to make another submission. Using this restrictions requires them to have a cookie-capable browser to complete the survey as it also checks to make sure they don't have cookies turned off. This is not 100% protection and the program can still be fooled into taking multiple survey submissions from the same user.<br><br>
<li> <b>Verified Email</b> - This is by far the most effective restriction. It requires that every person who completes the survey also supply an e-mail address which they are then forced to validate. It is still not 100% effective and cannot guard against users who have multiple e-mail addresses and wish to submit several surveys, but it does provide you with a working e-mail address with which you can contact survey respondents.<br><br>
</ul>
<a name="survey-editor-description"></a><li><b>Description</b><br>
This field contains text that will be displayed on the Survey Overview page which lists all of your active and inactive surveys. It is only there if you wish to provide a brief summary of the purpose or contents of this survey.<br><br>
</ul>
<b>FIELDS APPEARING IN ADVANCED INTERFACE ONLY:</b><br><br>
<ul>
<a name="survey-editor-instructions"></a><li><b>Instructions</b><br>
This field will be displayed at the top of the first page of the survey and can be used to explain what the survey is, how it should be taken or any other information you wish to communicate to the user. You can feel free to use any HTML markup you wish within this textarea and it will be shown as entered when a user begins to take the survey.<br><br>
Some information you may wish to display here are things such as <a href="#survey-editor-user-restrictions" class=pagelink>User Restrictions</a> so the user knows if they will need to have cookies enabled, supply a valid e-mail, etc.<br><br>
<a name="survey-editor-starting-date"></a><li><b>Starting Date</b><br>
<a name="survey-editor-ending-date"></a><li><b>Ending Date</b><br>
phpQ provides a way in which you can set up surveys with specific starting and ending dates. If you are not using starting and ending dates, you must manually activate and de-activate the survey when you wish for it to be available or taken down. The starting and ending dates allow you to activate the survey and have phpQ determine whether the user is allowed to access it based on the time. In this way, you don't have to be around at midnight if you wish for the survey to expire at the end of a day.<br><br>
<b>Starting Date</b> - By setting these fields to a valid date and time, phpQ will not allow anyone to fill out the survey before that specific time.<br><br>
<b>Ending Date</b> - By setting these fields to a valid date and time, phpQ will not allow anyone to fill out the survey after that specific time.<br><br>
You do not have to fill in both of the fields to use one of the functions. For example, if you wish to manually activate the survey, but have a pre-defined end time, you only have to set the Ending Date.<br><br>
<a name="survey-editor-survey-width"></a><li><b>Survey Width</b><br>
When phpQ places the survey inside of your template, it embeds the survey within a table. The Survey Width parameter allows you to control the width of the table in which your survey appears.<br><br>
In some cases, the text or style of some of your questions or answers may cause the survey table to be expanded outside of your defined Survey Width. Therefore, this field is more useful for specifying a width when the table is smaller than you would like it to appear, and wish to expand it.<br><br>
<a name="survey-editor-answer-indentation"></a><li><b>Answer Indentation</b><br>
This parameter specifies how many pixels your answers will appear indented from the leftmost text of each question. Leaving this blank or setting it to 0 will cause the answers to line up with the questions.<br><br>
<a name="survey-editor-auto-numbering"></a><li><b>Auto Numbering</b><br>
If Auto Numbering is set to "Yes", each question will have a number appear in front of it. If you set this to "No", no numbers will appear in front of the questions and you will be responsible for placing the numbers in each individual question if you wish to have them.<br><br>
<a name="survey-editor-question-text-style"></a><li><b>Question Text Style</b><br>
<a name="survey-editor-answer-text-style"></a><li><b>Answer Text Style</b><br>
<a name="survey-editor-error-text-style"></a><li><b>Error Text Style</b><br>
The goal of phpQ was to allow you to design your survey to look any way you wish. To do this, we have offered options on the way your questions, answers and error messages can appear.<br><br>
In these fields you may enter any CSS style definition that you wish to have applied to all question, answer or error text in the survey. You can also modify the question or answer text style individually when adding or modifying that question. The style of an individual question or answer will override the survey wide styles you define here. For example, if you wanted to have your error messages all appear in a red, Arial font of size 12px, you would enter the following into the Error Text Style field:<br><br>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -