====== redirect() ======

''void **redirect**(string //URL//, [boolean //continue//])''

The function ''redirect()'' leads the participant directly to the specified internet address (//URL//). 


  * //URL//\\ Internet address that the participant should be redirected to. Placeholders can be used in the //URL//, for example in order to continue with a panel ID ([[:en:survey:panels|Working with External Panel Providers]]).
  * //continue//\\ If no other parameters are specified apart from the URL, the interview will be terminated with the command (FINISHED=1). This is particularly useful if you want to quote the participants and use the function [[:en:create:functions:statistic|statistic()]] to do so. If ''true'' is specified as the second parameter, the respondent can continue the questionnaire later on the following (!) page.  

**Important:** A ''redirect()'' should always be by itself on a questionnaire page. Although other commands (e.g. a question) put before this command are executed, nothing is shown. Commands that are put after the ''redirect()'' are ignored completely. 

**Important:** If the second parameter is not specified or set to ''false'', the questionnaire is marked as completed. This means that the dataset is counted by the function ''[[:en:create:functions:statistic]]'' for example.

**Note:** In order to ensure that a survey can be continued at a later point in time, the other internet page must not only send the participant back, but also transfer the interview ID (please refer ''[[:en:create:functions:casetoken]]'' and ''[[:en:create:placeholders#predefined_placeholders|%caseToken%]]''). For example, %%https://www.soscisurvey.de/projekt?i=WBE0R7V8%% -- a subsequent call up via personalized link with access code is also possible.

**Note:** If the ''redirect()'' is located within a ''[[:en:create:frameset#define_a_frameset|frameset]]'' (e.g. in a questionnaire in which [[:en:create:frameset|music is played across several pages]]), the following PHP command must be set on the page with the ''redirect()'' command at the latest, or otherwise at the beginning of the questionnaire:

<code php>
option('frameset', true);
</code>

**Tip:** If the participant uses another internet page in the meantime and subsequently should return to the questionnaire, the other internet page can also send data besides the interview ID (see above). This data can be stored in the data record on the page after the ''redirect()'' by using a question [[:en:create:questions:client|Device and Transmitted Variables]].


===== Example =====

<code php>
redirect('http://www.panel.tld/quotaout.php?panelID=%reference%', false);
</code>