LimeSurvey Manual - User contributions [en]

Installation - LimeSurvey CE

2023-05-16T12:57:55Z

Holch:

<languages />
<translate>


__TOC__


<div class="simplebox"> Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found [[Installation Version 1.92 or older|here]] and update instructions can be found [[Upgrading from a previous version|here]]. </div>

==General== 


The LimeSurvey project provides two ways to install LimeSurvey:
*On your webserver:<br />In this case, just follow the instructions on this page starting with step 1.


*On your local Windows PC:<br />You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and [[Installation of the LimeSurvey XAMPP package|instructions how to install it]].

==Make sure you can use LimeSurvey on your website== 


Make sure your server meets the following additional requirements.


{{Note|The minimum set of requirements will also be checked during the installation process!}}


The minimum set of requirements for '''LimeSurvey 6.x''':
* Minimum 250 MB disk space.
* MySQL 5.5.3 or later '''OR''' Microsoft SQL Server 2005 or later '''OR''' Postgres 9 or later.
* PHP version requirements:
** LS 6.x from PHP 7.4.x to 8.1.x
** LS 5.x from PHP 7.2.5 to 8.0.x
** LS 3.x from PHP 5.5.9 to 7.4.x
* php.ini `short_open_tag` setting should be set to `ON`
* The following PHP modules/libraries should be enabled:
** [[Installation FAQ#Requirements page#What is the mbstring (Multibyte String Functions) library|mbstring (Multibyte String Functions)]] extension library.
** PDO database driver for MySQL (pdo_mysql or pdo_mysqli) or Postgres (pdo_pgsql) or MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] for Windows and [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] for Linux).
** Also, we assume in general that all PHP default libraries are enabled
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** etc …


<div class="simplebox"> Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the [[Troubleshooting]] page for more information.</div>


Optional PHP Extensions:
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas, nice charts in statistics or to upload images via the HTML editor - see [https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) is needed for the [[Email bounce tracking system|email bounce tracking system]] - see [https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' installed is needed to import survey participants using LDAP - see [https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) is needed for template upload, import of .zip archived resources, and excel export - see [https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]


In most cases, your web server provider or system administrator will be able to help you out with these optional components.


If you want to run Microsoft's IIS server, taking a look at [[Installation on XP with IIS]] might also help.

===Browser compatibility=== 
'''For the survey-taking side''', we currently support IE11 (intranet-mode excluded) and all newer comparable browsers like Edge, FF, Chrome, Opera etc. with activated JavaScript.


'''For the administration part''', we currently support Edge and all newer comparable browsers like FF, Chrome, Opera etc. with activated JavaScript. <u>We do not support any Internet Explorer versions in the administration part anymore.</u>

====Screen sizes==== 
We support any reasonable screen size for survey taking (360px x 640px and up).
The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.

===Hosting for LimeSurvey=== 


LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud], else check out our [[LimeSurvey-compatible hosting companies|list of LimeSurvey-compatible hosting companies]].

==Download the LimeSurvey package== 


[https://community.limesurvey.org/downloads/ Download] the latest stable LimeSurvey zip package (there are also gzip, bz2 and 7zip packages available for your convenience) and save it to your local disk.

==Unpack the LimeSurvey package== 


Uncompress the zip file into a dedicated directory/folder using your preferred compression software. When you uncompress the file make sure that you uncompress the directory structure with the files (this is default behavior for most compression programs). The path name for the installation directory should not include '(' or ')' special characters, but it may include the '''space''' character.

==Collect information about your server== 


You will need to know the following things to install LimeSurvey on your web server correctly:
*Your intended website URL where your scripts will reside (e.g. ''http://my.domain.com/limesurvey'').
*The physical disk location on your server where your scripts will reside (e.g. ''/home/usr/htdocs/limesurvey'').
*The IP/net location of your database server (i.e. ''localhost'').
*If your database server uses a non-standard port, find out which port it is.
*Your user name and password for your database server.
*With most providers you can't let the script create the database, but have to do it yourself. If you are using such a provider, please create a database (for example ''limesurvey'') yourself.

==Upload the files to your web server== 


Using your FTP program (e.g. FileZilla), connect to your web server and create a directory to store your scripts. Then upload the files using the directory structure they are in. Make sure you '''upload the files in binary mode''' (check the settings of your FTP program). Please note that uploading in ASCII mode can lead to uncommon errors (e.g. 'class not found' error during installation), also images may not be uploaded correctly.

==Set directory permissions== 


For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
*The '''"/limesurvey/tmp"''' directory (and all its subdirectories and files) are used for imports & uploads and should be set to ''Read & Write'' for your webserver.
*The '''"/limesurvey/upload/"''' directory (and all its subdirectories and files) must also have ''Read & Write'' for your webserver in order to enable picture and media files upload.
*The '''"/limesurvey/application/config/"''' directory also needs ''Read & Write'' permissions for your webserver.
*The other directories can be set to ''Read Only''. You may wish in Linux/Unix to set the permissions on each file within the /limesurvey/admin directory to ''Read Only''.


{{Alert|If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type '''chmod -R 755 <directory> ; chown -R apache <directory>'''. This will give everyone access to read, and your webserver will have the permission to write. Check the [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions following link] for more information on Linux permissions.}}

==Create a database user== 


LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:


- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX


- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER


- Microsoft SQL Server: ''Unknown - if you can find out this information, please complete it''.

==Run the installation script== 


'''Go to "example.org/limesurvey/admin"'''. If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked whether you wish to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.

==Connect to the administration script for the first time== 


You are done when the installation finishes! Open your browser and enter the URL to the LimeSurvey administration. Assuming you used 'limesurvey' as the directory name to store the files in, this will be something like "http://www.example.com/limesurvey/admin".


You should get a login screen. The default login credentials (if they have not been changed during the installation) are:


<syntaxhighlight lang='html'>


User: admin
Password: password


</syntaxhighlight>


You will be prompted to change the default password after you logged in. Have fun!

==Further configuration== 

===Caching=== 


LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:


* Memcached
* Redis
* WinCache
* XCache


Please see the [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] for full description.


Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array):


<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>


As with the main Yii cache, other cache systems can be used.


{{Note| The emcache is not compatible with randomized surveys, and will be automatically turned off in such cases.}}

==What if I have problems...== 


Like all computer programs, most of the time things will work just like the instructions say, but sometimes they just won't. There are too many possible reasons for things not going according to plan to describe here. If you have trouble, first check out the [[Installation FAQ]]. If you don't find your answer there, please post your problem and any error messages in the [https://www.limesurvey.org/forum LimeSurvey forums], open a [https://www.limesurvey.org/contact-us support ticket] (only for customers using LimeSurvey Cloud), or join our [https://discord.gg/DEjguXn Discord channel].

</translate>

Installation - LimeSurvey CE

2023-05-16T12:57:20Z

Holch:

<languages />
<translate>


__TOC__


<div class="simplebox"> Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found [[Installation Version 1.92 or older|here]] and update instructions can be found [[Upgrading from a previous version|here]]. </div>

==General== 


The LimeSurvey project provides two ways to install LimeSurvey:
*On your webserver:<br />In this case, just follow the instructions on this page starting with step 1.


*On your local Windows PC:<br />You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and [[Installation of the LimeSurvey XAMPP package|instructions how to install it]].

==Make sure you can use LimeSurvey on your website== 


Make sure your server meets the following additional requirements.


{{Note|The minimum set of requirements will also be checked during the installation process!}}


The minimum set of requirements for '''LimeSurvey 6.x''':
* Minimum 250 MB disk space.
* MySQL 5.5.3 or later '''OR''' Microsoft SQL Server 2005 or later '''OR''' Postgres 9 or later.
* PHP version requirements:
** LS 6.x from 7.4.x to 8.1.x
** LS 5.x from 7.2.5 to 8.0.x
** LS 3.x from 5.5.9 to 7.4.x
* php.ini `short_open_tag` setting should be set to `ON`
* The following PHP modules/libraries should be enabled:
** [[Installation FAQ#Requirements page#What is the mbstring (Multibyte String Functions) library|mbstring (Multibyte String Functions)]] extension library.
** PDO database driver for MySQL (pdo_mysql or pdo_mysqli) or Postgres (pdo_pgsql) or MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] for Windows and [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] for Linux).
** Also, we assume in general that all PHP default libraries are enabled
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** etc …


<div class="simplebox"> Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the [[Troubleshooting]] page for more information.</div>


Optional PHP Extensions:
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas, nice charts in statistics or to upload images via the HTML editor - see [https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) is needed for the [[Email bounce tracking system|email bounce tracking system]] - see [https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' installed is needed to import survey participants using LDAP - see [https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) is needed for template upload, import of .zip archived resources, and excel export - see [https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]


In most cases, your web server provider or system administrator will be able to help you out with these optional components.


If you want to run Microsoft's IIS server, taking a look at [[Installation on XP with IIS]] might also help.

===Browser compatibility=== 
'''For the survey-taking side''', we currently support IE11 (intranet-mode excluded) and all newer comparable browsers like Edge, FF, Chrome, Opera etc. with activated JavaScript.


'''For the administration part''', we currently support Edge and all newer comparable browsers like FF, Chrome, Opera etc. with activated JavaScript. <u>We do not support any Internet Explorer versions in the administration part anymore.</u>

====Screen sizes==== 
We support any reasonable screen size for survey taking (360px x 640px and up).
The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.

===Hosting for LimeSurvey=== 


LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud], else check out our [[LimeSurvey-compatible hosting companies|list of LimeSurvey-compatible hosting companies]].

==Download the LimeSurvey package== 


[https://community.limesurvey.org/downloads/ Download] the latest stable LimeSurvey zip package (there are also gzip, bz2 and 7zip packages available for your convenience) and save it to your local disk.

==Unpack the LimeSurvey package== 


Uncompress the zip file into a dedicated directory/folder using your preferred compression software. When you uncompress the file make sure that you uncompress the directory structure with the files (this is default behavior for most compression programs). The path name for the installation directory should not include '(' or ')' special characters, but it may include the '''space''' character.

==Collect information about your server== 


You will need to know the following things to install LimeSurvey on your web server correctly:
*Your intended website URL where your scripts will reside (e.g. ''http://my.domain.com/limesurvey'').
*The physical disk location on your server where your scripts will reside (e.g. ''/home/usr/htdocs/limesurvey'').
*The IP/net location of your database server (i.e. ''localhost'').
*If your database server uses a non-standard port, find out which port it is.
*Your user name and password for your database server.
*With most providers you can't let the script create the database, but have to do it yourself. If you are using such a provider, please create a database (for example ''limesurvey'') yourself.

==Upload the files to your web server== 


Using your FTP program (e.g. FileZilla), connect to your web server and create a directory to store your scripts. Then upload the files using the directory structure they are in. Make sure you '''upload the files in binary mode''' (check the settings of your FTP program). Please note that uploading in ASCII mode can lead to uncommon errors (e.g. 'class not found' error during installation), also images may not be uploaded correctly.

==Set directory permissions== 


For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
*The '''"/limesurvey/tmp"''' directory (and all its subdirectories and files) are used for imports & uploads and should be set to ''Read & Write'' for your webserver.
*The '''"/limesurvey/upload/"''' directory (and all its subdirectories and files) must also have ''Read & Write'' for your webserver in order to enable picture and media files upload.
*The '''"/limesurvey/application/config/"''' directory also needs ''Read & Write'' permissions for your webserver.
*The other directories can be set to ''Read Only''. You may wish in Linux/Unix to set the permissions on each file within the /limesurvey/admin directory to ''Read Only''.


{{Alert|If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type '''chmod -R 755 <directory> ; chown -R apache <directory>'''. This will give everyone access to read, and your webserver will have the permission to write. Check the [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions following link] for more information on Linux permissions.}}

==Create a database user== 


LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:


- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX


- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER


- Microsoft SQL Server: ''Unknown - if you can find out this information, please complete it''.

==Run the installation script== 


'''Go to "example.org/limesurvey/admin"'''. If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked whether you wish to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.

==Connect to the administration script for the first time== 


You are done when the installation finishes! Open your browser and enter the URL to the LimeSurvey administration. Assuming you used 'limesurvey' as the directory name to store the files in, this will be something like "http://www.example.com/limesurvey/admin".


You should get a login screen. The default login credentials (if they have not been changed during the installation) are:


<syntaxhighlight lang='html'>


User: admin
Password: password


</syntaxhighlight>


You will be prompted to change the default password after you logged in. Have fun!

==Further configuration== 

===Caching=== 


LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:


* Memcached
* Redis
* WinCache
* XCache


Please see the [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] for full description.


Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array):


<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>


As with the main Yii cache, other cache systems can be used.


{{Note| The emcache is not compatible with randomized surveys, and will be automatically turned off in such cases.}}

==What if I have problems...== 


Like all computer programs, most of the time things will work just like the instructions say, but sometimes they just won't. There are too many possible reasons for things not going according to plan to describe here. If you have trouble, first check out the [[Installation FAQ]]. If you don't find your answer there, please post your problem and any error messages in the [https://www.limesurvey.org/forum LimeSurvey forums], open a [https://www.limesurvey.org/contact-us support ticket] (only for customers using LimeSurvey Cloud), or join our [https://discord.gg/DEjguXn Discord channel].

</translate>

Installation - LimeSurvey CE

2023-05-16T12:55:29Z

Holch:

<languages />
<translate>


__TOC__


<div class="simplebox"> Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found [[Installation Version 1.92 or older|here]] and update instructions can be found [[Upgrading from a previous version|here]]. </div>

==General== 


The LimeSurvey project provides two ways to install LimeSurvey:
*On your webserver:<br />In this case, just follow the instructions on this page starting with step 1.


*On your local Windows PC:<br />You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and [[Installation of the LimeSurvey XAMPP package|instructions how to install it]].

==Make sure you can use LimeSurvey on your website== 


Make sure your server meets the following additional requirements.


{{Note|The minimum set of requirements will also be checked during the installation process!}}


The minimum set of requirements for LimeSurvey 6.x:
* Minimum 250 MB disk space.
* MySQL 5.5.3 or later '''OR''' Microsoft SQL Server 2005 or later '''OR''' Postgres 9 or later.
* PHP version requirments:
** LS 6.x from 7.4.x to 8.1.x
** LS 5.x from 7.2.5 to 8.0.x
** LS 3.x from 5.5.9 to 7.4.x
* php.ini `short_open_tag` setting should be set to `ON`
* The following PHP modules/libraries should be enabled:
** [[Installation FAQ#Requirements page#What is the mbstring (Multibyte String Functions) library|mbstring (Multibyte String Functions)]] extension library.
** PDO database driver for MySQL (pdo_mysql or pdo_mysqli) or Postgres (pdo_pgsql) or MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] for Windows and [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] for Linux).
** Also, we assume in general that all PHP default libraries are enabled
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** etc …


<div class="simplebox"> Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the [[Troubleshooting]] page for more information.</div>


Optional PHP Extensions:
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas, nice charts in statistics or to upload images via the HTML editor - see [https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) is needed for the [[Email bounce tracking system|email bounce tracking system]] - see [https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' installed is needed to import survey participants using LDAP - see [https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) is needed for template upload, import of .zip archived resources, and excel export - see [https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]


In most cases, your web server provider or system administrator will be able to help you out with these optional components.


If you want to run Microsoft's IIS server, taking a look at [[Installation on XP with IIS]] might also help.

===Browser compatibility=== 
'''For the survey-taking side''', we currently support IE11 (intranet-mode excluded) and all newer comparable browsers like Edge, FF, Chrome, Opera etc. with activated JavaScript.


'''For the administration part''', we currently support Edge and all newer comparable browsers like FF, Chrome, Opera etc. with activated JavaScript. <u>We do not support any Internet Explorer versions in the administration part anymore.</u>

====Screen sizes==== 
We support any reasonable screen size for survey taking (360px x 640px and up).
The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.

===Hosting for LimeSurvey=== 


LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud], else check out our [[LimeSurvey-compatible hosting companies|list of LimeSurvey-compatible hosting companies]].

==Download the LimeSurvey package== 


[https://community.limesurvey.org/downloads/ Download] the latest stable LimeSurvey zip package (there are also gzip, bz2 and 7zip packages available for your convenience) and save it to your local disk.

==Unpack the LimeSurvey package== 


Uncompress the zip file into a dedicated directory/folder using your preferred compression software. When you uncompress the file make sure that you uncompress the directory structure with the files (this is default behavior for most compression programs). The path name for the installation directory should not include '(' or ')' special characters, but it may include the '''space''' character.

==Collect information about your server== 


You will need to know the following things to install LimeSurvey on your web server correctly:
*Your intended website URL where your scripts will reside (e.g. ''http://my.domain.com/limesurvey'').
*The physical disk location on your server where your scripts will reside (e.g. ''/home/usr/htdocs/limesurvey'').
*The IP/net location of your database server (i.e. ''localhost'').
*If your database server uses a non-standard port, find out which port it is.
*Your user name and password for your database server.
*With most providers you can't let the script create the database, but have to do it yourself. If you are using such a provider, please create a database (for example ''limesurvey'') yourself.

==Upload the files to your web server== 


Using your FTP program (e.g. FileZilla), connect to your web server and create a directory to store your scripts. Then upload the files using the directory structure they are in. Make sure you '''upload the files in binary mode''' (check the settings of your FTP program). Please note that uploading in ASCII mode can lead to uncommon errors (e.g. 'class not found' error during installation), also images may not be uploaded correctly.

==Set directory permissions== 


For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
*The '''"/limesurvey/tmp"''' directory (and all its subdirectories and files) are used for imports & uploads and should be set to ''Read & Write'' for your webserver.
*The '''"/limesurvey/upload/"''' directory (and all its subdirectories and files) must also have ''Read & Write'' for your webserver in order to enable picture and media files upload.
*The '''"/limesurvey/application/config/"''' directory also needs ''Read & Write'' permissions for your webserver.
*The other directories can be set to ''Read Only''. You may wish in Linux/Unix to set the permissions on each file within the /limesurvey/admin directory to ''Read Only''.


{{Alert|If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type '''chmod -R 755 <directory> ; chown -R apache <directory>'''. This will give everyone access to read, and your webserver will have the permission to write. Check the [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions following link] for more information on Linux permissions.}}

==Create a database user== 


LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:


- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX


- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER


- Microsoft SQL Server: ''Unknown - if you can find out this information, please complete it''.

==Run the installation script== 


'''Go to "example.org/limesurvey/admin"'''. If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked whether you wish to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.

==Connect to the administration script for the first time== 


You are done when the installation finishes! Open your browser and enter the URL to the LimeSurvey administration. Assuming you used 'limesurvey' as the directory name to store the files in, this will be something like "http://www.example.com/limesurvey/admin".


You should get a login screen. The default login credentials (if they have not been changed during the installation) are:


<syntaxhighlight lang='html'>


User: admin
Password: password


</syntaxhighlight>


You will be prompted to change the default password after you logged in. Have fun!

==Further configuration== 

===Caching=== 


LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:


* Memcached
* Redis
* WinCache
* XCache


Please see the [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] for full description.


Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array):


<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>


As with the main Yii cache, other cache systems can be used.


{{Note| The emcache is not compatible with randomized surveys, and will be automatically turned off in such cases.}}

==What if I have problems...== 


Like all computer programs, most of the time things will work just like the instructions say, but sometimes they just won't. There are too many possible reasons for things not going according to plan to describe here. If you have trouble, first check out the [[Installation FAQ]]. If you don't find your answer there, please post your problem and any error messages in the [https://www.limesurvey.org/forum LimeSurvey forums], open a [https://www.limesurvey.org/contact-us support ticket] (only for customers using LimeSurvey Cloud), or join our [https://discord.gg/DEjguXn Discord channel].

</translate>

REST API

2023-05-03T14:59:35Z

Holch:

; TODO - Under development
: Available from version x (Version to be defined)
: Technical specification. UML.

=Introduction=

LimeSurvey REST API (v1) is available from Version [TBD] and offers '''various [https://api.limesurvey.org/swagger API endpoints]'''. The initial v1 REST API provides a subset of the functionality provided by the existing [https://manual.limesurvey.org/RemoteControl_2_API Remote Control API] except via a REST interface rather than an RPC interface.

=Setup=

==Configure==

In order to use REST API you must first enable the service, and then adjust the settings to suit your needs. To enable login to the LimeSurvey administration, go to [[Global settings]], choose the tab 'Interfaces' and select 'Publish API on /rest'.

==Security==

The REST API uses the same security measures as the normal administration login. That means that the permission set of the used username and password is the same as if you would login in the administration with that user/password. Also the REST API is protected against brute-force password cracking - like the normal administration login.

=Usage=

==Documentation==

The available API endpoints are fully documented using swagger [https://api.limesurvey.org/swagger https://api.limesurvey.org/swagger].

==API Location==

The REST API URL is [http://www.yourdomain.com/rest/v1 http://www.yourdomain.com/rest/v1] .

==Authorisation==

Currently the REST API supports server side session authorisation. You use your standard admin username and password to gain API authorisation.

===Login===
To login to the REST API, perform a POST request to ''/rest/v1/session'' with 'username' and 'password' post data. The API will returns a 200 response with a session id string body.

===Bearer Authentication===
The session id string returned in the JSON response of ''/rest/v1/session'' can be used as authorisation in requests to other endpoints using bearer authentication (also called token authentication).

Set HTTP header 'Authorization' with the value 'Bearer my-session-id-string-returned-from-server' in each request to endpoints that require authorisation.

===Logout===
To logout of the REST API perform an authorised DELETE request to the ''/rest/v1/session''.

==Endpoints==

See the [https://api.limesurvey.org/swagger Swagger Documentation] for full details.

; /rest/v1/
: session
: siteSettings
: siteSettings/<setting-name>
: survey
: survey/<id>
: questionGroup/<surveyId>
: questionGroup
: questionGroup/<groupId>
: questionGroupProperties/<groupId>
: questioGroupProperties/<groupId>

=Examples=

==PHP Example==

This example uses Guzzle as a PHP REST client but you can use any REST client.

<source lang=bash>
composer require guzzlehttp/guzzle:^7.0
</source>

or by inclusion of the following lines in your composer.json file:

<source lang=javascript>
{
"require": {
"guzzlehttp/guzzle": "^7.0"
}
}
</source>

This is an example how to connect to limesurvey REST API:

<source lang="php">
<?php
require './vendor/autoload.php';

use GuzzleHttp\Client;

$baseUrl = 'https://www.mysurveysite.com/index.php/';
$api = 'rest/v1/';
$apiUrl = $baseUrl . $api;
$timeout = 60;

///////////////////////////////////////////////////////////////////////////////
// Login

$loginClient = new Client([
'base_uri' => $apiUrl,
'timeout' => $timeout
]);

$loginResult = $loginClient->request('POST', 'session', [
'form_params' => [
'username' => 'admin',
'password' => 'password'
]
]);
$sessionId = null;
if ($loginResult->getStatusCode() == 200) {
$sessionId = json_decode(
(string) $loginResult->getBody(),
true
);
} else {
throw new Exception('Login failed: ' . $result->getStatusCode());
}

///////////////////////////////////////////////////////////////////////////////
// Use the API with session id that we got from login
$client = new Client([
'base_uri' => $apiUrl,
'timeout' => $timeout,
'headers' => ['Authorization' => 'Bearer ' . $sessionId]
]);

$result = $client->request('GET', 'siteSettings/sitename');
$siteName = null;
if ($result->getStatusCode() == 200) {
$siteName = json_decode(
(string) $result->getBody(),
true
);
} else {
throw new Exception('Failed getting site name: ' . $result->getStatusCode());
}

echo 'Site name: ' . $siteName;

///////////////////////////////////////////////////////////////////////////////
// Logout
// - This is important. If you create too many simultaneous login session
// - you may be temporarily blocked from creating more.
$result = $client->request('DELETE', 'session');
</source>

Survey quotas

2022-11-04T12:48:59Z

Holch:

<languages />
<translate>

__TOC__

=Introduction= 


A quota is used to set a limit on responses from defined groups of people on an active survey. Some common attributes used in defining quotas are gender, age, race, province/state, etc. To access the survey quotas panel, from the '''Settings''' ''Survey menu'', select the survey '''Quotas''' tab.


<center>[[File:Survey menu - Survey quotas.png]]</center>


{{Alert|title=Attention|text= You can only verify that Quotas have been set correctly when the survey is activated. So, if you set a quota with a limit of "0" and the survey is not activated, you will not be able to check whether it is working or not.}}

=How do quotas work?= 


To understand how the LimeSurvey quota system works, think of a survey that contains a "Yes or No" question and an Array question, each of them belonging to two different question groups. You set a quota on this survey that contains a restriction of 20 users who have answered "Yes" to this question. The quota will be checked every time someone answers "Yes" to that question.


Depending on [[General_settings#General_settings_panel|the format of your survey]] (how the questions are displayed to your participants), the '''check''' happens either when you submit:


*'''the whole survey answers at once:''' If the format of the survey is ''all in one'', the questions (regardless of the question group they belong to) will be displayed on the same page. Therefore, the user has to click the submit button in order to trigger the quota limit check;


*'''the answers to a question group:''' If the format of the survey is group by group, then the quota is activated when the survey participant has responded to all the questions that belong to the question group where the answer that contains the quota system check is located. Therefore, the quota may be triggered before the end of the survey if, for example, the question group is located in the beginning of the survey.


*'''the answer to a question:''' If the format of the survey is question by question, each question will be displayed separately, each of them being allocated a page. In this case, if you select the answer that the quota is applied to, the quota system will be automatically triggered once you click the ''Next/Submit'' button.


{{Note|To change the format of a survey, access the [[General settings|general settings of your survey]].}}


If "''No''" is chosen, the quota system is not triggered. Therefore, the survey will not restrict anyone from responding to the rest of the questions, unless otherwise specified.


To set a limit on the number of "''No''" responses, you need to add an additional quota, restricting the number of participants who choose "''No''".


<div class="simplebox">[[File:help.png]] '''Note:''' If you would like your participants to answer certain survey questions according to a previous answer, use the LimeSurvey [[ExpressionScript - Presentation|ExpressionScript]].</div>

==Using more answers and quotas== 


'''Example''': You want to conduct a survey where you want to limit it to 25 male and 30 female participants. In this case, you will have to apply two quota limits: one on males and one on females. This will give you a maximum of 25 males who can complete the survey, and a maximum of 30 females who can complete the survey..


Let's suppose now that you want 50 answers from males and 50 answers from females. Please note that each answer that triggers the quota must be introduced in its own quota box. Adding the two answers in the same box will result in collecting 50 answers, regardless of the respondents' gender distribution (e.g., the distribution can be 40 males and 10 females, or 20 males and 30 females, and so on). Continue reading this wiki page and see the [[Survey quotas#Examples|examples]] subsection get a grasp on the usage of the quota system.

==Activating the quota system while the survey responses table is not empty== 


Note that a quota system does not necessarily have to be added before you activate your survey. If you decide to activate the quota system at a later date, it will start to check the survey responses table and look for those entries that are marked as ''complete''. Then, it checks to determine if the quota condition has been met or not. If it has been met, the next survey responses/entries received will be marked as ''incomplete''.


For example, if you have previously gathered 1000 responses from women and you introduced after a couple of weeks the quota limit of 800 for women, the next responses that you receive from women will be marked ''incomplete''. The other 200 answers will appear in the survey responses table as ''complete'' because the quota was applied after the answers were collected.


<center>[[File:Survey_quotas_-_survey_responses_2.png]]</center>


The quota system does not store any answers and it does not record the number of the submitted survey answers! Think of it as a filter that is applied on the survey responses table. Basically, it looks into the '''completed''' column and those question columns that contain the answers to which one or more quotas are applied to.

=Supported question types= 


The quota system can be applied only to the following types of questions at the moment:
*Gender
*Multiple Choice
*Array - 5 Point Choice
*Array - 10 Point Choice
*Language Switch
*Yes/No
*List (Radio)
*List (Dropdown)
*List with comments
*Equation

=Survey quotas panel= 


Once you click the '''Survey quotas''' tab from the survey menu, the following page will be displayed:


<center>[[FIle:Survey quotas - panel.png]]</center>


To see the full set of options of this panel, add one survey quota. Then, the survey quota page will look like the following:


<center>[[File:Survey quotas - image 2.png]]</center>


The following options are available:
*'''[[Survey quotas#Quick CSV report|Add new quota]]:''' Located on the bottom right part of the survey quotas table, it allows users to add new quotas. Once quotas are displayed on the table, you can start implementing them to certain questions/subquestions answers.


*'''[[Survey quotas#Add an answer|Add an answer]]:''' Before adding an answer, you need to add a quota where the answer(s) will be stored in. The quota limit will be applied <u>only</u> to those answers displayed in the quota box.


*'''Edit quota:''' Click the green pencil located under the '''Action''' column of the survey quotas table to edit the fields of a quota


*'''Delete quota:''' Click the red trash button located under the '''Action''' column of the survey quotas table to delete the respective quota entry;


*'''[[Survey quotas#Quota validation|Quota validation]]:''' Click the last button located under the '''Action''' column of the survey quotas table to quickly check the quota message displayed to the respondents, the URL (and/or a short description of it) where they will be redirected.


*'''[[Survey quotas#Quick CSV report|Quick CSV report]]:''' Exports a summary of the quotas under the form of a comma-delimited CSV table.


*'''Selected quota(s)...:''' Works like an aggregator. Select multiple quotas and use this button to apply one of the actions described below to the selected group of quotas.


<center>[[File:Survey quotas - Selected quota(s).png]]</center>


**''Activate:'' Use this button to activate a quota. The active ones have the quota name, action, and URL written in white font on a green background.


<center>[[File:Active quota.png]]</center>


**''Deactivate:'' Use this button to deactivate a quota. The deactivated ones have the quota name, action, and URL written in black font on a grey background.


<center>[[File:Deactivated quota.png]]</center>


**''Change texts:'' Use this button to quickly change the quota message, URL, and URL description of a group of a quotas. You may use this function to redirect respondents to a certain link once different quota conditions were met.


<center>[[File:Survey quotas - change texts.png]]</center>


**''Delete:'' If you want to delete a group of quotas by a few clicks, tick the ones you want to delete, click the selected quota(s) button, and select the '''Delete''' option.

==Add new quota== 


'''For a fully working quota you must first "add a quota", and then "add answers" to that quota.'''


Once you click the '''Add new quota''' button, the following page will be displayed:


<center>[[File:Add_new_quota_panel.png]]</center>


{{Note|The fields marked with a star are required fields.}}


The following options are available:


*'''Quota Name:''' The name of the quota that will be displayed on the survey quotas table. It should describe the quota it will represent.


*'''Quota Limit:''' The maximum number of completed surveys that will be stored in the responses table and marked as ''complete''. See above the wiki section on [[Survey_quotas#How do quotas work|how do quotas work]] to better understand the mechanism employed by LimeSurvey.


*'''Quota Action:''' If the quota is triggered, then one of two actions will happen:
**''Terminate survey:'' This action immediately terminates and closes the survey.
**''Allow user to modify his last answers before terminate survey:'' Useful action when you want your participants to choose different options. In this way, you can force some of them choose another solution or option. For example, when incentives are offered, you can use a quota on each option so that not everyone chooses the same incentive.


*'''Autoload URL:''' This tells LimeSurvey to automatically redirect the participant to the URL when the quota action occurs.


*'''Quota Message:''' Write the text you want to be displayed to participants if the quota action is triggered. The message will be displayed if the '''Autoload URL''' is disabled.


*'''URL:''' The URL displayed to survey participants after the quota action is triggered. The users can also be automatically redirected to this URL if "Autoload URL" is enabled. You can use [[URL fields]] in this section.


*'''URL Description:''' A short URL description can be added in order to show to the other survey administrators the purpose of the URL for example.

===Add an answer=== 


Once the quota has been created, you can start adding answers. To add answers, access the Survey quotas panel. Look into the survey quotas table and select the '''Add answer''' option from the quota box that you want to add the respective answer to.


<center>[[File:Survey quotas table - add answer.png]]</center>


A new page will be displayed asking you to select the question the quota will be applied to.


<center>[[File:Add answer - part 1.png]]</center>


{{Box|Please remember that only certain types of questions accept quotas. [[Survey quotas#Supported question types|Click here]] to revisit the supported question types list.}}


Click '''Next'''. The answers of the question you selected one step before will be displayed. Now, you have to choose which answer you want the quota to be applied to.


<center>[[File:Add answer - part 2.png]]</center>


In this example, the "''Male''" answer will have the quota applied to it. Whenever participants choose this option, the quota system registers the answer. Once the quota limit is reached, the stored survey answers will be saved in the survey responses table, but it will be marked 'incomplete''.

==Quick CSV report== 


The quick CSV report function is used to export the survey quotas table in a comma-delimited CSV file. It includes the following fields:
*'''Quota name:''' The name of the quotas;
*'''Limit''': If the quota is active, it represents the maximum number of survey responses that can be marked as ''complete'' in the survey responses table;
*'''Completed:''' The number of survey answers marked as ''complete'' in the survey responses table. Please note that an answer is marked as ''incomplete'' if the quota is triggered.
*'''Remaining:''' The number of answers that can still be collected in the survey responses table and marked as ''complete'' there.

=Quota and tokens= 


When tokens are used in a survey and a participant is ''screened out'' due to a quota, then the respective token entry from the survey responses table is marked with the letter "Q" in the '''completed''' column from the survey responses table. The token is invalidated in this way and the survey participant cannot restart the survey.

=Examples= 


The following examples are used to better explain the role of quotas and their usage within the LimeSurvey environment. Before viewing the following examples, please take into account that:


*Answers added in the same quota are summed up. For example, if answers A and B from the available responses of a survey question are added to quota Q1, the quota limit '''sums up''' the number of users who pick up A and B as their answers. Therefore, there is a high probability that the distribution of A and B answers will be uneven (dependent on the characteristics or preferences of your respondents).


*Answers added in different quotas act as if there is a logical operator "AND" between them. Let's suppose that A is added to Q1 and B to Q2. If A is chosen and Q1 is reached, then respondents won't get their answers marked ''complete'' in the survey responses table. However, the survey participants that choose B are still allowed to continue as long as Q2 is not reached. Once it is reached, participants who further choose A or B as answers to that specific question will have their answers marked ''incomplete'' in the survey responses table.


<center>[[File:Survey quotas - survey responses.png]]</center>

==Adding more answers to different quotas== 


Let's assume that you are doing a survey about LimeSurvey and you would like to receive feedback from your participants. You would like to receive 1000 answers from students (PhD student, graduate, undergraduate) and another 1000 from non-students (unemployed persons, full/part-time working persons or other). In order to do this, create two quotas: '''Students quota''' and '''Non-students quota'''.


<center>[[File:Survey quotas - example - add survey quotas.png]]</center>


Now, start adding answers to each quota box following the steps described above in the [[Survey quotas#Add an answer|wiki section]]. The quota boxes should look like this:


<center>[[File:Survey quotas - example - add answers.png]]</center>


By using this method, you limit the number of responses you receive from the two defined groups: students and non-student groups. Now, activate the survey and start testing the quotas. If you first reach 1000 answers from the '''non-students''' group, the next answers you receive from this category will be marked as 'incomplete'' in the survey responses table. Only answers that come from the students group will still be accepted. Once it also reaches 1000, no more answers will be registered as ''complete'' in the survey responses table.


{{Box|However, the survey can still be accessed by the participants! Deactivate it once you see that the quota limit has been reached.}}

==Adding a URL link== 


To add a URL link to a quota, please continue reading the [[URL fields|URL fields]] wiki section.

==Using of equation question for quota in other question type== 


You can use [[Question_type_-_Equation|Equation Question]] to set a value to [[Survey_quotas#Supported_question_types|supported question types]] and [[Expression_Manager#Using_Assignment_Operator|assignment operator]].


The 2 question can be hidden, quota is checked if all question are hidden or when one question is in submitted page.


For example , to set a quota to a text question (user write ok or not) on a Y/N question: <code>{QuotaQuestion=if(strtolower(Q00.NAOK) == 'ok', 'Y', 'N')</code>


[[File:QuotaEquation.png]]


You can import and activate this sample survey [[File:Limesurvey_survey_quotaEquationAndOptOut.zip]] (remember to unzip the file and activate the survey).

==Limiting max number of responses in survey using a hidden question== 


Like using an equation to set a value to an answer, quota for default values are checked if a question is hidden. This allows you to set a maximum number of response in a specific survey. You put a quota on the default answer in a hidden question and put this question in a simple group.


You can import and activate this sample survey [[File:Quota_by_default_value_sample_survey.zip]] (remember to unzip the file and activate the survey).

</translate>

Available third party plugins

2022-07-25T15:21:59Z

Holch:

Some plugin are listed in the [https://account.limesurvey.org/limestore Limestore]. If you have a plugin you would like to share with the world, feel free to add it to this page.

== Authentication plugins ==

* [https://github.com/technowhizz/LimeSurvey-RegDomainRestricter Registration Email Domain Restrictor]
* [https://github.com/pitbulk/limesurvey-saml SAML support (Only supports Limesurvey version 2.x and below not 3.x or 4.x)]
* [http://extensions.sondages.pro/authentification-by-wordpress/ Authentification by WordPress user]
* [https://github.com/univlorraine/limesurvey-cas CAS Authentication plugin for limesurvey]
* [https://github.com/atlet/LimeSurvey-ShibbolethAuth LimeSurvey Shibboleth auth plugin]
* [https://framagit.org/Animafac/limesurvey/limesurvey-rememberme LimeSurvey RememberMe plugin]

== Export and statistics plugins ==

* [http://extensions.sondages.pro/exportcompleteanswers/ exportCompleteAnswers : Complete New export system allowing export Answer code and answer text in CSV. Options is manageable by super admin.]
* [http://extensions.sondages.pro/triple-s-export/ exportTripleS : export in Triple-S XML2 or XML1.3 format survey structure and data.]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/extendAdminStatitistics extendAdminStatitistics : rewriting of core statistics, actually put sub question in same table and graph]
* [https://github.com/reportico-web/limesurvey-reportico Reportico Reporting module for Limesurvey]: generate charts,tables and statistics from survey data

== Public survey plugins ==
* [http://extensions.sondages.pro/hideemptycolumn-for-limesurvey/ hideEmptyColumn : A plugin to add a solution to hide column of array question type with ExpressionScript of LimeSurvey ]
* [http://extensions.sondages.pro/moreaccessibility/ moreAccessibility : some option to add accessibility to public survey] 2.6lts compatible onlmy, deprecated in 3.0
* [https://git.framasoft.org/Shnoulle/addQuestionCodeClass addQuestionCodeClass : add the question code at the question wrapper class]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/radioToStarRating radioToStarRating : set any radio list to star rating system]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/moveSomeAnswers moveSomeAnswers] : If using random_order attribute : allow to always move some answers at end.

== Data editing plugins ==
* [https://manual.limesurvey.org/MassAction_Plugin MassAction] : A plugin for faster survey editing by loading questions details into editable cells. Includes a search and replace feature.

== Email plugins ==

* [https://gitlab.com/SondagesPro/mailing/noMailToExample noMailToExample]
* [https://github.com/LimeSurvey/LimeSurvey/blob/develop/plugins/mailSenderToFrom/mailSenderToFrom.php mailSenderToFrom]
* [https://github.com/Xites/LS_mailDKIM mailDKIM]
* [https://github.com/Xites/LS_mailEmbedImages mailEmbedImages]

== Other plugins ==

* [http://extensions.sondages.pro/recomputeexpression-for-limesurvey Recompute Expressions:] A Plugin for LimeSurvey to recompute expression in survey with already submitted survey. Allow to update some relevance too.
* [https://git.framasoft.org/SondagePro-LimeSurvey-plugin/showAdvancedSettings showAdvancedSettings:] Show advanced settings in question edit by default.
* [https://git.framasoft.org/SondagePro-LimeSurvey-plugin/replaceRegister replaceRegisterː] Extra option for Register, starting point for other plugin.
* [http://extensions.sondages.pro/fixmaxstep-for-question-index/ fixMaxStep : Fix question index for token answer persistence survey:] Example of usage : get the complete index when user come back to the survey.
* [http://extensions.sondages.pro/sendmailajax-all-email-in-one/ sendMailAjax : Send token email one by one with ajaxː] Allow to send all email in one click without restriction.
* [http://extensions.sondages.pro/mailing-management/sendmailcron sendMailCron: Automatically send invitations and reminders using cronjobsː] Automatically sends invitations and reminders in custom intervals. Extensive configuration and debugging options
* [https://github.com/SteveCohen/Piwik-for-Limesurvey Piwik-for-Limesurvey Piwik for LImesurveyː] Plugs Piwik into Limesurvey, so you can track your survey admin users and respondents.
* [https://github.com/SondagesPro/surveysModel Mark surveys as "Survey Model/Template"ː] Allow admins to mark a survey as "Survey Model", a kind of "master survey" or "survey template" which only users with appropriate rights are allowed to edit. The common user is only allowed to create copies based on such a survey template.
* [https://github.com/SondagesPro/LS-toolsDomDocument toolsDomDocumentː] a tools for anothers plugin
* [https://github.com/TonisOrmisson/limesurvey-url-templates UrlTemplateChangerː] Set respondent's interview template over an URL parameter.
* [https://github.com/evently-nl/zesthook ZestHookː] Makes it possible to send a Post request on every response submission. You can set the URL to post to, as well as several other options.
* [https://github.com/CEric-fr/limesurvey-rgpd Extension RGPD pour LimeSurvey] Each questionnaire owner is able to interact with these conditions of use via a new submenu added in the "questionnaire parameters" entitled: GDPR configuration.

== Example and demo plugins ==
* [https://framagit.org/SondagePro-LimeSurvey-plugin/extendRemoteControl extendRemoteControl] : Show how to add function to [[RemoteControl_2_API]], show how to create a new admin page too (usage of public function actionIndex() )

[[Category:Plugins]]

Available third party plugins

2022-07-25T15:21:28Z

Holch: Link to the Extension page was broken, included the link to the Limestore.

Some plugin are listed in the [//https://account.limesurvey.org/limestore Limestore]. If you have a plugin you would like to share with the world, feel free to add it to this page.

== Authentication plugins ==

* [https://github.com/technowhizz/LimeSurvey-RegDomainRestricter Registration Email Domain Restrictor]
* [https://github.com/pitbulk/limesurvey-saml SAML support (Only supports Limesurvey version 2.x and below not 3.x or 4.x)]
* [http://extensions.sondages.pro/authentification-by-wordpress/ Authentification by WordPress user]
* [https://github.com/univlorraine/limesurvey-cas CAS Authentication plugin for limesurvey]
* [https://github.com/atlet/LimeSurvey-ShibbolethAuth LimeSurvey Shibboleth auth plugin]
* [https://framagit.org/Animafac/limesurvey/limesurvey-rememberme LimeSurvey RememberMe plugin]

== Export and statistics plugins ==

* [http://extensions.sondages.pro/exportcompleteanswers/ exportCompleteAnswers : Complete New export system allowing export Answer code and answer text in CSV. Options is manageable by super admin.]
* [http://extensions.sondages.pro/triple-s-export/ exportTripleS : export in Triple-S XML2 or XML1.3 format survey structure and data.]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/extendAdminStatitistics extendAdminStatitistics : rewriting of core statistics, actually put sub question in same table and graph]
* [https://github.com/reportico-web/limesurvey-reportico Reportico Reporting module for Limesurvey]: generate charts,tables and statistics from survey data

== Public survey plugins ==
* [http://extensions.sondages.pro/hideemptycolumn-for-limesurvey/ hideEmptyColumn : A plugin to add a solution to hide column of array question type with ExpressionScript of LimeSurvey ]
* [http://extensions.sondages.pro/moreaccessibility/ moreAccessibility : some option to add accessibility to public survey] 2.6lts compatible onlmy, deprecated in 3.0
* [https://git.framasoft.org/Shnoulle/addQuestionCodeClass addQuestionCodeClass : add the question code at the question wrapper class]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/radioToStarRating radioToStarRating : set any radio list to star rating system]
* [https://framagit.org/SondagePro-LimeSurvey-plugin/moveSomeAnswers moveSomeAnswers] : If using random_order attribute : allow to always move some answers at end.

== Data editing plugins ==
* [https://manual.limesurvey.org/MassAction_Plugin MassAction] : A plugin for faster survey editing by loading questions details into editable cells. Includes a search and replace feature.

== Email plugins ==

* [https://gitlab.com/SondagesPro/mailing/noMailToExample noMailToExample]
* [https://github.com/LimeSurvey/LimeSurvey/blob/develop/plugins/mailSenderToFrom/mailSenderToFrom.php mailSenderToFrom]
* [https://github.com/Xites/LS_mailDKIM mailDKIM]
* [https://github.com/Xites/LS_mailEmbedImages mailEmbedImages]

== Other plugins ==

* [http://extensions.sondages.pro/recomputeexpression-for-limesurvey Recompute Expressions:] A Plugin for LimeSurvey to recompute expression in survey with already submitted survey. Allow to update some relevance too.
* [https://git.framasoft.org/SondagePro-LimeSurvey-plugin/showAdvancedSettings showAdvancedSettings:] Show advanced settings in question edit by default.
* [https://git.framasoft.org/SondagePro-LimeSurvey-plugin/replaceRegister replaceRegisterː] Extra option for Register, starting point for other plugin.
* [http://extensions.sondages.pro/fixmaxstep-for-question-index/ fixMaxStep : Fix question index for token answer persistence survey:] Example of usage : get the complete index when user come back to the survey.
* [http://extensions.sondages.pro/sendmailajax-all-email-in-one/ sendMailAjax : Send token email one by one with ajaxː] Allow to send all email in one click without restriction.
* [http://extensions.sondages.pro/mailing-management/sendmailcron sendMailCron: Automatically send invitations and reminders using cronjobsː] Automatically sends invitations and reminders in custom intervals. Extensive configuration and debugging options
* [https://github.com/SteveCohen/Piwik-for-Limesurvey Piwik-for-Limesurvey Piwik for LImesurveyː] Plugs Piwik into Limesurvey, so you can track your survey admin users and respondents.
* [https://github.com/SondagesPro/surveysModel Mark surveys as "Survey Model/Template"ː] Allow admins to mark a survey as "Survey Model", a kind of "master survey" or "survey template" which only users with appropriate rights are allowed to edit. The common user is only allowed to create copies based on such a survey template.
* [https://github.com/SondagesPro/LS-toolsDomDocument toolsDomDocumentː] a tools for anothers plugin
* [https://github.com/TonisOrmisson/limesurvey-url-templates UrlTemplateChangerː] Set respondent's interview template over an URL parameter.
* [https://github.com/evently-nl/zesthook ZestHookː] Makes it possible to send a Post request on every response submission. You can set the URL to post to, as well as several other options.
* [https://github.com/CEric-fr/limesurvey-rgpd Extension RGPD pour LimeSurvey] Each questionnaire owner is able to interact with these conditions of use via a new submenu added in the "questionnaire parameters" entitled: GDPR configuration.

== Example and demo plugins ==
* [https://framagit.org/SondagePro-LimeSurvey-plugin/extendRemoteControl extendRemoteControl] : Show how to add function to [[RemoteControl_2_API]], show how to create a new admin page too (usage of public function actionIndex() )

[[Category:Plugins]]

Workarounds: Manipulating a survey at runtime using Javascript

2015-03-11T18:02:32Z

Holch: /* Text input masks - second method */

Often you want to manipulate certain elements of a survey at runtime. The only solution without touching the source code is to use JavaScript or jQuery which is shipped with LimeSurvey. Here are some examples to hide and style elements, validate user input or do calculations at runtime.

Other workarounds can be found at
* [[Workarounds: Survey behaviour]]
* [[Workarounds: Question design, layout and templating]]

<div class="simplebox"><center><br />'''Please keep in mind that these workarounds are not official LimeSurvey extensions - they are solutions that users have created for themselves.<br /><span style='color:#EE0000,#FFFFFF'>Therefore LimeSurvey can't offer guarantees or support for these solutions.</span><br />If you have questions, please contact the users that, thankfully, shared their solutions with the community.'''<br /><br /></center></div>

<div class="simplebox">Note: Version 1.92 implements many new features that make some existing workarounds obsolete. You can continue to use existing workarounds, but may want to consider switching over to using the new features (since those new features are officially supported, and the workarounds are not). Please review below for details of which are no longer needed.<br /><br /></div>

<div class="simplebox">Also Note: Version 1.92's Expression Manager (EM) may cause some of these work-arounds to fail. Any custom javascript included as a .js file will be fine. However, if you in-line your JavaScript code, you must make sure that you have a space after every opening (left) curly brace, and a space before every closing (right) curly brace. Otherwise, EM will think that the content between the curly braces is something it should parse and understand. I have fixed all of the work-arounds below that can be fixed (many did not follow those rules). However, some will continue to break. If a work-around contains a regular expression which contains curly braces (to indicate a range of repeats of a sub-expression), EM will try to process those curly braces, and thus break your regular expression. Strategies to continue to support that work-around functionality are discussed below.<br /><br /></div>

__TOC__

=How to ''add'' a javascript workaround solution to this Wiki page?=

Well, this is pretty easy. Click the edit icon and create your own headline within the javascript section starting with "'''!'''". Then add a short note about the version you have used when creating your workaround, you can copy/paste this code snippet <nowiki>''Tested with: (enter LimeSurvey version and maybe browser)''</nowiki>.

Finally it's imported to mark all your code with code tags, other wise you might break this page.
*Start tag: '''<nowiki><syntaxhighlight lang="php" enclose="div"></nowiki>'''
*End tag: '''<nowiki></syntaxhighlight></nowiki>'''.

=How to ''use'' Script (eg. JavaScript etc.) in LimeSurvey?=

To use JavaScript within LimeSurvey, the XSS filter must be turned off and the code inserted in the source of a question or a group description.
*Go to Global settings --> Security and set "Filter HTML for XSS" to "Off".
* [http://docs.limesurvey.org/tiki-index.php?page=Adding+A+Question Add a new question]
* Edit the question and click the "Source" button in the editor toolbar:

[[File:editor_1.gif]]
* Enter your script after the question text:

[[File:editor_2.gif]]
* Save the question

A simple test to see if JavaScript is enabled is to echo an alert. Use this code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
alert("Test!");
</script></syntaxhighlight>

It is a good practice to use the jQuery $(document).ready function to prevent the code from executing until the page is fully loaded:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(document).ready(function() {
alert("Test!");
});
</script></syntaxhighlight>

It is also good practice to use jslint.com to get a good layout and design (e.q. no cluttering of name space)

==Usage of brackets (<nowiki>{ and }</nowiki>)==
{{Alert|title=Caution with bracket ( <nowiki>{ and }</nowiki>)|text=[[Expression Manager#Syntax|Expression manager]] use bracket ( <nowiki>{ and }</nowiki>) to enclose expression. Then if you have to use bracket in your javascript, you must add space or line feed after starting bracket (<nowiki>{</nowiki>) and before closing bracket (<nowiki>}</nowiki>) }}

===Exemples of usage of brackets===

Expression Manager try to parse the javascript :
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(function() {console.log('broken javascript');});
</script>
</syntaxhighlight>

Adding line feed and Expression Manager don't parse
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(function() {
console.log('Adding a line feed for javascript');
});
</script>
</syntaxhighlight>

Expression Manager try to parse the javascript :
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
if(myvar==1) {console.log('broken javascript');};
</script>
</syntaxhighlight>

Adding line feed and Expression Manager don't parse
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
if(myvar==1) { console.log('Adding a space for javascript'); };
</script>
</syntaxhighlight>

=Sum up input values using Javascript=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the sum() function in [[Expression Manager|Expression Manager]]. See this [[Expression Manager HowTos#Calculate assessment values at runtime and store the results in the survey data|HowTo example]].</div>

<div class="simplebox">Starting in Version 1.92, you also do no longer need to use SGQA (e.g. 45251X1X5) identifiers. Instead the code <code>{SGQ}</code> will automatically replaced by the current questions SGQA-codes.</div>

This is from a survey that is a invitation to a longer party, when the user clicks to the next page, the calculated results will be shown.

If you wonder what the {INSERTANS:1X6X12} stuff is, look at [http://docs.limesurvey.org/tiki-index.php?page=SGQA+Identifier SGQA identifier] and [[Adding a question#Information from previous answers|Using information from previous answers]].

<syntaxhighlight lang="html4strict" enclose="div">

<div style="text-align: left">These are your answers:<br />

<u></u><u></u><u></u><u></u><u>=

<p><script LANGUAGE="JavaScript">

partyprice = 3;

beadclothprice = 3;

breakfastprice = 7;

lunchprice = 8;

dinnerprice = 10;

foodtotal = 0;

var isreallytrue = "Yes";

var noanswer = "No answer";

document.write( "Can you come? = {INSERTANS:45251X1X1}<BR>" );

if ("{INSERTANS:45251X1X1}" == isreallytrue )

{

if ("{INSERTANS:45251X1X3}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X3}"; }

partypeople = parseInt(answer);

partytotal = partyprice * partypeople;

document.write( "It's {INSERTANS:45251X1X3} persons who will come = " + partytotal + "€<BR>" );

if ("{INSERTANS:45251X1X4}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X4}";}

beadcloths = parseInt(answer);

beadclothtotal = beadclothprice * beadcloths;

document.write( "You want to borrow {INSERTANS:45251X1X4} beadcloths = " + beadclothtotal + "€<BR>" );

document.write( "Will you be there thursday? = {INSERTANS:45251X1X5}<BR>" );

document.write( "On friday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X71}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X71}";}

breakfastfriday = parseInt(answer) * breakfastprice;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastfriday + "€<BR>" );

if ("{INSERTANS:45251X1X72}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X72}";}

lunchfriday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchfriday + "€<BR>" );

if ("{INSERTANS:45251X1X73}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X73}";}

dinnerfriday = parseInt(answer)* dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnerfriday + "€<BR>" );

foodtotal = breakfastfriday + lunchfriday + dinnerfriday;

document.write( "Will you be there saturday? = {INSERTANS:45251X1X8}<BR>" );

if ("{INSERTANS:45251X1X8}" == isreallytrue )

{

document.write( "On saturday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X91}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X91}"; }

breakfastsaturday = parseInt(answer) * breakfastprice ;

document.write("'''_ " + answer + " breakfeasts = " + breakfastsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X92}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X92}"; }

lunchsaturday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X93}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X93}"; }

dinnersaturday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersaturday + "€<BR>" );

foodtotal = foodtotal + breakfastsaturday + lunchsaturday + dinnersaturday;

}

document.write( "Will you be there sunday? = {INSERTANS:45251X1X10}<BR>" );

if ("{INSERTANS:45251X1X10}" == isreallytrue )

{

document.write( "On sunday you will have these meals: <br>" );

if ("{INSERTANS:45251X1X111}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X111}"; }

breakfastsunday = parseInt(answer) * breakfastprice ;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastsunday + "€<BR>" );

if ("{INSERTANS:45251X1X112}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X112}"; }

lunchsunday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsunday + "€<BR>" );

if ("{INSERTANS:45251X1X113}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X113}"; }

dinnersunday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersunday + "€<p>" );

foodtotal = foodtotal + breakfastsunday + lunchsunday + dinnersunday;

}

total = partytotal + beadclothtotal + foodtotal;

document.write( "<h3>In total it will cost you " + total + "€</h3><BR>

Put that sum in this bank account 1234 5678 9012" );

}

</SCRIPT></p>

</div></syntaxhighlight>

=Multiple Question Validation=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the min/max/equals_num_value attributes (to validate sums), or the em_validation_q function, which lets you refer to other variables when you validate the current question [[Expression Manager|Expression Manager]]. Such validations also work on the current page, and properly handle array_filter and cascading relevance.</div>

This workaround is in case you need to do some validation involving more than one question, it implies a very little JavaScript programming and the use of SGQA Identifiers; this should work on almost any version of LimeSurvey.

Is easy to explain with an example, we need to do a survey of the percentage of males and females and we want to be sure that the sum is 100, to do this follow this steps (the necessary data that is not indicated in these instructions are not important i.e. question codes, etc.):
#Create a new survey of type "group by group", set the "Show |<< Prev| button" to yes and note the SID.
#Add a new group called "Group 1" and note the GID.
#Add a new question "Percent of males" of type "numeric", make it mandatory and note the QID (we will refer to this as QID1).
#Add a new question "Percent of females" of type "numeric", make it mandatory and note the QID (we will refer to this as QID2).
#Add a new group called "Group 2"
#Add a new non mandatory question, here is the trick the question text has to be (be sure to replace the SID, GID, QID1 and QID2

<syntaxhighlight lang="javascript" enclose="div">

<script>

function validation()

{

if [[{INSERTANS:SIDXGIDXQID1}+{INSERTANS:SIDXGIDXQID2}) != 100)

{

alert("Your responses don't sum 100! Check them");

document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

else

{

document.limesurvey.move.value = 'movelast';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</script>

</syntaxhighlight>

But this will show shortly the question and will jump to the end page, a little weird for the survey taker but works.

This is a proof of concept, and may have some problems, please if you notice something or improve it send me an e-mail to leochaton-limesurvey at yahoo dot com.

This will work for 2 questions that you want to be the same. Works well for email and confirm email questions

<syntaxhighlight lang="php" enclose="div">

function validation() {

if ("{INSERTANS:SIDXGIDXQID}" != "{INSERTANS:SIDXGIDXQID}") {

alert("Your responses don't match Check them"); document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</syntaxhighlight>

=Alternate exit=

''Tested with: ''

Using the same idea of the previous post, you can implement an alternate exit of your survey.

This script should be in the first question to be displayed in a next page after the question that should trigger the alternate exit. In this example the question that trigger the alternate exit is a Yes/No question, if the user chooses no, he is redirected to another page.

<syntaxhighlight lang="php" enclose="div">

<script>

if ("{INSERTANS:SIDXGIDXQID}" == "No")

{

window.location="http://www.limesurvey.org";

}

</script>

</syntaxhighlight>

=Custom onload function=

''Tested with: 'All browsers', LimeSurvey 1.70 and up

==General==

This simple workaround describes how to '''add a custom Javascript code''' that is triggered right after the page is loaded. It may have numerous applications, especially when you deal with a custom JS/HTML code. It may be used to hide form elements (<input> tags), make them read-only, display alert messages, etc.

To run any Javascript code right after page load use the Query ready() function. It will be executed when the page is being loaded. For example when you add the following code to one of your question definitions...:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(

function(){

alert('onload alert!');

}

);

</script>

</syntaxhighlight>

...it will display a pop-up message immediately after the page has been loaded.

Some of the applications of this trick I've explored are:

a) Hiding the form elements by calling in your Custom_On_Load:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").style.display='none';</syntaxhighlight>

Note: As of svn build 9755, you can now dynamically reference the questions input fields by using the {SGQ} keyword. You can rewrite the previous example like this:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer{SGQ}").style.display='none';</syntaxhighlight>

this makes it a little easier when exporting surveys, so you don't have to worry about manually entering each questions SurveyGroupQuestion ID.

b) Making the elements read only:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").readOnly=true;</syntaxhighlight> where the "answer73166X16X54" structure has been described in one of other workarounds above.

c) For Hiding by a lot of elements by calling in your Customer_On_Load

jQuery searchs in html document for input-fields with radio type, if his answer text empty then do the display css set to none.

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function() {

jQuery('input:radio').each(

function() {

var s = jQuery(this);

var c = s.parent().children('.answertext');

for(var i=0; i < c.length; i++) {

var a = jQuery(c[i]]);

if(this.id </u> a.attr('for') && a.text() == '') {

s.css({ 'display' : 'none' });

a.css({ 'display' : 'none' });

break;

}

}

}

)

}

);

</syntaxhighlight>

==Advanced usage==

If you want to place global Javascript code using the above jQuery(document).ready function then the best place to do this is the template javascript file template.js. You can edit this file using the template editor. Please be aware that placing it in the template javascript file will make the function available to all surveys using that template. If needed just create a new template copy for your survey.

Alternatively you can place the jQuery(document).ready function in the group description to make a Javascript function only available to a certain question group.

==Language-specific Javascript code==

There is an easy way to find out the current language and execute according Javascript using jQuery: The <html> tag of any survey pages contains an 'lang' attribute which holds the current language code. You can read that language code by using the followin code

<syntaxhighlight lang="javascript" enclose="div">

jQuery(document).ready(

function(){

languagecode=$('html').attr('lang');

alert('This is the current language code: '+languagecode);

}

);

</syntaxhighlight>

For an English survey the above code would show a messagebox with "This is the current language code: en"

=Custom onload function in multi-language survey=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2,''

To use custom onload functions, as above, in multi-language surveys you must define the functions in the question source for '''all''' languages.

While this initially seems to be a bit tedious, it actually can be useful - you can alter your onload functions depending on the language in use. For example, you can dynamically display alerts or element contents in the current language.

=Skipping the welcome page=

''Tested with: 1.85 (second code snippet)''

<div class="simplebox">Note: As of version 1.91, there is a survey option letting you skip the welcome page, so this workaround is not needed.</div>

'''Solution 1:''' Include this Javascript in your welcome template, in the file welcome.pstpl for all welcome page, or in the source of the welcome text for one survey:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(function($) {

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit(); });

</script>

</syntaxhighlight>

It will reproduce the onclick event of the submit button and submit the form.

Drawback of course is that users will see the page flashing up.

Therefore, you may want to announce "... loading survey ..." as a description of your welcome page (in the admin interface when creating the survey), to pretend loading something big.

'''Solution 2:'''

<syntaxhighlight lang="php" enclose="div">

<script>

function custom_on_load(){

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit();

}

window.setTimeout( 'custom_on_load()',1);

</script>

</syntaxhighlight>

=Filter answers of a question with the answer of another=

===Method 1===

''Tested with: 1.70 - 1.72''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general.</div>

If you want to filter the answer of a question with another answer, you can use this workaround.

First, use answer code like that: XX for the first question, and XXYYY for the second one.

Answer of the second question filter if the 2 first letters are the answer of the first question.

We use 1000X1X1 and 1000X1X2 for the example, question had to be on separate page (question by question for example).The second question had to be a dropdown list (we can do similar workaround, but droplis is the best). You can do this using JQuery. It leaves the answer in the select box, but disables it. You could also replace "disable" with "remove" to get rid of it altogether.

<syntaxhighlight lang="php" enclose="div">

var previousQuestionAnswer = "{INSERTANS:1000X1X1}";

var currentQuestionID = "#answer1000X1X1"

$(document).ready(function() {

// See if the answer for the previous question matches an answer in the current question

// (other than 'No Answer')

// If so, disable it.

if (previousQuestionAnswer!='No Answer') {

$(currentQuestionID).children().each(function(index, Element)

{

if ($(this).attr('text') == previousQuestionAnswer)

{ $(this).attr('disabled', true); }

}

);}

}); // End of JQuery ready function

</syntaxhighlight>

===Method 2===

''Tested with 1.92 + Firefox 9.0''

If you have a country, state, and city set of questions (or similar), you could code answer options as:

'''Q1 Country''' ''Single choice list (ratio, dropdown)''

X country#

'''Q2 State''' ''Single choice list (dropdown)''

XY state#

'''Q3 City''' ''Single choice list (dropdown)''

XYZZ city#

Now you must put the following Javascript code in the source of question 2 (State):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the countryCode (first character of the country)
var countryCode = '{INSERTANS:1000X1X1}'.substr(0, 1).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the countryCode
$('select[id^="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 1).toUpperCase() != countryCode) {
$(this).remove();
}
});
});

</script></syntaxhighlight>

And the following code in the source of question 3 (City):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the stateCode (two first characters of the state)

var stateCode = '{INSERTANS:1000X1X2}'.substr(0, 2).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the stateCode

$('select[id^="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 2).toUpperCase() != stateCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

Each question must be in different pages of survey to work, i.e. in a question by question survey, or in diferent groups in a group by group survey.

Note that if you choose a two characters answer option code in the State question, i.e. a XYY answer option code, you must change the ''substr(0, 2)'' part of code in question 3 to ''substr(0, 3)''.

=Filter answers of a multiple numeric type question=

''Tested with: 1.90+''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general. In 1.92, array_filter works with all questions that have sub-questions (e.g. also works for multiple numeric and multiple short text).</div>

If you want to filter a question of type "multiple numeric", you have to modify the workaround.

Note that this workaround assumes that the code for each of the subquestions are a numeric sequence 1,2,3...

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Match elements with labels using htmlFor and a loop

var labels = document.getElementsByTagName('LABEL');

for (var i = 0; i < labels.length; i++) {

if (labels[i].htmlFor != '') {

var elem = document.getElementById(labels[i].htmlFor);

if (elem)

elem.label = labels[i];

}

}

var answerFilter="{INSERTANS:96553X63X759}";

for (i=0; i<30; i++){

var iLabel = document.getElementById('answer96553X63X760'+(i+1]].label.innerHTML;

if (answerFilter.search(iLabel) == -1){

// Hide element

$('#question760').find('li').eq(i).hide();

// Set value of hidden elements to zero

document.getElementById('answer96553X63X760'+(i+1)).value = 0;

}

}

});</script>

</syntaxhighlight>

=Use an answer to prefill another question (default value)=

''Tested with: 1.72''

''And tested with: 1.91+''

<div class="simplebox">As of version 1.92, this is easier to do using the enhanced defaults feature, which lets you pre-fill most question types with default values. In 1.91, you could set defaults for list and multiple choice questions. In 1.92, you can set defaults for any text-entry question too. Moreover, the defaults can be [[Expression Manager|Expression Manager]] compatible equations or tailored text. Finally, with 1.92, defaults are properly managed even when set on the same page.</div>

This workaround gives you the ablility to use an answer to fill the default value for another question. It's explained for free text question type but can be adapted for another question type.

We use SGQA identifier. For example, we use SGQA 1000X10X20 and 1000X10X21 to prefill 1000X11X30 and 1000X11X31. For the script to work, the question has to be on a different page.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X11X30').val('{INSERTANS:1000X10X20}');

$('#answer1000X11X31').val('{INSERTANS:1000X10X21}');

});

</script></syntaxhighlight>

If you want use two times the value of an integer input, you can also use this to prefill a question that you hide via CSS.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X2X2').val(parseInt('{INSERTANS:1000X1X1}')*2);

$("#question2").hide();

});

</script>

</syntaxhighlight>

Now you can use {INSERTANS:1000X2X2} for giving you twice the value of the user input from question 1.

=Dynamic Sum=

<div class="simplebox">As of version 1.92, this is easier to do with [[Expression Manager|Expression Manager]] using the sum() function. Not only will sums be dynamic, but they wille exclude irrelevant values, so you can array_filter a multiple numeric question and get the sum of just the answers that are visible. This [[Expression Manager HowTos#Calculate assessment values at runtime and store the results in the survey data|HowTo example]] demonstrates the dynamic sum feature.</div>

<div class="simplebox">Also note, as of version 1.92, the following workaround will fail, since it includes a a regular expression containing curly braces.</div>

This script is used with a "Multiple Options" type question calculate a total price based on how which checkboxes are selected. The prices are listed as part of the answer. The answers are set up like this: "USB Mouse ($20)". The script uses the number between the "($" and the ")" as the price for that item. You can adapt the script to if you need to change the currency or need to sum something other than money.

This script works when used in a question-by-question format. It does not work when there are more than one question on a page. I think it can be adapted to work, but I haven't done the coding yet.

Put the following code into body of your question:

<syntaxhighlight lang="php" enclose="div">

<script language=Javascript>

// General definitions

// Define a regular expression to match the labels containing information about an answer

// In LimeSurvey, these labels start with "answer..."

var answerRegex = /^answer/;

// Find all answer checkboxes in the document and set their

// onchange events to updatePrice

function Custom_On_Load()

{

// Find all input elements

var inputList=document.getElementsByTagName("input");

// Loop through each, looking for checkboxes

var i;

for( i=0; i< inputList.length;i++ )

{

// If input item does not have an ID, skip

if (! (inputList[i].id)) { continue; }

// Skip to next if ID doesn't start with "answer"

if (!answerRegex.test(inputList[i].id)) { continue; }

// Skip to next if not a checkbox

if (inputList[i].type.toUpperCase()!='CHECKBOX') { continue; }

// This is an answer checkbox!

// Setup onchange event

inputList[i].onclick = updatePrice;

}

// Load initial sum

updatePrice();

}

function updatePrice()

{

var labels=document.getElementsByTagName("LABEL");

// Define a regular expression to match a price inside parenthesis

// For example: ($29) or ($29.54).

// Set up

priceRegex = /$\$(\d*\.{0,1}\d+)$/;

// Loop through all the labels, looking for labels corresponding to

// answers that have a price in them.

var i;

var total = 0;

for( i=0; i<labels.length;i++ )

{

var myArray; // Define array used for regex matching

var inputID; // Define field element

// Get the ID of the field corresponding to the label using the

// "htmlFor" attribute

// (FYI, there are some labels that will have to be screened out

// because they don't correspond to an answer)

// Does the label start with "answer"?

// If not: exit.

if (!answerRegex.test(labels[i].htmlFor)) { continue; }

// First make sure this element exists

// If it doesn't, go to the next element

// If it does, it will be defined in inputID

if (! (inputID = document.getElementById(labels[i].htmlFor)) ) { continue; }

// See if the corresponding answer is a checkbox that is checked.

// If not, go to next label

if (inputID.type.toUpperCase()!='CHECKBOX') { continue; }

if (!inputID.checked) { continue; }

// This is label for an answer.

// The innerHTML will give us the text of the label

// The price information will be in the form ($XX.XX)

// which in contained in the label text.

// Find a match for a decimal number inside the pattern "($" and ")"

if [[myArray = priceRegex.exec(labels[i].innerHTML]] != null)

{

// Keep a running tally

total += parseFloat(myArray[1]);

}

}

// Update total price on form

document.getElementById("totalPrice").value = "$" + formatCurrency(total);

}

function formatCurrency(num) {

num = isNaN(num) || num <u> '' || num </u> null ? 0.00 : num;

return parseFloat(num).toFixed(2);

}

</script>

</syntaxhighlight>

Put the following code in the help section (or wherever you want the sum to appear):

<syntaxhighlight lang="php" enclose="div">Total Cost for selected accessories: <input type="readonly" value="" id="totalPrice" /></syntaxhighlight>

=Focus on the first Input field=

(''Tested with: LimeSurvey 1.80 / IE6/7, Firefox 3, Safari, Opera, chrome'')

<div class="simplebox">As of version 1.91, there is a built-in JavaScript function called focusFirst() to focus on the first visible element. It uses jQuery, so is more robust than this example.</div>

Again an onload Function is needed for this tasks. I have done it the DOM way with compatibility to IE6/7.

Put the following code into the startpage.pstpl of your template, right before the </head> closing tag:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function focusFirst(Event)

{

var i=0;

while(document.forms[0].elements[i].type == "hidden")

{

i++;

}

document.forms[0].elements[i].focus();

return;

}

if(ie)

{ window.attachEvent("onload", focusFirst); }

else

{ document.addEventListener("load", focusFirst, true); }

</script>

</syntaxhighlight>

'''Note:''' I am using this with version 1.80. As changes happened to the templates in the last release, you might need to add the following before the code, if your template is older than 1.80 stable and does not include this:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var ie = false;

</script>

</syntaxhighlight>

You will need this for the var ie to be set. Without this var, the function will not work with ie.

=Answer questions by keypress=

(''Tested with: IE7, Firefox 3'')

This workaround allow to answer the question on key 0-9 (0 is for the 10 answer).

Follow issues are supported at the moment:
*Yes-No Questions
*List Questions (radio)
*other radio questions

In lists the answer limit is ten.

You supply the template "endpage" of your template with the following script.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

jQuery(document).ready(function() {

jQuery(document).bind('keypress', function(e){

if (48 <= e.which && e.which <= 57) {

jQuery('input:radio').each(function() {

var v = jQuery(this).val();

var c = (e.which <u> 48) ? 10 : e.which - 48;

if(v </u> 'Y' || v <u> 'N') {

v = (v </u> 'Y') ? 1 : 2;

}

if(v == c) {

jQuery(this).click();

jQuery('#limesurvey input:submit').click();

}

});

}

})

});

</script>

</syntaxhighlight>

=Math notation in LimeSurvey=
#download the js file from [http://mathcs.chapman.edu/~jipsen/mathml/asciimathdownload.html AsciiMath script]
#copy it in the /scripts/ folder in your installation
#modify the startpage.psptl of the template you want to use adding the reference to the script (if you use an older version make sure that you copy the template folder first!) for example:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" src="ASCIIMathML.js">

</syntaxhighlight>

Use the notation where you need it!

'''Note:''' If you use internet explorer or safari you will need to download the plugin as well, but firefox does the lot for you.

Finally, if you are confident with the limesurvey structure you could add the editor which support math notation and change the reference to the editor you want to use in the configuration file. here is the [http://www.imathas.com/editordemo/demo.html link for a TinyMCE with math support].

=Reverse array_filter (for pre-1.90)=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">Note: Version 1.91 natively supports this functionality via the array_filter_exclude advanced quation option.</div>

This can be used to filter the answers of an array question to be displayed based on the answers of a multi option question that were '''NOT''' selected. A possible application would be to have a multi-option question asking which products were purchased, followed by 2 array questions - one asking to rate the purchased products and another asking why the remaining products were not purchased. Another would be to ask about sessions attended at a conference as in [http://www.limesurvey.org/en/forum/5-can-i-do-this-with-limesurvey/27970-reverse-of-arrayfilter.html this forum thread] and pictured below. There is a live [http://www.partnersinc.biz/surveys//index.php?sid=43358&newtest=Y&lang=en demo here]

[[File:sessions_645x344.gif]]

We'll use the above example to explain the process as follows:
#In group 1 - Create a ''SessionsAttended'' multi-options question
#In group 1 - Create a ''SessionsNotAttended'' multi-options question with identical answers as ''SessionsAttended'' and hide it with styles or conditions
#In group 2 - Create a ''RateSessionsAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsAttended''
#In group 2 - Create a ''ReasonNotAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsNotAttended''
#In group 1 - Place JavaScript/jQeury listeners on each of the checkboxes in ''SessionsAttended'' that would toggle the corresponding checkbox in ''SessionsNotAttended'' to the opposite state

The JavaScript/jQuery code used would be:

<syntaxhighlight lang="php" enclose="div">

// The toggle function

function toggle(q1, q2) {

if ($(q1).attr('checked') == false ) {

$(q2).attr('checked', true);

}

else {

$(q2).attr('checked', false);

}

}

// Initialize the SessionNotAttended checkboxes to "checked"

toggle ('#answer11111X22X331', '#answer11111X22X441');

toggle ('#answer11111X22X332', '#answer11111X22X442');

toggle ('#answer11111X22X333', '#answer11111X22X443');

toggle ('#answer11111X22X334', '#answer11111X22X444');

// The jQuery listeners on the SessionAttended checkboxes

// that toggle the SessionNotAttended checkboxes

$('#answer11111X22X331').change(function() {

toggle ('#answer11111X22X331', '#answer11111X22X441');

});

$('#answer11111X22X332').change(function() {

toggle ('#answer11111X22X332', '#answer11111X22X442');

});

$('#answer11111X22X333').change(function() {

toggle ('#answer11111X22X333', '#answer11111X22X443');

});

$('#answer11111X22X334').change(function() {

toggle ('#answer11111X22X334', '#answer11111X22X444');

});

</syntaxhighlight>

Some notes about the code:
*The code is in an onload function defined in the first question of group 1 - see [[Workarounds#Custom_onload_function|here]]
*Both ''SessionsAttended'' and ''SessionsNotAttended'' must be in the same group for the toggling to work
*This case only uses 4 checkboxes but could be expanded as required
*In this case the survey ID is 11111, the group ID is 22, ''SessionsAttended'' ID is 33 and SessionsNotAttended ID is 44 - these would need to be modified for your survey
*The toggle function looks for the state of a checkbox in ''SessionsAttended'' and sets the corresponding checkbox in ''SessionsNotAttended'' to the opposite state
*The "Initialize" section sets the state of ''SessionsNotAttended'' checkboxes whenever we navigate to the group
*The "Listener" section uses jQuery listeners to detect any change in the ''SessionsAttended'' checkboxes and then toggle the corresponding ''SessionsNotAttended'' checkbox

Some general notes about the questions:
*CSS can be used to hide ''SessionsNotAttended'' (div#question44 { display: none; }) if you don't want to use conditions (because maybe you've got [[Optional settings#Survey Behavior|$deletenonvalues set to 1]])
*''RateSessionsAttended'' and ''ReasonNotAttended'' are another group to avoid things popping in and out of existence as ''SessionsAttended'' is answered
*[[Setting conditions|Conditions]] are used to ensure that ''RateSessionsAttended'' only appears if some sessions are selected and ''ReasonNotAttended'' only appears if no sessions are selected

=Filter Ranking Question With Multiple-Options (pre 1.92)=

''Tested with: 1.90, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

<div class="simplebox">As of version 1.92, most of this is easier to do using the the array_filter attribute, or relevance equations in general. They all work on the same page, and fully support cascading relevance.</div>

This workaround applies a filter to a ranking question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and ranking questions being on the same page and a slightly different one for the filter question being on a page before the ranking question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=96314&newtest=Y&lang=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
*Place the following script in your template.js file. This function will be accessed by either method.<syntaxhighlight lang="javascript" enclose="div">
// A function to filter choices in a ranking question
function rankFilter(q1ID, q2ID, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes
if(prevPage == 1) {
$('#question'+q1ID+' li[id^="javatbd"]:visible input.checkbox').attr('checked', true);
$('#question'+q1ID+'').hide();
}

handleChecked(q1ID, q2ID);
$('#question'+q1ID+' input.checkbox').click(function() {
handleChecked(q1ID, q2ID);
});

function handleChecked(q1ID, q2ID) {

// Find the survey and group IDs
if($( 'input#fieldnames' ).length != 0) {
var fieldNames = $( 'input#fieldnames' ).attr('value');
var tmp = fieldNames.split('X');
var sID = tmp[0];
var gID = tmp[1];
}

// Loop through all Q1 options
$('#question'+q1ID+' input.checkbox').each(function(i) {

// Find the answer code and value
var tmp2 = $(this).attr('id').split('X'+gID+'X'+q1ID+'');
var ansCode = tmp2[1];
var ansTxt = $(this).next('label').text();

// If option is checked and not in rank choices or output, add it to the rank choices
if($(this).attr('checked') == true
&& $('#question'+q2ID+' select.select option[value="'+ansCode+'"]').length == 0
&& $('#question'+q2ID+' .output input[id^="fvalue_"][value="'+ansCode+'"]').length == 0) {
$('<option value="'+ansCode+'">'+ansTxt+'</option>').appendTo('#question'+q2ID+' select.select');
}

// If option is unchecked...
else if($(this).attr('checked') == false) {
// Remove it from the rank choices
$('#question'+q2ID+' select.select option[value="'+ansCode+'"]').remove();
// Remove it from the rank output and reset hidden values
$('#question'+q2ID+' .output input[id^="fvalue_"][value="'+ansCode+'"]').attr('value', '').siblings('input.text').val('').siblings('img').hide();
}
});

// Clean up empty inputs in the rank output table
$('#question'+q2ID+' .output table tr').each(function(i) {
var nextRow = $(this).next('tr');
if($('input.text', this).val() == '' && $('input.text', nextRow).val() != '') {
$('input.text', this).val($('input.text', nextRow).val());
$('input.text', nextRow).val('');
$('input[id^="fvalue_"]', this).attr('value', $('input[id^="fvalue_"]', nextRow).attr('value'));
$('input[id^="fvalue_"]', nextRow).attr('value', '');
}
});

// Show the scissors for the last populated rank output row
$('#question'+q2ID+' .output table img[id^="cut_"]').hide();
$('#question'+q2ID+' .output table input.text[value!=""]:last').siblings('img[id^="cut_"]').show();

// Hide extra rank output rows
var optNum = $('#question'+q1ID+' input.checkbox:checked').length;
$('#question'+q2ID+' .output table tr').hide();
$('#question'+q2ID+' .output table tr:lt('+(optNum+1)+')').show();

// Hide and clear the ranking question if there are less than 2 checked options in Q1
if(optNum < 2) {
$('#question'+q2ID+'').hide();
$('#question'+q2ID+' input.text').val('');
$('#question'+q2ID+' input[id^="fvalue_"]').attr('value', '');
}
else {
$('#question'+q2ID+'').show();
}

// A workaround for the built in max-answers function
$('#question'+q2ID+' select.select').attr('disabled', true);
$('#question'+q2ID+' td.output tr:visible').each(function(i) {
if($('input.text', this).val() == '') {
$('#question'+q2ID+' select.select').attr('disabled', false);
}
});
}

// A listener to work around the built in max-answers function
$('#question'+q2ID+' td.rank').click(function (event) {
$('#question'+q2ID+' select.select').attr('disabled', true);
$('#question'+q2ID+' td.item input.text').each(function(i) {
if ($(this).val() == '') {
$('#question'+q2ID+' select.select').attr('disabled', false);
}
});
});
}</syntaxhighlight>

'''FOR BOTH FILTER AND RANKING QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and a ranking question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question.
*The function will hide the ranking question unless at least two options are selected in the multiple options question, in which case, it will only show the options selected.<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {
rankFilter(MM, RR);
});
</script></syntaxhighlight>

'''FOR FILTER AND RANKING QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and a ranking question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question. Do not modify the "1".
*The function will hide the multiple options question. If at least 2 options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the ranking question.<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
rankFilter(MM, RR, 1);
});
</script></syntaxhighlight>

=Filter "Array by Column" Question With "Multiple-Options"=

''Tested with: 2.05''

This workaround applies a filter to an "Array by Column" question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and array questions being on the same page and a slightly different one for the filter question being on a page before the array question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=74213&newtest=Y&lang=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
*If using LimeSurvey version 2.05 or newer, place the following functions in your template.js file. These will be accessed by either method.<syntaxhighlight lang="javascript" enclose="div">function filterArrByCol(qMultiOpt, qArray, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes
if(prevPage == 1) {
$('#question'+qMultiOpt+' li[id^="javatbd"]:visible input.checkbox').attr('checked', true);
$('#question'+qMultiOpt+'').hide();
}

// Assign classes to the answer cells
$('#question'+qArray+' td.answer-item').each(function(i){
var classArr = $(this).attr('class').split('answer_cell_00');
classArr = classArr[1].split(' ');
var ansCode = classArr[0];
$(this).addClass('ans-'+ansCode+' filtered');
});

// Assign classes to the answer label cells
$('#question'+qArray+' table.subquestions-list tbody tr:eq(0) td.answer-item').each(function(i){
var classArr2 = $(this).attr('class').split(' ans-');
var ansCode2 = classArr2[1];
$('#question'+qArray+' table.subquestions-list thead tr:eq(0) th:eq('+i+')').addClass('ans-'+ansCode2+'');
});

// Fire the filter function on page load
filterArr(qMultiOpt, qArray);

// Listener on multi-opt checkboxes to fire the filter function
$('#question'+qMultiOpt+' input.checkbox').click(function(){
filterArr(qMultiOpt, qArray);
});

// On submit, clear all hidden radios of array
$('#movenextbtn, #movesubmitbtn').click(function(){
$('#question'+qArray+' td.filtered:hidden').each(function(i){
$('input.radio', this).prop('checked', false);
});
return true;
});
}

function filterArr(qMultiOpt, qArray) {

if($('#question'+qMultiOpt+' input.checkbox:checked').length < 1) {
// Hide the array if no multi-opt options are checked
$('#question'+qArray+'').hide();
}
else {
$('#question'+qArray+'').show();

// Hide all columns of array
$('#question'+qArray+' table.subquestions-list tbody td.answer-item, #question'+qArray+' table.question thead th').hide();

// Loop through multi-opt checkboxes and, if checked, show corresponding column of array
$('#question'+qMultiOpt+' input.checkbox').each(function(i){
if($(this).prop('checked') == true) {
var classArr3 = $(this).attr('id').split('X'+qMultiOpt);
var ansCode3 = classArr3[1];
$('#question'+qArray+' .ans-'+ansCode3+'').show();
}
});
}
}</syntaxhighlight>

*If using LimeSurvey version 2.0 or older, place the following functions in your template.js file. These will be accessed by either method.<syntaxhighlight lang="javascript" enclose="div">
$(document).ready(function() {

function filterArrByCol(qMultiOpt, qArray, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes
if(prevPage == 1) {
$('#question'+qMultiOpt+' li[id^="javatbd"]:visible input.checkbox').attr('checked', true);
$('#question'+qMultiOpt+'').hide();
}

// Assign classes to the answer cells
$('#question'+qArray+' table.question tbody td').each(function(i){
var classArr = $(this).attr('class').split('answer_cell_00');
var ansCode = classArr[1];
$(this).addClass('ans-'+ansCode+' filtered');
});

// Assign classes to the answer label cells
$('#question'+qArray+' table.question tbody tr:eq(0) td').each(function(i){
var classArr2 = $(this).attr('class').split(' ans-');
var ansCode2 = classArr2[1];
$('#question'+qArray+' table.question thead tr:eq(0) th:eq('+i+')').addClass('ans-'+ansCode2+'');
});

// Fire the filter function on page load
filterArr(qMultiOpt, qArray);

// Listener on multi-opt checkboxes to fire the filter function
$('#question'+qMultiOpt+' input.checkbox').click(function(){
filterArr(qMultiOpt, qArray);
});

// On submit, clear all hidden radios of array
$('#movenextbtn, #movesubmitbtn').click(function(){
$('#question'+qArray+' td.filtered:hidden').each(function(i){
$('input.radio', this).attr('checked', false);
});
return true;
});
}

function filterArr(qMultiOpt, qArray) {

if($('#question'+qMultiOpt+' input.checkbox:checked').length < 1) {
// Hide the array if no multi-opt options are checked
$('#question'+qArray+'').hide();
}
else {
$('#question'+qArray+'').show();

// Hide all columns of array
$('#question'+qArray+' table.question tbody td, #question'+qArray+' table.question thead th').hide();

// Loop through multi-opt checkboxes and, if checked, show corresponding column of array
$('#question'+qMultiOpt+' input.checkbox').each(function(i){
if($(this).attr('checked') == true) {
var classArr3 = $(this).attr('id').split('X'+qMultiOpt);
var ansCode3 = classArr3[1];
$('#question'+qArray+' .ans-'+ansCode3+'').show();
}
});
}
}
});</syntaxhighlight>

'''FOR BOTH FILTER AND ARRAY QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and an array-by-column question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the ranking question.
*The function will hide the array question unless at least one option is selected in the multiple-options question, in which case, it will only show the corresponding array column(s).<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
filterArrByCol(MM, AA);
});
</script></syntaxhighlight>

'''FOR FILTER AND ARRAY QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and an array-by-column question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the array question. Do not modify the "1".
*The function will hide the multiple options question. If options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the array columns.<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
filterArrByCol(MM, AA, 1);
});
</script></syntaxhighlight>

=Auto-tabbing between text input fields=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

This is a workaround to facilitate auto-tabbing between text input questions in a single group using a [http://plugins.jquery.com/project/autotab jQuery plugin by Mathachew] and the Maximum characters attribute of questions.

The behaviour will be: When the maximum number of characters has been entered into an input field, the focus (cursor) will be automatically moved to the next input field. When the backspace key is used to remove all characters from a field, the focus will be moved to the previous field. It's very useful in surveys having many text input questions to avoid having to manually tab or click between fields.

You can view a small demo survey [http://www.partnersinc.biz/surveys//index.php?sid=11327&newtest=Y&lang=en here].

Implementation is as follows:
#Visit [http://plugins.jquery.com/autotabs http://plugins.jquery.com/autotabs], download the plugin script and save it as ''jquery.autotab-1.1b.js'' in the template folder.
#Link to the script by placing ''<script type="text/javascript" src="{TEMPLATEURL}jquery.autotab-1.1b.js"></script>'' within the ''<head>'' tag of startpage.pstpl.
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Create the text based questions that auto-tabbing is to be applied to. (All must be in the same group if you're using group by group presentation)
#Define a Maximum characters attribute for all questions that the autotab is applied to.
{{QS:maximum_chars}}
#In the source of the first question of the group that contains the auto-tabbed questions, add the following code.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answerSSSSSXGGXAA').focus(); //initially focus on the first input

$('#answerSSSSSXGGXAA').autotab({ target: 'answerSSSSSXGGXBB' });

$('#answerSSSSSXGGXBB').autotab({ previous: 'answerSSSSSXGGXAA', target: 'answerSSSSSXGGXCC' });

$('#answerSSSSSXGGXCC').autotab({ previous: 'answerSSSSSXGGXBB', target: 'answerSSSSSXGGXDD' });

$('#answerSSSSSXGGXDD').autotab({ previous: 'answerSSSSSXGGXCC' });

});

</script></syntaxhighlight>

This example has 4 fields to be auto-tabbed between - all instances of the following must be replaced to be compatible with your survey (See image below):
*SSSSS -> Survey ID
*GG -> Group ID
*AA -> First question
*BB -> Second question
*CC -> Third question
*DD -> Last question

[[File:ids_343x252.gif]]

The ''target'' parameter defines where the next input is and the ''previous'' parameter defines (you guessed it) the previous input.

This plugin also has limited capability of formatting the input text - see comments in the plugin script.

=Custom response listeners=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

Listeners can be used to perform functions when a change in an input is detected. There are many uses such as the [[Workarounds#Reverse_array_filter|Reverse array_filter]] but a simple one would be to warn a respondent if they enter a value that may be too high.

We can use the [http://docs.jquery.com/Events/change jQuery change( ) event] to fire a function whenever there is a change to the input. The function will look for an input value higher than 10 and, if found, will warn the respondent.
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the script below in the source of one of the questions on the page where:
**11111 is the survey ID
**22 is the group ID
**33 is the question ID

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer11111X22X33').change(function() {

if ( $('#answer11111X22X33').val() > 10 ) {
alert ("That's an awful lot. Are you sure?");
}
});
});
</script></syntaxhighlight>

=Text input masks=

''Tested with: 1.90+, IE 7, FireFox 3.0, Safari 3.2, Chrome 2.0''

There may be instances where you would like to place a mask on a text input - for example only allowing respondents to enter the correct characters for a North American phone number ((###) ###-####) or a Canadian postal code (A1A 1A1) The [http://plugins.jquery.com/project/meioMask jQuery meioMask plugin by fabiomcosta] can be used to do this.

The plugin has several pre-defined masks and supports custom masks. It also allows for pasting of input, allows default values and can auto-focus the next form element when the current input is completely filled. See [http://www.meiocodigo.com/projects/meiomask/ http://www.meiocodigo.com/projects/meiomask/] for more details on features and options.

There is a small demo [http://www.partnersinc.biz/surveys//index.php?sid=36146&newtest=Y&lang=en here].

Implementation for this demo was as follows:
#Visit [http://www.meiocodigo.com/projects/meiomask/ http://www.meiocodigo.com/projects/meiomask/], download the latest plugin script and save it as jquery.meiomask.js in the template folder.
#Link to the script by placing <script type="text/javascript" src="{TEMPLATEURL}jquery.meiomask.js" charset="utf-8"></script> within the <head> tag of startpage.pstpl.
#Turn off $filterxsshtml to allow insertion of JavaScript in the questions. ([http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects See documentation here])
#Create the text input questions that the masks are to be applied to
#In the source of the help section of the first question of the group that contains the masked inputs, add the following code. ([http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ See How to use script here])

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Define custom masks
$.mask.masks = $.extend($.mask.masks,{
customMask1:{ mask: 'a9a 9a9' }, // Canadian postal code
// Maximum input of 9,999.99, reverse input, default value of 0.00
customMask2:{ mask: '99.999,9', type : 'reverse', defaultValue : '000' }
});

// Set the 'alt' attributes of the inputs
$('#answer111111X22XAA').attr('alt', 'phone-us'); // a pre-defined mask
$('#answer111111X22XBB').attr('alt', 'customMask1'); // a custom mask
$('#answer111111X22XCC').attr('alt', 'customMask2'); // a custom mask
$('#answer111111X22XDD').attr('alt', 'cc'); // a pre-defined mask for credit card

// Tell the plugin to apply masks to these inputs
$('input:#answer111111X22XAA').setMask();
$('input:#answer111111X22XBB').setMask();
$('input:#answer111111X22XCC').setMask();
$('input:#answer111111X22XDD').setMask();
});
</script>
</syntaxhighlight>

The first section defines two custom masks to be used - one for Canadian postal code with a format of A#A #A# and a second for a maximum amount of 9999.99 with reverse input (useful for cost inputs) and a default value of 0.00.

The next section sets the "alt" attributes for the text inputs. This will tell meioMask which mask we will be applying to each input. By default meioMask looks at the alt attribute to find which mask to apply however this can be changed using the [http://www.meiocodigo.com/projects/meiomask/#mm_options mask options].

In the final section we apply the masks to the inputs.

This example has 4 inputs with masks on them - all instances of the following must be replaced to be compatible with your survey (See image below):

*11111 -> Survey ID
*22 -> Group ID
*AA -> First question
*BB -> Second question
*CC -> Third question
*DD -> Fourth question

[[File:Ids 343x252.gif]]

=Text input masks - second method=

''Tested with: 1.91RC6+, FireFox 4.0''
''Tested with: 2.05, Chrome 40.0.2214.115 m (64-bit)

There may be instances where you would like to place a mask on a text input - for example only allowing respondents to enter the correct characters for a North American phone number ((###) ###-####) or a US social security number (###-##-####). The jQuery meioMask plugin by fabiomcosta is no longer supported but an alternative exists. The DigitalBush Masked Input Plugin is updated and simple to implement in LimeSurvey. See [http://digitalbush.com/projects/masked-input-plugin/ http://digitalbush.com/projects/masked-input-plugin/] for more details on features and options.

Implementation as follows:

#Visit [http://digitalbush.com/projects/masked-input-plugin/ http://digitalbush.com/projects/masked-input-plugin/], download the latest plugin script and save it as jquery.maskedinput.js in the template folder.
#Link to the script by placing <script type="text/javascript" src="{TEMPLATEURL}jquery.maskedinput.js" charset="utf-8"></script> within the <head> tag of startpage.pstpl.
#Turn off $filterxsshtml to allow insertion of JavaScript in the questions. ([http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects See documentation here])
#Create the text input questions that the masks are to be applied to
#In the source of the help section of the first question of the group that contains the masked inputs, add the following code. ([http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ See How to use script here])

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function($) {
$("#answer55431X1X5").mask("999-99-9999",{ placeholder:"#" });
});
</script>
</syntaxhighlight>

Replace the "#answer55431X1X5" with your survey ID, group ID, and question ID. You can change the mask format and change or eliminate the placeholder if you wish. If you have multiple questions in the same group, simply copy and paste the line that begins with "$" and change the code to what is needed for your application.

=Select a random response to a "Multiple options" question for later use=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

This workaround allows you to randomly select one of the checked boxes in a "Multiple options" question and store it's label for later use in the survey. A possible use would be to have a question asking what products were purchased and then randomly selecting one of the products to ask further questions about.

There is a small demo of the above example [http://www.partnersinc.biz/surveys//index.php?sid=81252&newtest=Y&lang=en here].

Basically what we've done here is to put listeners on all of the checkboxes. If a change of state is detected in any of them the "randomResponse" function is called which loops through all of the checkboxes and if it finds a checked state, that box's label is added to an array. Then a random item is pulled from the array and used to populate the hidden question. This hidden question can then be drawn upon later in the survey using [http://docs.limesurvey.org/tiki-index.php?page=Adding+a+Question#Information_from_previous_answers INSERTANS] or [http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure=English+Instructions+for+LimeSurvey Conditions].

Implementation for this demo is as follows:

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Create a "Multiple options" question that we're going to randomly pick a checked box from
#Create a text input question to store the label of the checked box in (we're going to hide this with JavaScript)
#Place the script below in the source of one of the questions on the page.

The following edits are required to implement this in your survey:

*EDIT HERE (1) - 11111 -> Survey ID, 22 -> Group ID, 44 -> hidden question ID.
*EDIT HERE (2) - 44 -> hidden question ID.
*EDIT HERE (3) - 11111 -> Survey ID, 22 -> Group ID, 33 -> multiple option question ID, A/B/C/D/E/F -> multiple option answer codes. Also add or remove CBs for more or less checkboxes.
*EDIT HERE (4) - add or remove CBs for more or less checkboxes.
*EDIT HERE (5) - add or remove CBs for more or less checkboxes.

For more info on these IDs see [http://docs.limesurvey.org/tiki-index.php?page=SGQA+identifier&structure=English+Instructions+for+LimeSurvey SGQA identifier].

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

//// Identify the hidden question input
//// EDIT HERE (1) - replace with your hidden question input ID
var hiddenInput = '#answer11111X22X44';

//// Make the "hidden" question disappear
//// EDIT HERE (2) - replace with your hidden question ID
$('#question44').hide();

//// Identify the checkboxes to be randomized
//// EDIT HERE (3) - add or remove as required,
//// replace with your checkbox IDs
var CB1 = '#answer11111X22X33A';
var CB2 = '#answer11111X22X33B';
var CB3 = '#answer11111X22X33C';
var CB4 = '#answer11111X22X33D';
var CB5 = '#answer11111X22X33E';
var CB6 = '#answer11111X22X33F';

//// Create an array of all checkboxes to be randomized
//// EDIT HERE (4) - add or remove CBs as required
checkBoxes = new Array( CB1, CB2, CB3, CB4, CB5, CB6 );
var checkBoxesLength = checkBoxes.length;

//// The randomizing function - no editing required
function randomResponse () {
var boxLabels = new Array();

// loop through all of the checkboxes and if they are checked,
// add their label to the boxLabels array
for( var i=0; i<checkBoxesLength; i++ ) {
if ( $(checkBoxes[i]).attr('checked') == true ) {
var cbid = checkBoxes[i].replace('#','');
boxLabels.push( $( 'label[for=' + cbid + ']' ).html() );
}
}

// find a random index of the responses array
var randomNum = Math.floor(Math.random() * boxLabels.length);

// populate the hidden question input with the
// random input value
$(hiddenInput).val( boxLabels[randomNum] );
}

//// The listeners that will fire the randomize function if a
//// change occurs in the checkboxes
//// EDIT HERE (5) - add or remove CBs as required
$(CB1).change(function() {
randomResponse ();
});
$(CB2).change(function() {
randomResponse ();
});
$(CB3).change(function() {
randomResponse ();
});
$(CB4).change(function() {
randomResponse ();
});
$(CB5).change(function() {
randomResponse ();
});
$(CB6).change(function() {
randomResponse ();
});
});
</script>
</syntaxhighlight>

=Display secondary options in a "Multiple options" question=

''Tested with: 2.05''

This workaround allows you to display secondary options in a "Multiple options" question if a primary option is checked as in the images below.

Primary option not selected:<br />
[[File:Secondary_options_1.jpg]]

Primary option selected:<br />
[[File:Secondary_options_2.jpg]]<br /><br />

'''DOWNLOADS:'''<br />
- [[Media:Demo_Secondary_Checkboxes.zip|Demo template]]<br />
- [[Media:Demo_Secondary_Checkboxes.lss|Demo survey]].<br /><br />

'''IMPLEMENTATION:'''

1) [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].

2) Create a "Multiple options" question including both the primary and secondary sub-questions (in the order that you would like them displayed if all shown).

3) Add the following function to the end of template.js:<syntaxhighlight lang="javascript" enclose="div">
// A function to handle "secondary" checkboxes
function secondaryCheckboxes(qID, primaryPosition, secondaryCount) {
// Identify the elements
var thisQuestion = $('#question'+qID);
var primaryRow = $('li.question-item:eq('+(primaryPosition-1)+')', thisQuestion);
var primaryInput = $('input.checkbox', primaryRow);
var secondaryRows = primaryRow.nextAll('li.question-item:lt('+(secondaryCount)+')');
var secondaryInputs = $('input.checkbox', secondaryRows);

// Indent the secondaries
secondaryRows.css({ 'margin-left':'2.5em' });

// Initial states of the secondary answers
if (primaryInput.prop('checked') == false ) {
secondaryRows.hide();
}

// A listener on the primary answer to show or hide secondary answers
primaryInput.click(function (event) {

// Hide/show the secondary answers accordingly
if (!$(this).is(':checked')) {
secondaryRows.hide();
secondaryInputs.prop('checked', false);
secondaryInputs.each(function(i) {
checkconditions(this.value, this.name, this.type);
});
}
else {
secondaryRows.show();
}
});
}</syntaxhighlight>

<br />4) Call the function in the source of the question with the question ID (no editing necessary), the start position of the primary sub-question and the number of secondaries to follow.
So, in this example, sub-question 1 is a primary followed by 2 secondaries and subquestion 6 is a primary followed by 3 secondaries.<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
// Sub-question 1 is primary followed by 2 secondaries
secondaryCheckboxes({QID}, 1, 2);
// Sub-question 6 is primary followed by 3 secondaries
secondaryCheckboxes({QID}, 6, 3);
});
</script></syntaxhighlight>

=Minimum number of required answers in an array (pre 1.92)=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2,''

<div class="simplebox">As of version 1.92 all array style questions have the min_answers and max_answers options, so this script is obsolete.</div>

This workaround allows you to specify a '''minimum number''' of answers required in an array question. It is an alternative to the "Mandatory" parameter which specifies that '''all''' answers are required. It could also be easily modified to specify a maximum number of answers.

We accomplish this by placing an onload function in the source of the array question. This function hides the Next/Submit button and displays a warning element until it detects a minimum number of responses. It then hides the warning and shows the Next/Submit button.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=97166&newtest=Y&lang=en here].

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [[Optional settings#Security|documentation here]])
#Set up the template to use custom onload functions. (See the [[Workarounds#Custom onload function|workaround here]])
#In the source of the array question add the following onload function. (See [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|How to use script here]])
#Modify the ''SETTINGS'' section of the code as required.

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

// Wait until the document is fully loaded
$(document).ready(function() {

/********************** SETTINGS **********************/
// The text to appear in the warning element
var warningText = 'Please answer at least 4 to continue';
// The question ID
var questionId = 137;
// The minimum number of answers required
var minNumber = 4;
/******************************************************/

// Create the warning element and place it after the submit button
var el = document.createElement('div');
el.setAttribute('id','warning');
document.body.appendChild(el);
$( '#warning' ).css({
'border':'1px solid #333333',
'width':'200px',
'padding':'3px',
'color':'red'
});
$('#warning').html(warningText);
$('input[type="submit"]').after($('#warning'));

// Detect the initial number of checked answers & display Next/Submit button accordingly
var inputInitCount = 0;
$('#question' + questionId + ' input').each(function(i) {
if ($( this ).attr('checked') == true ) {
inputInitCount++;
}
});
if (inputInitCount > (minNumber - 1)) {
$('input[type="submit"]').show();
$('#warning').hide();
}
else {
$('#warning').show();
$('input[type="submit"]').hide();
}

// Listener to detect number of checked answers & display Next/Submit button accordingly
$('#question' + questionId + ' input.radio, #question'+questionId+' tbody[id^="javatbd"] td').click(function() {
var inputCount = 0;
$('#question' + questionId + ' input.radio').each(function(i) {
if ($( this ).attr('checked') == true ) {
inputCount++;
}
});
if (inputCount > (minNumber - 1)) {
$('input[type="submit"]').show();
$('#warning').hide();
}
else {
$('#warning').show();
$('input[type="submit"]').hide();
}

// The original functions of the click event
checkconditions(this.value, this.name, this.type);
});
});
</script></syntaxhighlight>

=Minimum elapsed time before moving forward in survey=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

This workaround interrupts the Next/Submit function and checks the amount of time elapsed since the page loaded. If the time is less than the minimum dictated, the respondent is alerted and not allowed to proceed. It is useful if you want to enforce a minimum amount of time spent viewing a page.
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the script below in the source of one of the questions on the page, replacing "TT" with the minimum number of seconds required before advancing is allowed.

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minTime(TT);

function minTime(minTime) {

var startTime = new Date();

$('#movenextbtn, #movesubmitbtn').click(function(){

var endTime = new Date();

if((endTime - startTime)/1000 <= minTime) {
alert ('You must spend at least '+minTime+' seconds on the question.');
return false;
}
else {
return true;
}
});
}
});
</script>
</syntaxhighlight>

=Minimum number of characters in Long free text or Huge free text questions=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

<div class="simplebox">As of version 1.91, you can use regular expression masks (validation) to specify the minimum number of required characters. However, even if the question is mandatory, it can still be blank.</div>

<div class="simplebox">As of version 1.92, if you make the question mandatory and use a validation mask to specify the minimum number of characters, then the user will be forced to answer the question. Note that unlike 1.91, they can submit their current answers, even if partially invalid (so they are stored in the database), but they will not ber able to proceed to the next page until they have passed all mandatory and validity checks.</div>

This workaround interrupts the Next/Submit function and checks the number of characters entered in a Long free text or Huge free text question. If the number is less than the minimum dictated, the respondent is alerted and not allowed to proceed.

#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].

#Place the script below in the source of one of the questions on the page, replace "QQ" with the question ID and "CC" with the minimum number of characters required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minChar(QQ, CC);

function minChar(qID, minChars) {

$('#movenextbtn, #movesubmitbtn').click(function(){

if($('#question'+qID+' textarea').val().replace(/ /g,'').length < minChars) {

alert ('You must enter at least '+minChars+' characters.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Variable Length Array (Multi Flexible Text) question=

''Tested with: 1.90+, IE 6/7/8, FireFox 3.0, Safari 3.2''

This workaround allows a respondent to add or remove rows of an Array (Multi Flexible Text) question. It's useful to avoid the page being cluttered with unnecessary array rows.

A function is placed in the template.js file of your template (use template editor). This function hides all of the array rows except the first and inserts two elements that when clicked show or hide rows accordingly.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=53132&newtest=Y&lang=en here].

It must be noted that you can not make this question Mandatory as the respondent will have no way to complete hidden fields. If you want the displayed fields to be mandatory you will need to validate them in another function or modify this function to only allow the addition of rows if all fields in the last row are completed and then disable those fields - that, however, is a little over the top for this example.

Implementation is as follows:

#Set up your survey to use JavaScript (See instructions [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|here]])

#Add the following script to your ''template.js'' file.

#Replace "QQ" in the function call at the end with the question ID.

#Create one or more Array (Multi Flexible Text) questions

#If you want to apply it to more arrays on the same page simply add more calls with the appropriate question IDs. (eg. varLengthArray(1); varLengthArray(2);...)

<syntaxhighlight lang="javascript" enclose="div">$(document).ready(function() {

// A function to add or remove rows of an Array (Multi Flexible)(Text) question
function varLengthArray(qID) {

if ($('#question'+qID+'').length > 0) {

// The HTML content of the Add/Remove elements - modify as you wish
var addContent = '[+]';
var removeContent = '[-]';

// Create the Add and Remove elements & insert them
var el1 = document.createElement('div');
el1.setAttribute('id','addButton'+qID);
document.body.appendChild(el1);
var el2 = document.createElement('div');
el2.setAttribute('id','removeButton'+qID);
document.body.appendChild(el2);

// Move them to after the array
$( 'div#addButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent());
$( 'div#removeButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent());

// Insert their HTML
$( 'div#addButton'+qID ).html( addContent );
$( 'div#removeButton'+qID ).html( removeContent );

// Style the elements - you can modify here if you wish
$( 'div#addButton'+qID ).css({
'margin':'10px 0 0 10px',
'padding':'1px',
'text-align':'center',
'font-weight':'bold',
'width':'auto',
'cursor':'pointer',
'float':'left'
});

$( 'div#removeButton'+qID ).css({
'margin':'10px 0 0 10px',
'padding':'1px',
'text-align':'center',
'font-weight':'bold',
'width':'auto',
'cursor':'pointer',
'float':'left'
});

// Initially hide the Remove element
$( 'div#removeButton'+qID ).hide();

// Call the functions below when clicked
$( 'div#addButton'+qID ).click(function (event) {
addRow(qID);
});
$( 'div#removeButton'+qID ).click(function (event) {
removeRow(qID);
});

// Function to add a row, also shows the Remove element and hides the
//Add element if all rows are shown
function addRow(qID) {
var arrayRow = '#question' + qID + ' table.question tbody';
var rowCount = $( arrayRow ).size() - 1;
$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();
$( 'div#removeButton'+qID ).show();
if ( $( arrayRow + ':eq(' + rowCount + ')' ).attr('name') == 'visible' ) {
$( 'div#addButton'+qID ).hide();
}
}

// Function to remove a row, also clears the contents of the removed row,
// shows the Add element if the last row is hidden and hides the Remove
// element if only the first row is shown
function removeRow(qID) {
var arrayRow = '#question' + qID + ' table.question tbody';
var rowCount = $( arrayRow ).size() - 1;
$( arrayRow + '[name="visible"]:last input[type="text"]' ).val('');
$( arrayRow + '[name="visible"]:last' ).attr('name', 'hidden').hide();
$( 'div#addButton'+qID ).show();
if ( $( arrayRow + ':eq(1)' ).attr('name') == 'hidden' ) {
$( 'div#removeButton'+qID ).hide();
}
}

// Just some initialization stuff
var arrayRow = '#question' + qID + ' table.question tbody';
var rowCount = '';

// Initially hide all except first row or any rows with populated inputs
$( arrayRow ).each(function(i) {
if ( i > 0 ) {
// We also need to give the hidden rows a name cause IE doesn't
// recognize jQuery :visible selector consistently
$( this ).attr('name', 'hidden').hide();

$('input[type=text]', this).each(function(i) {
if ($(this).attr('value') != '') {
$(this).parents('tbody:eq(0)').attr('name', 'visible').show();
$( 'div#removeButton'+qID ).show();
}
});
rowCount = i;
}
});
}
}

// Call the function with a question ID
varLengthArray(QQ);

});</syntaxhighlight>

=Expandable Array=

''Tested with: 1.90+, IE 6/7, FireFox 3.5, Safari 3.2''

This workaround allows you to present an array question incrementally. That is to say that initially only the first option (row) in the array is shown. When that option is answered the next is shown and so-on.

A JavaScript function is placed in the source of the array question. This function hides all of the array rows except the first and then displays them as options are answered.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=94958&newtest=Y&lang=en here].

The workaround supports following question types:
*Array (flexible labels)
*Array (flexible labels) by column
*Array (Yes/No/Uncertain)
*Array (Increase, Same, Decrease)
*Array (Flexible Labels) dual scale
*Array (10 point choice)

Implementation is as follows:
#Set up your survey to use JavaScript. (See [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|documentation here]])
#Create one or more Array questions
#In the source of the first array question add the following script.
#Replace "QQ" in the function call at the end of the script with the question ID of the array you would like to manipulate.
#If you want to apply it to more arrays on the same page, simply add more calls with the appropriate question IDs. (eg. expandingArray(1); expandingArray(2);...)

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript">

$(document).ready(function() {

// A function to show subsequent rows of an array as options are checked
function expandingArray(qID) {

// Build an array of the question rows
var arrayRow = '#question' + qID + ' table.question tbody tr';

// Initially hide all rows unless an input was previously checked
$( arrayRow ).each(function(i) {

if ( $( arrayRow + ':eq(' + i + ') input.radio:checked' ).length != 0 ) {
$(this).attr('name', 'clickedRow');
}
else {
$(this).attr('name', 'hidden').hide();
}
});

// Now show the first hidden row
addRow();

// Add another row when an option is checked for the first time
$( '#question' + qID + ' td.answer input.radio' ).click(function (event) {

if ($(this).parents('tr:eq(0)').attr('name') != 'clickedRow') {
addRow();
$(this).parents('tr:eq(0)').attr('name', 'clickedRow');
}

// The original function of the click event
checkconditions(this.value, this.name, this.type);
});

// Add another row when an table cell is clicked for the first time
$( '#question' + qID + ' table.question tbody td' ).click(function (event) {

if ($(this).parents('tr:eq(0)').attr('name') != 'clickedRow') {
addRow();
$(this).parents('tr:eq(0)').attr('name', 'clickedRow');
}
});

// Function to add a row
function addRow() {
$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();
}
}

// Call the function with a question ID
expandingArray(QQ);

});
</script></syntaxhighlight>

=Partially Randomized Answers - Array questions=

''Tested with: 2.05''

This workaround allows the answers of Array questions to be randomized while always keeping one sub-question at the end of the list.

After the LimeSurvey randomizing has occurred a function in the source of a question moves the sub-question with a defined code to the bottom of the array.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]]
#Create an Array type question.
#Set the "Random order" question setting to "Randomize on each page load".
#Place the following script in the source of the question.
#Modify the "fixedCode" value as required.
<br />
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(document).ready(function() {

// The sub-question code to place in the last position
var fixedCode = 'A1';

// Identify this question
var q1ID = {QID};
var thisQuestion = $('#question'+q1ID);

// Move the "fixed" row to the end
$('table.subquestions-list tbody', thisQuestion).append($('tr[id$="X'+q1ID+fixedCode+'"]'));

// Fix up the array row background colours
$('tr.answers-list', thisQuestion).each(function(i){
$(this).removeClass('array1 array2').addClass('array'+(2-(i%2)));
});

});
</script></syntaxhighlight>

'''Download sample survey:'''<br />
[[Media:Partially_randomized_array.lss|Partially_randomized_array.lss]]

=Partially Randomized Answers - Multiple Options & List (radio) questions=

''Tested with: 2.05''

This workaround allows the answers of Multiple Options & List (radio) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last as in the image below:

[[File:random_336x179gif.gif]]

After the LimeSurvey randomizing has occurred a function in the source of a question moves the answer with the highest answer code to the end of the list.

Some conditions on the use of this are:
*The "Show No answer" survey setting must be set to "No"
*You must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:Partially_Randomized_Answers_1.png]]

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]]
#Create a Multiple Options or List (radio) question with sequential response codes.
#Set the "Random order" question setting to "Randomize on each page load".
#Place the following script in the source of the question
<br />
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Identify this question
var qID = {QID};

// Find the number of answers
var ansCount = $('#question'+qID+' li.answer-item').length;

// Place the last answer created at the end of the list
var answer = $( 'input[id$="X'+qID+ansCount+'"]');
var answerItem = $(answer).closest('li');
var answersList = $(answer).closest('ul');
$(answersList).append(answerItem);

});
</script></syntaxhighlight>

'''Download sample survey:'''<br />
[[Media:Partially_Ranomized_Answers.lss|Partially_Ranomized_Answers.lss]]

=Partially Randomized Answers - Multiple Options & List (radio) questions (Enhanced)=

''Tested with: 2.05''

This workaround allows the answers of Multiple Options & List (radio) questions to be randomized while always keeping a specified number of answers fixed at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth and sixth displayed last as in the image below:

[[File:Partially_Randomized_Answers_Enhanced_1.png]]

After the LimeSurvey randomizing has occurred a function in the source of a question moves the answer with the highest answer code to the end of the list.

Some conditions on the use of this are:
*The "Show No answer" survey setting must be set to "No"
*You must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:Partially_Randomized_Answers_Enhanced_2.png]]

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]]
#Create a Multiple Options or List (radio) question with sequential response codes.
#Set the "Random order" question setting to "Randomize on each page load".
#Place the following script in the source of the question.
#Modify the "fixedAnswers" variable as required.
<br />
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// The number of answers to be fixed at the end of the list
var fixedAnswers = 2;

// Identify this question
var qID = {QID};

// Find the number of answers
var ansCount = $('#question'+qID+' li.answer-item').length;

// Place the last n answers created at the end of the list
var fixedIndex = fixedAnswers - 1;
for (var i=0; i<fixedAnswers; i++) {
var answer = $( 'input[id$="X'+qID+(ansCount-fixedIndex)+'"]');
var answerItem = $(answer).closest('li');
var answersList = $(answer).closest('ul');
$(answersList).append(answerItem);
fixedIndex--;
}
});
</script></syntaxhighlight>

'''Download sample survey:'''<br />
[[Media:Partially_Randomized_Answers_Enhanced.lss|Partially_Randomized_Answers_Enhanced.lss]]

=Partially Randomized Answers - List (dropdown) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround, similar to the one above, allows the answers of List (dropdown) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

A script is placed in the source of a question. After the randomizing has occurred this script moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest=Y&lang=en here].

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [[Optional settings#Security|documentation here]])
#Create one or more List (dropdown) questions with sequential response codes. Set the [[Advanced question settings#random order|random_order question attribute]] to 1.
#In the source of the first question add the following onload function. (See [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|How to use script here]])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers
//except the last one in List/dropdown questions
function partRandDD(sID, gID, qID) {

// Find the number of answers
var ansCount = ''
$( 'div#question' + qID + ' select option' ).each(function(i) {
ansCount = i;
});

// Place the last answer created at the end of the list
$( 'option[value="' + ansCount + '"]' ).appendTo($( 'div#question' + qID + ' select' ));
}

// Call the function with the SID, GID and QID
partRandDD(89344, 72, 244);

});

</script></syntaxhighlight>

=Partially Randomized Answers - Multiple numerical input=

''Tested with: 1.90+, Safari 5.1''

This workaround, similar to the ones above, allows the answers of Multiple numerical input questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [[Optional settings#Security|documentation here]])
#Create one or more Multiple numerical input question with sequential response codes. Set the [[Advanced question settings#random order|random_order question attribute]] to 1.
#In the source of the first question add the following onload function. (See [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|How to use script here]])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in multiple numeric input questions
function partRand(sID, gID, qID) {

// Find the number of answers
var ansCount = ''
$( 'div#question' + qID + ' div.answers li' ).each(function(i) {
ansCount = (i - 1);
});

// Place the last answer created at the end of the list - but before the first helping sum
$( 'li#javatbd' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).insertBefore($( 'div#question' + qID + ' div.answers li.multiplenumerichelp' ).first());

}

// Call the function with the SID, GID and QID
partRand(SID, GID, QID);

});

</script></syntaxhighlight>

Using this solution for Multiple numerical input questions might be a bit more complicated than for other question types. All answers are organized in an unordered list (<nowiki><ul></nowiki>) structure. However, if advanced question settings like ''Equals sum value'' are used, LimeSurvey adds helping information (e.g. sum of all entries and remainder) to the same unordered list using the class ''multiplenumerichelp'' for these additional list items. The above example assumes that at least one of these list items is present and moves the last answer to the position right above the first helper item. Without such advanced settings, the code will most certainly need adaptation.

=Making one (or more) rows of an array mandatory=

''Tested with: 1.90+, IE 6/7, Firefox 3.0, Safari 3.2''

This workaround allows you to define one or more rows of an array question as mandatory (instead of all of them which the "Mandatory" question setting does). It is [http://www.partnersinc.biz/surveys//index.php?sid=26842&newtest=Y&lang=en demonstrated here].

A JavaScript function interrupts the submit function and checks if the inputs in the mandatory row(s) are populated. If not, an alert is popped up, the offending inputs are turned pink and the submit is aborted. Otherwise the submit goes ahead.

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions (see [[Optional settings#Security|documentation here]]).
#Create the array question.
#In the source of the array question add the following script (see [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|How to use script here]]).
#Modify the warningText (line10)as required.
#Replace "QQ" (lines 13 and 14) with the question ID and add calls as necessary for more rows - the example code renders rows 1 and 3 mandatory.

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function () {

// Interrupt the submit function
$('form#limesurvey').submit(function () {

// Override the built-in "disable navigation buttons" feature
$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var empty = 0;
var warningText = 'Please complete the highlighted inputs.';

// Call the mandatory row function with question IDs and row numbers
mandatoryRow(QQ, 1);
mandatoryRow(QQ, 3);

// A function to render rows of an array mandatory
function mandatoryRow(qID, rowNum) {

$('div#question' + qID + ' table.question tbody[id^="javatbd"]:eq(' + Number(rowNum - 1) + ') input[type="text"]').each(function (i) {

if ($(this).val() == '') {
$(this).css('background-color', 'pink');
empty = 1;
}
else {
$(this).css('background-color', '#FFFFFF');
}
});
}

if (empty == 1) {
alert(warningText);
return false;
}
else {
return true;
}
});

});

</script></syntaxhighlight>

=Randomly displaying one of a few YouTube videos, and recording which was displayed=

''Tested in 1.85+''

Jason Cleeland has created and documented a method to randomly display one of a number of youtube videos in a single question, and save which one was displayed.

http://www.aptigence.com.au/home/archives/23-Random-display-of-videos-in-a-question-2-YouTube.html

=Randomly displaying one of a few pictures, and recording which was displayed=

''Tested in 1.91+''

The following steps allow you to randomly display one of a few pictures and record in the dataset which picture was displayed. We use four pictures in this example, but you can easily adapt these scripts according to your needs.

1. Create a new sub-directory '''pic''' in your LimeSurvey folder.

2. Copy four pictures (named ''1.jpg'', ''2.jpg'', ''3.jpg'', and ''4.jpg'') in this pic sub-directory.

3. Deactivate the ''Filter HTML for XSS'' function in LimeSurvey's ''Global Settings''.

4. Create a '''Short free text''' question where you want these pictures to be displayed.

5. Figure out the [[SGQA identifier|SGQA Identifier]] of this question (e.g., 12345X67X89).

6. Paste the following code as question text after activating the editor's ''Source'' view and replace both SSSSSXGGXQQ strings with your SGQA identifier:

<syntaxhighlight lang="javascript" enclose="div">

Please have a look at this picture:

<br />

<script>

$(document).ready(

function(){

// Find a random number (here between 1 and 4)

var randNumber = Math.floor(Math.random()*4 + 1);

// Save the number as answer of this question

$('input#answerSSSSSXGGXQQ').val(randNumber);

// Hide this answer field

document.getElementById("answerSSSSSXGGXQQ").style.display='none';

// Show the picture

picString = '<img src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<p>

</p>

<div id="pic">

</div>

</syntaxhighlight>

If you want to display the number of this picture in a later question, use the following code as question text (don't forget to replace the SSSSSXGGXQQ string acordingly):

<syntaxhighlight lang="javascript" enclose="div">

You saw picture number {INSERTANS:SSSSSXGGXQQ}.

</syntaxhighlight>

Perhaps you want to display the same picture again in a later question, but a little bit smaller (100px width, 100px height)? Just paste the following code as question text after activating the editor's ''Source'' view, and replace the SSSSSXGGXQQ string acordingly:

<syntaxhighlight lang="javascript" enclose="div">

Here you see the picture again: <br>

<script>

$(document).ready(

function(){

// Get the picture number from previous question

var randNumber = "{INSERTANS:SSSSSXGGXQQ}";

// Show picture

picString = '<img width="100" height="100" src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<div id="pic">

</div>

</syntaxhighlight>

=Multiple numerical input with max_num_value defined in token (personalized limit)=

''Tested in 1.85+''

<div class="simplebox">As of version 1.92, max_num_value can be an experession, so you can simply enter the {TOKEN} or other variable in that question attribute.</div>

To make personalized survey with multiple numerical input when max_num_value (Maximum sum value) is different for each user and is loaded from the token use following tricks:
*Create 1st group with numerical input field (1000X10X11). "Limit"
*Add java script into this question:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

function Custom_On_Load(){

document.getElementById('answer1000X10X11').value='{TOKEN:ATTRIBUTE_1}';

document.getElementById('answer1000X10X11').readOnly=1;

}

</script>

</syntaxhighlight>

where:

TOKEN:ATTRIBUTE_1 is individual limit defined in token.

readOnly=1 // user shouldn't change it.
*Create 2nd group with multiple numerical input and add "Max value from SGQA" with 1000X10X11 as argument.

Note: If you don't want to show first field with numerical input (and show definied limit in different way) you can add 2 lines to above script to hide whole question:

<syntaxhighlight lang="javascript" enclose="div">

document.getElementById('question85').style.display='none';

document.getElementById('display85').value='';

</syntaxhighlight>

where:

question85 and display85 are field names.

Note: It's no possible to create it into one group, because all SGQA references can only refer to data on a previous page because when clicking next the answer is stored at the DB and the SGQA is replaced by querying the database.

=Default values in array questions=

''Tested with: 2.05+''

This workaround uses JavaScript to allow you to pre-check default answers in all sub-questions of an array type question. You can select a column of the array to be checked as the page loads. The script first checks to see if a sub-question has already been answered and, if not, checks the default answer.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use script]].
#Create the array question.
#In the source of the array question add the following script.
#Replace"QQ" with the question ID and "CC" with the column number to be checked.

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(document).ready(function() {
// A function to pre-check a column of an array
function checkedDefault(qID, column) {
var checkedCol = column - 1;
$('#question'+qID+' tr.subquestions-list').each(function(i) {
if ($('input.checkbox:checked', this).length == 0) {
$('input.checkbox:eq('+checkedCol+')', this).prop('checked', true);
$('input.checkbox:eq('+checkedCol+')', this).parent().find('input[type="hidden"]').val(1);
}
});
}
// Call the function with a question ID and column number
checkedDefault(QQ, CC);
});

</script></syntaxhighlight>

=Default Values In One Scale Of A Dual-scale Array Question=

''Tested with: 2.0+, IE 9/10, Firefox 24''

'''Overview'''<br />
This workaround uses JavaScript to allow you to pre-check default answers in all sub-questions of one scale of a dual-scale-array type question. You can select a scale and a column of that scale to be checked. The script first checks to see if a sub-question has already been answered and, if not, checks the default answer.

'''Implementation:'''
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use script]].
#Create the array question.
#In the source of the array question add the following script.
#Adjust "''defaultAnsweredScale''" and "''defaultAnsweredColumn''" as necessary.

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Scale to set the default answer on
var defaultAnsweredScale = 2;
// Column of that scale to set as default answer
var defaultAnsweredColumn = 3;

// Identify this question
var thisQuestion = $('#question{self.qid}');

// Identify the scales and columns
$('.answer-item[class^="answer_cell_1"]', thisQuestion).addClass('scale-1-item');
$('.answer-item[class^="answer_cell_2"]', thisQuestion).addClass('scale-2-item');
$('tr.answers-list', thisQuestion).each(function(i) {
$('.scale-1-item', this).each(function(i) {
$(this).addClass('scale-1-column-'+(i+1)+'-item');
});
$('.scale-2-item', this).each(function(i) {
$(this).addClass('scale-2-column-'+(i+1)+'-item');
});
});

// Click the default answers
$('tr.answers-list', thisQuestion).each(function(i) {
if($('.scale-'+defaultAnsweredScale+'-item input[type="radio"]:checked', this).length == 0) {
$('.scale-'+defaultAnsweredScale+'-column-'+defaultAnsweredColumn+'-item input[type="radio"]:last', this).click();
}
});
});
</script></syntaxhighlight>

'''Download sample survey:'''<br />
[[Media:Dual_scale_with_default_answers.lss|Dual_scale_with_default_answers.lss]]

=Record group view time=

''Tested with: 1.87+ (8518), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of version 1.92, group view time is accurately recorded in the timings table if you choose the Record Timings survey option.</div>

This workaround uses JavaScript to populate a hidden question with the total time that a respondent views a group. If used in a group with only one question, it could be used to track the amount of time required to answer the question.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#In the group, create a short-text question. We will hide this later with JavaScript and populate it with the elapsed time.
#Place the following script in the source of the short-text question.
#Replace "QQ" in line 6 with the ID of the short-text question.

The script populates the hidden question with the elapsed time since the group was opened. If a respondent leaves the group and then returns, the timer continues up from the elapsed time of the last visit.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// call the functions with the hidden timer question ID

runTimer(QQ);

function runTimer(timeQID) {

$('#question'+timeQID).hide();

var initSec = '0';

// Check for elapsed time from previous visits

if ($('#question'+timeQID+' input.text').val()) {

var initTime = $('#question'+timeQID+' input.text').val();

initTimeArr = initTime.split(':');

initSec = Number[[initTimeArr[0]*3600]]+Number[[initTimeArr[1]*60]]+Number(initTimeArr[2]);

}

// Run the timer update function

recordTime(initSec, timeQID);

}

});

// Timer update function

function recordTime(elapsedSec, timeQID){

elapsedSec++;

var h = Math.floor(elapsedSec / 3600);

var m = Math.floor(elapsedSec % 3600 / 60);

var s = Math.floor(elapsedSec % 3600 % 60);

var elapsedTime = [[h > 0 ? h + ":" : "00:") + (m > 0 ? (m < 10 ? "0" : "") + m + ":" : "00:") + (s < 10 ? "0" : "") + s);

$('#question'+timeQID+' input.text').val(elapsedTime);

// Run the timer update function every second

setTimeout('recordTime('+elapsedSec+', '+timeQID+')',1000);

}

</script>

</syntaxhighlight>

=Toggle visibility of groups=

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript to toggle the visibility of groups in an "all in one" survey. Initially the groups are hidden and there are links inserted to display the groups. It's useful to avoid the page being cluttered with many groups and lets the respondent focus on one at a time.

It's [http://www.partnersinc.biz/surveys//index.php?sid=33613&newtest=Y&lang=en demonstrated here].

Implementation is as follows:

#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Set the survey to run in "all in one" mode.
#Add your groups and questions.
#Place the following script in the source of one of the questions in the first group.

The comments in the script are pretty self-explanatory but it does the following:

#initially hides all of the groups
#inserts a link above each one to toggle its display
#some styles are added to the clickable links but these could be done in template.css instead
#shows any groups that have an unanswered mandatory after a submit attempt

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Insert show/hide divs before all group wrapper divs
$('<div class="groupToggler"><span></span></div>').insertBefore('div[id^="group-"]');

// Add some text to the show/hide divs
$('.groupToggler span').each(function(i) {
($( this ).text('Show/Hide Group '+(i+1)+''));
});

// Add some styles to the show/hide divs
$('.groupToggler').css({
'padding':'5px 0 10px 0',
'text-align':'center'
});
$('.groupToggler span').css({
'text-decoration':'underline',
'cursor':'pointer'
});

// Add some hover effects to the show/hide divs
$(".groupToggler span").hover(
function () {
$(this).css({
'text-decoration':'none',
'font-weight':'bold'
});
},
function () {
$(this).css({
'text-decoration':'underline',
'font-weight':'normal'
});
}
);

// Initially hide all of the groups
// Toggle their visibility when the show/hide is clicked
$('.groupToggler span').click(function() {
$(this).parent().next().toggle();
return false;
}).parent().next().hide();

// Display any groups that have unanswered mandatories
$('.errormandatory').parents('div[id^="group-"]').show();

// Some tidying up
$('h1').next().next().hide();
$('.surveywelcome').css({'margin-bottom':'10px'});
$('.surveywelcome').next().hide();
$('.surveywelcome').next().next().hide();

});

</script></syntaxhighlight>

=Use jQuery Autocomplete plugin to suggest answers for text inputs=

== 1.90 and previous versions==

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://docs.jquery.com/Plugins/Autocomplete jQuery Autocomplete] plugin to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

I've put together a small demonstration [http://www.partnersinc.biz/surveys//index.php?sid=78611&newtest=Y&lang=en here] and implementation is as follows.

'''Both methods:'''
*[http://docs.jquery.com/Plugins/Autocomplete Download the plugin]
*Place the files ''jquery.autocomplete.css'' and ''jquery.autocomplete.js'' in your template directory
*Add the following code inside the <head> element of startpage.pstpl

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.autocomplete.js"></script>
<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}jquery.autocomplete.css" /></syntaxhighlight>

'''Method 1 ("States" question in the demo):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware, District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky, Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York, North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan, Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota, Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete(states, {
matchContains: true,
minChars: 0
});
});

</script></syntaxhighlight>

'''Method 2 ("Countries" question in the demo):'''
*Place the CSV file of suggestions in your template directory.
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {
$line_of_text = fgetcsv($file_handle);
array_push($countriesArr, $line_of_text[0]);
}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;
var url = "templates/yourTemplate/countries.php";
var countriesArr = new Array();

$.getJSON(url,function(data){

$(data).each(function(i, item){
countriesArr.push(item);
});

$('#question'+qID+' input.text').autocomplete(countriesArr, {
matchContains: true,
minChars: 0
});
});
});

</script></syntaxhighlight>

== 1.91 and later versions==

''Tested with: 1.91+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

'''Both methods:'''
*Add the following styles to the end of your 'template.css' file

<syntaxhighlight lang="css" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {
width: 250px !important;
padding: 5px 10px;
list-style: none;
}</syntaxhighlight>

'''Method 1 (use local JavaScript array for data):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = 'QQ';

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware, District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky, Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York, North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan, Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota, Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete({
source: states
});

});

</script></syntaxhighlight>

'''Method 2 (use remote CSV file for data):'''
*Place the CSV file of suggestions in your template directory
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {
$line_of_text = fgetcsv($file_handle);
array_push($countriesArr, $line_of_text[0]);
}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;
var url = "templates/yourTemplate/countries.php";
var dataArr = [];

$.getJSON(url,function(data){

$.each(data,function(i, item){
dataArr.push(item);
});

$('#question'+qID+' input.text').autocomplete({
source: dataArr
});

});

});

</script></syntaxhighlight>

<br />
== Update for LimeSurvey 2.05+ ==
''Tested with: 2.05+, Chrome 40, FireFox 36, Opera 27, IE 11''

'''With LimeSurvey 2.05+ it is NOT necessary to:'''
<ol><li>Download the jQuery Autocomplete widget</li>
<li>Add special autocomplete styling to the survey template (tested with the Skeletonquest template by Denis Chenu)</li>
</ol>

This workaround builds on the previous examples, but is updated for use with newer versions of LimeSurvey. Note that the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] is already included in LimeSurvey, as part of jQuery UI.

<br />
Autocomplete may be configured to use different types of data input, three of which will be demonstrated in the following: Plain text, CSV-files, and MySQL databases.

<br />
'''1. Plain text input (the easiest, suitable for small lists or arrays).'''

To enable autocomplete of a list in plain text, simply add the following code to your question source. You will have to change qID to the question ID of the question you want the autocomplete to run in (this does not have to be the one you add the script to). In this case, the list has been added to the source directly, but you may also call the list as a predefined variable (see [http://jqueryui.com/demos/autocomplete/ jQuery website] for example):

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = 1;

$('#question'+qID+' input[type="text"]').autocomplete({
minLength: 2, // This line is optional, signifies number of keystrokes before autocomplete is initiated
source: ["Test1","Test2","Test3"]
});

});

</script>
</syntaxhighlight>

<br />
'''2. Input from CSV file (a little trickier, requires several files. Suitable for larger lists and arrays).'''

Please note that, with this method, all processing happens browser-side. Thus, the entire contents of your CSV file will be exposed, no matter where you "hide" it (it is not possible to request files from outside the webroot on your server using javascript). If any of this concerns you, please proceed to the next paragraph, which deals with autocomplete based on database queries. To enable autocomplete based on output from a CSV file, you will need the following:
<ol><li>A comma-separated data file (CSV)</li>
<li>The [https://code.google.com/p/jquery-csv/ jquery.csv.js plugin] (v0.71)</li>
</ol>

First, download the jquery.csv.js script, and place it in the template folder (may require manual FTP, rather than upload through the template manager). You will need to call this script in the head section of the survey page, which you find in startpage.pstpl. Make sure you call it <strong>before</strong> {TEMPLATEJS}.

<syntaxhighlight lang="html5" enclose="div">
<script type="text/javascript" src="{TEMPLATEURL}jquery.csv.js"></script>
</syntaxhighlight>

<br />
To make the CSV file, you may use Microsoft Excel and "Save as CSV". Note that Excel produces CSV files where the columns are separated by a <strong>semicolon</strong>, not a comma. To make this work with the jquery.csv.js plugin, you will have to edit the jquery.csv.js file on line 43:

<syntaxhighlight lang="javascript" enclose="div">
41 $.csv = {
42 defaults: {
43 separator:',', // Change this to: separator:';',
44 delimiter:'"',
45 headers:true
46 },
</syntaxhighlight>

<br />
Once the CSV file is in place, add the following javascript to your question source, using the correct question ID (qID) and url/filename for your CSV file:

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = 1;

var surveyRoot = location.pathname.split('index.php')[0];
var url = surveyRoot+'datafile.csv';

// Create an array to hold the data
var testArr = new Array();

// Grab the CSV contents
$.get(url,function(data){

// Convert CSV contents to an array of arrays
fullArray = $.csv.toArrays(data);

// Load the data array
$(fullArray).each(function(i, item){
testArr.push(item[0]);
});

// Initialise the autocomplete plugin
$('#question'+qID+' input.text').autocomplete({
source: testArr
});

// console.log(data); This would be a gould place to put your debugging script. Remember to comment out or remove before going into production, to economize on server workload
});
});

</script>
</syntaxhighlight>

<br />
Now, the autocomplete should work. If not, see if your CSV file shows up under "Network" or "Resources" in your browser's inspector, and if it provides any output. Adding <strong>console.log(data);</strong> to your javascript (as indicated) should output the data to the browser console (you'll see the contents of your CSV file), and may be useful for debugging. Note that only the data from the current function (the function, within which the text was placed) will be presented.

<br />
'''3. Input from a MySQL database (trickiest, but also the most versatile and secure).'''
<br />This method requires the following:
<ol><li>Access to a MySQL database (tested with MySQL 5.5)</li>
<li>A PHP script to connect to and query the database</li>
</ol>

First, paste the following script in your question source code, replacing for the correct question ID (qID) and the url/filename of your master PHP file (which in this case is autocomplete.php, see below):
<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = 1;

$('#question'+qID+' input[type="text"]').autocomplete({
minLength: 2, // This line is optional, signifies number of keystrokes before autocomplete is initiated
source: 'autocomplete.php'
});

});

</script>
</syntaxhighlight>

<br />
The structure of the database shouldn't matter too much, as long as you are using text fields. This example uses the UTF-8 character set. It is often a good idea to keep your login credentials in a separate file that you put outside of your webroot. In this case, I've put them in a file called constant.php:

<syntaxhighlight lang="php" enclose="div">
<?php
// Login credentials
define('DB_SERVER', "localhost");
define('DB_USER', "username");
define('DB_PASSWORD', "password");
define('DB_DATABASE', "database_name");
define('DB_DRIVER', "mysql");
?>
</syntaxhighlight>

<br />
The next file, database.php, deals with logging in to the database and performing the query that was requested through the javascript pasted above. Note that we're using the PDO convention rather than mysql_*, which has been deprecated for safety reasons (MySQLi remains a viable alternative, but is not shown here):

<syntaxhighlight lang="php" enclose="div">
<?php

// Connect and query MySQL database, using PDO
try {
$db = new PDO(DB_DRIVER . ":dbname=" . DB_DATABASE . ";host=" . DB_SERVER . ";charset=utf8", DB_USER, DB_PASSWORD);
}

catch(PDOException $e) {
echo $e->getMessage();
}

$return_arr = array();

if ($db)
{
$ac_term = "%".$_GET['term']."%";
$query = "SELECT * FROM table_name WHERE column_name LIKE :term";
$result = $db->prepare($query);
$result->bindValue(":term",$ac_term);
$result->execute();

// Fetch data and store in array
while ($row = $result->fetch(PDO::FETCH_ASSOC)) {
$row_array['label'] = $row['column_name'];
$row_array['value'] = $row['column_name'];

array_push($return_arr,$row_array);
}
}
</syntaxhighlight>

<br />
Finally, a PHP file (autocomplete.php) to include the previous two files and complete the query. This is the file that is called by the javascript, and the only one placed in the webroot:

<syntaxhighlight lang="php" enclose="div">
<?php

// Include files outside of webroot
set_include_path('/var/www/surveys/test-survey');

// Fetch database credentials
require_once ('constant.php');

// Connect to database and perform query
require_once ('database.php');

// Clear query
$db = null;

// Encode results in JSON. This is required for jquery autocomplete
echo json_encode($return_arr);

?>
</syntaxhighlight>

<br />
This should complete your setup, but there are obviously a variety of pitfalls, at which point the previously outlined debugging techniques may be of help.
<br />

== Use autocomplete to populate several fields==

''Tested with: 1.91+, IE 7/8/9, Firefox 18''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI and the [https://code.google.com/p/jquery-csv/downloads/list jquery.csv.js] plugin to provide a respondent with a list of suggested answers as they type in a text input and then to automatically populate other fields depending on the selection.

For example, if you have 3 questions - "Name", "ID" and "Email" - you can use this workaround to autocomplete the "Name" question and then the "ID" and "Email" questions can be automatically populated with values associated with the selected name.
*Download the [https://code.google.com/p/jquery-csv/downloads/list jquery.csv.js] plugin and place it in your template folder
*If using LimeSurvey 1.9x, add the following line to your startpage.pstpl BEFORE the tag for template.js, if using 2.x, add it AFTER the {TEMPLATEJS} placeholder<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.csv.js"></script></syntaxhighlight>
*Create your CSV file with 3 columns (name, ID, email) as in this example and place it in your template folder<syntaxhighlight lang="php" enclose="div">Bob, Bob's ID, Bob's email

Andy, Andy's ID, Andy's email

Sam, Sam's ID, Sam's email

Tony, Tony's ID, Tony's email

Fred, Fred's ID, Fred's email</syntaxhighlight>
*Create your 3 questions - "Name", "ID" and "Email". They must be in the same group/page.
*Add the following styles to the end of your 'template.css' file<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>
*Add the following script to the source of one of the questions
*Replace:
**"NN" with the "Name" question ID
**"II" with the "ID" question ID
**"EE" with the "Email" question ID
*Modify the path to your CSV file<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qNameID = NN;

var qIDID = II;

var qEmailID = EE;

var url = "upload/templates/yourTemplate/yourCsvFile.csv";

// Create an array to hold the names
var namesArr = new Array();

// Grab the CSV contents
$.get(url,function(data){

// Convert CSV contents to an array of arrays
fullArray = $.csv.toArrays(data);

// Load the names array
$(fullArray).each(function(i, item){
namesArr.push(item[0]);
});

// Initialise the autocomplete plugin
$('#question'+qNameID+' input.text').autocomplete({
source: namesArr,
// Event fired when a selection is made (ui.item.value refers to the selected item)
select: function(event, ui) {
// Find the "ID" and "Email" values associated with the selected name value and load those questions
$(fullArray).each(function(i, item){
if(item[0] == ui.item.value) {
// The value from column 2 of the CSV
$('#question'+qIDID+' input.text').val(item[1]);
// The value from column 3 of the CSV
$('#question'+qEmailID+' input.text').val(item[2]);
}
});
}
});
});
});

</script></syntaxhighlight>

=Drag and Drop Rankings=

{{Deprecated|2.0}}

{{Hint|Text=In 2.0 and up, this system Ranking question use jqueryui-sortable. This workaround is deprecated. }}

==Drag and Drop Ranking - Version 1.90 to 1.92==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

{{Hint|Text=In 2.0 and up, this system Ranking question use jqueryui-sortable. This workaround is deprecated. }}

This workaround is a modification of the workaround below and also uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables]. Thanks to the author of that workaround.

[[File:Untitled-12.png]]

Modifications include:
*Allow for multiple drag-n-drop ranking questions on a page
*Handle minimum and maximum answers settings
*Allow double clicking of items to add or remove them from the ranking list
*Work with the new shipped jQuery UI

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest=Y&lang=en demonstrated here]'''.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the large script below in your template.js file.
#Place the small script below in the source a ranking question, (this applies the "dragDropRank" function to the question). Replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID].
**Note: the LimeSurvey translations will be automatically used for the "Choices" and "Rankings" header labels but can be overridden with custom labels - see the example calls below.
#Insert the CSS below at the end of template.css (these styles are for the default template).

NOTE: I have not tested this workaround with conditions.

'''Code for template.js:'''

<syntaxhighlight lang="javascript" enclose="div">
function dragDropRank(qID, choiceText, rankText) {

if(!choiceText) {
choiceText = $('#question'+qID+' td.label label').text();
}
if(!rankText) {
rankText = $('#question'+qID+' td.output tr:first td:eq(1)').text();
}

//Add a class to the question
$('#question'+qID+'').addClass('dragDropRanking');

// Hide the original question in LimeSurvey (so that we can replace with drag and drop)
$('#question'+qID+' .rank, #question'+qID+' .questionhelp').hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)
//$('#display'+qID).val('off');

// Add connected sortables elements to the question
var htmlCode = '<table class="dragDropTable"> \
<tbody> \
<tr> \
<td> \
<span class="dragDropHeader choicesLabel">'+choiceText+'</span><br /> \
<div class="ui-state-highlight dragDropChoices"> \
<ul id="sortable1'+qID+'" class="connectedSortable'+qID+' dragDropChoiceList"> \
<li>Choices</li> \
</ul> \
</div> \
</td> \
<td> \
<span class="dragDropHeader rankingLabel">'+rankText+'</span><br /> \
<div class="ui-state-highlight dragDropRanks"> \
<ol id="sortable2'+qID+'" class="connectedSortable'+qID+' dragDropRankList"> \
<li>Ranks</li> \
</ol> \
</div> \
</td> \
</tr> \
</tbody> \
</table>';
$(htmlCode).insertAfter('#question'+qID+' table.rank');

// Remove placeholder list items (have to have one item so that LimeSurvey doesn"t remove the <ul>)
$('#sortable1'+qID+' li, #sortable2'+qID+' li').remove();

// Load any previously-set values
loadDragDropRank(qID);

// Find the number of LimeSurvey ranking inputs ("Maximum answers")
var maxAnswer = $('#question'+qID+' td.output input.text').length;

// Set up the connected sortable
$('#sortable1'+qID+', #sortable2'+qID+'').sortable({
connectWith: '.connectedSortable'+qID+'',
placeholder: 'ui-sortable-placeholder',
helper: 'clone',
revert: 50,
receive: function(event, ui) {
if($('#sortable2'+qID+' li').length > maxAnswer) {
alert ('You can only rank a maximum of '+maxAnswer+' choices.');
$(ui.sender).sortable('cancel');
}
},
stop: function(event, ui) {
$('#sortable1'+qID+'').sortable('refresh');
$('#sortable2'+qID+'').sortable('refresh');
updateDragDropRank(qID);
}
}).disableSelection();

// Get the list of choices from the LimeSurvey question and copy them as items into the sortable choices list
$('#CHOICES_' + qID).children().each(function(index, Element) {
var liCode = '<li class="ui-state-default" id="choice_' + $(this).attr("value") + '">' + this.text + '</li>'
$(liCode).appendTo('#sortable1'+qID+'');
});

// Allow users to double click to move to selections from list to list
$('#sortable1'+qID+' li').live('dblclick', function() {
if($('#sortable2'+qID+' li').length == maxAnswer) {
alert ('You can only rank a maximum of '+maxAnswer+' choices.');
return false;
}
else {
$(this).appendTo('#sortable2'+qID+'');
$('#sortable1'+qID+'').sortable('refresh');
$('#sortable2'+qID+'').sortable('refresh');
updateDragDropRank(qID);
}
});
$('#sortable2'+qID+' li').live('dblclick', function() {
$(this).appendTo('#sortable1'+qID+'');
$('#sortable2'+qID+'').sortable('refresh');
$('#sortable1'+qID+'').sortable('refresh');
updateDragDropRank(qID);
});
}

// This function copies the drag and drop sortable data into the LimeSurvey ranking list.
function updateDragDropRank(qID) {

// Reload the LimeSurvey choices select element
var rankees = [];
$('#sortable2'+qID+' li').each(function(index) {
$(this).attr('value', index+1);

// Get value of ranked item
var liID = $(this).attr("id");
liIDArray = liID.split('_');

// Save to an array
rankees[rankees.length] = { "r_name":$(this).text(),"r_value":liIDArray[1] };
});
$('#question'+qID+' input[name<div class="simplebox">="RANK_"]').each(function(index) {
if (rankees.length > index) {
$(this).val(rankees[index].r_name);
$(this).next('input').attr('value', rankees[index].r_value);
} else {
$(this).val('');
$(this).next().val('');
}
});

// Reload the LimeSurvey choices select element (we need this for "Minimum answers" code)
$('#question'+qID+' td.label select option').remove();
$('#sortable1'+qID+' li').each(function(index) {
var liText = $(this).text();
var liID = $(this).attr('id');
liIDArray = liID.split('_');
var optionCode = '<option value="'+liIDArray[1]+'">'+liText+'</option>';
$(optionCode).appendTo('#question'+qID+' td.label select');
});

// Hack for IE6
if ($.browser.msie && $.browser.version.substr(0,1)<7) {
$('#question'+qID+' select').show();
$('#question'+qID+' select').hide();
}
}

// This function is called on page load to see if there are any items already ranked (from a previous visit
// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list
function loadDragDropRank(qID) {

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values
$('#question'+qID+' input[name</div>="RANK_"]').each(function(index) {

// Check to see if the current item has a value
if ($(this).val()) {

// Item has a value - save to the array
// Use this element to contain the name and the next for the value (numeric)
rankees[rankees.length] = { "r_name":$(this).val(),"r_value":$(this).next().val() };
}
});

// Now that we have a list of all the pre-ranked items, populate the sortable list
// Note that the items *won"t* appear in the main list because LimeSurvey has removed them.
$.each(rankees, function(index, value) {

// Create the items in the sortable
var liCode = '<li class="ui-state-default" id="choice_' + value.r_value + '">' + value.r_name + '</li>';
$(liCode).appendTo('#sortable2'+qID+'');
});
}</syntaxhighlight>

'''Code in the source of the question(s) using the LimeSurvey translations for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">

$(document).ready(function() {
dragDropRank(QQ);
});

</script></syntaxhighlight>

'''Fix for later versions of 1.91+'''

In my version of LimeSurvey 1.91+, build 11026, this drag-n-drop workaround was not saving the selections properly. I'm not sure if that's because of my template, or other jquery uses, but I fixed it by making the following modifications to the above code placed into template.js.

If you're having problems (and it's definitely worth testing that the rankings are actually saving into your response table before proceeding with the survey) give this a try.

In the 'updateDragDropRank(qID)' function, replace the line:
<syntaxhighlight lang="javascript" enclose="div">
$('#question'+qID+' input[name<div class="simplebox">="RANK_"]').each(function(index) {
</syntaxhighlight>
with:
<syntaxhighlight lang="javascript" enclose="div">
$('#question'+qID+' input[name^="RANK_"]').each(function(index) {
</syntaxhighlight>

In the 'loadDragDropRank(qID) function, replace the line:
<syntaxhighlight lang="javascript" enclose="div">
$('#question'+qID+' input[name</div>="RANK_"]').each(function(index) {
</syntaxhighlight>
with:
<syntaxhighlight lang="javascript" enclose="div">
$('#question'+qID+' input[name^="RANK_"]').each(function(index) {
</syntaxhighlight>

'''Code in the source of the question(s) using custom text for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {
dragDropRank(QQ, 'Custom Choices Label', 'Custom Rankings Label');
});

</script></syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="css" enclose="div">
/* Drag-n-drop ranking styles */
.dragDropTable {
border: 0 none;
border-collapse: collapse;
width: 100%;
}

.dragDropTable td {
vertical-align: top;
width: 50%;
padding-right: 20px;
}

.dragDropTable .dragDropHeader {
font-weight: bold;
}

.dragDropTable .dragDropChoices,
.dragDropTable .dragDropRanks {
margin: 5px 0 0 0;
background: transparent none;
border: 0 none;
}

.dragDropTable .dragDropChoiceList,
.dragDropTable .dragDropRankList {
float: left;
width: 100%;
min-height: 2.4em;
_height: 2.4em; /* IE6 and below hack */
margin: 0;
padding: 0;
list-style-type: none;
background: #FBFBFB none;
border: 1px solid #CCCCCC;
}

.dragDropTable .dragDropChoiceList li,
.dragDropTable .dragDropRankList li {
margin: 3px;
*margin-left: -13px; /* IE7 and below */
padding: 3px;
min-height: 1.3em;
_height: 1.3em; /* IE6 and below hack */
font-weight: normal;
cursor: move;
display: block; /* Force the li to full width */
}</syntaxhighlight>

==Drag and Drop Ranking using Images - Version 1.90 to 1.92==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

{{Hint|Text=In 2.0 and up, this system Ranking question use jqueryui-sortable. This workaround is deprecated. }}

This workaround works in conjunction with the above workaround to allow ranking of images.

[[File:Untitled-11.png]]

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest=Y&lang=en demonstrated here]'''.

Implementation is as follows:

1) Follow the above workaround to get basic drag-n-drop functionality in your ranking question.

2) Insert your images in the ranking question text or help section after any text that you wish to have there (we'll move them later with JavaScript).

3) Give the images '''EXACTLY''' the same IDs as the answer code you would like them to be associated with:[[File:Untitled-8.png]]

4) Place the first script below in your template.js file.

5) Place the second script below in the source the ranking question '''AFTER''' the initial call for the dragDropRank function from the workaround above. Replace "QQ" with the ID of the ranking question (this applies the "dragDropRankImages" function to the question).

6) Insert the CSS below at the end of template.css. Replace "11" with your question ID. These styles are for the default template using 50x50px images (as in the demo) and may need to be modified for other templates or image sizes.

'''Code for template.js:'''

<syntaxhighlight lang="javascript" enclose="div">

function dragDropRankImages(qID) {

$('.connectedSortable'+qID+' li').each(function(i) {

// Remove any text in the sortable choice or rank items
$(this).text('');

// Move the images into the appropriate sortable list item
var liID = $(this).attr('id');
liIDArray = liID.split('_');
$('#question'+qID+' img#'+liIDArray[1]+'').appendTo(this);
});
}</syntaxhighlight>

'''Code in the source of the question(s):'''

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {
dragDropRankImages(QQ);
});

</script></syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="css" enclose="div">

/* Drag-n-drop for ranking images */
#question11 .dragDropTable {
width: auto;
}

#question11 .dragDropTable .dragDropChoiceList,
#question11 .dragDropTable .dragDropRankList {
min-height: 60px;
_height: 60px; /* IE6 and below hack */
width: auto;
min-width: 60px;
_width: 60px; /* IE6 and below hack */
}

#question11 .dragDropTable li {
background: 0 none;
border: 0 none;
height: 50px;
width: 50px;
}

#question11 .dragDropTable li img {
margin: 0;
padding: 0;
border: 0 none;
}</syntaxhighlight>

==Drag and Drop Ranking for iPad - Version 1.91 and newer==

''Tested with: LimeSurvey 1.91, iPad 2''

This workaround extends the above workarounds to work with the touch interface on iPads.

1) Follow the [[Workarounds: Manipulating a survey at runtime using Javascript#Drag and Drop Ranking - Version 1.90 and newer|Drag and Drop Ranking - Version 1.90 and newer]] workaround above to get basic drag-n-drop functionality in your ranking question.

2) Download the [https://github.com/furf/jquery-ui-touch-punch jQuery.ui.touch-punch.js plugin] and save it in your template directory.

3) Replace this line in your startpage.pstpl:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>With this:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.ui.touch-punch.js"></script>

<script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>

==Drag and Drop Ranking - Version 1.86==

Tested with 1.86 on IE 7,8, FireFox 3, Chrome, and Safari 4

{{Hint|Text=In 2.0 and up, this system Ranking question use jqueryui-sortable. This workaround is deprecated. }}

This workaround uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables] to modify a ranking question and allow the survey taker to drag and drop choices instead of clicking. The nice thing is that the choices can be easily re-arranged or removed from the ranking, all by drag and drop.

I used it for a voting application and some of the element names reflect that use.

It looks best when some CSS is added to control the appearance of the boxers around each choice.

[[File:drag-n-drop.png]]

<syntaxhighlight lang="javascript" enclose="div">
// Question ID global variable
var questionID;

$(document).ready(function() {

// Grab the question ID[[File:drag-n-drop.png]]
// This is something with a class of "ranking" and an ID that starts with "questionXXXXX". The X's represent the question ID
var entire_questionID = $(".ranking[id^='question']").attr('id');

// Get just the question number (ID)
var patt=/\d+$/;
questionID=patt.exec(entire_questionID);

// Hide the original quetion in LimeSurvey (so that we can replace with drag and drop)
$(".rank, .questionhelp").hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)
$("#display"+questionID).val("off");

// Add connected sortables to the question
var html_code = "<table style='border: medium none ; width: 770px; margin-left: auto; \
margin-right: auto;'><tbody><tr><td style='width: 590px; vertical-align: top;'><h3>List of Candidates:</h3> \
<div class='ui-state-highlight' style='margin: 5px; float: left;' id='ballot_list'> \
<ul id='sortable1' class='connectedSortable'><li>Candidates</li></ul></div></td> \
<td style='vertical-align: top;'><h3>Your selections:</h3><div class='ui-state-highlight' \
style='margin: 5px; float: left;' id='voting_selections'><ol id='sortable2' class='connectedSortable'> \
<li>Voting Area</li></ol></div></td></tr></tbody></table>";
$(html_code).appendTo("#question" + questionID);

// Remove list items (have to have one item so that LimeSurvey doesn't remove the <ul>)
$("#sortable1 li, #sortable2 li").remove();

// Load any previously-set values
loadRanking();

// Load jQuery UI
$.getScript("/scripts/jquery/jquery-ui.js", function() {

// After JQuery UI finishes loading, set up the connected sortable.
$("#sortable1, #sortable2").sortable({
connectWith: '.connectedSortable',
placeholder: 'ui-sortable-placeholder',
stop: function(event, ui) {
$("#sortable1").sortable("refresh");
$("#sortable2").sortable("refresh");
updateRanking();
}
}).disableSelection();

// Get the list of candidates from the built-in LimeSurvey question and copy them as items in sortable1
$("#CHOICES_" + questionID).children().each(function(index, Element) {
li_tag = "<li class='ui-state-default' id='choice_" + $(this).attr('value') + "'>" + this.text + "</li>"
$(li_tag).appendTo("#sortable1"); } );

// Make sure the submit button is showing
$(":submit[value|=' Submit']").show();

// Show a confirmation alert upon submit
$("form").submit(function() {

// Override the built-in "disable navigation buttons" feature
$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');
var validated = confirm("Cast your ballot now?");
if (validated) { return true; } else { return false; }
});

// Allow users to double click to move to selection list
$("#sortable1 li").assignDblClick();
}); // End of JQuery UI loading

}); // End of JQuery ready function

// Define the actions when an item is double clicked
$.fn.assignDblClick = function() {
$(this).dblclick(function(){
$(this).appendTo('#sortable2');
$("#sortable1").sortable("refresh");
$("#sortable2").sortable("refresh");
updateRanking();
});
}

// This function copies the drag and drop sortable data into the standard LimeSurvey ranking structure.
function updateRanking() {
var rankees = [];
$('#sortable2 li').each(function(index) {
$(this).attr("value", index+1);

// Get value of person
li_tag = $(this).attr('id');
li_tag_array = li_tag.split("_");

// Save to an array
rankees[rankees.length] = { 'r_name':$(this).text(),'r_value':li_tag_array[1] };
});
$("input[name</div>='RANK_']").each(function(index) {
if (rankees.length > index) {
$(this).val(rankees[index].r_name);
$(this).next().val(rankees[index].r_value);
} else {
$(this).val("");
$(this).next().val("");
}
});

// Re-assign double click action to first list items and remove
// double click action from section list items
$('#sortable1 li').unbind('dblclick').assignDblClick();
$('#sortable2 li').unbind('dblclick');
}

// This function is called on page load to see if there are any items already ranked (from a previous visit
// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list
function loadRanking() {
var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values
$("input[name<div class="simplebox">='RANK_']").each(function(index) {

// Check to see if the current item has a value
if ($(this).val()) {
// Item has a value - save to the array
// Use this element to contain the name and the next for the value (numeric)
rankees[rankees.length] = { 'r_name':$(this).val(),'r_value':$(this).next().val() };
}
});

// Now that we have a list of all the pre-ranked items, populate the sortable list
// Note that the items *won't* appear in the main list because LimeSurvey has removed them.
$.each(rankees, function(index, value) {
// Create the items in the sortable
li_tag = "<li class='ui-state-default' id='choice_" + value.r_value + "'>" + value.r_name + "</li>";
$(li_tag).appendTo("#sortable2");
});
}</syntaxhighlight>

=Create MaxDiff question type=

See the [[Workarounds: Question design, layout and templating|Question design, layout and templating]] section for a workaround that uses JavaScript to convert an '''''Array (flexible labels) by column''''' question into a [http://en.wikipedia.org/wiki/MaxDiff MaxDiff] question type.

[[File:max_diff_596x253.gif]]

=In a checkbox matrix, have the 'none' option in a row disable all other columns in that row=

''Tested with: LimeSurvey 1.90+''

The questionId parameter is the base ID of the question matrix (multiflexible).

numColumns and numRows speak for themselves

specialColumns is an array of the columns that have the special ability that when one of them

is checked, none of the others can be checked. E.g., a 'none of these' and/or a 'do now know' option.

<syntaxhighlight lang="php" enclose="div">

<script>

numColumns=13;

numRows=18;

questionId='28417X2X24';

specialColumns=[1,12,13];

function action(obj){

locator=obj.id.replace('cbox_'+questionId, '').split('_');

row=locator[0];

column=locator[1];

//alert('Action for row,column='+row+','+column);

my_id='#cbox_'+questionId+row+'_'+column+''

if($(my_id).attr('checked') == false) {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

$(id).attr('disabled',false);

}

} else {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

aid='#answer'+questionId+row+'_'+i

$(aid).val(0);

$(id).attr('checked',false);

$(id).attr('disabled',true);

}

}

}

function customOnLoad(){

for( var row=1; row<=numRows; row++ ) {

for( var k=0; k<specialColumns.length; k++ )

{

column=specialColumns[k];

$('#cbox_'+questionId+row+'_'+column).change(function() {

action(this);

});

}

}

}

jQuery(document).ready(

function(){

customOnLoad();

}

);

</script>

</syntaxhighlight>

=Last Option In Array (Numbers) (Checkboxes) Row Excludes All Others=

''Tested with: 2.05, IE 7-10, Firefox''

This workaround uses JavaScript/jQuery to make the last option of each Array (Numbers) (Checkboxes) row exclude all other options in the same row.

The script will uncheck all options in a row if the last option is checked and uncheck the last option in a row if any other options are checked.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the following script in the source of the array question.

NOTE: Care should be taken when using this script and conditional questions on the same page.

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
// Call the exclude function using question ID
excludeOpt ({QID});
});

// A function to make the last option in each array row exclusive
function excludeOpt (qID) {

var thisQuestion = $('#question'+qID)

// Add some classes to the checkbox cells
$('table.subquestions-list tbody td', thisQuestion).addClass('normalOpt');
$('table.subquestions-list tbody tr', thisQuestion).each(function(i) {
$('.normalOpt:last', this).removeClass('normalOpt').addClass('exlusiveOpt')
});

// A listener on the checkbox cells
$('table.subquestions-list tbody td', thisQuestion).click(function (event) {

// Set some vars
var thisRow = $(this).closest('tr');

// Uncheck the appropriate boxes in a row
if ($(this).hasClass('normalOpt')) {
$('.exlusiveOpt input[type=checkbox]', thisRow).attr('checked', false);
}
else {
$('.normalOpt input[type=checkbox]', thisRow).attr('checked', false);
}
});

// A listener on the checkboxes
$('table.subquestions tbody td input[type=checkbox]', thisQuestion).click(function (event) {

// Set some vars
var thisRow = $(this).closest('tr');
var thisCell = $(this).closest('td');

// Uncheck the appropriate boxes in a row
if ($(thisCell).hasClass('normalOpt')) {
$('.exlusiveOpt input[type=checkbox]', thisRow).attr('checked', false);
}
else {
$('.normalOpt input[type=checkbox]', thisRow).attr('checked', false);
}
});
}
</script></syntaxhighlight>

=Add Navigation Buttons (Next and Previous) To Top Of Page=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

Add the following to the end of template.js. It will insert a new div after the progress bar and then insert clones of the nav buttons in the new div.

This example is for the default template in 1.90 or 1.91. The placement of the new div may need to be modified for other templates.

<syntaxhighlight lang="javascript" enclose="div">
$(document).ready(function() {

// Insert a new div after the progress bar
$('<div id="navigator2" />').insertAfter('#progress-wrapper');

// Style the new div
$('#navigator2').css({
'text-align':'center'
});

// Insert clones of the nav buttons in the new div
$('input.submit:eq(0)').clone().appendTo('#navigator2');
$('input.submit:eq(2)').clone().appendTo('#navigator2');

// Give the new buttons some new IDs
$('#navigator2 input.submit').each(function(i) {
var oldID = $(this).attr('id');
var newID = oldID + '2';
$(this).attr('id', newID)
});
});</syntaxhighlight>

[[File:extra_buttons.png]]

=How to ''add'' an opt out link to your survey=

Tested with: 1.91+, Firefox 5.0

This javascript inserts a link to opt out of the survey above the progress bar.

[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|How to use script here]]

Then insert the following code into to the source of a group description or a question. I used the group description.

<syntaxhighlight lang="php" enclose="div"> <script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey ID
if($('input#fieldnames').length != 0) {
var fieldNames = $('input#fieldnames').attr('value');
var tmp = fieldNames.split('X');
var sID = tmp[0];
}

// Insert a new div after the progress bar
$('<div id="optOutLink" />').insertBefore('#progress-wrapper');

// Style the new div
$('#optOutLink').css({
'text-align':'center'
});

// Insert opt out url in the new div
$('#optOutLink').html('<p><a href="optout.php?lang=en&sid;='+sID+'&token;={TOKEN}">Click here to opt out of this survey.</a></p><br>');

});

</script></syntaxhighlight>

=Anonymously track respondents answers across multiple surveys=

''Tested with: 1.91+ and 1.92+''

This workaround uses JavaScript/jQuery to enable tracking of respondents across multiple surveys ensuring anonymity (it does not use tokens).

To do this you have to use this question in all the surveys you want to link respondents answers.

This workaround create an ID by asking some partial personal information (like initials, birth month ...). The ID will be encrypted using a one-way function (in this case SHA-1) and stored in a short text answer.

Implementation is as follows:
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the following code in the source of a short text question.
#Optional: you can also add other select field to avoid collisions (e.g. for large population sample)

<syntaxhighlight lang="php" enclose="div">

<p>This answers are used to generate your ID. These information will be encrypted, it will not be possible in any case to identify you neither from your answers nor from your ID.</p>

<table>

<tr>

<td>Initial of your name</td>

<td>

<select id="field1">

<option value=""></option>

<option value="A">A</option>

<option value="B">B</option>

<option value="C">C</option>

<option value="D">D</option>

<option value="E">E</option>

<option value="F">F</option>

<option value="G">G</option>

<option value="H">H</option>

<option value="I">I</option>

<option value="J">J</option>

<option value="K">K</option>

<option value="L">L</option>

<option value="M">M</option>

<option value="N">N</option>

<option value="O">O</option>

<option value="P">P</option>

<option value="Q">Q</option>

<option value="R">R</option>

<option value="S">S</option>

<option value="T">T</option>

<option value="U">U</option>

<option value="V">V</option>

<option value="W">W</option>

<option value="X">X</option>

<option value="Y">Y</option>

<option value="Z">Z</option>

</select>

</td>

</tr>

<tr>

<td>Your birth month</td>

<td>

<select id="field2">

<option value=""></option>

<option value="01">January</option>

<option value="02">February</option>

<option value="03">March</option>

<option value="04">April</option>

<option value="05">May</option>

<option value="06">June</option>

<option value="07">July</option>

<option value="08">August</option>

<option value="09">September</option>

<option value="10">October</option>

<option value="11">November</option>

<option value="12">December</option>

</select>

<td>

</tr>

</table>

<script type="text/javascript" src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/sha1.js"></script>

<script type="text/javascript">

$(document).ready(function() {

$("#answer{SGQ}").attr('readonly', 'readonly');

//$("#answer{SGQ}").css('display', 'none'); //uncomment this line for not displaying the code

});

$('#field1, #field2').bind('change keyup', function() {

if ($("#field1").val()=='' || $("#field2").val()=='')

$("#answer{SGQ}").val('');

else {

var sha1 = CryptoJS.algo.SHA1.create();

sha1.update($("#field1").val());

sha1.update($("#field2").val());

// sha1.update($("#otherfield").val());

var hash = sha1.finalize();

$("#answer{SGQ}").val(hash);

}

});

</script>

</syntaxhighlight>

=Check validity of international phone number in subquestion=

''Tested with: 1.91+, Firefox 8, Chrome 15''

As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.

Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92

This workaround uses javascript to check the validity of an international phone number in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the phone function with the question ID and the row number

phoneTest(QQ, NN);

function phoneTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var phoneMatch = /^[0-9,+,(), ,]{1,}(,[0-9]+){0,}$/;

var msg1 = 'Please enter a valid phone number.';

// Test the input

var phoneInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(phoneInput != '' && !phoneMatch.test(phoneInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1136 regexlib.com blank]

=Check validity of email address in subquestion=

'Tested with: 1.91+, Firefox 8, Chrome 15''

<div class="simplebox">As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<br />Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92</div>

This workaround uses javascript to check the validity of an email address in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the email function with the question ID and the row number

emailTest(QQ, NN);

function emailTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var emailMatch = /^[a-zA-Z0-9\_\-]+[a-zA-Z0-9\.\_\-]*@([a-zA-Z0-9\_\-]+\.)+([a-zA-Z]{2,4}|travel|museum)$/;

var msg1 = 'Please enter a valid email address.';

// Test the input

var emailInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(emailInput != '' && !emailMatch.test(emailInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1653 regexlib.com blank]

=Hiding the help-text when it's empty=

Tested with: 1.91+

I had made a style in my template putting a border around my help-text. To avoid empty help-text to show up (and have lines instead of just 'nothing' when there was no help text, I used this piece of code in question.pstpl:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var questionhelp="{QUESTIONHELP}";

if (questionhelp=="") {

document.write("");}

else {

document.write('<tr><td class="survey-question-help">'+ questionhelp +'</td></tr>');}

</script>

</syntaxhighlight>

it can probably be optimized but it worked for me

=Disable or hide selected fields in a matrix question=

''Tested with: 1.92+, IE 7/8/9, FireFox 12/13''

TASK

Hide or disable selected fields in a Matrix, so that users cannot make any input.

(See example, where users should not make input into red framed fields)

[[File:snap035.gif]]

Fig. 1: Prevent users from input into first two fields (as an example)

SOLUTION

First find the name of the fields you want to hide / disable. In my case I used Firebug with firefox to figure that out.

[[File:snap037.gif]]

Fig. 2: Figure out the name(s) of the field(s)

Then put the following script-code into the HTML-source code as described above:

Note: you have to change the code to match the names of your fields!

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('input[name="69965X2X10SQ001_SQ001"]').attr('disabled', 'disabled');

$('input[name="69965X2X10SQ001_SQ002"]').attr('hidden', 'hidden');

});

</script>

</syntaxhighlight>

[[File:snap039.gif]]

Fig. 3: Result: first field is diabled ("greyed out"), second one is completely hidden

I think this way one can apply many other attributes to a field like color etc. But did not try that myself.

Thanks to roB2009 for the input in the forum!

=Add prefix or suffix to question type "Array (Texts)"=

TASK

Add a prefix or suffix to the text fields in questions of the "Array (Texts)" type.

[[File:suffix.png]]

Fig. 1: Suffix

[[File:prefix.png]]

Fig. 1: Prefix

SOLUTION
*Set up your survey to use JavaScript.
*Add the following script to the source of the array. Replace "12345" with the array question ID and modify the suffixes/prefixes as required.
*The function call must consist of a question ID followed by the suffixes for each column. Suffixes/Prefixes must be enclosed in quotes and comma separated.
*In this example question ID 12345 will get an "in €" suffix in the first column and an "in %" in the next 3 columns.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the function with the question ID followed by a comma-separated list of suffixes

addSuffix(12345, 'in €', 'in %', 'in %', 'in %');

function addSuffix() {

var qID = $(arguments)[0];

// Assign some column-specific classes

$('#question'+qID+' table.question tbody tr').each(function(i){

$('td', this).each(function(i){

$(this).addClass('answerCol-'+(i+1)+'');

});

});

// Some styling

$('#question'+qID+' table.question tbody input[type="text"]').css({

'width': '50%'

});

// Insert the suffixes

$(arguments).each(function(i, val){

if(i > 0) {

$('#question'+qID+' td.answerCol-'+i+' label').append(val);

}

});

}

});

</script></syntaxhighlight>

For adding a prefix you need to substitute the following line in the code

<syntaxhighlight lang="php" enclose="div">$('#question'+qID+' td.answerCol-'+i+' label').append(val);</syntaxhighlight>

with this

<syntaxhighlight lang="php" enclose="div">$('#question'+qID+' td.answerCol-'+i+' label').prepend(val);</syntaxhighlight>

=Time question (Date question-like)=

''Tested with: 1.92+''

This workaround uses JavaScript/jQuery to build a Time question just like to the Date one.

Implementation is as follows:
#Download the file at [http://trentrichardson.com/examples/timepicker/jquery-ui-timepicker-addon.js trentrichardson.com/examples/timepicker/jquery-ui-timepicker-addon.js] and upload it to your survey.
#[[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].
#Place the following code in the source of a short text question.

<syntaxhighlight lang="javascript" enclose="div">
<script src="/upload/surveys/{SID}/jquery-ui-timepicker-addon.js"></script>

<script>

$(document).ready(function(){

$('#answer{SGQ}').timepicker({
timeText: 'Time', //here translation
hourText: 'hour', //here translation
minuteText: 'minute', //here translation
closeText: 'Done' //here translation
});

$('#answer{SGQ}').attr('readonly', 'readonly');

$( "<style>"
+".ui-widget-header, .ui-datepicker-current { display:none; }"
+".ui-timepicker-div dl dt { height: 25px; margin-bottom: -25px; }"
+".ui-timepicker-div dl dd { margin: 0 10px 10px 65px; }"
+" }"
+"</style>").appendTo( "head" );

});

</script></syntaxhighlight>

=Calculating date difference=

''Tested with: 1.92+ Build 120909''

This workaround explains how calculate difference between two dates (in: days, weeks, months and years) and is based on this [http://ditio.net/2010/05/02/javascript-date-difference-calculation/ resource external].

Requieres 2 groups and 'group by group' or 'question by question' presentation.

Group 1 (2 date questions)
*1st question - Question code: "DD"
*2nd question - Question code: "D2"

Group 2
*1 numerical input question.

This question retrieves the number of days between the 2 dates, and check if D2 is posterior than DD.

All the requiered code have to be added in the source of this numerical question.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

/*

Adapted from http://ditio.net/2010/05/02/javascript-date-difference-calculation/
*/

var DateDiff = {

inDays: function(d1, d2) {

var t2 = d2.getTime();

var t1 = d1.getTime();

return parseInt[[t2-t1)/(24*3600*1000]];

},

inWeeks: function(d1, d2) {

var t2 = d2.getTime();

var t1 = d1.getTime();

return parseInt[[t2-t1)/(24*3600*1000*7]];

},

inMonths: function(d1, d2) {

var d1Y = d1.getFullYear();

var d2Y = d2.getFullYear();

var d1M = d1.getMonth();

var d2M = d2.getMonth();

return (d2M+12*d2Y)-(d1M+12*d1Y);

},

inYears: function(d1, d2) {

return d2.getFullYear()-d1.getFullYear();

}

}

d1 = new Date({substr(DD,0,4)}, {substr(DD,5,2)}, {substr(DD,8,2)});

d2 = new Date({substr(D2,0,4)}, {substr(D2,5,2)}, {substr(D2,8,2)});

// Displays result

document.write("<br />Number of <b>days</b>: "+DateDiff.inDays(d1, d2));

document.write("<br />Number of <b>weeks</b>: "+DateDiff.inWeeks(d1, d2));

document.write("<br />Number of <b>months</b>: "+DateDiff.inMonths(d1, d2));

document.write("<br />Number of <b>years</b>: "+DateDiff.inYears(d1, d2));

// filled the numerical input with number of days (or nights)

var nDays = +DateDiff.inDays(d1, d2);

jQuery(document).ready(function() {

$(".numeric:eq(0) input.text").val(nDays);

$(".numeric:eq(0) input.text").attr('readonly','readonly');

// check if d2 > d1

$('#movenextbtn').hide();

$('#movesubmitbtn').hide();

if(nDays >= 0){

// automatic submit (uncomment if needed)

// document.limesurvey.submit();

// $('body').hide();

}

else alert("Check out date must be posterior than Check in\nPlease return to the previous page and edit your answers");

});

</script>

</syntaxhighlight>

=How to set minDate/maxDate based on other Datequestions=

'' tested with Version 2.00+ Build 130708''

QQ1 and QQ2 are the question identifiers. QQ2 gets as maxDate today and as minDate the date set in QQ1. The onClose event is needed because on document.ready the value of QQ1 is not yet known, although the value of today is.

<syntaxhighlight lang="php" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function () {
'use strict';
var qID1 = QQ1,
qID2 = QQ2,
q1 = $('#question' + 'QQ1' + ' .popupdate'),
q2 = $('#question' + 'QQ2' + ' .popupdate');

//if q1 loses focus, its value is taken and used as minDate in q2
q1.datepicker("option", "onClose", function (datum){
q2.datepicker( "option", "minDate", datum );
});
//q2 gets today as its maxDate
q2.datepicker( 'option', 'maxDate', new Date() );
});
</script>
</syntaxhighlight>

=Remove Question Help if empty=

''Version 2.00+ Build 130513''

Change your question.pstpl in your Template Editor so that the line looks like below. I've added the ID tag help_{question_number}.

<syntaxhighlight lang="javascript" enclose="div">
<tr><td class="survey-question-help" id=help_{QUESTION_NUMBER}>{QUESTIONHELP}</td></tr>
</syntaxhighlight>

You can then add the following javascript at the end of question.pstpl. If the contents of the help tag is empty then hide the element.

<syntaxhighlight lang="javascript" enclose="div">
<script>
$(document).ready(function(){
if($('#help_{QUESTION_NUMBER}').is(':empty')){
$('#help_{QUESTION_NUMBER}').hide();
}
});
</script>
</syntaxhighlight>

= Implicit Association Test (IAT)=

''Tested with: 2.0, IE 7-10, Firefox, Chrome, iPad''

This workaround uses JavaScript to insert an IAT interface into an Array (Texts) question. The workaround prompts respondents to assign words or phrases using the "E" or "I" keys. In mobile devices, "E" and "I" buttons are provided.<br /><br />

[[File:Iat_1.png]]<br /><br />

Download a [[Media:Demo_IAT_Concept.zip|working template]] and [[Media:Demo_iat_concept.lss|working survey]].

Implementation is as follows:

1) [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].

2) Create your Array (Texts) with sub-questions as follows:<br />
- Y scale - all of your "attribut" words or phrases<br />
- X scale - "Key Pressed" and "Elapsed Time (ms)"<br />
[[File:Iat_2.jpg]]

3) Insert your association terms and the other text elements for the interface into the Question Help section as depicted below. The text strings must be separated with "double pipes" (||) and you will need to place them in the following order:<br />
- Left association term<br />
- Right association term<br />
- Instructional text<br />
- Finished text<br />
[[File:Iat_3.png]]

4) Add the following to the end of template.js:<syntaxhighlight lang="javascript" enclose="div">
// A plugin to insert an IAT interface
function implicitAssociation(el, showAnswers) {

$(el).each(function() {

var thisQuestion = $(this);
var thisQuestionHelp = $('img[src$="help.gif"]', thisQuestion).parent();
var thisQuestionAnswers = $('table.question', thisQuestion).parent();
var startTime = '';
var endTime = '';
var agent = navigator.userAgent.toLowerCase();
var mobile = false;
if( /android|webos|iphone|ipad|ipod|blackberry/i.test(navigator.userAgent) ) { // Mobile devices
mobile = true;
}
mobile = true;

// Some classes
$(thisQuestion).addClass('iatQuestion');
$('.subquestion-list').addClass('unanswered');

// Hide the question help element
$(thisQuestionHelp).hide();

// Hide the answers
if(showAnswers != true) {
$('table.question', thisQuestion).hide();
}

// Insert IAT display
var iatTexts = $(thisQuestionHelp).text().split('||');
var iatDisplayHTML = '<div class="iatWrapper">\
<div class="iatLeftLabel">'+iatTexts[0]+'</div>\
<div class="iatRightLabel">'+iatTexts[1]+'</div>\
<div class="iatWord"></div>\
<div class="iatInstructions">'+iatTexts[2]+'</div>\
</div>\
<div class="iatMobileButtonWrapper">\
<div class="iatButton iatLeftButton">E</div>\
<div class="iatButton iatRightButton">I</div>\
<div style="width:100%; clear:both;"></div>\
</div>';
$(thisQuestionAnswers).prepend(iatDisplayHTML);

// Show a word
function iatShowWord() {
$('div.iatWord', thisQuestion).text($('.subquestion-list.unanswered:first .answertext', thisQuestion).text());
startTime = new Date();

$(document).bind('keypress.iatKeypress', function(e) {
if(e.which == 101 || e.which == 105) {
var thisRow = $('.subquestion-list.unanswered:eq(0)', thisQuestion);
$(thisRow).removeClass('unanswered');
endTime = new Date();
$('input[type="text"]:eq(1)', thisRow).val(endTime.valueOf() - startTime.valueOf());
if(e.which == 101) {
$('input[type="text"]:eq(0)', thisRow).val('E');
}
else {
$('input[type="text"]:eq(0)', thisRow).val('I');
}
$(document).unbind('keypress.iatKeypress');
if($('.subquestion-list.unanswered', thisQuestion).length > 0) {
iatShowWord();
}
else {
$('.iatLeftLabel, .iatWord, .iatRightLabel, .iatInstructions', thisQuestion).fadeOut('slow', function() {
$('div.iatWord', thisQuestion).text(iatTexts[3]);
$('.iatWord', thisQuestion).addClass('done').fadeIn('slow');
});
}
}
});
}
function iatShowWordMobile() {
$('div.iatWord', thisQuestion).text($('.subquestion-list.unanswered:first .answertext', thisQuestion).text());
startTime = new Date();

$('.iatButton', thisQuestion).bind('click.iatButtonClick', function(e) {
var thisRow = $('.subquestion-list.unanswered:eq(0)', thisQuestion);
$(thisRow).removeClass('unanswered');
endTime = new Date();
$('input[type="text"]:eq(1)', thisRow).val(endTime.valueOf() - startTime.valueOf());
$('input[type="text"]:eq(0)', thisRow).val($(this).text());
$('.iatButton', thisQuestion).unbind('click.iatButtonClick');
if($('.subquestion-list.unanswered', thisQuestion).length > 0) {
iatShowWordMobile();
}
else {
$('.iatLeftLabel, .iatWord, .iatRightLabel, .iatInstructions, .iatMobileButtonWrapper', thisQuestion).fadeOut('slow', function() {
$('div.iatWord', thisQuestion).text(iatTexts[3]);
$('.iatWord', thisQuestion).addClass('done').fadeIn('slow');
});
}
});
}

// Start the IAT display
if(mobile == true) { // Mobile devices
$('.iatMobileButtonWrapper', thisQuestion).show();
$('.iatButton', thisQuestion).bind('click.iatStartMobile', function(e) {
$('.iatButton', thisQuestion).unbind('click.iatStartMobile');
iatShowWordMobile();
});
}
else {
$(document).bind('keypress.iatStart', function(e) { // Non-mobile devices
if(e.which == 101 || e.which == 105) {
$(document).unbind('keypress.iatStart');
iatShowWord();
}
});
}
});
} </syntaxhighlight>

<br />5) Add the following to the end of template.css:<syntaxhighlight lang="css" enclose="div">
/* IAT questions */

.iatWrapper {
position: relative;
width: 600px;
height: 300px;
color: #FFFFFF;
background-color: #000000;
font-size: 21px;
}

.iatLeftLabel {
float: left;
padding: 10px;
}

.iatRightLabel {
float: right;
padding: 10px;
}

.iatWord {
position: absolute;
width: 100%;
top: 35%;
text-align: center;
font-size: 36px;
color:#0F0;
}

.iatWord.done {
color:#FFFFFF;
}

.iatInstructions {
position: absolute;
width: 100%;
bottom: 0px;
padding-bottom: 10px;
text-align: center;
}

.iatMobileButtonWrapper {
display: none;
position: relative;
width: 600px;
font-size: 36px;
}

.iatButton {
float: left;
margin: 20px;
width: 100px;
padding: 2px 0 5px 0;
border: 5px solid #999;
-moz-border-radius: 10px;
-webkit-border-radius: 10px;
-khtml-border-radius: 10px;
border-radius: 10px;
text-align: center;
line-height: normal;
cursor: pointer;
}

.iatLeftButton {
float: left;
}

.iatRightButton {
float: right;
}</syntaxhighlight>

<br />6) To apply the plugin, add one of the two scripts below to the question source:<br />
- With hidden answer table (for normally activated survey)
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(document).ready(function() {
// Apply the IAT plugin to this question
implicitAssociation('#question{QID}');
});
</script></syntaxhighlight>
- With visible answer table (for testing purposes)
<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">
$(document).ready(function() {
// Apply the IAT plugin to this question
implicitAssociation('#question{QID}', true);
});
</script></syntaxhighlight>

=Make multiple choice easier=

''Tested with Version 2.00 in Chrome, FF, Safar, IE''

The problem:
We often have multiple choice question, where the user has to select 4 elements out of 78 possible answers or 3 out of 25 and so on.
If we use pen and paper version for this questions, we noticed that the participants go through the whole list and if an answer doesn't suit on the first sight, they cross it out.

The solution:
The script gives the participant the possibility to cross out this answers in a digital way. The script adds a small "X" before the checkbox. When it is clicked, the label text of the checkbox turns grey.
(see the attached screenshot for an example)

Here is the script, just add it to help text

<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript">

/**
* Small script that adds a "X" before a checkbox.
* On click the text color of the label of the checkbox turns grey
* If the user has to choose some answers from many options, he can "delete" answers, that on first sight looks wrong
* Add the script to the question in Limesurvey (for example within the source code of the help text)
*/

//Define the X (standard is a X in capitals)
var x = "X";
css_class = "x";

/*
* Define the style of the X
* Of course you can define the style in the stylesheet - if so, the script ignores the following settings
* If there is a style, than set style var to 1
*/
var style = 0;
var size = "12px";
var weight = "bold";
var color = "red";
var cursor = "pointer";

//element type - standard is a span element
var type = "span";

//Define the new font color of the checkbox label
label_color = "#bfbfbf";

//End of configuration - start of the function

//Define the element that is added
if(style == 1) {
ele = "<"+type+" class='"+css_class+"'>"+x+"</"+type+">";
}
else {
ele = "<"+type+" class='"+css_class+"' style='font-size:"+size+"; font-weight:"+weight+"; color:"+color+"; cursor:"+cursor+";'>"+x+"</"+type+">";
}

//Get the standard font-color of the used style
st_color = $("label").css("color");

//insert the X before the checkboxes
$(document).ready(function() {
$("li").each(function(){
$(this).prepend(ele);
});
});

//bind an eventhandler on the X (delegate is used, because Limesurvey uses an old jQuery version)
var css_class_c = "."+css_class;
$(document).delegate(css_class_c,"click",function() {
var color_check = $(this).siblings("label").data("color");
if(color_check != "true") {
$(this).siblings("label").css("color",label_color).data("color","true");
$(this).siblings('input').attr('checked', false);

}
else {
$(this).siblings("label").css("color",st_color).data("color","false");

}
});

$(".checkbox").click(function () {
$(this).siblings("label").css("color",st_color).data("color","false");
});

</script>
</syntaxhighlight>

=Prevent the survey from being submitted when users press enter=

By default HTML forms are submitted when the user presses enter in any text field. This can be annoying with long survey pages or if your users are inexperienced with keyboard shortcuts.

To disable this behavior, add the following code snippet to template.js:

<syntaxhighlight lang="javascript" enclose="div">$(document).ready(function(){
$('input').keypress(
function(event){
if (event.which == '13') {
event.preventDefault();
}
});
});</syntaxhighlight>

= Card Sorting=

''Tested with: 2.05, IE 8-11, Firefox, Chrome, iPad''

This workaround uses JavaScript to allow dragging items into "buckets" to "card sort" them. A multiple-short-text question is used with sub-questions being the draggable items. The data recorded for each item is the "bucket" number that it was dropped in. "Buckets" are pre-defined in a list in the "Help" section of the question.<br /><br />

[[File:Card_sort_1.png]]<br /><br />

'''DOWNLOADS:'''<br />
- [[Media:Card_Sort.zip|Demo template]]<br />
- [[Media:Card_Sort.lss|Demo survey]].

'''IMPLEMENTATION:'''

1) [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|Set up your survey to use JavaScript]].

2) Create your multiple-short-text with sub-questions.

3) Insert the "bucket" labels into an unordered list in the Question Help section.

4) Add the following to the end of template.js:<syntaxhighlight lang="javascript" enclose="div">
function cardSort(qID) {

// Define some stuff...
var thisQuestion = $('#question'+qID);
var thisQuestionHelp = $('img[alt="Help"]', thisQuestion).parent();
thisQuestion.addClass('card-sort-question');

// Hide the "Help" section
thisQuestionHelp.hide();

//Insert the "card sort" elements
$('ul.questions-list', thisQuestion).parent().prepend('<div class="droppable items-start"></div><div class="items-end-wrapper" />');
$('ul:eq(0) li', thisQuestionHelp).each(function(i) {
$('.items-end-wrapper', thisQuestion).append('<div class="items-end-inner">\
<div class="items-end-text">'+$(this).html()+'</div>\
<div class="droppable items-end items-end-'+(i+1)+'" data-items-end="'+(i+1)+'"></div>\
</div>')});

// Insert the "cards"
$('li.answer-item', thisQuestion).each(function(i) {
var thisSGQA = $(this).attr('id').replace(/javatbd/, '');
var thisCode = $(this).attr('id').split('X'+qID)[1];
var thisHTML = $('label', this).html();
$('div.items-start').append('<div class="card draggable" data-sgqa="'+thisSGQA+'" data-code="'+thisCode+'">\
'+thisHTML+'\
</div>');
});

// Make the "cards" draggable
$('.draggable').draggable({
revert: "invalid",
zIndex: 2700,
helper: 'original',
start: function( event, ui ) {
$(ui.helper).addClass('ui-draggable-helper');
},
stop: function( event, ui ) {
}
});

// Set the targets for the draggables
$('.droppable.items-start').droppable({
hoverClass: 'target-hover',
accept: '.draggable.moved'
});
$('.droppable.items-end').droppable({
hoverClass: 'target-hover',
accept: '.draggable'
});

// After dropped
$('.droppable').bind('drop', function(event, ui) {

// Physically move the draggable to the target
// (the plugin just visually moves it)
// (need to use a clone here to fake out iPad)
var newDraggable = $(ui.draggable).clone();
$(newDraggable).appendTo(this);
$(ui.draggable).remove();
if($(this).hasClass('items-end')) {
$(newDraggable).addClass('moved');
}
else {
$(newDraggable).removeClass('moved');
}
$(newDraggable).removeClass('ui-draggable-helper ui-draggable-dragging').css({
'z-index':'',
'top':'auto',
'left':'auto'
});

// Now, make this new clone draggable
$(newDraggable).draggable({
revert: "invalid",
zIndex: 2700,
helper: 'original',
start: function( event, ui ) {
$(ui.helper).addClass('ui-draggable-helper');
},
stop: function( event, ui ) {
}
});
});

// Initial "card" positions
$('li.question-item input.text', thisQuestion).each(function(i) {
if($(this).val() > 0) {
$('.items-end[data-items-end="'+$(this).val()+'"]').append($('.card[data-sgqa="'+$(this).attr('name')+'"]'));
$('.card[data-sgqa="'+$(this).attr('name')+'"]').appendTo($('.items-end[data-items-end="'+$(this).val()+'"]')).addClass('moved');
}
});

// Interrupt the Next/Submit function and load the inputs
$('form#limesurvey').submit(function(){
$('.question-item input.text', thisQuestion).val(0);
$('.droppable.items-end .card', thisQuestion).each(function(i) {
var thisItemsEnd = $(this).closest('.droppable.items-end').attr('data-items-end');
var thisID = $(this).attr('data-sgqa');
$('#answer'+thisID+'').val(thisItemsEnd);
});
});
}</syntaxhighlight>

<br />5) Add the following to the end of template.css:<syntaxhighlight lang="css" enclose="div">
/* Card Sort */

.card-sort-question ul.subquestions-list {
/*display: none;
clear: both;*/
}

.card-sort-question .items-start {
float: left;
width: 340px;
height: 317px;
margin-top: 8px;
border: 1px solid #666;
-moz-border-radius: 6px;
-webkit-border-radius: 6px;
-khtml-border-radius: 6px;
border-radius: 6px;
}

.card-sort-question .items-start.target-hover {
background:#C9C9C9;
}

.card-sort-question .items-end-wrapper {
float: left;
margin-left: 20px;
width: 340px;
}

.card-sort-question .items-end {
width: 338px;
min-height: 73px;
margin-bottom: 10px;
padding-bottom: 5px;
border: 1px solid #666;
-moz-border-radius: 6px;
-webkit-border-radius: 6px;
-khtml-border-radius: 6px;
border-radius: 6px;
background: #EBEBEB;
}

.card-sort-question .items-end.target-hover {
background: #C9C9C9;
}

.card-sort-question .items-end.ui-state-disabled {
opacity: 1;
filter:alpha(opacity=100);
}

.card-sort-question .items-end-text {
width: 338px;
padding-bottom: 5px;
background: #FFFFFF;
font-size: 110%;
font-weight: bold;
}

.card-sort-question .card {
display: inline-block;
width: 140px;
height: auto;
margin: 5px 8px;
padding: 3px;
border: 2px solid #2F4354;
-moz-border-radius: 8px;
-webkit-border-radius: 8px;
-khtml-border-radius: 8px;
border-radius: 8px;
background-color: #43b3d1;
color: #2f4354;
font-weight: bold;
text-align: center;
line-height: normal;
}

.card-sort-question .items-end .card {
margin: 5px 7px;
}

.card-sort-question div.answer {
clear: both;
padding-top: 1px;
margin-top: 0;
}</syntaxhighlight>

<br />6) Add this to the source of the question to apply the function.<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
cardSort({QID});
});
</script></syntaxhighlight>

=Text Input (e.g. "short free text", "huge free text"): Force UpperCase + onBlur Trim=
Add this to the source of the question to apply the function.
<syntaxhighlight lang="javascript" enclose="div">
<script type="text/javascript" charset="utf-8">
$(document).ready( function() {
var my_surveyId='{SID}';
var my_groupId='{self.gid}';
var my_quesitonId='{self.qid}';
var my_self='{self.SGQA}';

// Operate for its appearance only (but have no effect to modify its intrinsic value): Display as UpperCase
$('#answer{self.SGQA}').css('text-transform', 'uppercase');

$('#answer{self.SGQA}').blur(function(){
// Operate for its intrinsic value: Trim + Transform to Uppercase
$(this).val( $.trim( $(this).val().toUpperCase() ) );
});
});
</script>
</syntaxhighlight>

Workarounds: Manipulating a survey at runtime using Javascript

2012-07-06T22:50:29Z

Holch:

Often you want to manipulate certain elements of a survey at runtime. The only solution without touching the source code is to use Javascript or jQuery which is shipped with Limesurvey. Here are some examples to hide and style elements, validate user input or do calculations at runtime.

Non Javascript workarounds can be found at
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Survey+behaviour&structure;=English+Instructions+for+LimeSurvey Workarounds - Survey Behavior]
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating Workarounds - Question design, layout and templating]

<div class="simplebox"><center>'''Please keep in mind that the workarounds published here are no official Limesurvey extensions but solutions that other users created for themselves.<br/><span style='color:#EE0000,#FFFFFF'>Therefore we can't give support for any solution on this page.</span><br/>Please contact the users that, thankfully, shared their solutions with the community if you have any questions.'''</center></div>

<div class="simplebox">Note: Version 1.92 implements many new features that make some existing workarounds obsolete. You can continue to use existing workarounds, but may want to consider switching over to using the new features (since those new features are officially supported, and the workarounds are not). Please review below for details of which are no longer needed.</div>

<div class="simplebox">Also Note: Version 1.92's Expression Manager (EM) may cause some of these work-arounds to fail. Any custom javascript included as a .js file will be fine. However, if you in-line your JavaScript code, you must make sure that you have a space after every opening (left) curly brace, and a space before every closing (right) curly brace. Otherwise, EM will think that the content between the curly braces is something it should parse and understand. I have fixed all of the work-arounds below that can be fixed (many did not follow those rules). However, some will continue to break. If a work-around contains a regular expression which contains curly braces (to indicate a range of repeats of a sub-expression), EM will try to process those curly braces, and thus break your regular expression. Strategies to continue to support that work-around functionality are discussed below.</div>

__TOC__

=How to ''add'' a javascript workaround solution to this Wiki page?=

Well, this is pretty easy. Click the edit icon and create your own headline within the javascript section starting with "'''!'''". Then add a short note about the version you have used when creating your workaround, you can copy/paste this code snippet <nowiki>''Tested with: (enter Limesurvey version and maybe browser)''</nowiki>.

Finally it's imported to mark all your code with code tags, other wise you might break this page.
*Start tag: '''<nowiki><syntaxhighlight lang="php" enclose="div"></nowiki>'''
*End tag: '''<nowiki></syntaxhighlight></nowiki>'''.

=How to ''use'' Script (eg. JavaScript etc.) in LimeSurvey?=

To use JavaScript within Limesurvey, the XSS filter must be turned off and the code inserted in the source of a question or a group description.
*Go to Global settings --> Security and set "Filter HTML for XSS" to "Off".
* [http://docs.limesurvey.org/tiki-index.php?page=Adding+A+Question Add a new question]
* Edit the question and click the "Source" button in the editor toolbar:

[[File:editor_1.gif]]
* Enter your script after the question text:

[[File:editor_2.gif]]
* Save the question

A simple test to see if JavaScript is enabled is to echo an alert. Use this code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

alert("Test!");

</script></syntaxhighlight>

It is a good practice to use the jQuery $(document).ready function to prevent the code from executing until the page is fully loaded:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

alert("Test!");

});

</script></syntaxhighlight>

=Sum up input values using Javascript=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the sum() function in [[Expression Manager|Expression Manager]]. See this [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]].</div>

This is from a survey that is a invitation to a longer party, when the user clicks to the next page, the calculated results will be shown.

If you wonder what the {INSERTANS:1X6X12} stuff is, look at [http://docs.limesurvey.org/tiki-index.php?page=SGQA+Identifier SGQA identifier] and [http://docs.limesurvey.org/tiki-index.php?page=Adding+a+Question#Information_from_previous_answers Using information from previous answers].

<syntaxhighlight lang="html" enclose="div">

<div style="text-align: left">These are your answers:<br />

<u></u><u></u><u></u><u></u><u>=

<p><script LANGUAGE="JavaScript">

partyprice = 3;

beadclothprice = 3;

breakfastprice = 7;

lunchprice = 8;

dinnerprice = 10;

foodtotal = 0;

var isreallytrue = "Yes";

var noanswer = "No answer";

document.write( "Can you come? = {INSERTANS:45251X1X1}<BR>" );

if ("{INSERTANS:45251X1X1}" == isreallytrue )

{

if ("{INSERTANS:45251X1X3}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X3}"; }

partypeople = parseInt(answer);

partytotal = partyprice * partypeople;

document.write( "It's {INSERTANS:45251X1X3} persons who will come = " + partytotal + "€<BR>" );

if ("{INSERTANS:45251X1X4}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X4}";}

beadcloths = parseInt(answer);

beadclothtotal = beadclothprice * beadcloths;

document.write( "You want to borrow {INSERTANS:45251X1X4} beadcloths = " + beadclothtotal + "€<BR>" );

document.write( "Will you be there thursday? = {INSERTANS:45251X1X5}<BR>" );

document.write( "On friday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X71}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X71}";}

breakfastfriday = parseInt(answer) * breakfastprice;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastfriday + "€<BR>" );

if ("{INSERTANS:45251X1X72}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X72}";}

lunchfriday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchfriday + "€<BR>" );

if ("{INSERTANS:45251X1X73}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X73}";}

dinnerfriday = parseInt(answer)* dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnerfriday + "€<BR>" );

foodtotal = breakfastfriday + lunchfriday + dinnerfriday;

document.write( "Will you be there saturday? = {INSERTANS:45251X1X8}<BR>" );

if ("{INSERTANS:45251X1X8}" == isreallytrue )

{

document.write( "On saturday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X91}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X91}"; }

breakfastsaturday = parseInt(answer) * breakfastprice ;

document.write("'''_ " + answer + " breakfeasts = " + breakfastsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X92}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X92}"; }

lunchsaturday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X93}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X93}"; }

dinnersaturday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersaturday + "€<BR>" );

foodtotal = foodtotal + breakfastsaturday + lunchsaturday + dinnersaturday;

}

document.write( "Will you be there sunday? = {INSERTANS:45251X1X10}<BR>" );

if ("{INSERTANS:45251X1X10}" == isreallytrue )

{

document.write( "On sunday you will have these meals: <br>" );

if ("{INSERTANS:45251X1X111}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X111}"; }

breakfastsunday = parseInt(answer) * breakfastprice ;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastsunday + "€<BR>" );

if ("{INSERTANS:45251X1X112}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X112}"; }

lunchsunday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsunday + "€<BR>" );

if ("{INSERTANS:45251X1X113}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X113}"; }

dinnersunday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersunday + "€<p>" );

foodtotal = foodtotal + breakfastsunday + lunchsunday + dinnersunday;

}

total = partytotal + beadclothtotal + foodtotal;

document.write( "<h3>In total it will cost you " + total + "€</h3><BR>

Put that sum in this bank account 1234 5678 9012" );

}

</SCRIPT></p>

</div></syntaxhighlight>

=Multiple Question Validation=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the min/max/equals_num_value attributes (to validate sums), or the em_validation_q function, which lets you refer to other variables when you validate the current question [[Expression Manager|Expression Manager]]. Such validations also work on the current page, and properly handle array_filter and cascading relevance.</div>

This workaround is in case you need to do some validation involving more than one question, it implies a very little JavaScript programming and the use of SQGA Identifiers; this should work on almost any version of LimeSurvey.

Is easy to explain with an example, we need to do a survey of the percentage of males and females and we want to be sure that the sum is 100, to do this follow this steps (the necessary data that is not indicated in these instructions are not important i.e. question codes, etc.):
#Create a new survey of type “group by group”, set the “Show |<< Prev| button” to yes and note the SID.
#Add a new group called “Group 1” and note the GID.
#Add a new question “Percent of males” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID1).
#Add a new question “Percent of females” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID2).
#Add a new group called “Group 2”
#Add a new non mandatory question, here is the trick the question text has to be (be sure to replace the SID, GID, QID1 and QID2

<syntaxhighlight lang="javascript" enclose="div">

<script>

function validation()

{

if [[{INSERTANS:SIDXGIDXQID1}+{INSERTANS:SIDXGIDXQID2}) != 100)

{

alert("Your responses don't sum 100! Check them");

document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

else

{

document.limesurvey.move.value = 'movelast';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</script>

</syntaxhighlight>

But this will show shortly the question and will jump to the end page, a little weird for the survey taker but works.

This is a proof of concept, and may have some problems, please if you notice something or improve it send me an e-mail to leochaton-limesurvey at yahoo dot com.

This will work for 2 questions that you want to be the same. Works well for email and confirm email questions

<syntaxhighlight lang="php" enclose="div">

function validation() {

if ("{INSERTANS:SIDXGIDXQID}" != "{INSERTANS:SIDXGIDXQID}") {

alert("Your responses don't match Check them"); document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</syntaxhighlight>

=Alternate exit=

''Tested with: ''

Using the same idea of the previous post, you can implement an alternate exit of your survey.

This script should be in the first question to be displayed in a next page after the question that should trigger the alternate exit. In this example the question that trigger the alternate exit is a Yes/No question, if the user chooses no, he is redirected to another page.

<syntaxhighlight lang="php" enclose="div">

<script>

if ("{INSERTANS:SIDXGIDXQID}" == "No")

{

window.location="http://www.limesurvey.org";

}

</script>

</syntaxhighlight>

=Custom onload function=

''Tested with: 'All browsers', LimeSurvey 1.70 and up

==General==

This simple workaround describes how to '''add a custom Javascript code''' that is triggered right after the page is loaded. It may have numerous applications, especially when you deal with a custom JS/HTML code. It may be used to hide form elements (<input> tags), make them read-only, display alert messages, etc.

To run any Javascript code right after page load use the Query ready() function. It will be executed when the page is being loaded. For example when you add the following code to one of your question definitions...:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(

function(){

alert('onload alert!');

}

);

</script>

</syntaxhighlight>

...it will display a pop-up message immediately after the page has been loaded.

Some of the applications of this trick I've explored are:

a) Hiding the form elements by calling in your Custom_On_Load:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").style.display='none';</syntaxhighlight>

Note: As of svn build 9755, you can now dynamically reference the questions input fields by using the {SGQ} keyword. You can rewrite the previous example like this:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer{SGQ}").style.display='none';</syntaxhighlight>

this makes it a little easier when exporting surveys, so you don't have to worry about manually entering each questions SurveyGroupQuestion ID.

b) Making the elements read only:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").readOnly=true;</syntaxhighlight> where the "answer73166X16X54" structure has been described in one of other workarounds above.

c) For Hiding by a lot of elements by calling in your Customer_On_Load

jQuery searchs in html document for input-fields with radio type, if his answer text empty then do the display css set to none.

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function() {

jQuery('input:radio').each(

function() {

var s = jQuery(this);

var c = s.parent().children('.answertext');

for(var i=0; i < c.length; i++) {

var a = jQuery(c[i]]);

if(this.id </u> a.attr('for') && a.text() == '') {

s.css({ 'display' : 'none' });

a.css({ 'display' : 'none' });

break;

}

}

}

)

}

);

</syntaxhighlight>

==Advanced usage==

If you want to place global Javascript code using the above jQuery(document).ready function then the best place to do this is the template javascript file template.js. You can edit this file using the template editor. Please be aware that placing it in the template javascript file will make the function available to all surveys using that template. If needed just create a new template copy for your survey.

Alternatively you can place the jQuery(document).ready function in the group description to make a Javascript function only available to a certain question group.

==Language-specific Javascript code==

There is an easy way to find out the current language and execute according Javascript using jQuery: The <html> tag of any survey pages contains an 'lang' attribute which holds the current language code. You can read that language code by using the followin code

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function(){

languagecode=$('html').attr('lang');

alert('This is the current language code: '+languagecode);

}

);

</syntaxhighlight>

For an English survey the above code would show a messagebox with "This is the current language code: en"

=Custom onload function in multi-language survey=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2,''

To use custom onload functions, as above, in multi-language surveys you must define the functions in the question source for '''all''' languages.

While this initially seems to be a bit tedious, it actually can be useful - you can alter your onload functions depending on the language in use. For example, you can dynamically display alerts or element contents in the current language.

=Skipping the welcome page=

''Tested with: 1.85 (second code snippet)''

<div class="simplebox">Note: As of version 1.91, there is a survey option letting you skip the welcome page, so this workaround is not needed.</div>

'''Solution 1:''' Include this Javascript in your welcome template, in the file welcome.pstpl for all welcome page, or in the source of the welcome text for one survey:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(function($) {

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit(); });

</script>

</syntaxhighlight>

It will reproduce the onclick event of the submit button and submit the form.

Drawback of course is that users will see the page flashing up.

Therefore, you may want to announce "... loading survey ..." as a description of your welcome page (in the admin interface when creating the survey), to pretend loading something big.

'''Solution 2:'''

<syntaxhighlight lang="php" enclose="div">

<script>

function custom_on_load(){

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit();

}

window.setTimeout( 'custom_on_load()',1);

</script>

</syntaxhighlight>

=Filter answers of a question with the answer of another=

===Method 1===

''Tested with: 1.70 - 1.72''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general.</div>

If you want to filter the answer of a question with another answer, you can use this workaround.

First, use answer code like that: XX for the first question, and XXYYY for the second one.

Answer of the second question filter if the 2 first letters are the answer of the first question.

We use 1000X1X1 and 1000X1X2 for the example, question had to be on separate page (question by question for example).The second question had to be a dropdown list (we can do similar workaround, but droplis is the best). You can do this using JQuery. It leaves the answer in the select box, but disables it. You could also replace "disable" with "remove" to get rid of it altogether.

<syntaxhighlight lang="php" enclose="div">

var previousQuestionAnswer = "{INSERTANS:1000X1X1}";

var currentQuestionID = "#answer1000X1X1"

$(document).ready(function() {

// See if the answer for the previous question matches an answer in the current question

// (other than 'No Answer')

// If so, disable it.

if (previousQuestionAnswer!='No Answer') {

$(currentQuestionID).children().each(function(index, Element)

{

if ($(this).attr('text') == previousQuestionAnswer)

{ $(this).attr('disabled', true); }

}

);}

}); // End of JQuery ready function

</syntaxhighlight>

===Method 2===

''Tested with 1.92 + Firefox 9.0''

If you have a country, state, and city set of questions (or similar), you could code answer options as:

'''Q1 Country''' ''Single choice list (ratio, dropdown)''

X country#

'''Q2 State''' ''Single choice list (dropdown)''

XY state#

'''Q3 City''' ''Single choice list (dropdown)''

XYZZ city#

Now you must put the following Javascript code in the source of question 2 (State):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the countryCode (first character of the country)

var countryCode = '{INSERTANS:1000X1X1}'.substr(0, 1).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the countryCode

$('select[id<div class="simplebox">="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 1).toUpperCase() != countryCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

And the following code in the source of question 3 (City):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the stateCode (two first characters of the state)

var stateCode = '{INSERTANS:1000X1X2}'.substr(0, 2).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the stateCode

$('select[id</div>="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 2).toUpperCase() != stateCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

Each question must be in different pages of survey to work, i.e. in a question by question survey, or in diferent groups in a group by group survey.

Note that if you choose a two characters answer option code in the State question, i.e. a XYY answer option code, you must change the ''substr(0, 2)'' part of code in question 3 to ''substr(0, 3)''.

=Filter answers of a multiple numeric type question=

''Tested with: 1.90+''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general. In 1.92, array_filter works with all questions that have sub-questions (e.g. also works for multiple numeric and multiple short text).</div>

If you want to filter a question of type "multiple numeric", you have to modify the workaround.

Note that this workaround assumes that the code for each of the subquestions are a numeric sequence 1,2,3...

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Match elements with labels using htmlFor and a loop

var labels = document.getElementsByTagName('LABEL');

for (var i = 0; i < labels.length; i++) {

if (labels[i].htmlFor != '') {

var elem = document.getElementById(labels[i].htmlFor);

if (elem)

elem.label = labels[i];

}

}

var answerFilter="{INSERTANS:96553X63X759}";

for (i=0; i<30; i++){

var iLabel = document.getElementById('answer96553X63X760'+(i+1]].label.innerHTML;

if (answerFilter.search(iLabel) == -1){

// Hide element

$('#question760').find('li').eq(i).hide();

// Set value of hidden elements to zero

document.getElementById('answer96553X63X760'+(i+1)).value = 0;

}

}

});</script>

</syntaxhighlight>

=Use an answer to prefill another question (default value)=

''Tested with: 1.72''

''And tested with: 1.91+''

<div class="simplebox">As of version 1.92, this is easier to do using the enhanced defaults feature, which lets you pre-fill most question types with default values. In 1.91, you could set defaults for list and multiple choice questions. In 1.92, you can set defaults for any text-entry question too. Moreover, the defaults can be [[Expression Manager|Expression Manager]] compatible equations or tailored text. Finally, with 1.92, defaults are properly managed even when set on the same page.</div>

This workaround gives you the ablility to use an answer to fill the default value for another question. It's explained for free text question type but can be adapted for another question type.

We use SGQA identifier. For example, we use SGQA 1000X10X20 and 1000X10X21 to prefill 1000X11X30 and 1000X11X31. For the script to work, the question has to be on a different page.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X11X30').val('{INSERTANS:1000X10X20}');

$('#answer1000X11X31').val('{INSERTANS:1000X10X21}');

});

</script></syntaxhighlight>

If you want use two times the value of an integer input, you can also use this to prefill a question that you hide via CSS.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X2X2').val(parseInt('{INSERTANS:1000X1X1}')*2);

$("#question2").hide();

});

</script>

</syntaxhighlight>

Now you can use {INSERTANS:1000X2X2} for giving you twice the value of the user input from question 1.

=Dynamic Sum=

<div class="simplebox">As of version 1.92, this is easier to do with [[Expression Manager|Expression Manager]] using the sum() function. Not only will sums be dynamic, but they wille exclude irrelevant values, so you can array_filter a multiple numeric question and get the sum of just the answers that are visible. This [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]] demonstrates the dynamic sum feature.</div>

<div class="simplebox">Also note, as of version 1.92, the following workaround will fail, since it includes a a regular expression containing curly braces.</div>

This script is used with a "Multiple Options" type question calculate a total price based on how which checkboxes are selected. The prices are listed as part of the answer. The answers are set up like this: "USB Mouse ($20)". The script uses the number between the "($" and the ")" as the price for that item. You can adapt the script to if you need to change the currency or need to sum something other than money.

This script works when used in a question-by-question format. It does not work when there are more than one question on a page. I think it can be adapted to work, but I haven't done the coding yet.

Put the following code into body of your question:

<syntaxhighlight lang="php" enclose="div">

<script language=Javascript>

// General definitions

// Define a regular expression to match the labels containing information about an answer

// In LimeSurvey, these labels start with "answer..."

var answerRegex = /^answer/;

// Find all answer checkboxes in the document and set their

// onchange events to updatePrice

function Custom_On_Load()

{

// Find all input elements

var inputList=document.getElementsByTagName("input");

// Loop through each, looking for checkboxes

var i;

for( i=0; i< inputList.length;i++ )

{

// If input item does not have an ID, skip

if (! (inputList[i].id)) { continue; }

// Skip to next if ID doesn't start with "answer"

if (!answerRegex.test(inputList[i].id)) { continue; }

// Skip to next if not a checkbox

if (inputList[i].type.toUpperCase()!='CHECKBOX') { continue; }

// This is an answer checkbox!

// Setup onchange event

inputList[i].onclick = updatePrice;

}

// Load initial sum

updatePrice();

}

function updatePrice()

{

var labels=document.getElementsByTagName("LABEL");

// Define a regular expression to match a price inside parenthesis

// For example: ($29) or ($29.54).

// Set up

priceRegex = /$\$(\d*\.{0,1}\d+)$/;

// Loop through all the labels, looking for labels corresponding to

// answers that have a price in them.

var i;

var total = 0;

for( i=0; i<labels.length;i++ )

{

var myArray; // Define array used for regex matching

var inputID; // Define field element

// Get the ID of the field corresponding to the label using the

// "htmlFor" attribute

// (FYI, there are some labels that will have to be screened out

// because they don't correspond to an answer)

// Does the label start with "answer"?

// If not: exit.

if (!answerRegex.test(labels[i].htmlFor)) { continue; }

// First make sure this element exists

// If it doesn't, go to the next element

// If it does, it will be defined in inputID

if (! (inputID = document.getElementById(labels[i].htmlFor)) ) { continue; }

// See if the corresponding answer is a checkbox that is checked.

// If not, go to next label

if (inputID.type.toUpperCase()!='CHECKBOX') { continue; }

if (!inputID.checked) { continue; }

// This is label for an answer.

// The innerHTML will give us the text of the label

// The price information will be in the form ($XX.XX)

// which in contained in the label text.

// Find a match for a decimal number inside the pattern "($" and ")"

if [[myArray = priceRegex.exec(labels[i].innerHTML]] != null)

{

// Keep a running tally

total += parseFloat(myArray[1]);

}

}

// Update total price on form

document.getElementById("totalPrice").value = "$" + formatCurrency(total);

}

function formatCurrency(num) {

num = isNaN(num) || num <u> '' || num </u> null ? 0.00 : num;

return parseFloat(num).toFixed(2);

}

</script>

</syntaxhighlight>

Put the following code in the help section (or wherever you want the sum to appear):

<syntaxhighlight lang="php" enclose="div">Total Cost for selected accessories: <input type="readonly" value="" id="totalPrice" /></syntaxhighlight>

=Focus on the first Input field=

(''Tested with: Limesurvey 1.80 / IE6/7, Firefox 3, Safari, Opera, chrome'')

<div class="simplebox">As of version 1.91, there is a built-in JavaScript function called focusFirst() to focus on the first visible element. It uses jQuery, so is more robust than this example.</div>

Again an onload Function is needed for this tasks. I have done it the DOM way with compatibility to IE6/7.

Put the following code into the startpage.pstpl of your template, right before the </head> closing tag:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function focusFirst(Event)

{

var i=0;

while(document.forms[0].elements[i].type == "hidden")

{

i++;

}

document.forms[0].elements[i].focus();

return;

}

if(ie)

{ window.attachEvent("onload", focusFirst); }

else

{ document.addEventListener("load", focusFirst, true); }

</script>

</syntaxhighlight>

'''Note:''' I am using this with version 1.80. As changes happened to the templates in the last release, you might need to add the following before the code, if your template is older than 1.80 stable and does not include this:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var ie = false;

</script>

</syntaxhighlight>

You will need this for the var ie to be set. Without this var, the function will not work with ie.

=Answer questions by keypress=

(''Tested with: IE7, Firefox 3'')

This workaround allow to answer the question on key 0-9 (0 is for the 10 answer).

Follow issues are supported at the moment:
*Yes-No Questions
*List Questions (radio)
*other radio questions

In lists the answer limit is ten.

You supply the template "endpage" of your template with the following script.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

jQuery(document).ready(function() {

jQuery(document).bind('keypress', function(e){

if (48 <= e.which && e.which <= 57) {

jQuery('input:radio').each(function() {

var v = jQuery(this).val();

var c = (e.which <u> 48) ? 10 : e.which - 48;

if(v </u> 'Y' || v <u> 'N') {

v = (v </u> 'Y') ? 1 : 2;

}

if(v == c) {

jQuery(this).click();

jQuery('#limesurvey input:submit').click();

}

});

}

})

});

</script>

</syntaxhighlight>

=Math notation in LimeSurvey=
#download the js file from [http://mathcs.chapman.edu/~jipsen/mathml/asciimathdownload.html AsciiMath script]
#copy it in the /scripts/ folder in your installation
#modify the startpage.psptl of the template you want to use adding the reference to the script (if you use an older version make sure that you copy the template folder first!) for example:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" src="ASCIIMathML.js">

</syntaxhighlight>

Use the notation where you need it!

'''Note:''' If you use internet explorer or safari you will need to download the plugin as well, but firefox does the lot for you.

Finally, if you are confident with the limesurvey structure you could add the editor which support math notation and change the reference to the editor you want to use in the configuration file. here is the [http://www.imathas.com/editordemo/demo.html link for a TinyMCE with math support].

=Reverse array_filter (for pre-1.90)=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">Note: Version 1.91 natively supports this functionality via the array_filter_exclude advanced quation option.</div>

This can be used to filter the answers of an array question to be displayed based on the answers of a multi option question that were '''NOT''' selected. A possible application would be to have a multi-option question asking which products were purchased, followed by 2 array questions - one asking to rate the purchased products and another asking why the remaining products were not purchased. Another would be to ask about sessions attended at a conference as in [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/27970-reverse-of-arrayfilter.html this forum thread] and pictured below. There is a live [http://www.partnersinc.biz/surveys//index.php?sid=43358&newtest;=Y&lang;=en demo here]

[[File:sessions_645x344.gif]]

We'll use the above example to explain the process as follows:
#In group 1 - Create a ''SessionsAttended'' multi-options question
#In group 1 - Create a ''SessionsNotAttended'' multi-options question with identical answers as ''SessionsAttended'' and hide it with styles or conditions
#In group 2 - Create a ''RateSessionsAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsAttended''
#In group 2 - Create a ''ReasonNotAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsNotAttended''
#In group 1 - Place JavaScript/jQeury listeners on each of the checkboxes in ''SessionsAttended'' that would toggle the corresponding checkbox in ''SessionsNotAttended'' to the opposite state

The JavaScript/jQuery code used would be:

<syntaxhighlight lang="php" enclose="div">

// The toggle function

function toggle(q1, q2) {

if ($(q1).attr('checked') == false ) {

$(q2).attr('checked', true);

}

else {

$(q2).attr('checked', false);

}

}

// Initialize the SessionNotAttended checkboxes to "checked"

toggle ('#answer11111X22X331', '#answer11111X22X441');

toggle ('#answer11111X22X332', '#answer11111X22X442');

toggle ('#answer11111X22X333', '#answer11111X22X443');

toggle ('#answer11111X22X334', '#answer11111X22X444');

// The jQuery listeners on the SessionAttended checkboxes

// that toggle the SessionNotAttended checkboxes

$('#answer11111X22X331').change(function() {

toggle ('#answer11111X22X331', '#answer11111X22X441');

});

$('#answer11111X22X332').change(function() {

toggle ('#answer11111X22X332', '#answer11111X22X442');

});

$('#answer11111X22X333').change(function() {

toggle ('#answer11111X22X333', '#answer11111X22X443');

});

$('#answer11111X22X334').change(function() {

toggle ('#answer11111X22X334', '#answer11111X22X444');

});

</syntaxhighlight>

Some notes about the code:
*The code is in an onload function defined in the first question of group 1 - see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workarounds here]
*Both ''SessionsAttended'' and ''SessionsNotAttended'' must be in the same group for the toggling to work
*This case only uses 4 checkboxes but could be expanded as required
*In this case the survey ID is 11111, the group ID is 22, ''SessionsAttended'' ID is 33 and SessionsNotAttended ID is 44 - these would need to be modified for your survey
*The toggle function looks for the state of a checkbox in ''SessionsAttended'' and sets the corresponding checkbox in ''SessionsNotAttended'' to the opposite state
*The "Initialize" section sets the state of ''SessionsNotAttended'' checkboxes whenever we navigate to the group
*The "Listener" section uses jQuery listeners to detect any change in the ''SessionsAttended'' checkboxes and then toggle the corresponding ''SessionsNotAttended'' checkbox

Some general notes about the questions:
*CSS can be used to hide ''SessionsNotAttended'' (div#question44 { display: none; }) if you don't want to use conditions (because maybe you've got [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $deletenonvalues set to 1])
*''RateSessionsAttended'' and ''ReasonNotAttended'' are another group to avoid things popping in and out of existence as ''SessionsAttended'' is answered
*[http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions] are used to ensure that ''RateSessionsAttended'' only appears if some sessions are selected and ''ReasonNotAttended'' only appears if no sessions are selected

=Filter Ranking Question With Multiple-Options=

''Tested with: 1.90, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

<div class="simplebox">As of version 1.92, most of this is easier to do using the the array_filter attribute, or relevance equations in general. They all work on the same page, and fully support cascading relevance.</div>

This workaround applies a filter to a ranking question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and ranking questions being on the same page and a slightly different one for the filter question being on a page before the ranking question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=96314&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following script in your template.js file. This function will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

// A function to filter choices in a ranking question

function rankFilter(q1ID, q2ID, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+q1ID+' li[id<div class="simplebox">="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+q1ID+'').hide();

}

handleChecked(q1ID, q2ID);

$('#question'+q1ID+' input.checkbox').click(function() {

handleChecked(q1ID, q2ID);

});

function handleChecked(q1ID, q2ID) {

// Find the survey and group IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $( 'input#fieldnames' ).attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

}

// Loop through all Q1 options

$('#question'+q1ID+' input.checkbox').each(function(i) {

// Find the answer code and value

var tmp2 = $(this).attr('id').split('X'+gID+'X'+q1ID+'');

var ansCode = tmp2[1];

var ansTxt = $(this).next('label').text();

// If option is checked and not in rank choices or output, add it to the rank choices

if($(this).attr('checked') == true

&& $('#question'+q2ID+' select.select option[value="'+ansCode+'"]').length == 0

&& $('#question'+q2ID+' .output input[id</div>="fvalue_"][value="'+ansCode+'"]').length == 0) {

$('<option value="'+ansCode+'">'+ansTxt+'</option>').appendTo('#question'+q2ID+' select.select');

}

// If option is unchecked...

else if($(this).attr('checked') == false) {

// Remove it from the rank choices

$('#question'+q2ID+' select.select option[value="'+ansCode+'"]').remove();

// Remove it from the rank output and reset hidden values

$('#question'+q2ID+' .output input[id<div class="simplebox">="fvalue_"][value="'+ansCode+'"]').attr('value', '').siblings('input.text').val('').siblings('img').hide();

}

});

// Clean up empty inputs in the rank output table

$('#question'+q2ID+' .output table tr').each(function(i) {

var nextRow = $(this).next('tr');

if($('input.text', this).val() == '' && $('input.text', nextRow).val() != '') {

$('input.text', this).val($('input.text', nextRow).val());

$('input.text', nextRow).val('');

$('input[id</div>="fvalue_"]', this).attr('value', $('input[id<div class="simplebox">="fvalue_"]', nextRow).attr('value'));

$('input[id</div>="fvalue_"]', nextRow).attr('value', '');

}

});

// Show the scissors for the last populated rank output row

$('#question'+q2ID+' .output table img[id<div class="simplebox">="cut_"]').hide();

$('#question'+q2ID+' .output table input.text[value!=""]:last').siblings('img[id</div>="cut_"]').show();

// Hide extra rank output rows

var optNum = $('#question'+q1ID+' input.checkbox:checked').length;

$('#question'+q2ID+' .output table tr').hide();

$('#question'+q2ID+' .output table tr:lt('+(optNum+1)+')').show();

// Hide and clear the ranking question if there are less than 2 checked options in Q1

if(optNum < 2) {

$('#question'+q2ID+'').hide();

$('#question'+q2ID+' input.text').val('');

$('#question'+q2ID+' input[id<div class="simplebox">="fvalue_"]').attr('value', '');

}

else {

$('#question'+q2ID+'').show();

}

// A work around for the built in max-answers function

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.output tr:visible').each(function(i) {

if($('input.text', this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

}

// A listener to work around the built in max-answers function

$('#question'+q2ID+' td.rank').click(function (event) {

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.item input.text').each(function(i) {

if ($(this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

});

}

</syntaxhighlight>

'''FOR BOTH FILTER AND RANKING QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and a ranking question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question.
*The function will hide the ranking question unless at least two options are selected in the multiple options question, in which case, it will only show the options selected.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND RANKING QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and a ranking question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question. Do not modify the "1".
*The function will hide the multiple options question. If at least 2 options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the ranking question.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR, 1);

});

</script>

</syntaxhighlight>

=Filter "Array by Column" Question With "Multiple-Options"=

''Tested with: 1.91, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

This workaround applies a filter to an "Array by Column" question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and array questions being on the same page and a slightly different one for the filter question being on a page before the array question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=74213&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following scripts in your template.js file. These functions will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

function filterArrByCol(qMultiOpt, qArray, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+qMultiOpt+' li[id</div>="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+qMultiOpt+'').hide();

}

// Assign classes to the answer cells

$('#question'+qArray+' table.question tbody td').each(function(i){

var classArr = $(this).attr('class').split('answer_cell_00');

var ansCode = classArr[1];

$(this).addClass('ans-'+ansCode+' filtered');

});

// Assign classes to the answer label cells

$('#question'+qArray+' table.question tbody tr:eq(0) td').each(function(i){

var classArr2 = $(this).attr('class').split(' ans-');

var ansCode2 = classArr2[1];

$('#question'+qArray+' table.question thead tr:eq(0) th:eq('+i+')').addClass('ans-'+ansCode2+'');

});

// Fire the filter function on page load

filterArr(qMultiOpt, qArray);

// Listener on multi-opt checkboxes to fire the filter function

$('#question'+qMultiOpt+' input.checkbox').click(function(){

filterArr(qMultiOpt, qArray);

});

// On submit, clear all hidden radios of array

$('#movenextbtn, #movesubmitbtn').click(function(){

$('#question'+qArray+' td.filtered:hidden').each(function(i){

$('input.radio', this).attr('checked', false);

});

return true;

});

}

function filterArr(qMultiOpt, qArray) {

if($('#question'+qMultiOpt+' input.checkbox:checked').length < 1) {

// Hide the array if no multi-opt options are checked

$('#question'+qArray+'').hide();

}

else {

$('#question'+qArray+'').show();

// Hide all columns of array

$('#question'+qArray+' table.question tbody td, #question'+qArray+' table.question thead th').hide();

// Loop through multi-opt checkboxes and, if checked, show corresponding column of array

$('#question'+qMultiOpt+' input.checkbox').each(function(i){

if($(this).attr('checked') == true) {

var classArr3 = $(this).attr('id').split('X'+qMultiOpt);

var ansCode3 = classArr3[1];

$('#question'+qArray+' .ans-'+ansCode3+'').show();

}

});

}

}

});

</syntaxhighlight>

'''FOR BOTH FILTER AND ARRAY QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and an array-by-column question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the ranking question.
*The function will hide the array question unless at least one option is selected in the multiple-options question, in which case, it will only show the corresponding array column(s).<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND ARRAY QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and an array-by-column question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the array question. Do not modify the "1".
*The function will hide the multiple options question. If options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the array columns.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA, 1);

});

</script>

</syntaxhighlight>

=Auto-tabbing between text input fields=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

This is a workaround to facilitate auto-tabbing between text input questions in a single group using a [http://plugins.jquery.com/project/autotab jQuery plugin by Mathachew] and the Maximum characters attribute of questions.

The behaviour will be: When the maximum number of characters has been entered into an input field, the focus (cursor) will be automatically moved to the next input field. When the backspace key is used to remove all characters from a field, the focus will be moved to the previous field. It's very useful in surveys having many text input questions to avoid having to manually tab or click between fields.

You can view a small demo survey [http://www.partnersinc.biz/surveys//index.php?sid=11327&newtest;=Y&lang;=en here].

Implementation is as follows:
#Visit [http://plugins.jquery.com/node/4046 http://plugins.jquery.com/node/4046], download the plugin script and save it as ''jquery.autotab-1.1b.js'' in the template folder.
#Link to the script by placing ''<script type="text/javascript" src="{TEMPLATEURL}jquery.autotab-1.1b.js"></script>'' within the ''<head>'' tag of startpage.pstpl.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Create the text based questions that auto-tabbing is to be applied to. (All must be in the same group if you're using group by group presentation)
#Define a Maximum characters attribute for all questions that the autotab is applied to. (See [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#maximum_chars documentation here])
#In the source of the first question of the group that contains the auto-tabbed questions, add the following code.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answerSSSSSXGGXAA').focus(); //initially focus on the first input

$('#answerSSSSSXGGXAA').autotab({ target: 'answerSSSSSXGGXBB' });

$('#answerSSSSSXGGXBB').autotab({ previous: 'answerSSSSSXGGXAA', target: 'answerSSSSSXGGXCC' });

$('#answerSSSSSXGGXCC').autotab({ previous: 'answerSSSSSXGGXBB', target: 'answerSSSSSXGGXDD' });

$('#answerSSSSSXGGXDD').autotab({ previous: 'answerSSSSSXGGXCC' });

});

</script></syntaxhighlight>

This example has 4 fields to be auto-tabbed between - all instances of the following must be replaced to be compatible with your survey (See image below):
*SSSSS -> Survey ID
*GG -> Group ID
*AA -> First question
*BB -> Second question
*CC -> Third question
*DD -> Last question

[[File:ids_343x252.gif]]

The ''target'' parameter defines where the next input is and the ''previous'' parameter defines (you guessed it) the previous input.

This plugin also has limited capability of formatting the input text - see comments in the plugin script.

=Custom response listeners=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

Listeners can be used to perform functions when a change in an input is detected. There are many uses such as the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds#Reverse_array_filter Reverse array_filter] but a simple one would be to warn a respondent if they enter a value that may be too high.

We can use the [http://docs.jquery.com/Events/change jQuery change( ) event] to fire a function whenever there is a change to the input. The function will look for an input value higher than 10 and, if found, will warn the respondent.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page where:
**11111 is the survey ID
**22 is the group ID
**33 is the question ID

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer11111X22X33').change(function() {

if ( $('#answer11111X22X33').val() > 10 ) {

alert ("That's an awful lot. Are you sure?");

}

});

});

</script></syntaxhighlight>

=Text input masks=

''Tested with: 1.90+, IE 7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">We're considering adding this as a built-in feature for version 1.92 (e.g. an advanced question attribute).</div>

There may be instances where you would like to place a mask on a text input - for example only allowing respondents to enter the correct characters for a North American phone number [[Expression Manager|Expression Manager]] rand() function. This can be part of a relevance equation to randomly control which questions are shown; or you can create an Equation question type to store the random value, and let that question be part of downstream relevance equations.</div>

This workaround allows you to generate a random number and then populate a hidden question with that number. You can then use this question to control the display of subsequent questions with [http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions]. It's useful if you have several sets of questions that you would like to randomly present to participants - see this [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/29579-experiment-with-random-questions.html forum post].

There is a small demo [http://www.partnersinc.biz/surveys//index.php?sid=12659&newtest;=Y&lang;=en here].

In the demo, in the first group, we generate a random number between 1 and 4 and populate a hidden question with it. Then in the second group we have 4 questions, each showing conditional on the answer of the first question.

Implementation for this demo is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the first group add a "Short free text" question (We're going to hide this with JavaScript)
#In the source of that question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#In the following groups add the questions that are conditional on the answer of the first question.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function Custom_On_Load(){

$(document).ready(function() {

// Find a random number between 1 and 4

var randNumber = Math.floor(Math.random()*4 + 1);

// Populate and hide the hidden question

$('input#answerSSSSSXGGXQQ').val(randNumber);

$('#questionQQ').hide();

/***********************************************************/

// This just tells the user which number has been selected

// You can remove this from your onload function

$('input#setNumber').val(randNumber);

$('input#setNumber').css({

'margin-left':'0.5em',

'width':'1.5em',

'text-align':'center',

'font-weight':'bold'

});

$('input#setNumber').attr('disabled', true);

/***********************************************************/

});

}

</script>

</syntaxhighlight>

Where '''SSSSS''' is the survey ID, '''GG''' is the group ID and '''QQ''' is the hidden question ID.

Increase or decrease the maximum value of the random number by modifying the first section. For example to get a number between 1 and 10 you would use this:

<syntaxhighlight lang="php" enclose="div">

var randNumber = Math.floor(Math.random()*10 + 1);

</syntaxhighlight>

The third section of code just populates a placeholder element that I use to tell the participant what's going on. You can remove it from your code.

=Minimum number of required answers in an array=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2,''

<div class="simplebox">As of version 1.92 all array style questions have the min_answers and max_answers options, so this script is obsolete.</div>

This workaround allows you to specify a '''minimum number''' of answers required in an array question. It is an alternative to the "Mandatory" parameter which specifies that '''all''' answers are required. It could also be easily modified to specify a maximum number of answers.

We accomplish this by placing an onload function in the source of the array question. This function hides the Next/Submit button and displays a warning element until it detects a minimum number of responses. It then hides the warning and shows the Next/Submit button.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=97166&newtest;=Y&lang;=en here].

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the source of the array question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Modify the ''SETTINGS'' section of the code as required.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

// Wait until the document is fully loaded

$(document).ready(function() {

/********************** SETTINGS **********************/

// The text to appear in the warning element

var warningText = 'Please answer at least 4 to continue';

// The question ID

var questionId = 137;

// The minimum number of answers required

var minNumber = 4;

/******************************************************/

// Create the warning element and place it after the submit button

var el = document.createElement('div');

el.setAttribute('id','warning');

document.body.appendChild(el);

$( '#warning' ).css({

'border':'1px solid #333333',

'width':'200px',

'padding':'3px',

'color':'red'

});

$('#warning').html(warningText);

$('input[type="submit"]').after($('#warning'));

// Detect the initial number of checked answers & display Next/Submit button accordingly

var inputInitCount = 0;

$('#question' + questionId + ' input').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputInitCount++;

}

});

if (inputInitCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// Listener to detect number of checked answers & display Next/Submit button accordingly

$('#question' + questionId + ' input.radio, #question'+questionId+' tbody[id<div class="simplebox">="javatbd"] td').click(function() {

var inputCount = 0;

$('#question' + questionId + ' input.radio').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputCount++;

}

});

if (inputCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// The original functions of the click event

checkconditions(this.value, this.name, this.type);

});

});

</script>

</syntaxhighlight>

=Minimum elapsed time before moving forward in survey=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

This workaround interrupts the Next/Submit function and checks the amount of time elapsed since the page loaded. If the time is less than the minimum dictated, the respondent is alerted and not allowed to proceed. It is useful if you want to enforce a minimum amount of time spent viewing a page.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page, replacing "TT" with the minimum number of seconds required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minTime(TT);

function minTime(minTime) {

var startTime = new Date();

$('#movenextbtn, #movesubmitbtn').click(function(){

var endTime = new Date();

if[[endTime - startTime)/1000 <= minTime) {

alert ('You must spend at least '+minTime+' seconds on the question.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Minimum number of characters in Long free text or Huge free text questions=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

</div>As of version 1.91, you can use regular expression masks (validation) to specify the minimum number of required characters. However, even if the question is mandatory, it can still be blank.<div class="simplebox">

</div>As of version 1.92, if you make the question mandatory and use a validation mask to specify the minimum number of characters, then the user will be forced to answer the question. Note that unlike 1.91, they can submit their current answers, even if partially invalid (so they are stored in the database), but they will not ber able to proceed to the next page until they have passed all mandatory and validity checks.<div class="simplebox">

This workaround interrupts the Next/Submit function and checks the number of characters entered in a Long free text or Huge free text question. If the number is less than the minimum dictated, the respondent is alerted and not allowed to proceed.

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|Set up your survey to use JavaScript].

#Place the script below in the source of one of the questions on the page, replace "QQ" with the question ID and "CC" with the minimum number of characters required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minChar(QQ, CC);

function minChar(qID, minChars) {

$('#movenextbtn, #movesubmitbtn').click(function(){

if($('#question'+qID+' textarea').val().replace(/ /g,'').length < minChars) {

alert ('You must enter at least '+minChars+' characters.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Variable Length Array (Multi Flexible Text) question=

''Tested with: 1.90+, IE 6/7/8, FireFox 3.0, Safari 3.2''

This workaround allows a respondent to add or remove rows of an Array (Multi Flexible Text) question. It's useful to avoid the page being cluttered with unnecessary array rows.

A function is placed in the template.js file of your template (use template editor). This function hides all of the array rows except the first and inserts two elements that when clicked show or hide rows accordingly.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=53132&newtest;=Y&lang;=en|here].

It must be noted that you can not make this question Mandatory as the respondent will have no way to complete hidden fields. If you want the displayed fields to be mandatory you will need to validate them in another function or modify this function to only allow the addition of rows if all fields in the last row are completed and then disable those fields - that, however, is a little over the top for this example.

Implementation is as follows:

#Set up your survey to use JavaScript (See instructions [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|here])

#Add the following script to your ''template.js'' file.

#Replace "QQ" in the function call at the end with the question ID.

#Create one or more Array (Multi Flexible Text) questions

#If you want to apply it to more arrays on the same page simply add more calls with the appropriate question IDs. (eg. varLengthArray(1); varLengthArray(2);...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// A function to add or remove rows of an Array (Multi Flexible)(Text) question

function varLengthArray(qID) {

if ($('#question'+qID+'').length > 0) {

// The HTML content of the Add/Remove elements - modify as you wish

var addContent = '[+]';

var removeContent = '[-]';

// Create the Add and Remove elements & insert them

var el1 = document.createElement('div');

el1.setAttribute('id','addButton'+qID);

document.body.appendChild(el1);

var el2 = document.createElement('div');

el2.setAttribute('id','removeButton'+qID);

document.body.appendChild(el2);

// Move them to after the array

$( 'div#addButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent(]];

$( 'div#removeButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent());

// Insert their HTML

$( 'div#addButton'+qID ).html( addContent );

$( 'div#removeButton'+qID ).html( removeContent );

// Style the elements - you can modify here if you wish

$( 'div#addButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

$( 'div#removeButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

// Initially hide the Remove element

$( 'div#removeButton'+qID ).hide();

// Call the functions below when clicked

$( 'div#addButton'+qID ).click(function (event) {

addRow(qID);

});

$( 'div#removeButton'+qID ).click(function (event) {

removeRow(qID);

});

// Function to add a row, also shows the Remove element and hides the

//Add element if all rows are shown

function addRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

if ( $( arrayRow + ':eq(' + rowCount + ')' ).attr('name') == 'visible' ) {

$( 'div#addButton'+qID ).hide();

}

}

// Function to remove a row, also clears the contents of the removed row,

// shows the Add element if the last row is hidden and hides the Remove

// element if only the first row is shown

function removeRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="visible"]:last input[type="text"]' ).val('');

$( arrayRow + '[name="visible"]:last' ).attr('name', 'hidden').hide();

$( 'div#addButton'+qID ).show();

if ( $( arrayRow + ':eq(1)' ).attr('name') == 'hidden' ) {

$( 'div#removeButton'+qID ).hide();

}

}

// Just some initialization stuff

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = '';

// Initially hide all except first row or any rows with populated inputs

$( arrayRow ).each(function(i) {

if ( i > 0 ) {

// We also need to give the hidden rows a name cause IE doesn't

// recognize jQuery :visible selector consistently

$( this ).attr('name', 'hidden').hide();

$('input[type=text]', this).each(function(i) {

if ($(this).attr('value') != '') {

$(this).parents('tbody:eq(0)').attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

}

});

rowCount = i;

}

});

}

}

// Call the function with a question ID

varLengthArray(QQ);

});

</syntaxhighlight>

=Expandable Array=

''Tested with: 1.90+, IE 6/7, FireFox 3.5, Safari 3.2''

This workaround allows you to present an array question incrementally. That is to say that initially only the first option (row) in the array is shown. When that option is answered the next is shown and so-on.

A JavaScript function is placed in the source of the array question. This function hides all of the array rows except the first and then displays them as options are answered.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=94958&newtest;=Y&lang;=en here].

The workaround supports following question types:
*Array (flexible labels)
*Array (flexible labels) by column
*Array (Yes/No/Uncertain)
*Array (Increase, Same, Decrease)
*Array (Flexible Labels) dual scale
*Array (10 point choice)

Implementation is as follows:
#Set up your survey to use JavaScript. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ documentation here])
#Create one or more Array questions
#In the source of the first array question add the following script.
#Replace "QQ" in the function call at the end of the script with the question ID of the array you would like to manipulate.
#If you want to apply it to more arrays on the same page, simply add more calls with the appropriate question IDs. (eg. expandingArray(1); expandingArray(2);...)

Onload code:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript">

$(document).ready(function() {

// A function to show subsequent rows of an array as options are checked

function expandingArray(qID) {

// Build an array of the question rows

var arrayRow = '#question' + qID + ' table.question tbody tr';

// Initially hide all rows unless an input was previously checked

$( arrayRow ).each(function(i) {

if ( $( arrayRow + ':eq(' + i + ') input.radio:checked' ).length != 0 ) {

$( this ).attr('name', 'clickedRow');

}

else {

$( this ).attr('name', 'hidden').hide();

}

});

// Now show the first hidden row

addRow();

// Add another row when an option is checked for the first time

$( '#question' + qID + ' td.answer input.radio' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

// The original function of the click event

checkconditions(this.value, this.name, this.type);

});

// Add another row when an table cell is clicked for the first time

$( '#question' + qID + ' table.question tbody td' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

});

// Function to add a row

function addRow() {

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

}

}

// Call the function with a question ID

expandingArray(QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - Multiple Options & List (radio) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround allows the answers of Multiple Options & List (radio) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last as in the image below:

[[File:random_336x179gif.gif]]

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

Some conditions on the use of this are:
*For Select/radio type questions it will only work if the [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $shownoanswer option] is set to 0 in config.php. ("No answer" is removed from the end of questions)
*You must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple Options or List (radio) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRand(11111, 22, 1); partRand(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in Multiple options and List/radio questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' td.answer li' ).each(function(i) {

ansCount = (i + 1);

});

// Place the last answer created at the end of the list

$( 'input#answer' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).parent().appendTo($( '#question' + qID + ' td.answer ul' ));

}

// Call the function with the SID, GID and QID

partRand(SSSSS, GG, QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - List (dropdown) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround, similar to the one above, allows the answers of List (dropdown) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more List (dropdown) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers

//except the last one in List/dropdown questions

function partRandDD(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' select option' ).each(function(i) {

ansCount = i;

});

// Place the last answer created at the end of the list

$( 'option[value="' + ansCount + '"]' ).appendTo($( 'div#question' + qID + ' select' ));

}

// Call the function with the SID, GID and QID

partRandDD(89344, 72, 244);

});

</script>

</syntaxhighlight>

=Partially Randomized Answers - Multiple numerical input=

''Tested with: 1.90+, Safari 5.1''

This workaround, similar to the ones above, allows the answers of Multiple numerical input questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple numerical input question with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in multiple numeric input questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' div.answers li' ).each(function(i) {

ansCount = (i - 1);

});

// Place the last answer created at the end of the list - but before the first helping sum

$( 'li#javatbd' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).insertBefore($( 'div#question' + qID + ' div.answers li.multiplenumerichelp' ).first());

}

// Call the function with the SID, GID and QID

partRand(SID, GID, QID);

});

</syntaxhighlight>

Using this solution for Multiple numerical input questions might be a bit more complicated than for other question types. All answers are organized in an unordered list (<ul>) structure. However, if advanced question settings like ''Equals sum value'' are used, LimeSurvey adds helping information (e.g. sum of all entries and remainder) to the same unordered list using the class ''multiplenumerichelp'' for these additional list items. The above example assumes that at least one of these list items is present and moves the last answer to the position right above the first helper item. Without such advanced settings, the code will most certainly need adaptation.

=Making one (or more) rows of an array mandatory=

''Tested with: 1.90+, IE 6/7, Firefox 3.0, Safari 3.2''

This workaround allows you to define one or more rows of an array question as mandatory (instead of all of them which the "Mandatory" question setting does). It is [http://www.partnersinc.biz/surveys//index.php?sid=26842&newtest;=Y&lang;=en demonstrated here].

A JavaScript function interrupts the submit function and checks if the inputs in the mandatory row(s) are populated. If not, an alert is popped up, the offending inputs are turned pink and the submit is aborted. Otherwise the submit goes ahead.

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions (see [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here]).
#Create the array question.
#In the source of the array question add the following script (see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here]).
#Modify the warningText (line10)as required.
#Replace "QQ" (lines 13 and 14) with the question ID and add calls as necessary for more rows - the example code renders rows 1 and 3 mandatory.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function () {

// Interrupt the submit function

$('form#limesurvey').submit(function () {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var empty = 0;

var warningText = 'Please complete the highlighted inputs.';

// Call the mandatory row function with question IDs and row numbers

mandatoryRow(QQ, 1);

mandatoryRow(QQ, 3);

// A function to render rows of an array mandatory

function mandatoryRow(qID, rowNum) {

$('div#question' + qID + ' table.question tbody[id</div>="javatbd"]:eq(' + Number(rowNum - 1) + ') input[type="text"]').each(function (i) {

if ($(this).val() == '') {

$(this).css('background-color', 'pink');

empty = 1;

} else {

$(this).css('background-color', '#FFFFFF');

}

});

}

if (empty == 1) {

alert(warningText);

return false;

} else {

return true;

}

});

});

</script></syntaxhighlight>

=Randomly displaying one of a few YouTube videos, and recording which was displayed=

''Tested in 1.85+''

Jason Cleeland has created and documented a method to randomly display one of a number of youtube videos in a single question, and save which one was displayed.

http://www.aptigence.com.au/home/archives/23-Random-display-of-videos-in-a-question-2-YouTube.html

=Randomly displaying one of a few pictures, and recording which was displayed=

''Tested in 1.91+''

The following steps allow you to randomly display one of a few pictures and record in the dataset which picture was displayed. We use four pictures in this example, but you can easily adapt these scripts according to your needs.

1. Create a new sub-directory '''pic''' in your LimeSurvey folder.

2. Copy four pictures (named ''1.jpg'', ''2.jpg'', ''3.jpg'', and ''4.jpg'') in this pic sub-directory.

3. Deactivate the ''Filter HTML for XSS'' function in LimeSurvey's ''Global Settings''.

4. Create a '''Short free text''' question where you want these pictures to be displayed.

5. Figure out the [http://docs.limesurvey.org/SGQA+identifier SGQA Identifier] of this question (e.g., 12345X67X89).

6. Paste the following code as question text after activating the editor's ''Source'' view and replace both SSSSSXGGXQQ strings with your SGQA identifier:

<syntaxhighlight lang="javascript" enclose="div">

Please have a look at this picture:

<br />

<script>

$(document).ready(

function(){

// Find a random number (here between 1 and 4)

var randNumber = Math.floor(Math.random()*4 + 1);

// Save the number as answer of this question

$('input#answerSSSSSXGGXQQ').val(randNumber);

// Hide this answer field

document.getElementById("answerSSSSSXGGXQQ").style.display='none';

// Show the picture

picString = '<img src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<p>

</p>

<div id="pic">

</div>

</syntaxhighlight>

If you want to display the number of this picture in a later question, use the following code as question text (don't forget to replace the SSSSSXGGXQQ string acordingly):

<syntaxhighlight lang="javascript" enclose="div">

You saw picture number {INSERTANS:SSSSSXGGXQQ}.

</syntaxhighlight>

Perhaps you want to display the same picture again in a later question, but a little bit smaller (100px width, 100px height)? Just paste the following code as question text after activating the editor's ''Source'' view, and replace the SSSSSXGGXQQ string acordingly:

<syntaxhighlight lang="javascript" enclose="div">

Here you see the picture again: <br>

<script>

$(document).ready(

function(){

// Get the picture number from previous question

var randNumber = "{INSERTANS:SSSSSXGGXQQ}";

// Show picture

picString = '<img width="100" height="100" src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<div id="pic">

</div>

</syntaxhighlight>

=Multiple numerical input with max_num_value defined in token (personalized limit)=

''Tested in 1.85+''

<div class="simplebox">As of version 1.92, max_num_value can be an experession, so you can simply enter the {TOKEN} or other variable in that question attribute.</div>

To make personalized survey with multiple numerical input when max_num_value (Maximum sum value) is different for each user and is loaded from the token use following tricks:
*Create 1st group with numerical input field (1000X10X11). "Limit"
*Add java script into this question:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

function Custom_On_Load(){

document.getElementById('answer1000X10X11').value='{TOKEN:ATTRIBUTE_1}';

document.getElementById('answer1000X10X11').readOnly=1;

}

</script>

</syntaxhighlight>

where:

TOKEN:ATTRIBUTE_1 is individual limit defined in token.

readOnly=1 // user shouldn't change it.
*Create 2nd group with multiple numerical input and add "Max value from SGQA" with 1000X10X11 as argument.

Note: If you don't want to show first field with numerical input (and show definied limit in different way) you can add 2 lines to above script to hide whole question:

<syntaxhighlight lang="javascript" enclose="div">

document.getElementById('question85').style.display='none';

document.getElementById('display85').value='';

</syntaxhighlight>

where:

question85 and display85 are field names.

Note: It's no possible to create it into one group, because all SGQA references can only refer to data on a previous page because when clicking next the answer is stored at the DB and the SGQA is replaced by querying the database.

=Default values in array questions=

''Tested with: 1.87+ (7557), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of Version 1.92, many more question types support default values.</div>

This workaround uses JavaScript to allow you to pre-check default answers in all sub-questions of an array type question. You can select a column of the array to be checked as the page loads. The script first checks to see if a sub-question has already been answered and, if not, checks the default answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#Create the array question.
#In the source of the array question add the following script.
#Replace"QQ" with the question ID and "CC" with the column number to be checked.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// A function to pre-check a column of an array

function checkedDefault(qID, column) {

var checkedCol = column - 1;

$('#question' + qID + ' table.question tbody tr').each(function(i) {

if ($('input.radio[checked=true]', this).length == 0) {

$('input.radio:eq(' + checkedCol + ')', this).attr('checked', true);

}

});

}

// Call the function with a question ID and column number

checkedDefault(QQ, CC);

});

</script>

</syntaxhighlight>

=Record group view time=

''Tested with: 1.87+ (8518), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of version 1.92, group view time is accurately recorded in the timings table if you choose the Record Timings survey option.</div>

This workaround uses JavaScript to populate a hidden question with the total time that a respondent views a group. If used in a group with only one question, it could be used to track the amount of time required to answer the question.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#In the group, create a short-text question. We will hide this later with JavaScript and populate it with the elapsed time.
#Place the following script in the source of the short-text question.
#Replace "QQ" in line 6 with the ID of the short-text question.

The script populates the hidden question with the elapsed time since the group was opened. If a respondent leaves the group and then returns, the timer continues up from the elapsed time of the last visit.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// call the functions with the hidden timer question ID

runTimer(QQ);

function runTimer(timeQID) {

$('#question'+timeQID).hide();

var initSec = '0';

// Check for elapsed time from previous visits

if ($('#question'+timeQID+' input.text').val()) {

var initTime = $('#question'+timeQID+' input.text').val();

initTimeArr = initTime.split(':');

initSec = Number[[initTimeArr[0]*3600]]+Number[[initTimeArr[1]*60]]+Number(initTimeArr[2]);

}

// Run the timer update function

recordTime(initSec, timeQID);

}

});

// Timer update function

function recordTime(elapsedSec, timeQID){

elapsedSec++;

var h = Math.floor(elapsedSec / 3600);

var m = Math.floor(elapsedSec % 3600 / 60);

var s = Math.floor(elapsedSec % 3600 % 60);

var elapsedTime = [[h > 0 ? h + ":" : "00:") + (m > 0 ? (m < 10 ? "0" : "") + m + ":" : "00:") + (s < 10 ? "0" : "") + s);

$('#question'+timeQID+' input.text').val(elapsedTime);

// Run the timer update function every second

setTimeout('recordTime('+elapsedSec+', '+timeQID+')',1000);

}

</script>

</syntaxhighlight>

=Toggle visibility of groups=

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

<div class="simplebox">Version 1.92 supports group-level relevance, making this workaround obsolete.</div>

This workaround uses JavaScript to toggle the visibility of groups in an "all in one" survey. Initially the groups are hidden and there are links inserted to display the groups. It's useful to avoid the page being cluttered with many groups and lets the respondent focus on one at a time.

It's [http://www.partnersinc.biz/surveys//index.php?sid=33613&newtest;=Y&lang;=en|demonstrated here].

Implementation is as follows:

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._|Set up your survey to use JavaScript].

#Set the survey to run in "all in one" mode.

#Add your groups and questions.

#Place the following script in the source of one of the questions in the first group.

The comments in the script are pretty self-explanatory but it does the following:

#initially hides all of the groups

#inserts a link above each one to toggle its display

#some styles are added to the clickable links but these could be done in template.css instead

#shows any groups that have an unanswered mandatory after a submit attempt

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Insert show/hide elements before all group wrapper divs

$('<div class="groupToggler"><span></span></div>').insertBefore('div[id<div class="simplebox">="group-"]');

// Add some text to the show/hide elements

$('.groupToggler span').each(function(i) {

($( this ).text('Show/Hide Group '+(i+1)+'']];

});

// Add some styles to the show/hide elements

$('.groupToggler').css({

'padding':'5px 0 10px 0',

'text-align':'center'

});

$('.groupToggler span').css({

'text-decoration':'underline',

'cursor':'pointer'

});

// Add some hover effects to the show/hide elements

$(".groupToggler span").hover(

function () {

$(this).css({

'text-decoration':'none',

'font-weight':'bold'

});

},

function () {

$(this).css({

'text-decoration':'underline',

'font-weight':'normal'

});

}

);

// Initially hide all of the groups

// Toggle their visibility when the show/hide element is clicked

$('.groupToggler span').click(function() {

$(this).parent().next().toggle();

return false;

}).parent().next().hide();

// Display any groups that have unanswered mandatories

$('.errormandatory').parents('div[id</div>="group-"]').show();

});

</script>

</syntaxhighlight>

=Use jQuery Autocomplete plugin to suggest answers for text inputs=

== 1.90 and previous versions==

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://docs.jquery.com/Plugins/Autocomplete jQuery Autocomplete] plugin to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

I've put together a small demonstration [http://www.partnersinc.biz/surveys//index.php?sid=78611&newtest;=Y&lang;=en here] and implementation is as follows.

'''Both methods:'''
*[http://docs.jquery.com/Plugins/Autocomplete Download the plugin]
*Place the files ''jquery.autocomplete.css'' and ''jquery.autocomplete.js'' in your template directory
*Add the following code inside the <head> element of startpage.pstpl

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.autocomplete.js"></script>

<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}jquery.autocomplete.css" /></syntaxhighlight>

'''Method 1 ("States" question in the demo):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete(states, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

'''Method 2 ("Countries" question in the demo):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var countriesArr = new Array();

$.getJSON(url,function(data){

$(data).each(function(i, item){

countriesArr.push(item);

});

$('#question'+qID+' input.text').autocomplete(countriesArr, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

== 1.91 and later versions==

''Tested with: 1.91+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

'''Both methods:'''
*Add the following styles to the end of your 'template.css' file

<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>

'''Method 1 (use local JavaScript array for data):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete({

source: states

});

});

</script></syntaxhighlight>

'''Method 2 (use remote CSV file for data):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var dataArr = [];

$.getJSON(url,function(data){

$.each(data,function(i, item){

dataArr.push(item);

});

$('#question'+qID+' input.text').autocomplete({

source: dataArr

});

});

});

</script></syntaxhighlight>

== Use autocomplete to populate several fields==

''Tested with: 1.91+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI and the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin to provide a respondent with a list of suggested answers as they type in a text input and then to automatically populate other fields depending on the selection.

For example, if you have 3 questions - "Name", "ID" and "Email" - you can use this workaround to autocomplete the "Name" question and then the "ID" and "Email" questions can be automatically populated with values associated with the selected name.
*Download the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin and place it in your template folder
*Add the following line to your startpage.pstpl BEFORE the tag for template.js<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.csv.js"></script></syntaxhighlight>
*Create your CSV file with 3 columns (name, ID, email) as in this example and place it in your template folder<syntaxhighlight lang="php" enclose="div">Bob, Bob's ID, Bob's email

Andy, Andy's ID, Andy's email

Sam, Sam's ID, Sam's email

Tony, Tony's ID, Tony's email

Fred, Fred's ID, Fred's email</syntaxhighlight>
*Create your 3 questions - "Name", "ID" and "Email". They must be in the same group/page.
*Add the following styles to the end of your 'template.css' file<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>
*Add the following script to the source of one of the questions
*Replace:
**"NN" with the "Name" question ID
**"II" with the "ID" question ID
**"EE" with the "Email" question ID
*Modify the path to your CSV file<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qNameID = NN;

var qIDID = II;

var qEmailID = EE;

var url = "upload/templates/yourTemplate/yourCsvFile.csv";

// Create an array to hold the names

var namesArr = new Array();

// Grab the CSV contents

$.get(url,function(data){

// Convert CSV contents to an array of arrays

fullArray = jQuery.csv()(data);

// Load the names array

$(fullArray).each(function(i, item){

namesArr.push(item[0]);

});

// Initialise the autocomplete plugin

$('#question'+qNameID+' input.text').autocomplete({

source: namesArr,

// Event fired when a selection is made (ui.item.value refers to the selected item)

select: function(event, ui) {

// Find the "ID" and "Email" values associated with the selected name value and load those questions

$(fullArray).each(function(i, item){

if(item[0] == ui.item.value) {

// The value from column 2 of the CSV

$('#question'+qIDID+' input.text').val(item[1]);

// The value from column 3 of the CSV

$('#question'+qEmailID+' input.text').val(item[2]);

}

});

}

});

});

});

</script></syntaxhighlight>

=Drag and Drop Rankings=

==Drag and Drop Ranking - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround is a modification of the workaround below and also uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables]. Thanks to the author of that workaround.

[[File:Untitled-12.png]]

Modifications include:
*Allow for multiple drag-n-drop ranking questions on a page
*Handle minimum and maximum answers settings
*Allow double clicking of items to add or remove them from the ranking list
*Work with the new shipped jQuery UI

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the large script below in your template.js file.
#Place the small script below in the source a ranking question, (this applies the "dragDropRank" function to the question). Replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID].
**Note: the LimeSurvey translations will be automatically used for the "Choices" and "Rankings" header labels but can be overridden with custom labels - see the example calls below.
#Insert the CSS below at the end of template.css (these styles are for the default template).

NOTE: I have not tested this workaround with conditions.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRank(qID, choiceText, rankText) {

if(!choiceText) {

choiceText = $('#question'+qID+' td.label label').text();

}

if(!rankText) {

rankText = $('#question'+qID+' td.output tr:first td:eq(1)').text();

}

//Add a class to the question

$('#question'+qID+'').addClass('dragDropRanking');

// Hide the original question in LimeSurvey (so that we can replace with drag and drop)

$('#question'+qID+' .rank, #question'+qID+' .questionhelp').hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

//$('#display'+qID).val('off');

// Add connected sortables elements to the question

var htmlCode = '<table class="dragDropTable"> \

<tbody> \

<tr> \

<td> \

<span class="dragDropHeader choicesLabel">'+choiceText+'</span><br /> \

<div class="ui-state-highlight dragDropChoices"> \

<ul id="sortable1'+qID+'" class="connectedSortable'+qID+' dragDropChoiceList"> \

<li>Choices</li> \

</ul> \

</div> \

</td> \

<td> \

<span class="dragDropHeader rankingLabel">'+rankText+'</span><br /> \

<div class="ui-state-highlight dragDropRanks"> \

<ol id="sortable2'+qID+'" class="connectedSortable'+qID+' dragDropRankList"> \

<li>Ranks</li> \

</ol> \

</div> \

</td> \

</tr> \

</tbody> \

</table>';

$(htmlCode).insertAfter('#question'+qID+' table.rank');

// Remove placeholder list items (have to have one item so that LimeSurvey doesn"t remove the <ul>)

$('#sortable1'+qID+' li, #sortable2'+qID+' li').remove();

// Load any previously-set values

loadDragDropRank(qID);

// Find the number of LimeSurvey ranking inputs ("Maximum answers")

var maxAnswer = $('#question'+qID+' td.output input.text').length;

// Set up the connected sortable

$('#sortable1'+qID+', #sortable2'+qID+'').sortable({

connectWith: '.connectedSortable'+qID+'',

placeholder: 'ui-sortable-placeholder',

helper: 'clone',

revert: 50,

receive: function(event, ui) {

if($('#sortable2'+qID+' li').length > maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

$(ui.sender).sortable('cancel');

}

},

stop: function(event, ui) {

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

}).disableSelection();

// Get the list of choices from the LimeSurvey question and copy them as items into the sortable choices list

$('#CHOICES_' + qID).children().each(function(index, Element) {

var liCode = '<li class="ui-state-default" id="choice_' + $(this).attr("value") + '">' + this.text + '</li>'

$(liCode).appendTo('#sortable1'+qID+'');

});

// Allow users to double click to move to selections from list to list

$('#sortable1'+qID+' li').live('dblclick', function() {

if($('#sortable2'+qID+' li').length == maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

return false;

}

else {

$(this).appendTo('#sortable2'+qID+'');

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

});

$('#sortable2'+qID+' li').live('dblclick', function() {

$(this).appendTo('#sortable1'+qID+'');

$('#sortable2'+qID+'').sortable('refresh');

$('#sortable1'+qID+'').sortable('refresh');

updateDragDropRank(qID);

});

}

// This function copies the drag and drop sortable data into the LimeSurvey ranking list.

function updateDragDropRank(qID)

{

// Reload the LimeSurvey choices select element

var rankees = [];

$('#sortable2'+qID+' li').each(function(index) {

$(this).attr('value', index+1);

// Get value of ranked item

var liID = $(this).attr("id");

liIDArray = liID.split('_');

// Save to an array

rankees[rankees.length] = { "r_name":$(this).text(),"r_value":liIDArray[1] };

});

$('#question'+qID+' input[name<div class="simplebox">="RANK_"]').each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

//alert (rankees[index].r_value);

$(this).next('input').attr('value', rankees[index].r_value);

} else {

$(this).val('');

$(this).next().val('');

}

});

// Reload the LimeSurvey choices select element (we need this for "Minimum answers" code)

$('#question'+qID+' td.label select option').remove();

$('#sortable1'+qID+' li').each(function(index) {

var liText = $(this).text();

var liID = $(this).attr('id');

liIDArray = liID.split('_');

var optionCode = '<option value="'+liIDArray[1]+'">'+liText+'</option>';

$(optionCode).appendTo('#question'+qID+' td.label select');

});

// Hack for IE6

if ($.browser.msie && $.browser.version.substr(0,1)<7) {

$('#question'+qID+' select').show();

$('#question'+qID+' select').hide();

}

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadDragDropRank(qID)

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$('#question'+qID+' input[name</div>="RANK_"]').each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { "r_name":$(this).val(),"r_value":$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won"t* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

var liCode = '<li class="ui-state-default" id="choice_' + value.r_value + '">' + value.r_name + '</li>';

$(liCode).appendTo('#sortable2'+qID+'');

});

}

</syntaxhighlight>

'''Code in the source of the question(s) using the LimeSurvey translations for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ);

});

</script>

</syntaxhighlight>

'''Code in the source of the question(s) using custom text for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ, 'Custom Choices Label', 'Custom Rankings Label');

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop ranking styles */

.dragDropTable {

border: 0 none;

border-collapse: collapse;

width: 100%;

}

.dragDropTable td {

vertical-align: top;

width: 50%;

padding-right: 20px;

}

.dragDropTable .dragDropHeader {

font-weight: bold;

}

.dragDropTable .dragDropChoices,

.dragDropTable .dragDropRanks {

margin: 5px 0 0 0;

background: transparent none;

border: 0 none;

}

.dragDropTable .dragDropChoiceList,

.dragDropTable .dragDropRankList {

float: left;

width: 100%;

min-height: 2.4em;

_height: 2.4em; /* IE6 and below hack */

margin: 0;

padding: 0;

list-style-type: none;

background: #FBFBFB none;

border: 1px solid #CCCCCC;

}

.dragDropTable .dragDropChoiceList li,

.dragDropTable .dragDropRankList li {

margin: 3px;

*margin-left: -13px; /* IE7 and below */

padding: 3px;

min-height: 1.3em;

_height: 1.3em; /* IE6 and below hack */

font-weight: normal;

cursor: move;

display: block; /* Force the li to full width */

}

</syntaxhighlight>

==Drag and Drop Ranking using Images - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround works in conjunction with the above workaround to allow ranking of images.

[[File:Untitled-11.png]]

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:

1) Follow the above workaround to get basic drag-n-drop functionality in your ranking question.

2) Insert your images in the ranking question text or help section after any text that you wish to have there (we'll move them later with JavaScript).

3) Give the images '''EXACTLY''' the same IDs as the answer code you would like them to be associated with:[[File:Untitled-8.png]]

4) Place the first script below in your template.js file.

5) Place the second script below in the source the ranking question '''AFTER''' the initial call for the dragDropRank function from the workaround above. Replace "QQ" with the ID of the ranking question (this applies the "dragDropRankImages" function to the question).

6) Insert the CSS below at the end of template.css. Replace "11" with your question ID. These styles are for the default template using 50x50px images (as in the demo) and may need to be modified for other templates or image sizes.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRankImages(qID) {

$('.connectedSortable'+qID+' li').each(function(i) {

// Remove any text in the sortable choice or rank items

$(this).text('');

// Move the images into the appropriate sortable list item

var liID = $(this).attr('id');

liIDArray = liID.split('_');

$('#question'+qID+' img#'+liIDArray[1]+'').appendTo(this);

});

}

</syntaxhighlight>

'''Code in the source of the question(s):'''

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRankImages(QQ);

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop for ranking images */
#question11 .dragDropTable {

width: auto;

}
#question11 .dragDropTable .dragDropChoiceList,
#question11 .dragDropTable .dragDropRankList {

min-height: 60px;

_height: 60px; /* IE6 and below hack */

width: auto;

min-width: 60px;

_width: 60px; /* IE6 and below hack */

}
#question11 .dragDropTable li {

background: 0 none;

border: 0 none;

height: 50px;

width: 50px;

}
#question11 .dragDropTable li img {

margin: 0;

padding: 0;

border: 0 none;

}

</syntaxhighlight>

==Drag and Drop Ranking for iPad - Version 1.91 and newer==

''Tested with: LimeSurvey 1.91, iPad 2''

This workaround extends the above workarounds to work with the touch interface on iPads.

1) Follow the "[http://docs.limesurvey.org/Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#Drag_and_Drop_Ranking_-_Version_1.90_and_newer Drag and Drop Ranking - Version 1.90 and newer]" workaround above to get basic drag-n-drop functionality in your ranking question.

2) Download the [https://github.com/furf/jquery-ui-touch-punch jQuery.ui.touch-punch.js plugin] and save it in your template directory.

3) Replace this line in your startpage.pstpl:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>With this:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.ui.touch-punch.js"></script>

<script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>

==Drag and Drop Ranking - Version 1.86==

Tested with 1.86 on IE 7,8, FireFox 3, Chrome, and Safari 4

This workaround uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables] to modify a ranking question and allow the survey taker to drag and drop choices instead of clicking. The nice thing is that the choices can be easily re-arranged or removed from the ranking, all by drag and drop.

I used it for a voting application and some of the element names reflect that use.

It looks best when some CSS is added to control the appearance of the boxers around each choice.

[[File:drag-n-drop.png]]

<syntaxhighlight lang="php" enclose="div">

// Question ID global variable

var questionID;

$(document).ready(function() {

// Grab the question ID[[File:drag-n-drop.png]]

// This is something with a class of "ranking" and an ID that starts with "questionXXXXX". The X's represent the question ID

var entire_questionID = $(".ranking[id<div class="simplebox">='question']").attr('id');

// Get just the question number (ID)

var patt=/\d+$/;

questionID=patt.exec(entire_questionID);

// Hide the original quetion in LimeSurvey (so that we can replace with drag and drop)

$(".rank, .questionhelp").hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

$("#display"+questionID).val("off");

// Add connected sortables to the question

var html_code = "<table style='border: medium none ; width: 770px; margin-left: auto; \

margin-right: auto;'><tbody><tr><td style='width: 590px; vertical-align: top;'><h3>List of Candidates:</h3> \

<div class='ui-state-highlight' style='margin: 5px; float: left;' id='ballot_list'> \

<ul id='sortable1' class='connectedSortable'><li>Candidates</li></ul></div></td> \

<td style='vertical-align: top;'><h3>Your selections:</h3><div class='ui-state-highlight' \

style='margin: 5px; float: left;' id='voting_selections'><ol id='sortable2' class='connectedSortable'> \

<li>Voting Area</li></ol></div></td></tr></tbody></table>";

$(html_code).appendTo("#question" + questionID);

// Remove list items (have to have one item so that LimeSurvey doesn't remove the <ul>)

$("#sortable1 li, #sortable2 li").remove();

// Load any previously-set values

loadRanking();

// Load jQuery UI

$.getScript("/scripts/jquery/jquery-ui.js", function() {

// After JQuery UI finishes loading, set up the connected sortable.

$("#sortable1, #sortable2").sortable({

connectWith: '.connectedSortable',

placeholder: 'ui-sortable-placeholder',

stop: function(event, ui) {

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

}

}).disableSelection();

// Get the list of candidates from the built-in LimeSurvey question and copy them as items in sortable1

$("#CHOICES_" + questionID).children().each(function(index, Element) {

li_tag = "<li class='ui-state-default' id='choice_" + $(this).attr('value') + "'>" + this.text + "</li>"

$(li_tag).appendTo("#sortable1"); } );

// Make sure the submit button is showing

$(":submit[value|=' Submit']").show();

// Show a confirmation alert upon submit

$("form").submit(function() {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var validated = confirm("Cast your ballot now?");

if (validated) { return true; } else { return false; }

});

// Allow users to double click to move to selection list

$("#sortable1 li").assignDblClick();

}); // End of JQuery UI loading

}); // End of JQuery ready function

// Define the actions when an item is double clicked

$.fn.assignDblClick = function()

{

$(this).dblclick(function(){

$(this).appendTo('#sortable2');

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

});

}

// This function copies the drag and drop sortable data into the standard LimeSurvey ranking structure.

function updateRanking()

{

var rankees = [];

$('#sortable2 li').each(function(index) {

$(this).attr("value", index+1);

// Get value of person

li_tag = $(this).attr('id');

li_tag_array = li_tag.split("_");

// Save to an array

rankees[rankees.length] = { 'r_name':$(this).text(),'r_value':li_tag_array[1] };

});

$("input[name</div>='RANK_']").each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

$(this).next().val(rankees[index].r_value);

} else {

$(this).val("");

$(this).next().val("");

}

});

// Re-assign double click action to first list items and remove

// double click action from section list items

$('#sortable1 li').unbind('dblclick').assignDblClick();

$('#sortable2 li').unbind('dblclick');

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadRanking()

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$("input[name<div class="simplebox">='RANK_']").each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { 'r_name':$(this).val(),'r_value':$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won't* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

li_tag = "<li class='ui-state-default' id='choice_" + value.r_value + "'>" + value.r_name + "</li>";

$(li_tag).appendTo("#sortable2");

});

}

</syntaxhighlight>

=Create MaxDiff question type=

See the "[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating&structure;=English+Instructions+for+LimeSurvey Question design, layout and templating]" section for a workaround that uses JavaScript to convert an '''''Array (flexible labels) by column''''' question into a [http://en.wikipedia.org/wiki/MaxDiff MaxDiff] question type.

[[File:max_diff_596x253.gif]]

=In a checkbox matrix, have the 'none' option in a row disable all other columns in that row=

''Tested with: Limesurvey 1.90+''

The questionId parameter is the base ID of the question matrix (multiflexible).

numColumns and numRows speak for themselves

specialColumns is an array of the columns that have the special ability that when one of them

is checked, none of the others can be checked. E.g., a 'none of these' and/or a 'do now know' option.

<syntaxhighlight lang="php" enclose="div">

<script>

numColumns=13;

numRows=18;

questionId='28417X2X24';

specialColumns=[1,12,13];

function action(obj){

locator=obj.id.replace('cbox_'+questionId, '').split('_');

row=locator[0];

column=locator[1];

//alert('Action for row,column='+row+','+column);

my_id='#cbox_'+questionId+row+'_'+column+''

if($(my_id).attr('checked') == false) {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

$(id).attr('disabled',false);

}

} else {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

aid='#answer'+questionId+row+'_'+i

$(aid).val(0);

$(id).attr('checked',false);

$(id).attr('disabled',true);

}

}

}

function customOnLoad(){

for( var row=1; row<=numRows; row++ ) {

for( var k=0; k<specialColumns.length; k++ )

{

column=specialColumns[k];

$('#cbox_'+questionId+row+'_'+column).change(function() {

action(this);

});

}

}

}

jQuery(document).ready(

function(){

customOnLoad();

}

);

</script>

</syntaxhighlight>

=Last Option In Array (Numbers) (Checkboxes) Row Excludes All Others=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to make the last option of each Array (Numbers) (Checkboxes) row exclude all other options in the same row.

The script will uncheck all options in a row if the last option is checked and uncheck the last option in a row if any other options are checked.

It's [http://www.partnersinc.biz/surveys//index.php?sid=22532&newtest;=Y&lang;=en demonstrated here].

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following script in the source of the array question or the group description.
#Call the script by replacing "QQ" in line 6 with your array question ID (you can call the script for more array questions by copying this line with new IDs).

NOTE: Care should be taken when using this script and conditional questions on the same page.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the exclude function using question ID(s)

excludeOpt (QQ);

// A function to make the last option in each array row exclusive

function excludeOpt (qID) {

// Add some classes to the checkboxes so we can manipulate them

$('#question'+qID+' table.question tbody td').addClass('normalOpt');

$('#question'+qID+' table.question tbody').each(function(i) {

$('td:last', this).removeClass('normalOpt').addClass('exlusiveOpt')

});

// A listener on the checkbox cells

$('#question'+qID+' table.question tbody td').click(function (event) {

// Set some vars

var el = $(this).parent();

var optLength = $('td', el).length

// Uncheck the appropriate boxes in a row

if ($(this).hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el).attr('checked', false);

}

else {

$('td', el).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

// A listener on the checkboxes

$('#question'+qID+' table.question tbody td input[type=checkbox]').click(function (event) {

// Set some vars

var el2 = $(this).parent().parent();

var optLength = $('td', el2).length

// Uncheck the appropriate boxes in a row

if ($(this).parent().hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el2).attr('checked', false);

}

else {

$('td', el2).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

}

});

</script>

</syntaxhighlight>

=Load SVG Code From Drawing Tool=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to load a drawing tool and store the results in a huge-text question.

The drawing tool is supplied by [http://www.mainada.net/inputdraw/ mainada.net].

Implementation is as follows:
#Go to [www.mainada.net/inputdraw/downloads|www.mainada.net/inputdraw/downloads], download the latest package and install all files in the root of your LS installation (you only really need '''inputdraw.js''', '''inputdraw.non-commercial.v1.5.swf''' and '''swfobject.js''' but the others are cool to play with).
#Add the following to the <head> element of your template startpage.pstpl file to pull in the scripts:

+~hs<span style="color:hs</span>hs<span style="color:hs~<script src="swfobject.js" type="text/javascript"></script>

+~hs</span>hs<span style="color:hs</span>hs~<script src="inputdraw.js" type="text/javascript"></script>
#Create a huge-text question and add the following script to the source of that question.

The script will">
*Automatically find the ID of the first huge-text question on the page
*Insert the drawing element into the huge-text question
*Hide the textarea of that question
*Populate it with the SVG code generated by the drawing element.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey, group and question IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

var qIDStr = $('div.text-huge:eq(0)').attr('id');

var tmp2 = qIDStr.split('question');

var qID = tmp2[1];

}

var textAreaID = 'answer'+sID+'X'+gID+'X'+qID;

// Hide the textarea

$('#'+textAreaID+'').hide();

// Insert an element for the drawing tool

$('<div id="place"></div>').insertBefore($('#'+textAreaID+''));

// Load the drawing tool

var draw = new InputDraw('inputdraw.non-commercial.v1.5.swf', 'place', {

id:textAreaID,

width:'350',

height:'100',

stroke_style:'2 1 rgb(255,0,0)',

animation:60,

color:'#CCCCCC' ,

tools_color:'0xd6c004',

clean:'clear.png',

undo:'undo.png',

disable:'size opacity color' // Get rid of most of the tools

});

});

</script>

</syntaxhighlight>

=Add Navigation Buttons (Next and Previous) To Top Of Page=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

Add the following to the end of template.js. It will insert a new div after the progress bar and then insert clones of the nav buttons in the new div.

This example is for the default template in 1.90 or 1.91. The placement of the new div may need to be modified for other templates.

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// Insert a new div after the progress bar

$('<div id="navigator2" />').insertAfter('#progress-wrapper');

// Style the new div

$('#navigator2').css({

'text-align':'center'

});

// Insert clones of the nav buttons in the new div

$('input.submit:eq(0)').clone().appendTo('#navigator2');

$('input.submit:eq(2)').clone().appendTo('#navigator2');

// Give the new buttons some new IDs

$('#navigator2 input.submit').each(function(i) {

var oldID = $(this).attr('id');

var newID = oldID + '2';

$(this).attr('id', newID)

});

});

</syntaxhighlight>

[[File:extra_buttons.png]]

=How to ''add'' an opt out link to your survey using javascript.=

Tested with: 1.91+, Firefox 5.0

This javascript inserts a link to opt out of the survey above the progress bar.

First see the section above entitled: "How to use Script (eg. JavaScript etc.) in LimeSurvey?".

Then insert the following code into to the source of a group description or a question. I used the group description.

<syntaxhighlight lang="php" enclose="div"> <script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey ID

if($('input#fieldnames').length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

}

// Insert a new div after the progress bar

$('<div id="optOutLink" />').insertBefore('#progress-wrapper');

// Style the new div

$('#optOutLink').css({

'text-align':'center'

});

// Insert opt out url in the new div

$('#optOutLink').html('<P><a href="optout.php?lang=en&sid;='+sID+'&token;={TOKEN}"> /

Click here to opt out of this survey.</a></p><br>');

});

</script></syntaxhighlight>

=Anonymously track respondents answers across multiple surveys=

''Tested with: 1.91+ and 1.92+''

This workaround uses JavaScript/jQuery to enable tracking of respondents across multiple surveys ensuring anonymity (it does not use tokens).

To do this you have to use this question in all the surveys you want to link respondents answers.

This workaround create an ID by asking some partial personal information (like initials, birth month ...). The ID will be encrypted using a one-way function (in this case SHA-1) and stored in a brief text answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following code in the source of a brief text question.
#Optional: you can also add other select field to avoid collisions (e.g. for large population sample)

<syntaxhighlight lang="php" enclose="div">

<p>This answers are used to generate your ID. These information will be encrypted, it will not be possible in any case to identify you neither from your answers nor from your ID.</p>

<table>

<tr>

<td>Initial of your name</td>

<td>

<select id="field1">

<option value=""></option>

<option value="A">A</option>

<option value="B">B</option>

<option value="C">C</option>

<option value="D">D</option>

<option value="E">E</option>

<option value="F">F</option>

<option value="G">G</option>

<option value="H">H</option>

<option value="I">I</option>

<option value="J">J</option>

<option value="K">K</option>

<option value="L">L</option>

<option value="M">M</option>

<option value="N">N</option>

<option value="O">O</option>

<option value="P">P</option>

<option value="Q">Q</option>

<option value="R">R</option>

<option value="S">S</option>

<option value="T">T</option>

<option value="U">U</option>

<option value="V">V</option>

<option value="W">W</option>

<option value="X">X</option>

<option value="Y">Y</option>

<option value="Z">Z</option>

</select>

</td>

</tr>

<tr>

<td>Your birth month</td>

<td>

<select id="field2">

<option value=""></option>

<option value="01">January</option>

<option value="02">February</option>

<option value="03">March</option>

<option value="04">April</option>

<option value="05">May</option>

<option value="06">June</option>

<option value="07">July</option>

<option value="08">August</option>

<option value="09">September</option>

<option value="10">October</option>

<option value="11">November</option>

<option value="12">December</option>

</select>

<td>

</tr>

</table>

<script type="text/javascript" src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/sha1.js"></script>

<script type="text/javascript">

$(document).ready(function() {

$("#answer{SGQ}").attr('readonly', 'readonly');

//$("#answer{SGQ}").css('display', 'none'); //uncomment this line for not displaying the code

});

$('#field1, #field2').bind('change keyup', function() {

if ($("#field1").val()=='' || $("#field2").val()=='')

$("#answer{SGQ}").val('');

else {

var sha1 = CryptoJS.algo.SHA1.create();

sha1.update($("#field1").val());

sha1.update($("#field2").val());

// sha1.update($("#otherfield").val());

var hash = sha1.finalize();

$("#answer{SGQ}").val(hash);

}

});

</script>

</syntaxhighlight>

=Check validity of international phone number in subquestion=

''Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an international phone number in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the phone function with the question ID and the row number

phoneTest(QQ, NN);

function phoneTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var phoneMatch = /^[0-9,+,(), ,]{1,}(,[0-9]+){0,}$/;

var msg1 = 'Please enter a valid phone number.';

// Test the input

var phoneInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(phoneInput != '' && !phoneMatch.test(phoneInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1136 regexlib.com blank]

=Check validity of email address in subquestion=

'Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an email address in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the email function with the question ID and the row number

emailTest(QQ, NN);

function emailTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var emailMatch = /^[a-zA-Z0-9\_\-]+[a-zA-Z0-9\.\_\-]*@([a-zA-Z0-9\_\-]+\.)+([a-zA-Z]{2,4}|travel|museum)$/;

var msg1 = 'Please enter a valid email address.';

// Test the input

var emailInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(emailInput != '' && !emailMatch.test(emailInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1653 regexlib.com blank]

=Hiding the help-text when it's empty=

Tested with: 1.91+

I had made a style in my template putting a border around my help-text. To avoid empty help-text to show up (and have lines instead of just 'nothing' when there was no help text, I used this piece of code in question.pstpl:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var questionhelp="{QUESTIONHELP}";

if (questionhelp=="") {

document.write("");}

else {

document.write('<tr><td class="survey-question-help">'+ questionhelp +'</td></tr>');}

</script>

</syntaxhighlight>

it can probably be optimized but it worked for me

=Disable or hide selected fields in a matrix question=

''Tested with: 1.92+, IE 7/8/9, FireFox 12/13''

TASK

Hide or disable selected fields in a Matrix, so that users cannot make any input.

(See example, where users should not make input into red framed fields)

[[File:snap035.gif]]

Fig. 1: Prevent users from input into first two fields (as an example)

SOLUTION

First find the name of the fields you want to hide / disable. In my case I used Firebug with firefox to figure that out.

[[File:snap037.gif]]

Fig. 2: Figure out the name(s) of the field(s)

Then put the following script-code into the HTML-source code as described above:

Note: you have to change the code to match the names of your fields!

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('input[name="69965X2X10SQ001_SQ001"]').attr('disabled', 'disabled');

$('input[name="69965X2X10SQ001_SQ002"]').attr('hidden', 'hidden');

});

</script>

</syntaxhighlight>

[[File:snap039.gif]]

Fig. 3: Result: first field is diabled ("greyed out"), second one is completely hidden

I think this way one can apply many other attributes to a field like color etc. But did not try that myself.

Thanks to roB2009 for the input in the forum!

=Add prefix or suffix to question type "Array (Texts)"=

TASK

Add a prefix or suffix to the text fields in questions of the "Array (Texts)" type.

[[File:suffix.png]]

Fig. 1: Suffix

[[File:prefix.png]]

Fig. 1: Prefix

SOLUTION
*Set up your survey to use JavaScript.
*Add the following script to the source of the array. Replace "12345" with the array question ID and modify the suffixes/prefixes as required.
*The function call must consist of a question ID followed by the suffixes for each column. Suffixes/Prefixes must be enclosed in quotes and comma separated.
*In this example question ID 12345 will get an "in €" suffix in the first column and an "in %" in the next 3 columns.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the function with the question ID followed by a comma-separated list of suffixes

addSuffix(12345, 'in €', 'in %', 'in %', 'in %');

function addSuffix() {

var qID = $(arguments)[0];

// Assign some column-specific classes

$('#question'+qID+' table.question tbody tr').each(function(i){

$('td', this).each(function(i){

$(this).addClass('answerCol-'+(i+1)+'');

});

});

// Some styling

$('#question'+qID+' table.question tbody input[type="text"]').css({

'width': '50%'

});

// Insert the suffixes

$(arguments).each(function(i, val){

if(i > 0) {

$('#question'+qID+' td.answerCol-'+i+' label').append(val);

}

});

}

});

</script></syntaxhighlight>

For adding a prefix you need to substitute the following line in the code

<syntaxhighlight lang="php" enclose="div">$('#question'+qID+' td.answerCol-'+i+' label').append(val);</syntaxhighlight>

with this

<syntaxhighlight lang="php" enclose="div">$('#question'+qID+' td.answerCol-'+i+' label').prepend(val);</syntaxhighlight>

Workarounds: Manipulating a survey at runtime using Javascript

2012-07-06T22:49:35Z

Holch:

Workarounds: Manipulating a survey at runtime using Javascript

2012-07-06T22:47:29Z

Holch:

Often you want to manipulate certain elements of a survey at runtime. The only solution without touching the source code is to use Javascript or jQuery which is shipped with Limesurvey. Here are some examples to hide and style elements, validate user input or do calculations at runtime.

Non Javascript workarounds can be found at
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Survey+behaviour&structure;=English+Instructions+for+LimeSurvey Workarounds - Survey Behavior]
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating Workarounds - Question design, layout and templating]

<div class="simplebox"><center>'''Please keep in mind that the workarounds published here are no official Limesurvey extensions but solutions that other users created for themselves.<br/><span style='color:#EE0000,#FFFFFF'>Therefore we can't give support for any solution on this page.</span><br/>Please contact the users that, thankfully, shared their solutions with the community if you have any questions.'''</center></div>

<div class="simplebox">Note: Version 1.92 implements many new features that make some existing workarounds obsolete. You can continue to use existing workarounds, but may want to consider switching over to using the new features (since those new features are officially supported, and the workarounds are not). Please review below for details of which are no longer needed.</div>

<div class="simplebox">Also Note: Version 1.92's Expression Manager (EM) may cause some of these work-arounds to fail. Any custom javascript included as a .js file will be fine. However, if you in-line your JavaScript code, you must make sure that you have a space after every opening (left) curly brace, and a space before every closing (right) curly brace. Otherwise, EM will think that the content between the curly braces is something it should parse and understand. I have fixed all of the work-arounds below that can be fixed (many did not follow those rules). However, some will continue to break. If a work-around contains a regular expression which contains curly braces (to indicate a range of repeats of a sub-expression), EM will try to process those curly braces, and thus break your regular expression. Strategies to continue to support that work-around functionality are discussed below.</div>

__TOC__

=How to ''add'' a javascript workaround solution to this Wiki page?=

Well, this is pretty easy. Click the edit icon and create your own headline within the javascript section starting with "'''!'''". Then add a short note about the version you have used when creating your workaround, you can copy/paste this code snippet <nowiki>''Tested with: (enter Limesurvey version and maybe browser)''</nowiki>.

Finally it's imported to mark all your code with code tags, other wise you might break this page.
*Start tag: '''<nowiki><syntaxhighlight lang="php" enclose="div"></nowiki>'''
*End tag: '''<nowiki></syntaxhighlight></nowiki>'''.

=How to ''use'' Script (eg. JavaScript etc.) in LimeSurvey?=

To use JavaScript within Limesurvey, the XSS filter must be turned off and the code inserted in the source of a question or a group description.
*Go to Global settings --> Security and set "Filter HTML for XSS" to "Off".
* [http://docs.limesurvey.org/tiki-index.php?page=Adding+A+Question Add a new question]
* Edit the question and click the "Source" button in the editor toolbar:

[[File:editor_1.gif]]
* Enter your script after the question text:

[[File:editor_2.gif]]
* Save the question

A simple test to see if JavaScript is enabled is to echo an alert. Use this code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

alert("Test!");

</script></syntaxhighlight>

It is a good practice to use the jQuery $(document).ready function to prevent the code from executing until the page is fully loaded:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

alert("Test!");

});

</script></syntaxhighlight>

=Sum up input values using Javascript=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the sum() function in [[Expression Manager|Expression Manager]]. See this [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]].</div>

This is from a survey that is a invitation to a longer party, when the user clicks to the next page, the calculated results will be shown.

If you wonder what the {INSERTANS:1X6X12} stuff is, look at [http://docs.limesurvey.org/tiki-index.php?page=SGQA+Identifier SGQA identifier] and [http://docs.limesurvey.org/tiki-index.php?page=Adding+a+Question#Information_from_previous_answers Using information from previous answers].

<syntaxhighlight lang="html" enclose="div">

<div style="text-align: left">These are your answers:<br />

<u></u><u></u><u></u><u></u><u>=

<p><script LANGUAGE="JavaScript">

partyprice = 3;

beadclothprice = 3;

breakfastprice = 7;

lunchprice = 8;

dinnerprice = 10;

foodtotal = 0;

var isreallytrue = "Yes";

var noanswer = "No answer";

document.write( "Can you come? = {INSERTANS:45251X1X1}<BR>" );

if ("{INSERTANS:45251X1X1}" == isreallytrue )

{

if ("{INSERTANS:45251X1X3}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X3}"; }

partypeople = parseInt(answer);

partytotal = partyprice * partypeople;

document.write( "It's {INSERTANS:45251X1X3} persons who will come = " + partytotal + "€<BR>" );

if ("{INSERTANS:45251X1X4}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X4}";}

beadcloths = parseInt(answer);

beadclothtotal = beadclothprice * beadcloths;

document.write( "You want to borrow {INSERTANS:45251X1X4} beadcloths = " + beadclothtotal + "€<BR>" );

document.write( "Will you be there thursday? = {INSERTANS:45251X1X5}<BR>" );

document.write( "On friday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X71}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X71}";}

breakfastfriday = parseInt(answer) * breakfastprice;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastfriday + "€<BR>" );

if ("{INSERTANS:45251X1X72}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X72}";}

lunchfriday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchfriday + "€<BR>" );

if ("{INSERTANS:45251X1X73}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X73}";}

dinnerfriday = parseInt(answer)* dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnerfriday + "€<BR>" );

foodtotal = breakfastfriday + lunchfriday + dinnerfriday;

document.write( "Will you be there saturday? = {INSERTANS:45251X1X8}<BR>" );

if ("{INSERTANS:45251X1X8}" == isreallytrue )

{

document.write( "On saturday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X91}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X91}"; }

breakfastsaturday = parseInt(answer) * breakfastprice ;

document.write("'''_ " + answer + " breakfeasts = " + breakfastsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X92}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X92}"; }

lunchsaturday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X93}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X93}"; }

dinnersaturday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersaturday + "€<BR>" );

foodtotal = foodtotal + breakfastsaturday + lunchsaturday + dinnersaturday;

}

document.write( "Will you be there sunday? = {INSERTANS:45251X1X10}<BR>" );

if ("{INSERTANS:45251X1X10}" == isreallytrue )

{

document.write( "On sunday you will have these meals: <br>" );

if ("{INSERTANS:45251X1X111}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X111}"; }

breakfastsunday = parseInt(answer) * breakfastprice ;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastsunday + "€<BR>" );

if ("{INSERTANS:45251X1X112}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X112}"; }

lunchsunday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsunday + "€<BR>" );

if ("{INSERTANS:45251X1X113}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X113}"; }

dinnersunday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersunday + "€<p>" );

foodtotal = foodtotal + breakfastsunday + lunchsunday + dinnersunday;

}

total = partytotal + beadclothtotal + foodtotal;

document.write( "<h3>In total it will cost you " + total + "€</h3><BR>

Put that sum in this bank account 1234 5678 9012" );

}

</SCRIPT></p>

</div></syntaxhighlight>

=Multiple Question Validation=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the min/max/equals_num_value attributes (to validate sums), or the em_validation_q function, which lets you refer to other variables when you validate the current question [[Expression Manager|Expression Manager]]. Such validations also work on the current page, and properly handle array_filter and cascading relevance.</div>

This workaround is in case you need to do some validation involving more than one question, it implies a very little JavaScript programming and the use of SQGA Identifiers; this should work on almost any version of LimeSurvey.

Is easy to explain with an example, we need to do a survey of the percentage of males and females and we want to be sure that the sum is 100, to do this follow this steps (the necessary data that is not indicated in these instructions are not important i.e. question codes, etc.):
#Create a new survey of type “group by group”, set the “Show |<< Prev| button” to yes and note the SID.
#Add a new group called “Group 1” and note the GID.
#Add a new question “Percent of males” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID1).
#Add a new question “Percent of females” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID2).
#Add a new group called “Group 2”
#Add a new non mandatory question, here is the trick the question text has to be (be sure to replace the SID, GID, QID1 and QID2

<syntaxhighlight lang="javascript" enclose="div">

<script>

function validation()

{

if [[{INSERTANS:SIDXGIDXQID1}+{INSERTANS:SIDXGIDXQID2}) != 100)

{

alert("Your responses don't sum 100! Check them");

document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

else

{

document.limesurvey.move.value = 'movelast';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</script>

</syntaxhighlight>

But this will show shortly the question and will jump to the end page, a little weird for the survey taker but works.

This is a proof of concept, and may have some problems, please if you notice something or improve it send me an e-mail to leochaton-limesurvey at yahoo dot com.

This will work for 2 questions that you want to be the same. Works well for email and confirm email questions

<syntaxhighlight lang="php" enclose="div">

function validation() {

if ("{INSERTANS:SIDXGIDXQID}" != "{INSERTANS:SIDXGIDXQID}") {

alert("Your responses don't match Check them"); document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</syntaxhighlight>

=Alternate exit=

''Tested with: ''

Using the same idea of the previous post, you can implement an alternate exit of your survey.

This script should be in the first question to be displayed in a next page after the question that should trigger the alternate exit. In this example the question that trigger the alternate exit is a Yes/No question, if the user chooses no, he is redirected to another page.

<syntaxhighlight lang="php" enclose="div">

<script>

if ("{INSERTANS:SIDXGIDXQID}" == "No")

{

window.location="http://www.limesurvey.org";

}

</script>

</syntaxhighlight>

=Custom onload function=

''Tested with: 'All browsers', LimeSurvey 1.70 and up

==General==

This simple workaround describes how to '''add a custom Javascript code''' that is triggered right after the page is loaded. It may have numerous applications, especially when you deal with a custom JS/HTML code. It may be used to hide form elements (<input> tags), make them read-only, display alert messages, etc.

To run any Javascript code right after page load use the Query ready() function. It will be executed when the page is being loaded. For example when you add the following code to one of your question definitions...:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(

function(){

alert('onload alert!');

}

);

</script>

</syntaxhighlight>

...it will display a pop-up message immediately after the page has been loaded.

Some of the applications of this trick I've explored are:

a) Hiding the form elements by calling in your Custom_On_Load:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").style.display='none';</syntaxhighlight>

Note: As of svn build 9755, you can now dynamically reference the questions input fields by using the {SGQ} keyword. You can rewrite the previous example like this:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer{SGQ}").style.display='none';</syntaxhighlight>

this makes it a little easier when exporting surveys, so you don't have to worry about manually entering each questions SurveyGroupQuestion ID.

b) Making the elements read only:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").readOnly=true;</syntaxhighlight> where the "answer73166X16X54" structure has been described in one of other workarounds above.

c) For Hiding by a lot of elements by calling in your Customer_On_Load

jQuery searchs in html document for input-fields with radio type, if his answer text empty then do the display css set to none.

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function() {

jQuery('input:radio').each(

function() {

var s = jQuery(this);

var c = s.parent().children('.answertext');

for(var i=0; i < c.length; i++) {

var a = jQuery(c[i]]);

if(this.id </u> a.attr('for') && a.text() == '') {

s.css({ 'display' : 'none' });

a.css({ 'display' : 'none' });

break;

}

}

}

)

}

);

</syntaxhighlight>

==Advanced usage==

If you want to place global Javascript code using the above jQuery(document).ready function then the best place to do this is the template javascript file template.js. You can edit this file using the template editor. Please be aware that placing it in the template javascript file will make the function available to all surveys using that template. If needed just create a new template copy for your survey.

Alternatively you can place the jQuery(document).ready function in the group description to make a Javascript function only available to a certain question group.

==Language-specific Javascript code==

There is an easy way to find out the current language and execute according Javascript using jQuery: The <html> tag of any survey pages contains an 'lang' attribute which holds the current language code. You can read that language code by using the followin code

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function(){

languagecode=$('html').attr('lang');

alert('This is the current language code: '+languagecode);

}

);

</syntaxhighlight>

For an English survey the above code would show a messagebox with "This is the current language code: en"

=Custom onload function in multi-language survey=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2,''

To use custom onload functions, as above, in multi-language surveys you must define the functions in the question source for '''all''' languages.

While this initially seems to be a bit tedious, it actually can be useful - you can alter your onload functions depending on the language in use. For example, you can dynamically display alerts or element contents in the current language.

=Skipping the welcome page=

''Tested with: 1.85 (second code snippet)''

<div class="simplebox">Note: As of version 1.91, there is a survey option letting you skip the welcome page, so this workaround is not needed.</div>

'''Solution 1:''' Include this Javascript in your welcome template, in the file welcome.pstpl for all welcome page, or in the source of the welcome text for one survey:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(function($) {

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit(); });

</script>

</syntaxhighlight>

It will reproduce the onclick event of the submit button and submit the form.

Drawback of course is that users will see the page flashing up.

Therefore, you may want to announce "... loading survey ..." as a description of your welcome page (in the admin interface when creating the survey), to pretend loading something big.

'''Solution 2:'''

<syntaxhighlight lang="php" enclose="div">

<script>

function custom_on_load(){

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit();

}

window.setTimeout( 'custom_on_load()',1);

</script>

</syntaxhighlight>

=Filter answers of a question with the answer of another=

===Method 1===

''Tested with: 1.70 - 1.72''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general.</div>

If you want to filter the answer of a question with another answer, you can use this workaround.

First, use answer code like that: XX for the first question, and XXYYY for the second one.

Answer of the second question filter if the 2 first letters are the answer of the first question.

We use 1000X1X1 and 1000X1X2 for the example, question had to be on separate page (question by question for example).The second question had to be a dropdown list (we can do similar workaround, but droplis is the best). You can do this using JQuery. It leaves the answer in the select box, but disables it. You could also replace "disable" with "remove" to get rid of it altogether.

<syntaxhighlight lang="php" enclose="div">

var previousQuestionAnswer = "{INSERTANS:1000X1X1}";

var currentQuestionID = "#answer1000X1X1"

$(document).ready(function() {

// See if the answer for the previous question matches an answer in the current question

// (other than 'No Answer')

// If so, disable it.

if (previousQuestionAnswer!='No Answer') {

$(currentQuestionID).children().each(function(index, Element)

{

if ($(this).attr('text') == previousQuestionAnswer)

{ $(this).attr('disabled', true); }

}

);}

}); // End of JQuery ready function

</syntaxhighlight>

===Method 2===

''Tested with 1.92 + Firefox 9.0''

If you have a country, state, and city set of questions (or similar), you could code answer options as:

'''Q1 Country''' ''Single choice list (ratio, dropdown)''

X country#

'''Q2 State''' ''Single choice list (dropdown)''

XY state#

'''Q3 City''' ''Single choice list (dropdown)''

XYZZ city#

Now you must put the following Javascript code in the source of question 2 (State):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the countryCode (first character of the country)

var countryCode = '{INSERTANS:1000X1X1}'.substr(0, 1).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the countryCode

$('select[id<div class="simplebox">="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 1).toUpperCase() != countryCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

And the following code in the source of question 3 (City):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the stateCode (two first characters of the state)

var stateCode = '{INSERTANS:1000X1X2}'.substr(0, 2).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the stateCode

$('select[id</div>="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 2).toUpperCase() != stateCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

Each question must be in different pages of survey to work, i.e. in a question by question survey, or in diferent groups in a group by group survey.

Note that if you choose a two characters answer option code in the State question, i.e. a XYY answer option code, you must change the ''substr(0, 2)'' part of code in question 3 to ''substr(0, 3)''.

=Filter answers of a multiple numeric type question=

''Tested with: 1.90+''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general. In 1.92, array_filter works with all questions that have sub-questions (e.g. also works for multiple numeric and multiple short text).</div>

If you want to filter a question of type "multiple numeric", you have to modify the workaround.

Note that this workaround assumes that the code for each of the subquestions are a numeric sequence 1,2,3...

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Match elements with labels using htmlFor and a loop

var labels = document.getElementsByTagName('LABEL');

for (var i = 0; i < labels.length; i++) {

if (labels[i].htmlFor != '') {

var elem = document.getElementById(labels[i].htmlFor);

if (elem)

elem.label = labels[i];

}

}

var answerFilter="{INSERTANS:96553X63X759}";

for (i=0; i<30; i++){

var iLabel = document.getElementById('answer96553X63X760'+(i+1]].label.innerHTML;

if (answerFilter.search(iLabel) == -1){

// Hide element

$('#question760').find('li').eq(i).hide();

// Set value of hidden elements to zero

document.getElementById('answer96553X63X760'+(i+1)).value = 0;

}

}

});</script>

</syntaxhighlight>

=Use an answer to prefill another question (default value)=

''Tested with: 1.72''

''And tested with: 1.91+''

<div class="simplebox">As of version 1.92, this is easier to do using the enhanced defaults feature, which lets you pre-fill most question types with default values. In 1.91, you could set defaults for list and multiple choice questions. In 1.92, you can set defaults for any text-entry question too. Moreover, the defaults can be [[Expression Manager|Expression Manager]] compatible equations or tailored text. Finally, with 1.92, defaults are properly managed even when set on the same page.</div>

This workaround gives you the ablility to use an answer to fill the default value for another question. It's explained for free text question type but can be adapted for another question type.

We use SGQA identifier. For example, we use SGQA 1000X10X20 and 1000X10X21 to prefill 1000X11X30 and 1000X11X31. For the script to work, the question has to be on a different page.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X11X30').val('{INSERTANS:1000X10X20}');

$('#answer1000X11X31').val('{INSERTANS:1000X10X21}');

});

</script></syntaxhighlight>

If you want use two times the value of an integer input, you can also use this to prefill a question that you hide via CSS.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X2X2').val(parseInt('{INSERTANS:1000X1X1}')*2);

$("#question2").hide();

});

</script>

</syntaxhighlight>

Now you can use {INSERTANS:1000X2X2} for giving you twice the value of the user input from question 1.

=Dynamic Sum=

<div class="simplebox">As of version 1.92, this is easier to do with [[Expression Manager|Expression Manager]] using the sum() function. Not only will sums be dynamic, but they wille exclude irrelevant values, so you can array_filter a multiple numeric question and get the sum of just the answers that are visible. This [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]] demonstrates the dynamic sum feature.</div>

<div class="simplebox">Also note, as of version 1.92, the following workaround will fail, since it includes a a regular expression containing curly braces.</div>

This script is used with a "Multiple Options" type question calculate a total price based on how which checkboxes are selected. The prices are listed as part of the answer. The answers are set up like this: "USB Mouse ($20)". The script uses the number between the "($" and the ")" as the price for that item. You can adapt the script to if you need to change the currency or need to sum something other than money.

This script works when used in a question-by-question format. It does not work when there are more than one question on a page. I think it can be adapted to work, but I haven't done the coding yet.

Put the following code into body of your question:

<syntaxhighlight lang="php" enclose="div">

<script language=Javascript>

// General definitions

// Define a regular expression to match the labels containing information about an answer

// In LimeSurvey, these labels start with "answer..."

var answerRegex = /^answer/;

// Find all answer checkboxes in the document and set their

// onchange events to updatePrice

function Custom_On_Load()

{

// Find all input elements

var inputList=document.getElementsByTagName("input");

// Loop through each, looking for checkboxes

var i;

for( i=0; i< inputList.length;i++ )

{

// If input item does not have an ID, skip

if (! (inputList[i].id)) { continue; }

// Skip to next if ID doesn't start with "answer"

if (!answerRegex.test(inputList[i].id)) { continue; }

// Skip to next if not a checkbox

if (inputList[i].type.toUpperCase()!='CHECKBOX') { continue; }

// This is an answer checkbox!

// Setup onchange event

inputList[i].onclick = updatePrice;

}

// Load initial sum

updatePrice();

}

function updatePrice()

{

var labels=document.getElementsByTagName("LABEL");

// Define a regular expression to match a price inside parenthesis

// For example: ($29) or ($29.54).

// Set up

priceRegex = /$\$(\d*\.{0,1}\d+)$/;

// Loop through all the labels, looking for labels corresponding to

// answers that have a price in them.

var i;

var total = 0;

for( i=0; i<labels.length;i++ )

{

var myArray; // Define array used for regex matching

var inputID; // Define field element

// Get the ID of the field corresponding to the label using the

// "htmlFor" attribute

// (FYI, there are some labels that will have to be screened out

// because they don't correspond to an answer)

// Does the label start with "answer"?

// If not: exit.

if (!answerRegex.test(labels[i].htmlFor)) { continue; }

// First make sure this element exists

// If it doesn't, go to the next element

// If it does, it will be defined in inputID

if (! (inputID = document.getElementById(labels[i].htmlFor)) ) { continue; }

// See if the corresponding answer is a checkbox that is checked.

// If not, go to next label

if (inputID.type.toUpperCase()!='CHECKBOX') { continue; }

if (!inputID.checked) { continue; }

// This is label for an answer.

// The innerHTML will give us the text of the label

// The price information will be in the form ($XX.XX)

// which in contained in the label text.

// Find a match for a decimal number inside the pattern "($" and ")"

if [[myArray = priceRegex.exec(labels[i].innerHTML]] != null)

{

// Keep a running tally

total += parseFloat(myArray[1]);

}

}

// Update total price on form

document.getElementById("totalPrice").value = "$" + formatCurrency(total);

}

function formatCurrency(num) {

num = isNaN(num) || num <u> '' || num </u> null ? 0.00 : num;

return parseFloat(num).toFixed(2);

}

</script>

</syntaxhighlight>

Put the following code in the help section (or wherever you want the sum to appear):

<syntaxhighlight lang="php" enclose="div">Total Cost for selected accessories: <input type="readonly" value="" id="totalPrice" /></syntaxhighlight>

=Focus on the first Input field=

(''Tested with: Limesurvey 1.80 / IE6/7, Firefox 3, Safari, Opera, chrome'')

<div class="simplebox">As of version 1.91, there is a built-in JavaScript function called focusFirst() to focus on the first visible element. It uses jQuery, so is more robust than this example.</div>

Again an onload Function is needed for this tasks. I have done it the DOM way with compatibility to IE6/7.

Put the following code into the startpage.pstpl of your template, right before the </head> closing tag:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function focusFirst(Event)

{

var i=0;

while(document.forms[0].elements[i].type == "hidden")

{

i++;

}

document.forms[0].elements[i].focus();

return;

}

if(ie)

{ window.attachEvent("onload", focusFirst); }

else

{ document.addEventListener("load", focusFirst, true); }

</script>

</syntaxhighlight>

'''Note:''' I am using this with version 1.80. As changes happened to the templates in the last release, you might need to add the following before the code, if your template is older than 1.80 stable and does not include this:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var ie = false;

</script>

</syntaxhighlight>

You will need this for the var ie to be set. Without this var, the function will not work with ie.

=Answer questions by keypress=

(''Tested with: IE7, Firefox 3'')

This workaround allow to answer the question on key 0-9 (0 is for the 10 answer).

Follow issues are supported at the moment:
*Yes-No Questions
*List Questions (radio)
*other radio questions

In lists the answer limit is ten.

You supply the template "endpage" of your template with the following script.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

jQuery(document).ready(function() {

jQuery(document).bind('keypress', function(e){

if (48 <= e.which && e.which <= 57) {

jQuery('input:radio').each(function() {

var v = jQuery(this).val();

var c = (e.which <u> 48) ? 10 : e.which - 48;

if(v </u> 'Y' || v <u> 'N') {

v = (v </u> 'Y') ? 1 : 2;

}

if(v == c) {

jQuery(this).click();

jQuery('#limesurvey input:submit').click();

}

});

}

})

});

</script>

</syntaxhighlight>

=Math notation in LimeSurvey=
#download the js file from [http://mathcs.chapman.edu/~jipsen/mathml/asciimathdownload.html AsciiMath script]
#copy it in the /scripts/ folder in your installation
#modify the startpage.psptl of the template you want to use adding the reference to the script (if you use an older version make sure that you copy the template folder first!) for example:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" src="ASCIIMathML.js">

</syntaxhighlight>

Use the notation where you need it!

'''Note:''' If you use internet explorer or safari you will need to download the plugin as well, but firefox does the lot for you.

Finally, if you are confident with the limesurvey structure you could add the editor which support math notation and change the reference to the editor you want to use in the configuration file. here is the [http://www.imathas.com/editordemo/demo.html link for a TinyMCE with math support].

=Reverse array_filter (for pre-1.90)=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">Note: Version 1.91 natively supports this functionality via the array_filter_exclude advanced quation option.</div>

This can be used to filter the answers of an array question to be displayed based on the answers of a multi option question that were '''NOT''' selected. A possible application would be to have a multi-option question asking which products were purchased, followed by 2 array questions - one asking to rate the purchased products and another asking why the remaining products were not purchased. Another would be to ask about sessions attended at a conference as in [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/27970-reverse-of-arrayfilter.html this forum thread] and pictured below. There is a live [http://www.partnersinc.biz/surveys//index.php?sid=43358&newtest;=Y&lang;=en demo here]

[[File:sessions_645x344.gif]]

We'll use the above example to explain the process as follows:
#In group 1 - Create a ''SessionsAttended'' multi-options question
#In group 1 - Create a ''SessionsNotAttended'' multi-options question with identical answers as ''SessionsAttended'' and hide it with styles or conditions
#In group 2 - Create a ''RateSessionsAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsAttended''
#In group 2 - Create a ''ReasonNotAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsNotAttended''
#In group 1 - Place JavaScript/jQeury listeners on each of the checkboxes in ''SessionsAttended'' that would toggle the corresponding checkbox in ''SessionsNotAttended'' to the opposite state

The JavaScript/jQuery code used would be:

<syntaxhighlight lang="php" enclose="div">

// The toggle function

function toggle(q1, q2) {

if ($(q1).attr('checked') == false ) {

$(q2).attr('checked', true);

}

else {

$(q2).attr('checked', false);

}

}

// Initialize the SessionNotAttended checkboxes to "checked"

toggle ('#answer11111X22X331', '#answer11111X22X441');

toggle ('#answer11111X22X332', '#answer11111X22X442');

toggle ('#answer11111X22X333', '#answer11111X22X443');

toggle ('#answer11111X22X334', '#answer11111X22X444');

// The jQuery listeners on the SessionAttended checkboxes

// that toggle the SessionNotAttended checkboxes

$('#answer11111X22X331').change(function() {

toggle ('#answer11111X22X331', '#answer11111X22X441');

});

$('#answer11111X22X332').change(function() {

toggle ('#answer11111X22X332', '#answer11111X22X442');

});

$('#answer11111X22X333').change(function() {

toggle ('#answer11111X22X333', '#answer11111X22X443');

});

$('#answer11111X22X334').change(function() {

toggle ('#answer11111X22X334', '#answer11111X22X444');

});

</syntaxhighlight>

Some notes about the code:
*The code is in an onload function defined in the first question of group 1 - see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workarounds here]
*Both ''SessionsAttended'' and ''SessionsNotAttended'' must be in the same group for the toggling to work
*This case only uses 4 checkboxes but could be expanded as required
*In this case the survey ID is 11111, the group ID is 22, ''SessionsAttended'' ID is 33 and SessionsNotAttended ID is 44 - these would need to be modified for your survey
*The toggle function looks for the state of a checkbox in ''SessionsAttended'' and sets the corresponding checkbox in ''SessionsNotAttended'' to the opposite state
*The "Initialize" section sets the state of ''SessionsNotAttended'' checkboxes whenever we navigate to the group
*The "Listener" section uses jQuery listeners to detect any change in the ''SessionsAttended'' checkboxes and then toggle the corresponding ''SessionsNotAttended'' checkbox

Some general notes about the questions:
*CSS can be used to hide ''SessionsNotAttended'' (div#question44 { display: none; }) if you don't want to use conditions (because maybe you've got [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $deletenonvalues set to 1])
*''RateSessionsAttended'' and ''ReasonNotAttended'' are another group to avoid things popping in and out of existence as ''SessionsAttended'' is answered
*[http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions] are used to ensure that ''RateSessionsAttended'' only appears if some sessions are selected and ''ReasonNotAttended'' only appears if no sessions are selected

=Filter Ranking Question With Multiple-Options=

''Tested with: 1.90, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

<div class="simplebox">As of version 1.92, most of this is easier to do using the the array_filter attribute, or relevance equations in general. They all work on the same page, and fully support cascading relevance.</div>

This workaround applies a filter to a ranking question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and ranking questions being on the same page and a slightly different one for the filter question being on a page before the ranking question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=96314&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following script in your template.js file. This function will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

// A function to filter choices in a ranking question

function rankFilter(q1ID, q2ID, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+q1ID+' li[id<div class="simplebox">="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+q1ID+'').hide();

}

handleChecked(q1ID, q2ID);

$('#question'+q1ID+' input.checkbox').click(function() {

handleChecked(q1ID, q2ID);

});

function handleChecked(q1ID, q2ID) {

// Find the survey and group IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $( 'input#fieldnames' ).attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

}

// Loop through all Q1 options

$('#question'+q1ID+' input.checkbox').each(function(i) {

// Find the answer code and value

var tmp2 = $(this).attr('id').split('X'+gID+'X'+q1ID+'');

var ansCode = tmp2[1];

var ansTxt = $(this).next('label').text();

// If option is checked and not in rank choices or output, add it to the rank choices

if($(this).attr('checked') == true

&& $('#question'+q2ID+' select.select option[value="'+ansCode+'"]').length == 0

&& $('#question'+q2ID+' .output input[id</div>="fvalue_"][value="'+ansCode+'"]').length == 0) {

$('<option value="'+ansCode+'">'+ansTxt+'</option>').appendTo('#question'+q2ID+' select.select');

}

// If option is unchecked...

else if($(this).attr('checked') == false) {

// Remove it from the rank choices

$('#question'+q2ID+' select.select option[value="'+ansCode+'"]').remove();

// Remove it from the rank output and reset hidden values

$('#question'+q2ID+' .output input[id<div class="simplebox">="fvalue_"][value="'+ansCode+'"]').attr('value', '').siblings('input.text').val('').siblings('img').hide();

}

});

// Clean up empty inputs in the rank output table

$('#question'+q2ID+' .output table tr').each(function(i) {

var nextRow = $(this).next('tr');

if($('input.text', this).val() == '' && $('input.text', nextRow).val() != '') {

$('input.text', this).val($('input.text', nextRow).val());

$('input.text', nextRow).val('');

$('input[id</div>="fvalue_"]', this).attr('value', $('input[id<div class="simplebox">="fvalue_"]', nextRow).attr('value'));

$('input[id</div>="fvalue_"]', nextRow).attr('value', '');

}

});

// Show the scissors for the last populated rank output row

$('#question'+q2ID+' .output table img[id<div class="simplebox">="cut_"]').hide();

$('#question'+q2ID+' .output table input.text[value!=""]:last').siblings('img[id</div>="cut_"]').show();

// Hide extra rank output rows

var optNum = $('#question'+q1ID+' input.checkbox:checked').length;

$('#question'+q2ID+' .output table tr').hide();

$('#question'+q2ID+' .output table tr:lt('+(optNum+1)+')').show();

// Hide and clear the ranking question if there are less than 2 checked options in Q1

if(optNum < 2) {

$('#question'+q2ID+'').hide();

$('#question'+q2ID+' input.text').val('');

$('#question'+q2ID+' input[id<div class="simplebox">="fvalue_"]').attr('value', '');

}

else {

$('#question'+q2ID+'').show();

}

// A work around for the built in max-answers function

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.output tr:visible').each(function(i) {

if($('input.text', this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

}

// A listener to work around the built in max-answers function

$('#question'+q2ID+' td.rank').click(function (event) {

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.item input.text').each(function(i) {

if ($(this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

});

}

</syntaxhighlight>

'''FOR BOTH FILTER AND RANKING QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and a ranking question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question.
*The function will hide the ranking question unless at least two options are selected in the multiple options question, in which case, it will only show the options selected.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND RANKING QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and a ranking question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question. Do not modify the "1".
*The function will hide the multiple options question. If at least 2 options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the ranking question.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR, 1);

});

</script>

</syntaxhighlight>

=Filter "Array by Column" Question With "Multiple-Options"=

''Tested with: 1.91, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

This workaround applies a filter to an "Array by Column" question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and array questions being on the same page and a slightly different one for the filter question being on a page before the array question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=74213&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following scripts in your template.js file. These functions will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

function filterArrByCol(qMultiOpt, qArray, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+qMultiOpt+' li[id</div>="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+qMultiOpt+'').hide();

}

// Assign classes to the answer cells

$('#question'+qArray+' table.question tbody td').each(function(i){

var classArr = $(this).attr('class').split('answer_cell_00');

var ansCode = classArr[1];

$(this).addClass('ans-'+ansCode+' filtered');

});

// Assign classes to the answer label cells

$('#question'+qArray+' table.question tbody tr:eq(0) td').each(function(i){

var classArr2 = $(this).attr('class').split(' ans-');

var ansCode2 = classArr2[1];

$('#question'+qArray+' table.question thead tr:eq(0) th:eq('+i+')').addClass('ans-'+ansCode2+'');

});

// Fire the filter function on page load

filterArr(qMultiOpt, qArray);

// Listener on multi-opt checkboxes to fire the filter function

$('#question'+qMultiOpt+' input.checkbox').click(function(){

filterArr(qMultiOpt, qArray);

});

// On submit, clear all hidden radios of array

$('#movenextbtn, #movesubmitbtn').click(function(){

$('#question'+qArray+' td.filtered:hidden').each(function(i){

$('input.radio', this).attr('checked', false);

});

return true;

});

}

function filterArr(qMultiOpt, qArray) {

if($('#question'+qMultiOpt+' input.checkbox:checked').length < 1) {

// Hide the array if no multi-opt options are checked

$('#question'+qArray+'').hide();

}

else {

$('#question'+qArray+'').show();

// Hide all columns of array

$('#question'+qArray+' table.question tbody td, #question'+qArray+' table.question thead th').hide();

// Loop through multi-opt checkboxes and, if checked, show corresponding column of array

$('#question'+qMultiOpt+' input.checkbox').each(function(i){

if($(this).attr('checked') == true) {

var classArr3 = $(this).attr('id').split('X'+qMultiOpt);

var ansCode3 = classArr3[1];

$('#question'+qArray+' .ans-'+ansCode3+'').show();

}

});

}

}

});

</syntaxhighlight>

'''FOR BOTH FILTER AND ARRAY QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and an array-by-column question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the ranking question.
*The function will hide the array question unless at least one option is selected in the multiple-options question, in which case, it will only show the corresponding array column(s).<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND ARRAY QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and an array-by-column question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the array question. Do not modify the "1".
*The function will hide the multiple options question. If options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the array columns.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA, 1);

});

</script>

</syntaxhighlight>

=Auto-tabbing between text input fields=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

This is a workaround to facilitate auto-tabbing between text input questions in a single group using a [http://plugins.jquery.com/project/autotab jQuery plugin by Mathachew] and the Maximum characters attribute of questions.

The behaviour will be: When the maximum number of characters has been entered into an input field, the focus (cursor) will be automatically moved to the next input field. When the backspace key is used to remove all characters from a field, the focus will be moved to the previous field. It's very useful in surveys having many text input questions to avoid having to manually tab or click between fields.

You can view a small demo survey [http://www.partnersinc.biz/surveys//index.php?sid=11327&newtest;=Y&lang;=en here].

Implementation is as follows:
#Visit [http://plugins.jquery.com/node/4046 http://plugins.jquery.com/node/4046], download the plugin script and save it as ''jquery.autotab-1.1b.js'' in the template folder.
#Link to the script by placing ''<script type="text/javascript" src="{TEMPLATEURL}jquery.autotab-1.1b.js"></script>'' within the ''<head>'' tag of startpage.pstpl.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Create the text based questions that auto-tabbing is to be applied to. (All must be in the same group if you're using group by group presentation)
#Define a Maximum characters attribute for all questions that the autotab is applied to. (See [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#maximum_chars documentation here])
#In the source of the first question of the group that contains the auto-tabbed questions, add the following code.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answerSSSSSXGGXAA').focus(); //initially focus on the first input

$('#answerSSSSSXGGXAA').autotab({ target: 'answerSSSSSXGGXBB' });

$('#answerSSSSSXGGXBB').autotab({ previous: 'answerSSSSSXGGXAA', target: 'answerSSSSSXGGXCC' });

$('#answerSSSSSXGGXCC').autotab({ previous: 'answerSSSSSXGGXBB', target: 'answerSSSSSXGGXDD' });

$('#answerSSSSSXGGXDD').autotab({ previous: 'answerSSSSSXGGXCC' });

});

</script></syntaxhighlight>

This example has 4 fields to be auto-tabbed between - all instances of the following must be replaced to be compatible with your survey (See image below):
*SSSSS -> Survey ID
*GG -> Group ID
*AA -> First question
*BB -> Second question
*CC -> Third question
*DD -> Last question

[[File:ids_343x252.gif]]

The ''target'' parameter defines where the next input is and the ''previous'' parameter defines (you guessed it) the previous input.

This plugin also has limited capability of formatting the input text - see comments in the plugin script.

=Custom response listeners=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

Listeners can be used to perform functions when a change in an input is detected. There are many uses such as the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds#Reverse_array_filter Reverse array_filter] but a simple one would be to warn a respondent if they enter a value that may be too high.

We can use the [http://docs.jquery.com/Events/change jQuery change( ) event] to fire a function whenever there is a change to the input. The function will look for an input value higher than 10 and, if found, will warn the respondent.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page where:
**11111 is the survey ID
**22 is the group ID
**33 is the question ID

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer11111X22X33').change(function() {

if ( $('#answer11111X22X33').val() > 10 ) {

alert ("That's an awful lot. Are you sure?");

}

});

});

</script></syntaxhighlight>

=Text input masks=

''Tested with: 1.90+, IE 7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">We're considering adding this as a built-in feature for version 1.92 (e.g. an advanced question attribute).</div>

There may be instances where you would like to place a mask on a text input - for example only allowing respondents to enter the correct characters for a North American phone number [[Expression Manager|Expression Manager]] rand() function. This can be part of a relevance equation to randomly control which questions are shown; or you can create an Equation question type to store the random value, and let that question be part of downstream relevance equations.</div>

This workaround allows you to generate a random number and then populate a hidden question with that number. You can then use this question to control the display of subsequent questions with [http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions]. It's useful if you have several sets of questions that you would like to randomly present to participants - see this [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/29579-experiment-with-random-questions.html forum post].

There is a small demo [http://www.partnersinc.biz/surveys//index.php?sid=12659&newtest;=Y&lang;=en here].

In the demo, in the first group, we generate a random number between 1 and 4 and populate a hidden question with it. Then in the second group we have 4 questions, each showing conditional on the answer of the first question.

Implementation for this demo is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the first group add a "Short free text" question (We're going to hide this with JavaScript)
#In the source of that question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#In the following groups add the questions that are conditional on the answer of the first question.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function Custom_On_Load(){

$(document).ready(function() {

// Find a random number between 1 and 4

var randNumber = Math.floor(Math.random()*4 + 1);

// Populate and hide the hidden question

$('input#answerSSSSSXGGXQQ').val(randNumber);

$('#questionQQ').hide();

/***********************************************************/

// This just tells the user which number has been selected

// You can remove this from your onload function

$('input#setNumber').val(randNumber);

$('input#setNumber').css({

'margin-left':'0.5em',

'width':'1.5em',

'text-align':'center',

'font-weight':'bold'

});

$('input#setNumber').attr('disabled', true);

/***********************************************************/

});

}

</script>

</syntaxhighlight>

Where '''SSSSS''' is the survey ID, '''GG''' is the group ID and '''QQ''' is the hidden question ID.

Increase or decrease the maximum value of the random number by modifying the first section. For example to get a number between 1 and 10 you would use this:

<syntaxhighlight lang="php" enclose="div">

var randNumber = Math.floor(Math.random()*10 + 1);

</syntaxhighlight>

The third section of code just populates a placeholder element that I use to tell the participant what's going on. You can remove it from your code.

=Minimum number of required answers in an array=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2,''

<div class="simplebox">As of version 1.92 all array style questions have the min_answers and max_answers options, so this script is obsolete.</div>

This workaround allows you to specify a '''minimum number''' of answers required in an array question. It is an alternative to the "Mandatory" parameter which specifies that '''all''' answers are required. It could also be easily modified to specify a maximum number of answers.

We accomplish this by placing an onload function in the source of the array question. This function hides the Next/Submit button and displays a warning element until it detects a minimum number of responses. It then hides the warning and shows the Next/Submit button.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=97166&newtest;=Y&lang;=en here].

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the source of the array question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Modify the ''SETTINGS'' section of the code as required.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

// Wait until the document is fully loaded

$(document).ready(function() {

/********************** SETTINGS **********************/

// The text to appear in the warning element

var warningText = 'Please answer at least 4 to continue';

// The question ID

var questionId = 137;

// The minimum number of answers required

var minNumber = 4;

/******************************************************/

// Create the warning element and place it after the submit button

var el = document.createElement('div');

el.setAttribute('id','warning');

document.body.appendChild(el);

$( '#warning' ).css({

'border':'1px solid #333333',

'width':'200px',

'padding':'3px',

'color':'red'

});

$('#warning').html(warningText);

$('input[type="submit"]').after($('#warning'));

// Detect the initial number of checked answers & display Next/Submit button accordingly

var inputInitCount = 0;

$('#question' + questionId + ' input').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputInitCount++;

}

});

if (inputInitCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// Listener to detect number of checked answers & display Next/Submit button accordingly

$('#question' + questionId + ' input.radio, #question'+questionId+' tbody[id<div class="simplebox">="javatbd"] td').click(function() {

var inputCount = 0;

$('#question' + questionId + ' input.radio').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputCount++;

}

});

if (inputCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// The original functions of the click event

checkconditions(this.value, this.name, this.type);

});

});

</script>

</syntaxhighlight>

=Minimum elapsed time before moving forward in survey=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

This workaround interrupts the Next/Submit function and checks the amount of time elapsed since the page loaded. If the time is less than the minimum dictated, the respondent is alerted and not allowed to proceed. It is useful if you want to enforce a minimum amount of time spent viewing a page.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page, replacing "TT" with the minimum number of seconds required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minTime(TT);

function minTime(minTime) {

var startTime = new Date();

$('#movenextbtn, #movesubmitbtn').click(function(){

var endTime = new Date();

if[[endTime - startTime)/1000 <= minTime) {

alert ('You must spend at least '+minTime+' seconds on the question.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Minimum number of characters in Long free text or Huge free text questions=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

</div>As of version 1.91, you can use regular expression masks (validation) to specify the minimum number of required characters. However, even if the question is mandatory, it can still be blank.<div class="simplebox">

</div>As of version 1.92, if you make the question mandatory and use a validation mask to specify the minimum number of characters, then the user will be forced to answer the question. Note that unlike 1.91, they can submit their current answers, even if partially invalid (so they are stored in the database), but they will not ber able to proceed to the next page until they have passed all mandatory and validity checks.<div class="simplebox">

This workaround interrupts the Next/Submit function and checks the number of characters entered in a Long free text or Huge free text question. If the number is less than the minimum dictated, the respondent is alerted and not allowed to proceed.

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|Set up your survey to use JavaScript].

#Place the script below in the source of one of the questions on the page, replace "QQ" with the question ID and "CC" with the minimum number of characters required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minChar(QQ, CC);

function minChar(qID, minChars) {

$('#movenextbtn, #movesubmitbtn').click(function(){

if($('#question'+qID+' textarea').val().replace(/ /g,'').length < minChars) {

alert ('You must enter at least '+minChars+' characters.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Variable Length Array (Multi Flexible Text) question=

''Tested with: 1.90+, IE 6/7/8, FireFox 3.0, Safari 3.2''

This workaround allows a respondent to add or remove rows of an Array (Multi Flexible Text) question. It's useful to avoid the page being cluttered with unnecessary array rows.

A function is placed in the template.js file of your template (use template editor). This function hides all of the array rows except the first and inserts two elements that when clicked show or hide rows accordingly.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=53132&newtest;=Y&lang;=en|here].

It must be noted that you can not make this question Mandatory as the respondent will have no way to complete hidden fields. If you want the displayed fields to be mandatory you will need to validate them in another function or modify this function to only allow the addition of rows if all fields in the last row are completed and then disable those fields - that, however, is a little over the top for this example.

Implementation is as follows:

#Set up your survey to use JavaScript (See instructions [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|here])

#Add the following script to your ''template.js'' file.

#Replace "QQ" in the function call at the end with the question ID.

#Create one or more Array (Multi Flexible Text) questions

#If you want to apply it to more arrays on the same page simply add more calls with the appropriate question IDs. (eg. varLengthArray(1); varLengthArray(2);...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// A function to add or remove rows of an Array (Multi Flexible)(Text) question

function varLengthArray(qID) {

if ($('#question'+qID+'').length > 0) {

// The HTML content of the Add/Remove elements - modify as you wish

var addContent = '[+]';

var removeContent = '[-]';

// Create the Add and Remove elements & insert them

var el1 = document.createElement('div');

el1.setAttribute('id','addButton'+qID);

document.body.appendChild(el1);

var el2 = document.createElement('div');

el2.setAttribute('id','removeButton'+qID);

document.body.appendChild(el2);

// Move them to after the array

$( 'div#addButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent(]];

$( 'div#removeButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent());

// Insert their HTML

$( 'div#addButton'+qID ).html( addContent );

$( 'div#removeButton'+qID ).html( removeContent );

// Style the elements - you can modify here if you wish

$( 'div#addButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

$( 'div#removeButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

// Initially hide the Remove element

$( 'div#removeButton'+qID ).hide();

// Call the functions below when clicked

$( 'div#addButton'+qID ).click(function (event) {

addRow(qID);

});

$( 'div#removeButton'+qID ).click(function (event) {

removeRow(qID);

});

// Function to add a row, also shows the Remove element and hides the

//Add element if all rows are shown

function addRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

if ( $( arrayRow + ':eq(' + rowCount + ')' ).attr('name') == 'visible' ) {

$( 'div#addButton'+qID ).hide();

}

}

// Function to remove a row, also clears the contents of the removed row,

// shows the Add element if the last row is hidden and hides the Remove

// element if only the first row is shown

function removeRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="visible"]:last input[type="text"]' ).val('');

$( arrayRow + '[name="visible"]:last' ).attr('name', 'hidden').hide();

$( 'div#addButton'+qID ).show();

if ( $( arrayRow + ':eq(1)' ).attr('name') == 'hidden' ) {

$( 'div#removeButton'+qID ).hide();

}

}

// Just some initialization stuff

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = '';

// Initially hide all except first row or any rows with populated inputs

$( arrayRow ).each(function(i) {

if ( i > 0 ) {

// We also need to give the hidden rows a name cause IE doesn't

// recognize jQuery :visible selector consistently

$( this ).attr('name', 'hidden').hide();

$('input[type=text]', this).each(function(i) {

if ($(this).attr('value') != '') {

$(this).parents('tbody:eq(0)').attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

}

});

rowCount = i;

}

});

}

}

// Call the function with a question ID

varLengthArray(QQ);

});

</syntaxhighlight>

=Expandable Array=

''Tested with: 1.90+, IE 6/7, FireFox 3.5, Safari 3.2''

This workaround allows you to present an array question incrementally. That is to say that initially only the first option (row) in the array is shown. When that option is answered the next is shown and so-on.

A JavaScript function is placed in the source of the array question. This function hides all of the array rows except the first and then displays them as options are answered.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=94958&newtest;=Y&lang;=en here].

The workaround supports following question types:
*Array (flexible labels)
*Array (flexible labels) by column
*Array (Yes/No/Uncertain)
*Array (Increase, Same, Decrease)
*Array (Flexible Labels) dual scale
*Array (10 point choice)

Implementation is as follows:
#Set up your survey to use JavaScript. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ documentation here])
#Create one or more Array questions
#In the source of the first array question add the following script.
#Replace "QQ" in the function call at the end of the script with the question ID of the array you would like to manipulate.
#If you want to apply it to more arrays on the same page, simply add more calls with the appropriate question IDs. (eg. expandingArray(1); expandingArray(2);...)

Onload code:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript">

$(document).ready(function() {

// A function to show subsequent rows of an array as options are checked

function expandingArray(qID) {

// Build an array of the question rows

var arrayRow = '#question' + qID + ' table.question tbody tr';

// Initially hide all rows unless an input was previously checked

$( arrayRow ).each(function(i) {

if ( $( arrayRow + ':eq(' + i + ') input.radio:checked' ).length != 0 ) {

$( this ).attr('name', 'clickedRow');

}

else {

$( this ).attr('name', 'hidden').hide();

}

});

// Now show the first hidden row

addRow();

// Add another row when an option is checked for the first time

$( '#question' + qID + ' td.answer input.radio' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

// The original function of the click event

checkconditions(this.value, this.name, this.type);

});

// Add another row when an table cell is clicked for the first time

$( '#question' + qID + ' table.question tbody td' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

});

// Function to add a row

function addRow() {

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

}

}

// Call the function with a question ID

expandingArray(QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - Multiple Options & List (radio) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround allows the answers of Multiple Options & List (radio) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last as in the image below:

[[File:random_336x179gif.gif]]

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

Some conditions on the use of this are:
*For Select/radio type questions it will only work if the [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $shownoanswer option] is set to 0 in config.php. ("No answer" is removed from the end of questions)
*You must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple Options or List (radio) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRand(11111, 22, 1); partRand(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in Multiple options and List/radio questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' td.answer li' ).each(function(i) {

ansCount = (i + 1);

});

// Place the last answer created at the end of the list

$( 'input#answer' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).parent().appendTo($( '#question' + qID + ' td.answer ul' ));

}

// Call the function with the SID, GID and QID

partRand(SSSSS, GG, QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - List (dropdown) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround, similar to the one above, allows the answers of List (dropdown) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more List (dropdown) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers

//except the last one in List/dropdown questions

function partRandDD(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' select option' ).each(function(i) {

ansCount = i;

});

// Place the last answer created at the end of the list

$( 'option[value="' + ansCount + '"]' ).appendTo($( 'div#question' + qID + ' select' ));

}

// Call the function with the SID, GID and QID

partRandDD(89344, 72, 244);

});

</script>

</syntaxhighlight>

=Partially Randomized Answers - Multiple numerical input=

''Tested with: 1.90+, Safari 5.1''

This workaround, similar to the ones above, allows the answers of Multiple numerical input questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple numerical input question with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in multiple numeric input questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' div.answers li' ).each(function(i) {

ansCount = (i - 1);

});

// Place the last answer created at the end of the list - but before the first helping sum

$( 'li#javatbd' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).insertBefore($( 'div#question' + qID + ' div.answers li.multiplenumerichelp' ).first());

}

// Call the function with the SID, GID and QID

partRand(SID, GID, QID);

});

</syntaxhighlight>

Using this solution for Multiple numerical input questions might be a bit more complicated than for other question types. All answers are organized in an unordered list (<ul>) structure. However, if advanced question settings like ''Equals sum value'' are used, LimeSurvey adds helping information (e.g. sum of all entries and remainder) to the same unordered list using the class ''multiplenumerichelp'' for these additional list items. The above example assumes that at least one of these list items is present and moves the last answer to the position right above the first helper item. Without such advanced settings, the code will most certainly need adaptation.

=Making one (or more) rows of an array mandatory=

''Tested with: 1.90+, IE 6/7, Firefox 3.0, Safari 3.2''

This workaround allows you to define one or more rows of an array question as mandatory (instead of all of them which the "Mandatory" question setting does). It is [http://www.partnersinc.biz/surveys//index.php?sid=26842&newtest;=Y&lang;=en demonstrated here].

A JavaScript function interrupts the submit function and checks if the inputs in the mandatory row(s) are populated. If not, an alert is popped up, the offending inputs are turned pink and the submit is aborted. Otherwise the submit goes ahead.

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions (see [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here]).
#Create the array question.
#In the source of the array question add the following script (see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here]).
#Modify the warningText (line10)as required.
#Replace "QQ" (lines 13 and 14) with the question ID and add calls as necessary for more rows - the example code renders rows 1 and 3 mandatory.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function () {

// Interrupt the submit function

$('form#limesurvey').submit(function () {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var empty = 0;

var warningText = 'Please complete the highlighted inputs.';

// Call the mandatory row function with question IDs and row numbers

mandatoryRow(QQ, 1);

mandatoryRow(QQ, 3);

// A function to render rows of an array mandatory

function mandatoryRow(qID, rowNum) {

$('div#question' + qID + ' table.question tbody[id</div>="javatbd"]:eq(' + Number(rowNum - 1) + ') input[type="text"]').each(function (i) {

if ($(this).val() == '') {

$(this).css('background-color', 'pink');

empty = 1;

} else {

$(this).css('background-color', '#FFFFFF');

}

});

}

if (empty == 1) {

alert(warningText);

return false;

} else {

return true;

}

});

});

</script></syntaxhighlight>

=Randomly displaying one of a few YouTube videos, and recording which was displayed=

''Tested in 1.85+''

Jason Cleeland has created and documented a method to randomly display one of a number of youtube videos in a single question, and save which one was displayed.

http://www.aptigence.com.au/home/archives/23-Random-display-of-videos-in-a-question-2-YouTube.html

=Randomly displaying one of a few pictures, and recording which was displayed=

''Tested in 1.91+''

The following steps allow you to randomly display one of a few pictures and record in the dataset which picture was displayed. We use four pictures in this example, but you can easily adapt these scripts according to your needs.

1. Create a new sub-directory '''pic''' in your LimeSurvey folder.

2. Copy four pictures (named ''1.jpg'', ''2.jpg'', ''3.jpg'', and ''4.jpg'') in this pic sub-directory.

3. Deactivate the ''Filter HTML for XSS'' function in LimeSurvey's ''Global Settings''.

4. Create a '''Short free text''' question where you want these pictures to be displayed.

5. Figure out the [http://docs.limesurvey.org/SGQA+identifier SGQA Identifier] of this question (e.g., 12345X67X89).

6. Paste the following code as question text after activating the editor's ''Source'' view and replace both SSSSSXGGXQQ strings with your SGQA identifier:

<syntaxhighlight lang="javascript" enclose="div">

Please have a look at this picture:

<br />

<script>

$(document).ready(

function(){

// Find a random number (here between 1 and 4)

var randNumber = Math.floor(Math.random()*4 + 1);

// Save the number as answer of this question

$('input#answerSSSSSXGGXQQ').val(randNumber);

// Hide this answer field

document.getElementById("answerSSSSSXGGXQQ").style.display='none';

// Show the picture

picString = '<img src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<p>

</p>

<div id="pic">

</div>

</syntaxhighlight>

If you want to display the number of this picture in a later question, use the following code as question text (don't forget to replace the SSSSSXGGXQQ string acordingly):

<syntaxhighlight lang="javascript" enclose="div">

You saw picture number {INSERTANS:SSSSSXGGXQQ}.

</syntaxhighlight>

Perhaps you want to display the same picture again in a later question, but a little bit smaller (100px width, 100px height)? Just paste the following code as question text after activating the editor's ''Source'' view, and replace the SSSSSXGGXQQ string acordingly:

<syntaxhighlight lang="javascript" enclose="div">

Here you see the picture again: <br>

<script>

$(document).ready(

function(){

// Get the picture number from previous question

var randNumber = "{INSERTANS:SSSSSXGGXQQ}";

// Show picture

picString = '<img width="100" height="100" src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<div id="pic">

</div>

</syntaxhighlight>

=Multiple numerical input with max_num_value defined in token (personalized limit)=

''Tested in 1.85+''

<div class="simplebox">As of version 1.92, max_num_value can be an experession, so you can simply enter the {TOKEN} or other variable in that question attribute.</div>

To make personalized survey with multiple numerical input when max_num_value (Maximum sum value) is different for each user and is loaded from the token use following tricks:
*Create 1st group with numerical input field (1000X10X11). "Limit"
*Add java script into this question:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

function Custom_On_Load(){

document.getElementById('answer1000X10X11').value='{TOKEN:ATTRIBUTE_1}';

document.getElementById('answer1000X10X11').readOnly=1;

}

</script>

</syntaxhighlight>

where:

TOKEN:ATTRIBUTE_1 is individual limit defined in token.

readOnly=1 // user shouldn't change it.
*Create 2nd group with multiple numerical input and add "Max value from SGQA" with 1000X10X11 as argument.

Note: If you don't want to show first field with numerical input (and show definied limit in different way) you can add 2 lines to above script to hide whole question:

<syntaxhighlight lang="javascript" enclose="div">

document.getElementById('question85').style.display='none';

document.getElementById('display85').value='';

</syntaxhighlight>

where:

question85 and display85 are field names.

Note: It's no possible to create it into one group, because all SGQA references can only refer to data on a previous page because when clicking next the answer is stored at the DB and the SGQA is replaced by querying the database.

=Default values in array questions=

''Tested with: 1.87+ (7557), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of Version 1.92, many more question types support default values.</div>

This workaround uses JavaScript to allow you to pre-check default answers in all sub-questions of an array type question. You can select a column of the array to be checked as the page loads. The script first checks to see if a sub-question has already been answered and, if not, checks the default answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#Create the array question.
#In the source of the array question add the following script.
#Replace"QQ" with the question ID and "CC" with the column number to be checked.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// A function to pre-check a column of an array

function checkedDefault(qID, column) {

var checkedCol = column - 1;

$('#question' + qID + ' table.question tbody tr').each(function(i) {

if ($('input.radio[checked=true]', this).length == 0) {

$('input.radio:eq(' + checkedCol + ')', this).attr('checked', true);

}

});

}

// Call the function with a question ID and column number

checkedDefault(QQ, CC);

});

</script>

</syntaxhighlight>

=Record group view time=

''Tested with: 1.87+ (8518), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of version 1.92, group view time is accurately recorded in the timings table if you choose the Record Timings survey option.</div>

This workaround uses JavaScript to populate a hidden question with the total time that a respondent views a group. If used in a group with only one question, it could be used to track the amount of time required to answer the question.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#In the group, create a short-text question. We will hide this later with JavaScript and populate it with the elapsed time.
#Place the following script in the source of the short-text question.
#Replace "QQ" in line 6 with the ID of the short-text question.

The script populates the hidden question with the elapsed time since the group was opened. If a respondent leaves the group and then returns, the timer continues up from the elapsed time of the last visit.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// call the functions with the hidden timer question ID

runTimer(QQ);

function runTimer(timeQID) {

$('#question'+timeQID).hide();

var initSec = '0';

// Check for elapsed time from previous visits

if ($('#question'+timeQID+' input.text').val()) {

var initTime = $('#question'+timeQID+' input.text').val();

initTimeArr = initTime.split(':');

initSec = Number[[initTimeArr[0]*3600]]+Number[[initTimeArr[1]*60]]+Number(initTimeArr[2]);

}

// Run the timer update function

recordTime(initSec, timeQID);

}

});

// Timer update function

function recordTime(elapsedSec, timeQID){

elapsedSec++;

var h = Math.floor(elapsedSec / 3600);

var m = Math.floor(elapsedSec % 3600 / 60);

var s = Math.floor(elapsedSec % 3600 % 60);

var elapsedTime = [[h > 0 ? h + ":" : "00:") + (m > 0 ? (m < 10 ? "0" : "") + m + ":" : "00:") + (s < 10 ? "0" : "") + s);

$('#question'+timeQID+' input.text').val(elapsedTime);

// Run the timer update function every second

setTimeout('recordTime('+elapsedSec+', '+timeQID+')',1000);

}

</script>

</syntaxhighlight>

=Toggle visibility of groups=

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

<div class="simplebox">Version 1.92 supports group-level relevance, making this workaround obsolete.</div>

This workaround uses JavaScript to toggle the visibility of groups in an "all in one" survey. Initially the groups are hidden and there are links inserted to display the groups. It's useful to avoid the page being cluttered with many groups and lets the respondent focus on one at a time.

It's [http://www.partnersinc.biz/surveys//index.php?sid=33613&newtest;=Y&lang;=en|demonstrated here].

Implementation is as follows:

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._|Set up your survey to use JavaScript].

#Set the survey to run in "all in one" mode.

#Add your groups and questions.

#Place the following script in the source of one of the questions in the first group.

The comments in the script are pretty self-explanatory but it does the following:

#initially hides all of the groups

#inserts a link above each one to toggle its display

#some styles are added to the clickable links but these could be done in template.css instead

#shows any groups that have an unanswered mandatory after a submit attempt

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Insert show/hide elements before all group wrapper divs

$('<div class="groupToggler"><span></span></div>').insertBefore('div[id<div class="simplebox">="group-"]');

// Add some text to the show/hide elements

$('.groupToggler span').each(function(i) {

($( this ).text('Show/Hide Group '+(i+1)+'']];

});

// Add some styles to the show/hide elements

$('.groupToggler').css({

'padding':'5px 0 10px 0',

'text-align':'center'

});

$('.groupToggler span').css({

'text-decoration':'underline',

'cursor':'pointer'

});

// Add some hover effects to the show/hide elements

$(".groupToggler span").hover(

function () {

$(this).css({

'text-decoration':'none',

'font-weight':'bold'

});

},

function () {

$(this).css({

'text-decoration':'underline',

'font-weight':'normal'

});

}

);

// Initially hide all of the groups

// Toggle their visibility when the show/hide element is clicked

$('.groupToggler span').click(function() {

$(this).parent().next().toggle();

return false;

}).parent().next().hide();

// Display any groups that have unanswered mandatories

$('.errormandatory').parents('div[id</div>="group-"]').show();

});

</script>

</syntaxhighlight>

=Use jQuery Autocomplete plugin to suggest answers for text inputs=

== 1.90 and previous versions==

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://docs.jquery.com/Plugins/Autocomplete jQuery Autocomplete] plugin to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

I've put together a small demonstration [http://www.partnersinc.biz/surveys//index.php?sid=78611&newtest;=Y&lang;=en here] and implementation is as follows.

'''Both methods:'''
*[http://docs.jquery.com/Plugins/Autocomplete Download the plugin]
*Place the files ''jquery.autocomplete.css'' and ''jquery.autocomplete.js'' in your template directory
*Add the following code inside the <head> element of startpage.pstpl

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.autocomplete.js"></script>

<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}jquery.autocomplete.css" /></syntaxhighlight>

'''Method 1 ("States" question in the demo):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete(states, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

'''Method 2 ("Countries" question in the demo):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var countriesArr = new Array();

$.getJSON(url,function(data){

$(data).each(function(i, item){

countriesArr.push(item);

});

$('#question'+qID+' input.text').autocomplete(countriesArr, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

== 1.91 and later versions==

''Tested with: 1.91+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

'''Both methods:'''
*Add the following styles to the end of your 'template.css' file

<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>

'''Method 1 (use local JavaScript array for data):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete({

source: states

});

});

</script></syntaxhighlight>

'''Method 2 (use remote CSV file for data):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var dataArr = [];

$.getJSON(url,function(data){

$.each(data,function(i, item){

dataArr.push(item);

});

$('#question'+qID+' input.text').autocomplete({

source: dataArr

});

});

});

</script></syntaxhighlight>

== Use autocomplete to populate several fields==

''Tested with: 1.91+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI and the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin to provide a respondent with a list of suggested answers as they type in a text input and then to automatically populate other fields depending on the selection.

For example, if you have 3 questions - "Name", "ID" and "Email" - you can use this workaround to autocomplete the "Name" question and then the "ID" and "Email" questions can be automatically populated with values associated with the selected name.
*Download the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin and place it in your template folder
*Add the following line to your startpage.pstpl BEFORE the tag for template.js<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.csv.js"></script></syntaxhighlight>
*Create your CSV file with 3 columns (name, ID, email) as in this example and place it in your template folder<syntaxhighlight lang="php" enclose="div">Bob, Bob's ID, Bob's email

Andy, Andy's ID, Andy's email

Sam, Sam's ID, Sam's email

Tony, Tony's ID, Tony's email

Fred, Fred's ID, Fred's email</syntaxhighlight>
*Create your 3 questions - "Name", "ID" and "Email". They must be in the same group/page.
*Add the following styles to the end of your 'template.css' file<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>
*Add the following script to the source of one of the questions
*Replace:
**"NN" with the "Name" question ID
**"II" with the "ID" question ID
**"EE" with the "Email" question ID
*Modify the path to your CSV file<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qNameID = NN;

var qIDID = II;

var qEmailID = EE;

var url = "upload/templates/yourTemplate/yourCsvFile.csv";

// Create an array to hold the names

var namesArr = new Array();

// Grab the CSV contents

$.get(url,function(data){

// Convert CSV contents to an array of arrays

fullArray = jQuery.csv()(data);

// Load the names array

$(fullArray).each(function(i, item){

namesArr.push(item[0]);

});

// Initialise the autocomplete plugin

$('#question'+qNameID+' input.text').autocomplete({

source: namesArr,

// Event fired when a selection is made (ui.item.value refers to the selected item)

select: function(event, ui) {

// Find the "ID" and "Email" values associated with the selected name value and load those questions

$(fullArray).each(function(i, item){

if(item[0] == ui.item.value) {

// The value from column 2 of the CSV

$('#question'+qIDID+' input.text').val(item[1]);

// The value from column 3 of the CSV

$('#question'+qEmailID+' input.text').val(item[2]);

}

});

}

});

});

});

</script></syntaxhighlight>

=Drag and Drop Rankings=

==Drag and Drop Ranking - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround is a modification of the workaround below and also uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables]. Thanks to the author of that workaround.

[[File:Untitled-12.png]]

Modifications include:
*Allow for multiple drag-n-drop ranking questions on a page
*Handle minimum and maximum answers settings
*Allow double clicking of items to add or remove them from the ranking list
*Work with the new shipped jQuery UI

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the large script below in your template.js file.
#Place the small script below in the source a ranking question, (this applies the "dragDropRank" function to the question). Replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID].
**Note: the LimeSurvey translations will be automatically used for the "Choices" and "Rankings" header labels but can be overridden with custom labels - see the example calls below.
#Insert the CSS below at the end of template.css (these styles are for the default template).

NOTE: I have not tested this workaround with conditions.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRank(qID, choiceText, rankText) {

if(!choiceText) {

choiceText = $('#question'+qID+' td.label label').text();

}

if(!rankText) {

rankText = $('#question'+qID+' td.output tr:first td:eq(1)').text();

}

//Add a class to the question

$('#question'+qID+'').addClass('dragDropRanking');

// Hide the original question in LimeSurvey (so that we can replace with drag and drop)

$('#question'+qID+' .rank, #question'+qID+' .questionhelp').hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

//$('#display'+qID).val('off');

// Add connected sortables elements to the question

var htmlCode = '<table class="dragDropTable"> \

<tbody> \

<tr> \

<td> \

<span class="dragDropHeader choicesLabel">'+choiceText+'</span><br /> \

<div class="ui-state-highlight dragDropChoices"> \

<ul id="sortable1'+qID+'" class="connectedSortable'+qID+' dragDropChoiceList"> \

<li>Choices</li> \

</ul> \

</div> \

</td> \

<td> \

<span class="dragDropHeader rankingLabel">'+rankText+'</span><br /> \

<div class="ui-state-highlight dragDropRanks"> \

<ol id="sortable2'+qID+'" class="connectedSortable'+qID+' dragDropRankList"> \

<li>Ranks</li> \

</ol> \

</div> \

</td> \

</tr> \

</tbody> \

</table>';

$(htmlCode).insertAfter('#question'+qID+' table.rank');

// Remove placeholder list items (have to have one item so that LimeSurvey doesn"t remove the <ul>)

$('#sortable1'+qID+' li, #sortable2'+qID+' li').remove();

// Load any previously-set values

loadDragDropRank(qID);

// Find the number of LimeSurvey ranking inputs ("Maximum answers")

var maxAnswer = $('#question'+qID+' td.output input.text').length;

// Set up the connected sortable

$('#sortable1'+qID+', #sortable2'+qID+'').sortable({

connectWith: '.connectedSortable'+qID+'',

placeholder: 'ui-sortable-placeholder',

helper: 'clone',

revert: 50,

receive: function(event, ui) {

if($('#sortable2'+qID+' li').length > maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

$(ui.sender).sortable('cancel');

}

},

stop: function(event, ui) {

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

}).disableSelection();

// Get the list of choices from the LimeSurvey question and copy them as items into the sortable choices list

$('#CHOICES_' + qID).children().each(function(index, Element) {

var liCode = '<li class="ui-state-default" id="choice_' + $(this).attr("value") + '">' + this.text + '</li>'

$(liCode).appendTo('#sortable1'+qID+'');

});

// Allow users to double click to move to selections from list to list

$('#sortable1'+qID+' li').live('dblclick', function() {

if($('#sortable2'+qID+' li').length == maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

return false;

}

else {

$(this).appendTo('#sortable2'+qID+'');

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

});

$('#sortable2'+qID+' li').live('dblclick', function() {

$(this).appendTo('#sortable1'+qID+'');

$('#sortable2'+qID+'').sortable('refresh');

$('#sortable1'+qID+'').sortable('refresh');

updateDragDropRank(qID);

});

}

// This function copies the drag and drop sortable data into the LimeSurvey ranking list.

function updateDragDropRank(qID)

{

// Reload the LimeSurvey choices select element

var rankees = [];

$('#sortable2'+qID+' li').each(function(index) {

$(this).attr('value', index+1);

// Get value of ranked item

var liID = $(this).attr("id");

liIDArray = liID.split('_');

// Save to an array

rankees[rankees.length] = { "r_name":$(this).text(),"r_value":liIDArray[1] };

});

$('#question'+qID+' input[name<div class="simplebox">="RANK_"]').each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

//alert (rankees[index].r_value);

$(this).next('input').attr('value', rankees[index].r_value);

} else {

$(this).val('');

$(this).next().val('');

}

});

// Reload the LimeSurvey choices select element (we need this for "Minimum answers" code)

$('#question'+qID+' td.label select option').remove();

$('#sortable1'+qID+' li').each(function(index) {

var liText = $(this).text();

var liID = $(this).attr('id');

liIDArray = liID.split('_');

var optionCode = '<option value="'+liIDArray[1]+'">'+liText+'</option>';

$(optionCode).appendTo('#question'+qID+' td.label select');

});

// Hack for IE6

if ($.browser.msie && $.browser.version.substr(0,1)<7) {

$('#question'+qID+' select').show();

$('#question'+qID+' select').hide();

}

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadDragDropRank(qID)

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$('#question'+qID+' input[name</div>="RANK_"]').each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { "r_name":$(this).val(),"r_value":$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won"t* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

var liCode = '<li class="ui-state-default" id="choice_' + value.r_value + '">' + value.r_name + '</li>';

$(liCode).appendTo('#sortable2'+qID+'');

});

}

</syntaxhighlight>

'''Code in the source of the question(s) using the LimeSurvey translations for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ);

});

</script>

</syntaxhighlight>

'''Code in the source of the question(s) using custom text for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ, 'Custom Choices Label', 'Custom Rankings Label');

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop ranking styles */

.dragDropTable {

border: 0 none;

border-collapse: collapse;

width: 100%;

}

.dragDropTable td {

vertical-align: top;

width: 50%;

padding-right: 20px;

}

.dragDropTable .dragDropHeader {

font-weight: bold;

}

.dragDropTable .dragDropChoices,

.dragDropTable .dragDropRanks {

margin: 5px 0 0 0;

background: transparent none;

border: 0 none;

}

.dragDropTable .dragDropChoiceList,

.dragDropTable .dragDropRankList {

float: left;

width: 100%;

min-height: 2.4em;

_height: 2.4em; /* IE6 and below hack */

margin: 0;

padding: 0;

list-style-type: none;

background: #FBFBFB none;

border: 1px solid #CCCCCC;

}

.dragDropTable .dragDropChoiceList li,

.dragDropTable .dragDropRankList li {

margin: 3px;

*margin-left: -13px; /* IE7 and below */

padding: 3px;

min-height: 1.3em;

_height: 1.3em; /* IE6 and below hack */

font-weight: normal;

cursor: move;

display: block; /* Force the li to full width */

}

</syntaxhighlight>

==Drag and Drop Ranking using Images - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround works in conjunction with the above workaround to allow ranking of images.

[[File:Untitled-11.png]]

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:

1) Follow the above workaround to get basic drag-n-drop functionality in your ranking question.

2) Insert your images in the ranking question text or help section after any text that you wish to have there (we'll move them later with JavaScript).

3) Give the images '''EXACTLY''' the same IDs as the answer code you would like them to be associated with:[[File:Untitled-8.png]]

4) Place the first script below in your template.js file.

5) Place the second script below in the source the ranking question '''AFTER''' the initial call for the dragDropRank function from the workaround above. Replace "QQ" with the ID of the ranking question (this applies the "dragDropRankImages" function to the question).

6) Insert the CSS below at the end of template.css. Replace "11" with your question ID. These styles are for the default template using 50x50px images (as in the demo) and may need to be modified for other templates or image sizes.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRankImages(qID) {

$('.connectedSortable'+qID+' li').each(function(i) {

// Remove any text in the sortable choice or rank items

$(this).text('');

// Move the images into the appropriate sortable list item

var liID = $(this).attr('id');

liIDArray = liID.split('_');

$('#question'+qID+' img#'+liIDArray[1]+'').appendTo(this);

});

}

</syntaxhighlight>

'''Code in the source of the question(s):'''

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRankImages(QQ);

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop for ranking images */
#question11 .dragDropTable {

width: auto;

}
#question11 .dragDropTable .dragDropChoiceList,
#question11 .dragDropTable .dragDropRankList {

min-height: 60px;

_height: 60px; /* IE6 and below hack */

width: auto;

min-width: 60px;

_width: 60px; /* IE6 and below hack */

}
#question11 .dragDropTable li {

background: 0 none;

border: 0 none;

height: 50px;

width: 50px;

}
#question11 .dragDropTable li img {

margin: 0;

padding: 0;

border: 0 none;

}

</syntaxhighlight>

==Drag and Drop Ranking for iPad - Version 1.91 and newer==

''Tested with: LimeSurvey 1.91, iPad 2''

This workaround extends the above workarounds to work with the touch interface on iPads.

1) Follow the "[http://docs.limesurvey.org/Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#Drag_and_Drop_Ranking_-_Version_1.90_and_newer Drag and Drop Ranking - Version 1.90 and newer]" workaround above to get basic drag-n-drop functionality in your ranking question.

2) Download the [https://github.com/furf/jquery-ui-touch-punch jQuery.ui.touch-punch.js plugin] and save it in your template directory.

3) Replace this line in your startpage.pstpl:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>With this:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.ui.touch-punch.js"></script>

<script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>

==Drag and Drop Ranking - Version 1.86==

Tested with 1.86 on IE 7,8, FireFox 3, Chrome, and Safari 4

This workaround uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables] to modify a ranking question and allow the survey taker to drag and drop choices instead of clicking. The nice thing is that the choices can be easily re-arranged or removed from the ranking, all by drag and drop.

I used it for a voting application and some of the element names reflect that use.

It looks best when some CSS is added to control the appearance of the boxers around each choice.

[[File:drag-n-drop.png]]

<syntaxhighlight lang="php" enclose="div">

// Question ID global variable

var questionID;

$(document).ready(function() {

// Grab the question ID[[File:drag-n-drop.png]]

// This is something with a class of "ranking" and an ID that starts with "questionXXXXX". The X's represent the question ID

var entire_questionID = $(".ranking[id<div class="simplebox">='question']").attr('id');

// Get just the question number (ID)

var patt=/\d+$/;

questionID=patt.exec(entire_questionID);

// Hide the original quetion in LimeSurvey (so that we can replace with drag and drop)

$(".rank, .questionhelp").hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

$("#display"+questionID).val("off");

// Add connected sortables to the question

var html_code = "<table style='border: medium none ; width: 770px; margin-left: auto; \

margin-right: auto;'><tbody><tr><td style='width: 590px; vertical-align: top;'><h3>List of Candidates:</h3> \

<div class='ui-state-highlight' style='margin: 5px; float: left;' id='ballot_list'> \

<ul id='sortable1' class='connectedSortable'><li>Candidates</li></ul></div></td> \

<td style='vertical-align: top;'><h3>Your selections:</h3><div class='ui-state-highlight' \

style='margin: 5px; float: left;' id='voting_selections'><ol id='sortable2' class='connectedSortable'> \

<li>Voting Area</li></ol></div></td></tr></tbody></table>";

$(html_code).appendTo("#question" + questionID);

// Remove list items (have to have one item so that LimeSurvey doesn't remove the <ul>)

$("#sortable1 li, #sortable2 li").remove();

// Load any previously-set values

loadRanking();

// Load jQuery UI

$.getScript("/scripts/jquery/jquery-ui.js", function() {

// After JQuery UI finishes loading, set up the connected sortable.

$("#sortable1, #sortable2").sortable({

connectWith: '.connectedSortable',

placeholder: 'ui-sortable-placeholder',

stop: function(event, ui) {

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

}

}).disableSelection();

// Get the list of candidates from the built-in LimeSurvey question and copy them as items in sortable1

$("#CHOICES_" + questionID).children().each(function(index, Element) {

li_tag = "<li class='ui-state-default' id='choice_" + $(this).attr('value') + "'>" + this.text + "</li>"

$(li_tag).appendTo("#sortable1"); } );

// Make sure the submit button is showing

$(":submit[value|=' Submit']").show();

// Show a confirmation alert upon submit

$("form").submit(function() {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var validated = confirm("Cast your ballot now?");

if (validated) { return true; } else { return false; }

});

// Allow users to double click to move to selection list

$("#sortable1 li").assignDblClick();

}); // End of JQuery UI loading

}); // End of JQuery ready function

// Define the actions when an item is double clicked

$.fn.assignDblClick = function()

{

$(this).dblclick(function(){

$(this).appendTo('#sortable2');

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

});

}

// This function copies the drag and drop sortable data into the standard LimeSurvey ranking structure.

function updateRanking()

{

var rankees = [];

$('#sortable2 li').each(function(index) {

$(this).attr("value", index+1);

// Get value of person

li_tag = $(this).attr('id');

li_tag_array = li_tag.split("_");

// Save to an array

rankees[rankees.length] = { 'r_name':$(this).text(),'r_value':li_tag_array[1] };

});

$("input[name</div>='RANK_']").each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

$(this).next().val(rankees[index].r_value);

} else {

$(this).val("");

$(this).next().val("");

}

});

// Re-assign double click action to first list items and remove

// double click action from section list items

$('#sortable1 li').unbind('dblclick').assignDblClick();

$('#sortable2 li').unbind('dblclick');

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadRanking()

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$("input[name<div class="simplebox">='RANK_']").each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { 'r_name':$(this).val(),'r_value':$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won't* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

li_tag = "<li class='ui-state-default' id='choice_" + value.r_value + "'>" + value.r_name + "</li>";

$(li_tag).appendTo("#sortable2");

});

}

</syntaxhighlight>

=Create MaxDiff question type=

See the "[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating&structure;=English+Instructions+for+LimeSurvey Question design, layout and templating]" section for a workaround that uses JavaScript to convert an '''''Array (flexible labels) by column''''' question into a [http://en.wikipedia.org/wiki/MaxDiff MaxDiff] question type.

[[File:max_diff_596x253.gif]]

=In a checkbox matrix, have the 'none' option in a row disable all other columns in that row=

''Tested with: Limesurvey 1.90+''

The questionId parameter is the base ID of the question matrix (multiflexible).

numColumns and numRows speak for themselves

specialColumns is an array of the columns that have the special ability that when one of them

is checked, none of the others can be checked. E.g., a 'none of these' and/or a 'do now know' option.

<syntaxhighlight lang="php" enclose="div">

<script>

numColumns=13;

numRows=18;

questionId='28417X2X24';

specialColumns=[1,12,13];

function action(obj){

locator=obj.id.replace('cbox_'+questionId, '').split('_');

row=locator[0];

column=locator[1];

//alert('Action for row,column='+row+','+column);

my_id='#cbox_'+questionId+row+'_'+column+''

if($(my_id).attr('checked') == false) {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

$(id).attr('disabled',false);

}

} else {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

aid='#answer'+questionId+row+'_'+i

$(aid).val(0);

$(id).attr('checked',false);

$(id).attr('disabled',true);

}

}

}

function customOnLoad(){

for( var row=1; row<=numRows; row++ ) {

for( var k=0; k<specialColumns.length; k++ )

{

column=specialColumns[k];

$('#cbox_'+questionId+row+'_'+column).change(function() {

action(this);

});

}

}

}

jQuery(document).ready(

function(){

customOnLoad();

}

);

</script>

</syntaxhighlight>

=Last Option In Array (Numbers) (Checkboxes) Row Excludes All Others=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to make the last option of each Array (Numbers) (Checkboxes) row exclude all other options in the same row.

The script will uncheck all options in a row if the last option is checked and uncheck the last option in a row if any other options are checked.

It's [http://www.partnersinc.biz/surveys//index.php?sid=22532&newtest;=Y&lang;=en demonstrated here].

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following script in the source of the array question or the group description.
#Call the script by replacing "QQ" in line 6 with your array question ID (you can call the script for more array questions by copying this line with new IDs).

NOTE: Care should be taken when using this script and conditional questions on the same page.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the exclude function using question ID(s)

excludeOpt (QQ);

// A function to make the last option in each array row exclusive

function excludeOpt (qID) {

// Add some classes to the checkboxes so we can manipulate them

$('#question'+qID+' table.question tbody td').addClass('normalOpt');

$('#question'+qID+' table.question tbody').each(function(i) {

$('td:last', this).removeClass('normalOpt').addClass('exlusiveOpt')

});

// A listener on the checkbox cells

$('#question'+qID+' table.question tbody td').click(function (event) {

// Set some vars

var el = $(this).parent();

var optLength = $('td', el).length

// Uncheck the appropriate boxes in a row

if ($(this).hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el).attr('checked', false);

}

else {

$('td', el).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

// A listener on the checkboxes

$('#question'+qID+' table.question tbody td input[type=checkbox]').click(function (event) {

// Set some vars

var el2 = $(this).parent().parent();

var optLength = $('td', el2).length

// Uncheck the appropriate boxes in a row

if ($(this).parent().hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el2).attr('checked', false);

}

else {

$('td', el2).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

}

});

</script>

</syntaxhighlight>

=Load SVG Code From Drawing Tool=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to load a drawing tool and store the results in a huge-text question.

The drawing tool is supplied by [http://www.mainada.net/inputdraw/ mainada.net].

Implementation is as follows:
#Go to [www.mainada.net/inputdraw/downloads|www.mainada.net/inputdraw/downloads], download the latest package and install all files in the root of your LS installation (you only really need '''inputdraw.js''', '''inputdraw.non-commercial.v1.5.swf''' and '''swfobject.js''' but the others are cool to play with).
#Add the following to the <head> element of your template startpage.pstpl file to pull in the scripts:

+~hs<span style="color:hs</span>hs<span style="color:hs~<script src="swfobject.js" type="text/javascript"></script>

+~hs</span>hs<span style="color:hs</span>hs~<script src="inputdraw.js" type="text/javascript"></script>
#Create a huge-text question and add the following script to the source of that question.

The script will">
*Automatically find the ID of the first huge-text question on the page
*Insert the drawing element into the huge-text question
*Hide the textarea of that question
*Populate it with the SVG code generated by the drawing element.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey, group and question IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

var qIDStr = $('div.text-huge:eq(0)').attr('id');

var tmp2 = qIDStr.split('question');

var qID = tmp2[1];

}

var textAreaID = 'answer'+sID+'X'+gID+'X'+qID;

// Hide the textarea

$('#'+textAreaID+'').hide();

// Insert an element for the drawing tool

$('<div id="place"></div>').insertBefore($('#'+textAreaID+''));

// Load the drawing tool

var draw = new InputDraw('inputdraw.non-commercial.v1.5.swf', 'place', {

id:textAreaID,

width:'350',

height:'100',

stroke_style:'2 1 rgb(255,0,0)',

animation:60,

color:'#CCCCCC' ,

tools_color:'0xd6c004',

clean:'clear.png',

undo:'undo.png',

disable:'size opacity color' // Get rid of most of the tools

});

});

</script>

</syntaxhighlight>

=Add Navigation Buttons (Next and Previous) To Top Of Page=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

Add the following to the end of template.js. It will insert a new div after the progress bar and then insert clones of the nav buttons in the new div.

This example is for the default template in 1.90 or 1.91. The placement of the new div may need to be modified for other templates.

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// Insert a new div after the progress bar

$('<div id="navigator2" />').insertAfter('#progress-wrapper');

// Style the new div

$('#navigator2').css({

'text-align':'center'

});

// Insert clones of the nav buttons in the new div

$('input.submit:eq(0)').clone().appendTo('#navigator2');

$('input.submit:eq(2)').clone().appendTo('#navigator2');

// Give the new buttons some new IDs

$('#navigator2 input.submit').each(function(i) {

var oldID = $(this).attr('id');

var newID = oldID + '2';

$(this).attr('id', newID)

});

});

</syntaxhighlight>

[[File:extra_buttons.png]]

=How to ''add'' an opt out link to your survey using javascript.=

Tested with: 1.91+, Firefox 5.0

This javascript inserts a link to opt out of the survey above the progress bar.

First see the section above entitled: "How to use Script (eg. JavaScript etc.) in LimeSurvey?".

Then insert the following code into to the source of a group description or a question. I used the group description.

<syntaxhighlight lang="php" enclose="div"> <script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey ID

if($('input#fieldnames').length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

}

// Insert a new div after the progress bar

$('<div id="optOutLink" />').insertBefore('#progress-wrapper');

// Style the new div

$('#optOutLink').css({

'text-align':'center'

});

// Insert opt out url in the new div

$('#optOutLink').html('<P><a href="optout.php?lang=en&sid;='+sID+'&token;={TOKEN}"> /

Click here to opt out of this survey.</a></p><br>');

});

</script></syntaxhighlight>

=Anonymously track respondents answers across multiple surveys=

''Tested with: 1.91+ and 1.92+''

This workaround uses JavaScript/jQuery to enable tracking of respondents across multiple surveys ensuring anonymity (it does not use tokens).

To do this you have to use this question in all the surveys you want to link respondents answers.

This workaround create an ID by asking some partial personal information (like initials, birth month ...). The ID will be encrypted using a one-way function (in this case SHA-1) and stored in a brief text answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following code in the source of a brief text question.
#Optional: you can also add other select field to avoid collisions (e.g. for large population sample)

<syntaxhighlight lang="php" enclose="div">

<p>This answers are used to generate your ID. These information will be encrypted, it will not be possible in any case to identify you neither from your answers nor from your ID.</p>

<table>

<tr>

<td>Initial of your name</td>

<td>

<select id="field1">

<option value=""></option>

<option value="A">A</option>

<option value="B">B</option>

<option value="C">C</option>

<option value="D">D</option>

<option value="E">E</option>

<option value="F">F</option>

<option value="G">G</option>

<option value="H">H</option>

<option value="I">I</option>

<option value="J">J</option>

<option value="K">K</option>

<option value="L">L</option>

<option value="M">M</option>

<option value="N">N</option>

<option value="O">O</option>

<option value="P">P</option>

<option value="Q">Q</option>

<option value="R">R</option>

<option value="S">S</option>

<option value="T">T</option>

<option value="U">U</option>

<option value="V">V</option>

<option value="W">W</option>

<option value="X">X</option>

<option value="Y">Y</option>

<option value="Z">Z</option>

</select>

</td>

</tr>

<tr>

<td>Your birth month</td>

<td>

<select id="field2">

<option value=""></option>

<option value="01">January</option>

<option value="02">February</option>

<option value="03">March</option>

<option value="04">April</option>

<option value="05">May</option>

<option value="06">June</option>

<option value="07">July</option>

<option value="08">August</option>

<option value="09">September</option>

<option value="10">October</option>

<option value="11">November</option>

<option value="12">December</option>

</select>

<td>

</tr>

</table>

<script type="text/javascript" src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/sha1.js"></script>

<script type="text/javascript">

$(document).ready(function() {

$("#answer{SGQ}").attr('readonly', 'readonly');

//$("#answer{SGQ}").css('display', 'none'); //uncomment this line for not displaying the code

});

$('#field1, #field2').bind('change keyup', function() {

if ($("#field1").val()=='' || $("#field2").val()=='')

$("#answer{SGQ}").val('');

else {

var sha1 = CryptoJS.algo.SHA1.create();

sha1.update($("#field1").val());

sha1.update($("#field2").val());

// sha1.update($("#otherfield").val());

var hash = sha1.finalize();

$("#answer{SGQ}").val(hash);

}

});

</script>

</syntaxhighlight>

=Check validity of international phone number in subquestion=

''Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an international phone number in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the phone function with the question ID and the row number

phoneTest(QQ, NN);

function phoneTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var phoneMatch = /^[0-9,+,(), ,]{1,}(,[0-9]+){0,}$/;

var msg1 = 'Please enter a valid phone number.';

// Test the input

var phoneInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(phoneInput != '' && !phoneMatch.test(phoneInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1136 regexlib.com blank]

=Check validity of email address in subquestion=

'Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an email address in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the email function with the question ID and the row number

emailTest(QQ, NN);

function emailTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var emailMatch = /^[a-zA-Z0-9\_\-]+[a-zA-Z0-9\.\_\-]*@([a-zA-Z0-9\_\-]+\.)+([a-zA-Z]{2,4}|travel|museum)$/;

var msg1 = 'Please enter a valid email address.';

// Test the input

var emailInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(emailInput != '' && !emailMatch.test(emailInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1653 regexlib.com blank]

=Hiding the help-text when it's empty=

Tested with: 1.91+

I had made a style in my template putting a border around my help-text. To avoid empty help-text to show up (and have lines instead of just 'nothing' when there was no help text, I used this piece of code in question.pstpl:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var questionhelp="{QUESTIONHELP}";

if (questionhelp=="") {

document.write("");}

else {

document.write('<tr><td class="survey-question-help">'+ questionhelp +'</td></tr>');}

</script>

</syntaxhighlight>

it can probably be optimized but it worked for me

=Disable or hide selected fields in a matrix question=

''Tested with: 1.92+, IE 7/8/9, FireFox 12/13''

TASK

Hide or disable selected fields in a Matrix, so that users cannot make any input.

(See example, where users should not make input into red framed fields)

[[File:snap035.gif]]

Fig. 1: Prevent users from input into first two fields (as an example)

SOLUTION

First find the name of the fields you want to hide / disable. In my case I used Firebug with firefox to figure that out.

[[File:snap037.gif]]

Fig. 2: Figure out the name(s) of the field(s)

Then put the following script-code into the HTML-source code as described above:

Note: you have to change the code to match the names of your fields!

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('input[name="69965X2X10SQ001_SQ001"]').attr('disabled', 'disabled');

$('input[name="69965X2X10SQ001_SQ002"]').attr('hidden', 'hidden');

});

</script>

</syntaxhighlight>

[[File:snap039.gif]]

Fig. 3: Result: first field is diabled ("greyed out"), second one is completely hidden

I think this way one can apply many other attributes to a field like color etc. But did not try that myself.

Thanks to roB2009 for the input in the forum!

=Add prefix or suffix to question type "Array (Texts)"=

TASK

Add a prefix or suffix to the text fields in questions of the "Array (Texts)" type.

[[File:suffix.png]]

Fig. 1: Suffix

[[File:prefix.png]]

Fig. 1: Prefix

SOLUTION
*Set up your survey to use JavaScript.
*Add the following script to the source of the array. Replace "12345" with the array question ID and modify the suffixes/prefixes as required.
*The function call must consist of a question ID followed by the suffixes for each column. Suffixes/Prefixes must be enclosed in quotes and comma separated.
*In this example question ID 12345 will get an "in €" suffix in the first column and an "in %" in the next 3 columns.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the function with the question ID followed by a comma-separated list of suffixes

addSuffix(12345, 'in €', 'in %', 'in %', 'in %');

function addSuffix() {

var qID = $(arguments)[0];

// Assign some column-specific classes

$('#question'+qID+' table.question tbody tr').each(function(i){

$('td', this).each(function(i){

$(this).addClass('answerCol-'+(i+1)+'');

});

});

// Some styling

$('#question'+qID+' table.question tbody input[type="text"]').css({

'width': '50%'

});

// Insert the suffixes

$(arguments).each(function(i, val){

if(i > 0) {

$('#question'+qID+' td.answerCol-'+i+' label').append(val);

}

});

}

});

</script></syntaxhighlight>

For adding a prefix you need to substitute the following line in the code

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').append(val);</syntaxhighlight>

with this

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').prepend(val);</syntaxhighlight>

=Add prefix or suffix to question type "Array (Texts)"=

TASK

Add a prefix or suffix to the text fields in questions of the "Array (Texts)" type.

[[File:suffix.png]]

Fig. 1: Suffix

[[File:prefix.png]]

Fig. 1: Prefix

SOLUTION
*Set up your survey to use JavaScript.
*Add the following script to the source of the array. Replace "12345" with the array question ID and modify the suffixes/prefixes as required.
*The function call must consist of a question ID followed by the suffixes for each column. Suffixes/Prefixes must be enclosed in quotes and comma separated.
*In this example question ID 12345 will get an "in €" suffix in the first column and an "in %" in the next 3 columns.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the function with the question ID followed by a comma-separated list of suffixes

addSuffix(12345, 'in €', 'in %', 'in %', 'in %');

function addSuffix() {

var qID = $(arguments)[0];

// Assign some column-specific classes

$('#question'+qID+' table.question tbody tr').each(function(i){

$('td', this).each(function(i){

$(this).addClass('answerCol-'+(i+1)+'');

});

});

// Some styling

$('#question'+qID+' table.question tbody input[type="text"]').css({

'width': '50%'

});

// Insert the suffixes

$(arguments).each(function(i, val){

if(i > 0) {

$('#question'+qID+' td.answerCol-'+i+' label').append(val);

}

});

}

});

</script></syntaxhighlight>

For adding a prefix you need to substitute the following line in the code

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').append(val);</syntaxhighlight>

with this

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').prepend(val);</syntaxhighlight>

Workarounds: Manipulating a survey at runtime using Javascript

2012-07-06T22:47:25Z

Holch:

Often you want to manipulate certain elements of a survey at runtime. The only solution without touching the source code is to use Javascript or jQuery which is shipped with Limesurvey. Here are some examples to hide and style elements, validate user input or do calculations at runtime.

Non Javascript workarounds can be found at
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Survey+behaviour&structure;=English+Instructions+for+LimeSurvey Workarounds - Survey Behavior]
* [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating Workarounds - Question design, layout and templating]

<div class="simplebox"><center>'''Please keep in mind that the workarounds published here are no official Limesurvey extensions but solutions that other users created for themselves.<br/><span style='color:#EE0000,#FFFFFF'>Therefore we can't give support for any solution on this page.</span><br/>Please contact the users that, thankfully, shared their solutions with the community if you have any questions.'''</center></div>

<div class="simplebox">Note: Version 1.92 implements many new features that make some existing workarounds obsolete. You can continue to use existing workarounds, but may want to consider switching over to using the new features (since those new features are officially supported, and the workarounds are not). Please review below for details of which are no longer needed.</div>

<div class="simplebox">Also Note: Version 1.92's Expression Manager (EM) may cause some of these work-arounds to fail. Any custom javascript included as a .js file will be fine. However, if you in-line your JavaScript code, you must make sure that you have a space after every opening (left) curly brace, and a space before every closing (right) curly brace. Otherwise, EM will think that the content between the curly braces is something it should parse and understand. I have fixed all of the work-arounds below that can be fixed (many did not follow those rules). However, some will continue to break. If a work-around contains a regular expression which contains curly braces (to indicate a range of repeats of a sub-expression), EM will try to process those curly braces, and thus break your regular expression. Strategies to continue to support that work-around functionality are discussed below.</div>

__TOC__

=How to ''add'' a javascript workaround solution to this Wiki page?=

Well, this is pretty easy. Click the edit icon and create your own headline within the javascript section starting with "'''!'''". Then add a short note about the version you have used when creating your workaround, you can copy/paste this code snippet <nowiki>''Tested with: (enter Limesurvey version and maybe browser)''</nowiki>.

Finally it's imported to mark all your code with code tags, other wise you might break this page.
*Start tag: '''<nowiki><syntaxhighlight lang="php" enclose="div"></nowiki>'''
*End tag: '''<nowiki></syntaxhighlight></nowiki>'''.

=How to ''use'' Script (eg. JavaScript etc.) in LimeSurvey?=

To use JavaScript within Limesurvey, the XSS filter must be turned off and the code inserted in the source of a question or a group description.
*Go to Global settings --> Security and set "Filter HTML for XSS" to "Off".
* [http://docs.limesurvey.org/tiki-index.php?page=Adding+A+Question Add a new question]
* Edit the question and click the "Source" button in the editor toolbar:

[[File:editor_1.gif]]
* Enter your script after the question text:

[[File:editor_2.gif]]
* Save the question

A simple test to see if JavaScript is enabled is to echo an alert. Use this code:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

alert("Test!");

</script></syntaxhighlight>

It is a good practice to use the jQuery $(document).ready function to prevent the code from executing until the page is fully loaded:

<syntaxhighlight lang="javascript" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

alert("Test!");

});

</script></syntaxhighlight>

=Sum up input values using Javascript=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the sum() function in [[Expression Manager|Expression Manager]]. See this [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]].</div>

This is from a survey that is a invitation to a longer party, when the user clicks to the next page, the calculated results will be shown.

If you wonder what the {INSERTANS:1X6X12} stuff is, look at [http://docs.limesurvey.org/tiki-index.php?page=SGQA+Identifier SGQA identifier] and [http://docs.limesurvey.org/tiki-index.php?page=Adding+a+Question#Information_from_previous_answers Using information from previous answers].

<syntaxhighlight lang="html" enclose="div">

<div style="text-align: left">These are your answers:<br />

<u></u><u></u><u></u><u></u><u>=

<p><script LANGUAGE="JavaScript">

partyprice = 3;

beadclothprice = 3;

breakfastprice = 7;

lunchprice = 8;

dinnerprice = 10;

foodtotal = 0;

var isreallytrue = "Yes";

var noanswer = "No answer";

document.write( "Can you come? = {INSERTANS:45251X1X1}<BR>" );

if ("{INSERTANS:45251X1X1}" == isreallytrue )

{

if ("{INSERTANS:45251X1X3}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X3}"; }

partypeople = parseInt(answer);

partytotal = partyprice * partypeople;

document.write( "It's {INSERTANS:45251X1X3} persons who will come = " + partytotal + "€<BR>" );

if ("{INSERTANS:45251X1X4}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X4}";}

beadcloths = parseInt(answer);

beadclothtotal = beadclothprice * beadcloths;

document.write( "You want to borrow {INSERTANS:45251X1X4} beadcloths = " + beadclothtotal + "€<BR>" );

document.write( "Will you be there thursday? = {INSERTANS:45251X1X5}<BR>" );

document.write( "On friday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X71}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X71}";}

breakfastfriday = parseInt(answer) * breakfastprice;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastfriday + "€<BR>" );

if ("{INSERTANS:45251X1X72}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X72}";}

lunchfriday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchfriday + "€<BR>" );

if ("{INSERTANS:45251X1X73}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X73}";}

dinnerfriday = parseInt(answer)* dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnerfriday + "€<BR>" );

foodtotal = breakfastfriday + lunchfriday + dinnerfriday;

document.write( "Will you be there saturday? = {INSERTANS:45251X1X8}<BR>" );

if ("{INSERTANS:45251X1X8}" == isreallytrue )

{

document.write( "On saturday you will have these meals: <BR>" );

if ("{INSERTANS:45251X1X91}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X91}"; }

breakfastsaturday = parseInt(answer) * breakfastprice ;

document.write("'''_ " + answer + " breakfeasts = " + breakfastsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X92}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X92}"; }

lunchsaturday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsaturday + "€<BR>" );

if ("{INSERTANS:45251X1X93}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X93}"; }

dinnersaturday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersaturday + "€<BR>" );

foodtotal = foodtotal + breakfastsaturday + lunchsaturday + dinnersaturday;

}

document.write( "Will you be there sunday? = {INSERTANS:45251X1X10}<BR>" );

if ("{INSERTANS:45251X1X10}" == isreallytrue )

{

document.write( "On sunday you will have these meals: <br>" );

if ("{INSERTANS:45251X1X111}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X111}"; }

breakfastsunday = parseInt(answer) * breakfastprice ;

document.write( "'''_ " + answer + " breakfeasts = " + breakfastsunday + "€<BR>" );

if ("{INSERTANS:45251X1X112}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X112}"; }

lunchsunday = parseInt(answer) * lunchprice ;

document.write( "'''_ " + answer + " lunches = " + lunchsunday + "€<BR>" );

if ("{INSERTANS:45251X1X113}"== noanswer) { answer = 0; }

else { answer = "{INSERTANS:45251X1X113}"; }

dinnersunday = parseInt(answer) * dinnerprice ;

document.write( "'''_ " + answer + " dinners = " + dinnersunday + "€<p>" );

foodtotal = foodtotal + breakfastsunday + lunchsunday + dinnersunday;

}

total = partytotal + beadclothtotal + foodtotal;

document.write( "<h3>In total it will cost you " + total + "€</h3><BR>

Put that sum in this bank account 1234 5678 9012" );

}

</SCRIPT></p>

</div></syntaxhighlight>

=Multiple Question Validation=

''Tested with: ''

<div class="simplebox">As of version 1.92, this is easier to do using the min/max/equals_num_value attributes (to validate sums), or the em_validation_q function, which lets you refer to other variables when you validate the current question [[Expression Manager|Expression Manager]]. Such validations also work on the current page, and properly handle array_filter and cascading relevance.</div>

This workaround is in case you need to do some validation involving more than one question, it implies a very little JavaScript programming and the use of SQGA Identifiers; this should work on almost any version of LimeSurvey.

Is easy to explain with an example, we need to do a survey of the percentage of males and females and we want to be sure that the sum is 100, to do this follow this steps (the necessary data that is not indicated in these instructions are not important i.e. question codes, etc.):
#Create a new survey of type “group by group”, set the “Show |<< Prev| button” to yes and note the SID.
#Add a new group called “Group 1” and note the GID.
#Add a new question “Percent of males” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID1).
#Add a new question “Percent of females” of type “numeric”, make it mandatory and note the QID (we will refer to this as QID2).
#Add a new group called “Group 2”
#Add a new non mandatory question, here is the trick the question text has to be (be sure to replace the SID, GID, QID1 and QID2

<syntaxhighlight lang="javascript" enclose="div">

<script>

function validation()

{

if [[{INSERTANS:SIDXGIDXQID1}+{INSERTANS:SIDXGIDXQID2}) != 100)

{

alert("Your responses don't sum 100! Check them");

document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

else

{

document.limesurvey.move.value = 'movelast';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</script>

</syntaxhighlight>

But this will show shortly the question and will jump to the end page, a little weird for the survey taker but works.

This is a proof of concept, and may have some problems, please if you notice something or improve it send me an e-mail to leochaton-limesurvey at yahoo dot com.

This will work for 2 questions that you want to be the same. Works well for email and confirm email questions

<syntaxhighlight lang="php" enclose="div">

function validation() {

if ("{INSERTANS:SIDXGIDXQID}" != "{INSERTANS:SIDXGIDXQID}") {

alert("Your responses don't match Check them"); document.limesurvey.move.value = 'moveprev';

document.limesurvey.submit();

}

}

setTimeout("validation()",250);

</syntaxhighlight>

=Alternate exit=

''Tested with: ''

Using the same idea of the previous post, you can implement an alternate exit of your survey.

This script should be in the first question to be displayed in a next page after the question that should trigger the alternate exit. In this example the question that trigger the alternate exit is a Yes/No question, if the user chooses no, he is redirected to another page.

<syntaxhighlight lang="php" enclose="div">

<script>

if ("{INSERTANS:SIDXGIDXQID}" == "No")

{

window.location="http://www.limesurvey.org";

}

</script>

</syntaxhighlight>

=Custom onload function=

''Tested with: 'All browsers', LimeSurvey 1.70 and up

==General==

This simple workaround describes how to '''add a custom Javascript code''' that is triggered right after the page is loaded. It may have numerous applications, especially when you deal with a custom JS/HTML code. It may be used to hide form elements (<input> tags), make them read-only, display alert messages, etc.

To run any Javascript code right after page load use the Query ready() function. It will be executed when the page is being loaded. For example when you add the following code to one of your question definitions...:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(

function(){

alert('onload alert!');

}

);

</script>

</syntaxhighlight>

...it will display a pop-up message immediately after the page has been loaded.

Some of the applications of this trick I've explored are:

a) Hiding the form elements by calling in your Custom_On_Load:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").style.display='none';</syntaxhighlight>

Note: As of svn build 9755, you can now dynamically reference the questions input fields by using the {SGQ} keyword. You can rewrite the previous example like this:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer{SGQ}").style.display='none';</syntaxhighlight>

this makes it a little easier when exporting surveys, so you don't have to worry about manually entering each questions SurveyGroupQuestion ID.

b) Making the elements read only:

<syntaxhighlight lang="php" enclose="div">document.getElementById("answer73166X16X54").readOnly=true;</syntaxhighlight> where the "answer73166X16X54" structure has been described in one of other workarounds above.

c) For Hiding by a lot of elements by calling in your Customer_On_Load

jQuery searchs in html document for input-fields with radio type, if his answer text empty then do the display css set to none.

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function() {

jQuery('input:radio').each(

function() {

var s = jQuery(this);

var c = s.parent().children('.answertext');

for(var i=0; i < c.length; i++) {

var a = jQuery(c[i]]);

if(this.id </u> a.attr('for') && a.text() == '') {

s.css({ 'display' : 'none' });

a.css({ 'display' : 'none' });

break;

}

}

}

)

}

);

</syntaxhighlight>

==Advanced usage==

If you want to place global Javascript code using the above jQuery(document).ready function then the best place to do this is the template javascript file template.js. You can edit this file using the template editor. Please be aware that placing it in the template javascript file will make the function available to all surveys using that template. If needed just create a new template copy for your survey.

Alternatively you can place the jQuery(document).ready function in the group description to make a Javascript function only available to a certain question group.

==Language-specific Javascript code==

There is an easy way to find out the current language and execute according Javascript using jQuery: The <html> tag of any survey pages contains an 'lang' attribute which holds the current language code. You can read that language code by using the followin code

<syntaxhighlight lang="php" enclose="div">

jQuery(document).ready(

function(){

languagecode=$('html').attr('lang');

alert('This is the current language code: '+languagecode);

}

);

</syntaxhighlight>

For an English survey the above code would show a messagebox with "This is the current language code: en"

=Custom onload function in multi-language survey=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2,''

To use custom onload functions, as above, in multi-language surveys you must define the functions in the question source for '''all''' languages.

While this initially seems to be a bit tedious, it actually can be useful - you can alter your onload functions depending on the language in use. For example, you can dynamically display alerts or element contents in the current language.

=Skipping the welcome page=

''Tested with: 1.85 (second code snippet)''

<div class="simplebox">Note: As of version 1.91, there is a survey option letting you skip the welcome page, so this workaround is not needed.</div>

'''Solution 1:''' Include this Javascript in your welcome template, in the file welcome.pstpl for all welcome page, or in the source of the welcome text for one survey:

<syntaxhighlight lang="php" enclose="div">

<script>

jQuery(document).ready(function($) {

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit(); });

</script>

</syntaxhighlight>

It will reproduce the onclick event of the submit button and submit the form.

Drawback of course is that users will see the page flashing up.

Therefore, you may want to announce "... loading survey ..." as a description of your welcome page (in the admin interface when creating the survey), to pretend loading something big.

'''Solution 2:'''

<syntaxhighlight lang="php" enclose="div">

<script>

function custom_on_load(){

document.limesurvey.move.value = 'movenext';

document.limesurvey.submit();

}

window.setTimeout( 'custom_on_load()',1);

</script>

</syntaxhighlight>

=Filter answers of a question with the answer of another=

===Method 1===

''Tested with: 1.70 - 1.72''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general.</div>

If you want to filter the answer of a question with another answer, you can use this workaround.

First, use answer code like that: XX for the first question, and XXYYY for the second one.

Answer of the second question filter if the 2 first letters are the answer of the first question.

We use 1000X1X1 and 1000X1X2 for the example, question had to be on separate page (question by question for example).The second question had to be a dropdown list (we can do similar workaround, but droplis is the best). You can do this using JQuery. It leaves the answer in the select box, but disables it. You could also replace "disable" with "remove" to get rid of it altogether.

<syntaxhighlight lang="php" enclose="div">

var previousQuestionAnswer = "{INSERTANS:1000X1X1}";

var currentQuestionID = "#answer1000X1X1"

$(document).ready(function() {

// See if the answer for the previous question matches an answer in the current question

// (other than 'No Answer')

// If so, disable it.

if (previousQuestionAnswer!='No Answer') {

$(currentQuestionID).children().each(function(index, Element)

{

if ($(this).attr('text') == previousQuestionAnswer)

{ $(this).attr('disabled', true); }

}

);}

}); // End of JQuery ready function

</syntaxhighlight>

===Method 2===

''Tested with 1.92 + Firefox 9.0''

If you have a country, state, and city set of questions (or similar), you could code answer options as:

'''Q1 Country''' ''Single choice list (ratio, dropdown)''

X country#

'''Q2 State''' ''Single choice list (dropdown)''

XY state#

'''Q3 City''' ''Single choice list (dropdown)''

XYZZ city#

Now you must put the following Javascript code in the source of question 2 (State):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the countryCode (first character of the country)

var countryCode = '{INSERTANS:1000X1X1}'.substr(0, 1).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the countryCode

$('select[id<div class="simplebox">="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 1).toUpperCase() != countryCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

And the following code in the source of question 3 (City):

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Get the stateCode (two first characters of the state)

var stateCode = '{INSERTANS:1000X1X2}'.substr(0, 2).toUpperCase();

// Loop through all dropdown options and remove those with codes not starting with the stateCode

$('select[id</div>="answer"] option').each(function(i){

if($(this).attr('value') && $(this).attr('value').substr(0, 2).toUpperCase() != stateCode) {

$(this).remove();

}

});

});

</script></syntaxhighlight>

Each question must be in different pages of survey to work, i.e. in a question by question survey, or in diferent groups in a group by group survey.

Note that if you choose a two characters answer option code in the State question, i.e. a XYY answer option code, you must change the ''substr(0, 2)'' part of code in question 3 to ''substr(0, 3)''.

=Filter answers of a multiple numeric type question=

''Tested with: 1.90+''

<div class="simplebox">As of version 1.92, this is easier to do using the the array_filter attribute, or relevance equations in general. In 1.92, array_filter works with all questions that have sub-questions (e.g. also works for multiple numeric and multiple short text).</div>

If you want to filter a question of type "multiple numeric", you have to modify the workaround.

Note that this workaround assumes that the code for each of the subquestions are a numeric sequence 1,2,3...

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Match elements with labels using htmlFor and a loop

var labels = document.getElementsByTagName('LABEL');

for (var i = 0; i < labels.length; i++) {

if (labels[i].htmlFor != '') {

var elem = document.getElementById(labels[i].htmlFor);

if (elem)

elem.label = labels[i];

}

}

var answerFilter="{INSERTANS:96553X63X759}";

for (i=0; i<30; i++){

var iLabel = document.getElementById('answer96553X63X760'+(i+1]].label.innerHTML;

if (answerFilter.search(iLabel) == -1){

// Hide element

$('#question760').find('li').eq(i).hide();

// Set value of hidden elements to zero

document.getElementById('answer96553X63X760'+(i+1)).value = 0;

}

}

});</script>

</syntaxhighlight>

=Use an answer to prefill another question (default value)=

''Tested with: 1.72''

''And tested with: 1.91+''

<div class="simplebox">As of version 1.92, this is easier to do using the enhanced defaults feature, which lets you pre-fill most question types with default values. In 1.91, you could set defaults for list and multiple choice questions. In 1.92, you can set defaults for any text-entry question too. Moreover, the defaults can be [[Expression Manager|Expression Manager]] compatible equations or tailored text. Finally, with 1.92, defaults are properly managed even when set on the same page.</div>

This workaround gives you the ablility to use an answer to fill the default value for another question. It's explained for free text question type but can be adapted for another question type.

We use SGQA identifier. For example, we use SGQA 1000X10X20 and 1000X10X21 to prefill 1000X11X30 and 1000X11X31. For the script to work, the question has to be on a different page.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X11X30').val('{INSERTANS:1000X10X20}');

$('#answer1000X11X31').val('{INSERTANS:1000X10X21}');

});

</script></syntaxhighlight>

If you want use two times the value of an integer input, you can also use this to prefill a question that you hide via CSS.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer1000X2X2').val(parseInt('{INSERTANS:1000X1X1}')*2);

$("#question2").hide();

});

</script>

</syntaxhighlight>

Now you can use {INSERTANS:1000X2X2} for giving you twice the value of the user input from question 1.

=Dynamic Sum=

<div class="simplebox">As of version 1.92, this is easier to do with [[Expression Manager|Expression Manager]] using the sum() function. Not only will sums be dynamic, but they wille exclude irrelevant values, so you can array_filter a multiple numeric question and get the sum of just the answers that are visible. This [[Expression Manager HowTos|#Calculate assessment values at runtime and store the results in the survey data|HowTo example]] demonstrates the dynamic sum feature.</div>

<div class="simplebox">Also note, as of version 1.92, the following workaround will fail, since it includes a a regular expression containing curly braces.</div>

This script is used with a "Multiple Options" type question calculate a total price based on how which checkboxes are selected. The prices are listed as part of the answer. The answers are set up like this: "USB Mouse ($20)". The script uses the number between the "($" and the ")" as the price for that item. You can adapt the script to if you need to change the currency or need to sum something other than money.

This script works when used in a question-by-question format. It does not work when there are more than one question on a page. I think it can be adapted to work, but I haven't done the coding yet.

Put the following code into body of your question:

<syntaxhighlight lang="php" enclose="div">

<script language=Javascript>

// General definitions

// Define a regular expression to match the labels containing information about an answer

// In LimeSurvey, these labels start with "answer..."

var answerRegex = /^answer/;

// Find all answer checkboxes in the document and set their

// onchange events to updatePrice

function Custom_On_Load()

{

// Find all input elements

var inputList=document.getElementsByTagName("input");

// Loop through each, looking for checkboxes

var i;

for( i=0; i< inputList.length;i++ )

{

// If input item does not have an ID, skip

if (! (inputList[i].id)) { continue; }

// Skip to next if ID doesn't start with "answer"

if (!answerRegex.test(inputList[i].id)) { continue; }

// Skip to next if not a checkbox

if (inputList[i].type.toUpperCase()!='CHECKBOX') { continue; }

// This is an answer checkbox!

// Setup onchange event

inputList[i].onclick = updatePrice;

}

// Load initial sum

updatePrice();

}

function updatePrice()

{

var labels=document.getElementsByTagName("LABEL");

// Define a regular expression to match a price inside parenthesis

// For example: ($29) or ($29.54).

// Set up

priceRegex = /$\$(\d*\.{0,1}\d+)$/;

// Loop through all the labels, looking for labels corresponding to

// answers that have a price in them.

var i;

var total = 0;

for( i=0; i<labels.length;i++ )

{

var myArray; // Define array used for regex matching

var inputID; // Define field element

// Get the ID of the field corresponding to the label using the

// "htmlFor" attribute

// (FYI, there are some labels that will have to be screened out

// because they don't correspond to an answer)

// Does the label start with "answer"?

// If not: exit.

if (!answerRegex.test(labels[i].htmlFor)) { continue; }

// First make sure this element exists

// If it doesn't, go to the next element

// If it does, it will be defined in inputID

if (! (inputID = document.getElementById(labels[i].htmlFor)) ) { continue; }

// See if the corresponding answer is a checkbox that is checked.

// If not, go to next label

if (inputID.type.toUpperCase()!='CHECKBOX') { continue; }

if (!inputID.checked) { continue; }

// This is label for an answer.

// The innerHTML will give us the text of the label

// The price information will be in the form ($XX.XX)

// which in contained in the label text.

// Find a match for a decimal number inside the pattern "($" and ")"

if [[myArray = priceRegex.exec(labels[i].innerHTML]] != null)

{

// Keep a running tally

total += parseFloat(myArray[1]);

}

}

// Update total price on form

document.getElementById("totalPrice").value = "$" + formatCurrency(total);

}

function formatCurrency(num) {

num = isNaN(num) || num <u> '' || num </u> null ? 0.00 : num;

return parseFloat(num).toFixed(2);

}

</script>

</syntaxhighlight>

Put the following code in the help section (or wherever you want the sum to appear):

<syntaxhighlight lang="php" enclose="div">Total Cost for selected accessories: <input type="readonly" value="" id="totalPrice" /></syntaxhighlight>

=Focus on the first Input field=

(''Tested with: Limesurvey 1.80 / IE6/7, Firefox 3, Safari, Opera, chrome'')

<div class="simplebox">As of version 1.91, there is a built-in JavaScript function called focusFirst() to focus on the first visible element. It uses jQuery, so is more robust than this example.</div>

Again an onload Function is needed for this tasks. I have done it the DOM way with compatibility to IE6/7.

Put the following code into the startpage.pstpl of your template, right before the </head> closing tag:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function focusFirst(Event)

{

var i=0;

while(document.forms[0].elements[i].type == "hidden")

{

i++;

}

document.forms[0].elements[i].focus();

return;

}

if(ie)

{ window.attachEvent("onload", focusFirst); }

else

{ document.addEventListener("load", focusFirst, true); }

</script>

</syntaxhighlight>

'''Note:''' I am using this with version 1.80. As changes happened to the templates in the last release, you might need to add the following before the code, if your template is older than 1.80 stable and does not include this:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var ie = false;

</script>

</syntaxhighlight>

You will need this for the var ie to be set. Without this var, the function will not work with ie.

=Answer questions by keypress=

(''Tested with: IE7, Firefox 3'')

This workaround allow to answer the question on key 0-9 (0 is for the 10 answer).

Follow issues are supported at the moment:
*Yes-No Questions
*List Questions (radio)
*other radio questions

In lists the answer limit is ten.

You supply the template "endpage" of your template with the following script.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

jQuery(document).ready(function() {

jQuery(document).bind('keypress', function(e){

if (48 <= e.which && e.which <= 57) {

jQuery('input:radio').each(function() {

var v = jQuery(this).val();

var c = (e.which <u> 48) ? 10 : e.which - 48;

if(v </u> 'Y' || v <u> 'N') {

v = (v </u> 'Y') ? 1 : 2;

}

if(v == c) {

jQuery(this).click();

jQuery('#limesurvey input:submit').click();

}

});

}

})

});

</script>

</syntaxhighlight>

=Math notation in LimeSurvey=
#download the js file from [http://mathcs.chapman.edu/~jipsen/mathml/asciimathdownload.html AsciiMath script]
#copy it in the /scripts/ folder in your installation
#modify the startpage.psptl of the template you want to use adding the reference to the script (if you use an older version make sure that you copy the template folder first!) for example:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" src="ASCIIMathML.js">

</syntaxhighlight>

Use the notation where you need it!

'''Note:''' If you use internet explorer or safari you will need to download the plugin as well, but firefox does the lot for you.

Finally, if you are confident with the limesurvey structure you could add the editor which support math notation and change the reference to the editor you want to use in the configuration file. here is the [http://www.imathas.com/editordemo/demo.html link for a TinyMCE with math support].

=Reverse array_filter (for pre-1.90)=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">Note: Version 1.91 natively supports this functionality via the array_filter_exclude advanced quation option.</div>

This can be used to filter the answers of an array question to be displayed based on the answers of a multi option question that were '''NOT''' selected. A possible application would be to have a multi-option question asking which products were purchased, followed by 2 array questions - one asking to rate the purchased products and another asking why the remaining products were not purchased. Another would be to ask about sessions attended at a conference as in [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/27970-reverse-of-arrayfilter.html this forum thread] and pictured below. There is a live [http://www.partnersinc.biz/surveys//index.php?sid=43358&newtest;=Y&lang;=en demo here]

[[File:sessions_645x344.gif]]

We'll use the above example to explain the process as follows:
#In group 1 - Create a ''SessionsAttended'' multi-options question
#In group 1 - Create a ''SessionsNotAttended'' multi-options question with identical answers as ''SessionsAttended'' and hide it with styles or conditions
#In group 2 - Create a ''RateSessionsAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsAttended''
#In group 2 - Create a ''ReasonNotAttended'' array question with an [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#array_filter array_filter] based on ''SessionsNotAttended''
#In group 1 - Place JavaScript/jQeury listeners on each of the checkboxes in ''SessionsAttended'' that would toggle the corresponding checkbox in ''SessionsNotAttended'' to the opposite state

The JavaScript/jQuery code used would be:

<syntaxhighlight lang="php" enclose="div">

// The toggle function

function toggle(q1, q2) {

if ($(q1).attr('checked') == false ) {

$(q2).attr('checked', true);

}

else {

$(q2).attr('checked', false);

}

}

// Initialize the SessionNotAttended checkboxes to "checked"

toggle ('#answer11111X22X331', '#answer11111X22X441');

toggle ('#answer11111X22X332', '#answer11111X22X442');

toggle ('#answer11111X22X333', '#answer11111X22X443');

toggle ('#answer11111X22X334', '#answer11111X22X444');

// The jQuery listeners on the SessionAttended checkboxes

// that toggle the SessionNotAttended checkboxes

$('#answer11111X22X331').change(function() {

toggle ('#answer11111X22X331', '#answer11111X22X441');

});

$('#answer11111X22X332').change(function() {

toggle ('#answer11111X22X332', '#answer11111X22X442');

});

$('#answer11111X22X333').change(function() {

toggle ('#answer11111X22X333', '#answer11111X22X443');

});

$('#answer11111X22X334').change(function() {

toggle ('#answer11111X22X334', '#answer11111X22X444');

});

</syntaxhighlight>

Some notes about the code:
*The code is in an onload function defined in the first question of group 1 - see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workarounds here]
*Both ''SessionsAttended'' and ''SessionsNotAttended'' must be in the same group for the toggling to work
*This case only uses 4 checkboxes but could be expanded as required
*In this case the survey ID is 11111, the group ID is 22, ''SessionsAttended'' ID is 33 and SessionsNotAttended ID is 44 - these would need to be modified for your survey
*The toggle function looks for the state of a checkbox in ''SessionsAttended'' and sets the corresponding checkbox in ''SessionsNotAttended'' to the opposite state
*The "Initialize" section sets the state of ''SessionsNotAttended'' checkboxes whenever we navigate to the group
*The "Listener" section uses jQuery listeners to detect any change in the ''SessionsAttended'' checkboxes and then toggle the corresponding ''SessionsNotAttended'' checkbox

Some general notes about the questions:
*CSS can be used to hide ''SessionsNotAttended'' (div#question44 { display: none; }) if you don't want to use conditions (because maybe you've got [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $deletenonvalues set to 1])
*''RateSessionsAttended'' and ''ReasonNotAttended'' are another group to avoid things popping in and out of existence as ''SessionsAttended'' is answered
*[http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions] are used to ensure that ''RateSessionsAttended'' only appears if some sessions are selected and ''ReasonNotAttended'' only appears if no sessions are selected

=Filter Ranking Question With Multiple-Options=

''Tested with: 1.90, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

<div class="simplebox">As of version 1.92, most of this is easier to do using the the array_filter attribute, or relevance equations in general. They all work on the same page, and fully support cascading relevance.</div>

This workaround applies a filter to a ranking question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and ranking questions being on the same page and a slightly different one for the filter question being on a page before the ranking question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=96314&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following script in your template.js file. This function will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

// A function to filter choices in a ranking question

function rankFilter(q1ID, q2ID, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+q1ID+' li[id<div class="simplebox">="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+q1ID+'').hide();

}

handleChecked(q1ID, q2ID);

$('#question'+q1ID+' input.checkbox').click(function() {

handleChecked(q1ID, q2ID);

});

function handleChecked(q1ID, q2ID) {

// Find the survey and group IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $( 'input#fieldnames' ).attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

}

// Loop through all Q1 options

$('#question'+q1ID+' input.checkbox').each(function(i) {

// Find the answer code and value

var tmp2 = $(this).attr('id').split('X'+gID+'X'+q1ID+'');

var ansCode = tmp2[1];

var ansTxt = $(this).next('label').text();

// If option is checked and not in rank choices or output, add it to the rank choices

if($(this).attr('checked') == true

&& $('#question'+q2ID+' select.select option[value="'+ansCode+'"]').length == 0

&& $('#question'+q2ID+' .output input[id</div>="fvalue_"][value="'+ansCode+'"]').length == 0) {

$('<option value="'+ansCode+'">'+ansTxt+'</option>').appendTo('#question'+q2ID+' select.select');

}

// If option is unchecked...

else if($(this).attr('checked') == false) {

// Remove it from the rank choices

$('#question'+q2ID+' select.select option[value="'+ansCode+'"]').remove();

// Remove it from the rank output and reset hidden values

$('#question'+q2ID+' .output input[id<div class="simplebox">="fvalue_"][value="'+ansCode+'"]').attr('value', '').siblings('input.text').val('').siblings('img').hide();

}

});

// Clean up empty inputs in the rank output table

$('#question'+q2ID+' .output table tr').each(function(i) {

var nextRow = $(this).next('tr');

if($('input.text', this).val() == '' && $('input.text', nextRow).val() != '') {

$('input.text', this).val($('input.text', nextRow).val());

$('input.text', nextRow).val('');

$('input[id</div>="fvalue_"]', this).attr('value', $('input[id<div class="simplebox">="fvalue_"]', nextRow).attr('value'));

$('input[id</div>="fvalue_"]', nextRow).attr('value', '');

}

});

// Show the scissors for the last populated rank output row

$('#question'+q2ID+' .output table img[id<div class="simplebox">="cut_"]').hide();

$('#question'+q2ID+' .output table input.text[value!=""]:last').siblings('img[id</div>="cut_"]').show();

// Hide extra rank output rows

var optNum = $('#question'+q1ID+' input.checkbox:checked').length;

$('#question'+q2ID+' .output table tr').hide();

$('#question'+q2ID+' .output table tr:lt('+(optNum+1)+')').show();

// Hide and clear the ranking question if there are less than 2 checked options in Q1

if(optNum < 2) {

$('#question'+q2ID+'').hide();

$('#question'+q2ID+' input.text').val('');

$('#question'+q2ID+' input[id<div class="simplebox">="fvalue_"]').attr('value', '');

}

else {

$('#question'+q2ID+'').show();

}

// A work around for the built in max-answers function

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.output tr:visible').each(function(i) {

if($('input.text', this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

}

// A listener to work around the built in max-answers function

$('#question'+q2ID+' td.rank').click(function (event) {

$('#question'+q2ID+' select.select').attr('disabled', true);

$('#question'+q2ID+' td.item input.text').each(function(i) {

if ($(this).val() == '') {

$('#question'+q2ID+' select.select').attr('disabled', false);

}

});

});

}

</syntaxhighlight>

'''FOR BOTH FILTER AND RANKING QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and a ranking question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question.
*The function will hide the ranking question unless at least two options are selected in the multiple options question, in which case, it will only show the options selected.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND RANKING QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and a ranking question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "RR" with the ID of the ranking question. Do not modify the "1".
*The function will hide the multiple options question. If at least 2 options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the ranking question.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

rankFilter(MM, RR, 1);

});

</script>

</syntaxhighlight>

=Filter "Array by Column" Question With "Multiple-Options"=

''Tested with: 1.91, IE 7/8, FireFox 3/4, Safari 5.0, Chrome 10.0''

This workaround applies a filter to an "Array by Column" question based on the checked boxes of a previous multiple-options question. There are two methods - one for filter and array questions being on the same page and a slightly different one for the filter question being on a page before the array question.

There is a [http://www.partnersinc.biz/surveys//index.php?sid=74213&newtest;=Y&lang;=en demo of both methods here].

Implementation is as follows.

'''FOR BOTH METHODS:'''
*[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
*Place the following scripts in your template.js file. These functions will be accessed by either method.<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

function filterArrByCol(qMultiOpt, qArray, prevPage) {

// If filter question is on a previous page, hide Q1 and check all "visible" boxes

if(prevPage == 1) {

$('#question'+qMultiOpt+' li[id</div>="javatbd"]:visible input.checkbox').attr('checked', true);

$('#question'+qMultiOpt+'').hide();

}

// Assign classes to the answer cells

$('#question'+qArray+' table.question tbody td').each(function(i){

var classArr = $(this).attr('class').split('answer_cell_00');

var ansCode = classArr[1];

$(this).addClass('ans-'+ansCode+' filtered');

});

// Assign classes to the answer label cells

$('#question'+qArray+' table.question tbody tr:eq(0) td').each(function(i){

var classArr2 = $(this).attr('class').split(' ans-');

var ansCode2 = classArr2[1];

$('#question'+qArray+' table.question thead tr:eq(0) th:eq('+i+')').addClass('ans-'+ansCode2+'');

});

// Fire the filter function on page load

filterArr(qMultiOpt, qArray);

// Listener on multi-opt checkboxes to fire the filter function

$('#question'+qMultiOpt+' input.checkbox').click(function(){

filterArr(qMultiOpt, qArray);

});

// On submit, clear all hidden radios of array

$('#movenextbtn, #movesubmitbtn').click(function(){

$('#question'+qArray+' td.filtered:hidden').each(function(i){

$('input.radio', this).attr('checked', false);

});

return true;

});

}

function filterArr(qMultiOpt, qArray) {

if($('#question'+qMultiOpt+' input.checkbox:checked').length < 1) {

// Hide the array if no multi-opt options are checked

$('#question'+qArray+'').hide();

}

else {

$('#question'+qArray+'').show();

// Hide all columns of array

$('#question'+qArray+' table.question tbody td, #question'+qArray+' table.question thead th').hide();

// Loop through multi-opt checkboxes and, if checked, show corresponding column of array

$('#question'+qMultiOpt+' input.checkbox').each(function(i){

if($(this).attr('checked') == true) {

var classArr3 = $(this).attr('id').split('X'+qMultiOpt);

var ansCode3 = classArr3[1];

$('#question'+qArray+' .ans-'+ansCode3+'').show();

}

});

}

}

});

</syntaxhighlight>

'''FOR BOTH FILTER AND ARRAY QUESTIONS ON SAME PAGE:'''
*Create a multiple options question and an array-by-column question on the same page (in the same group).
*Both questions '''MUST''' have identical sub-questions and sub-question codes.
*Place the following script in the source of one of the questions.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the ranking question.
*The function will hide the array question unless at least one option is selected in the multiple-options question, in which case, it will only show the corresponding array column(s).<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA);

});

</script>

</syntaxhighlight>

'''FOR FILTER AND ARRAY QUESTIONS ON SEPARATE PAGES:'''
*Create a multiple options question on page 1.
*Create a multiple options question and an array-by-column question on page 2.
*All three questions '''MUST''' have identical sub-questions and sub-question codes.
*Set the multiple options on page 2 to be filtered by the multiple options on page 1.
*Place the following script in the source of one of the questions on page 2.
*Replace "MM" with the ID of the multiple options question and "AA" with the ID of the array question. Do not modify the "1".
*The function will hide the multiple options question. If options were selected in the multiple options on page 1, the corresponding options will be checked in the hidden multiple options question which will then be used to control the display of the array columns.<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

filterArrByCol(MM, AA, 1);

});

</script>

</syntaxhighlight>

=Auto-tabbing between text input fields=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

This is a workaround to facilitate auto-tabbing between text input questions in a single group using a [http://plugins.jquery.com/project/autotab jQuery plugin by Mathachew] and the Maximum characters attribute of questions.

The behaviour will be: When the maximum number of characters has been entered into an input field, the focus (cursor) will be automatically moved to the next input field. When the backspace key is used to remove all characters from a field, the focus will be moved to the previous field. It's very useful in surveys having many text input questions to avoid having to manually tab or click between fields.

You can view a small demo survey [http://www.partnersinc.biz/surveys//index.php?sid=11327&newtest;=Y&lang;=en here].

Implementation is as follows:
#Visit [http://plugins.jquery.com/node/4046 http://plugins.jquery.com/node/4046], download the plugin script and save it as ''jquery.autotab-1.1b.js'' in the template folder.
#Link to the script by placing ''<script type="text/javascript" src="{TEMPLATEURL}jquery.autotab-1.1b.js"></script>'' within the ''<head>'' tag of startpage.pstpl.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Create the text based questions that auto-tabbing is to be applied to. (All must be in the same group if you're using group by group presentation)
#Define a Maximum characters attribute for all questions that the autotab is applied to. (See [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#maximum_chars documentation here])
#In the source of the first question of the group that contains the auto-tabbed questions, add the following code.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answerSSSSSXGGXAA').focus(); //initially focus on the first input

$('#answerSSSSSXGGXAA').autotab({ target: 'answerSSSSSXGGXBB' });

$('#answerSSSSSXGGXBB').autotab({ previous: 'answerSSSSSXGGXAA', target: 'answerSSSSSXGGXCC' });

$('#answerSSSSSXGGXCC').autotab({ previous: 'answerSSSSSXGGXBB', target: 'answerSSSSSXGGXDD' });

$('#answerSSSSSXGGXDD').autotab({ previous: 'answerSSSSSXGGXCC' });

});

</script></syntaxhighlight>

This example has 4 fields to be auto-tabbed between - all instances of the following must be replaced to be compatible with your survey (See image below):
*SSSSS -> Survey ID
*GG -> Group ID
*AA -> First question
*BB -> Second question
*CC -> Third question
*DD -> Last question

[[File:ids_343x252.gif]]

The ''target'' parameter defines where the next input is and the ''previous'' parameter defines (you guessed it) the previous input.

This plugin also has limited capability of formatting the input text - see comments in the plugin script.

=Custom response listeners=

''Tested with: 1.85+ (7253), IE 6/7, FireFox 3.0, Safari 3.2, Chrome 2.0''

Listeners can be used to perform functions when a change in an input is detected. There are many uses such as the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds#Reverse_array_filter Reverse array_filter] but a simple one would be to warn a respondent if they enter a value that may be too high.

We can use the [http://docs.jquery.com/Events/change jQuery change( ) event] to fire a function whenever there is a change to the input. The function will look for an input value higher than 10 and, if found, will warn the respondent.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page where:
**11111 is the survey ID
**22 is the group ID
**33 is the question ID

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('#answer11111X22X33').change(function() {

if ( $('#answer11111X22X33').val() > 10 ) {

alert ("That's an awful lot. Are you sure?");

}

});

});

</script></syntaxhighlight>

=Text input masks=

''Tested with: 1.90+, IE 7, FireFox 3.0, Safari 3.2, Chrome 2.0''

<div class="simplebox">We're considering adding this as a built-in feature for version 1.92 (e.g. an advanced question attribute).</div>

There may be instances where you would like to place a mask on a text input - for example only allowing respondents to enter the correct characters for a North American phone number [[Expression Manager|Expression Manager]] rand() function. This can be part of a relevance equation to randomly control which questions are shown; or you can create an Equation question type to store the random value, and let that question be part of downstream relevance equations.</div>

This workaround allows you to generate a random number and then populate a hidden question with that number. You can then use this question to control the display of subsequent questions with [http://docs.limesurvey.org/tiki-index.php?page=Setting+conditions&structure;=English+Instructions+for+LimeSurvey Conditions]. It's useful if you have several sets of questions that you would like to randomly present to participants - see this [http://www.limesurvey.org/en/support/forums/5-can-i-do-this-with-limesurvey/29579-experiment-with-random-questions.html forum post].

There is a small demo [http://www.partnersinc.biz/surveys//index.php?sid=12659&newtest;=Y&lang;=en here].

In the demo, in the first group, we generate a random number between 1 and 4 and populate a hidden question with it. Then in the second group we have 4 questions, each showing conditional on the answer of the first question.

Implementation for this demo is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the first group add a "Short free text" question (We're going to hide this with JavaScript)
#In the source of that question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#In the following groups add the questions that are conditional on the answer of the first question.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

function Custom_On_Load(){

$(document).ready(function() {

// Find a random number between 1 and 4

var randNumber = Math.floor(Math.random()*4 + 1);

// Populate and hide the hidden question

$('input#answerSSSSSXGGXQQ').val(randNumber);

$('#questionQQ').hide();

/***********************************************************/

// This just tells the user which number has been selected

// You can remove this from your onload function

$('input#setNumber').val(randNumber);

$('input#setNumber').css({

'margin-left':'0.5em',

'width':'1.5em',

'text-align':'center',

'font-weight':'bold'

});

$('input#setNumber').attr('disabled', true);

/***********************************************************/

});

}

</script>

</syntaxhighlight>

Where '''SSSSS''' is the survey ID, '''GG''' is the group ID and '''QQ''' is the hidden question ID.

Increase or decrease the maximum value of the random number by modifying the first section. For example to get a number between 1 and 10 you would use this:

<syntaxhighlight lang="php" enclose="div">

var randNumber = Math.floor(Math.random()*10 + 1);

</syntaxhighlight>

The third section of code just populates a placeholder element that I use to tell the participant what's going on. You can remove it from your code.

=Minimum number of required answers in an array=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2,''

<div class="simplebox">As of version 1.92 all array style questions have the min_answers and max_answers options, so this script is obsolete.</div>

This workaround allows you to specify a '''minimum number''' of answers required in an array question. It is an alternative to the "Mandatory" parameter which specifies that '''all''' answers are required. It could also be easily modified to specify a maximum number of answers.

We accomplish this by placing an onload function in the source of the array question. This function hides the Next/Submit button and displays a warning element until it detects a minimum number of responses. It then hides the warning and shows the Next/Submit button.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=97166&newtest;=Y&lang;=en here].

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Set up the template to use custom onload functions. (See the [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#Custom_onload_function workaround here])
#In the source of the array question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Modify the ''SETTINGS'' section of the code as required.

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

// Wait until the document is fully loaded

$(document).ready(function() {

/********************** SETTINGS **********************/

// The text to appear in the warning element

var warningText = 'Please answer at least 4 to continue';

// The question ID

var questionId = 137;

// The minimum number of answers required

var minNumber = 4;

/******************************************************/

// Create the warning element and place it after the submit button

var el = document.createElement('div');

el.setAttribute('id','warning');

document.body.appendChild(el);

$( '#warning' ).css({

'border':'1px solid #333333',

'width':'200px',

'padding':'3px',

'color':'red'

});

$('#warning').html(warningText);

$('input[type="submit"]').after($('#warning'));

// Detect the initial number of checked answers & display Next/Submit button accordingly

var inputInitCount = 0;

$('#question' + questionId + ' input').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputInitCount++;

}

});

if (inputInitCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// Listener to detect number of checked answers & display Next/Submit button accordingly

$('#question' + questionId + ' input.radio, #question'+questionId+' tbody[id<div class="simplebox">="javatbd"] td').click(function() {

var inputCount = 0;

$('#question' + questionId + ' input.radio').each(function(i) {

if ($( this ).attr('checked') == true ) {

inputCount++;

}

});

if (inputCount > (minNumber - 1)) {

$('input[type="submit"]').show();

$('#warning').hide();

}

else {

$('#warning').show();

$('input[type="submit"]').hide();

}

// The original functions of the click event

checkconditions(this.value, this.name, this.type);

});

});

</script>

</syntaxhighlight>

=Minimum elapsed time before moving forward in survey=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

This workaround interrupts the Next/Submit function and checks the amount of time elapsed since the page loaded. If the time is less than the minimum dictated, the respondent is alerted and not allowed to proceed. It is useful if you want to enforce a minimum amount of time spent viewing a page.
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the script below in the source of one of the questions on the page, replacing "TT" with the minimum number of seconds required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minTime(TT);

function minTime(minTime) {

var startTime = new Date();

$('#movenextbtn, #movesubmitbtn').click(function(){

var endTime = new Date();

if[[endTime - startTime)/1000 <= minTime) {

alert ('You must spend at least '+minTime+' seconds on the question.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Minimum number of characters in Long free text or Huge free text questions=

''Tested with: 1.91, IE 7/8, Firefox 7.0, Safari 3.2''

</div>As of version 1.91, you can use regular expression masks (validation) to specify the minimum number of required characters. However, even if the question is mandatory, it can still be blank.<div class="simplebox">

</div>As of version 1.92, if you make the question mandatory and use a validation mask to specify the minimum number of characters, then the user will be forced to answer the question. Note that unlike 1.91, they can submit their current answers, even if partially invalid (so they are stored in the database), but they will not ber able to proceed to the next page until they have passed all mandatory and validity checks.<div class="simplebox">

This workaround interrupts the Next/Submit function and checks the number of characters entered in a Long free text or Huge free text question. If the number is less than the minimum dictated, the respondent is alerted and not allowed to proceed.

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|Set up your survey to use JavaScript].

#Place the script below in the source of one of the questions on the page, replace "QQ" with the question ID and "CC" with the minimum number of characters required before advancing is allowed.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

minChar(QQ, CC);

function minChar(qID, minChars) {

$('#movenextbtn, #movesubmitbtn').click(function(){

if($('#question'+qID+' textarea').val().replace(/ /g,'').length < minChars) {

alert ('You must enter at least '+minChars+' characters.');

return false;

}

else {

return true;

}

});

}

});

</script></syntaxhighlight>

=Variable Length Array (Multi Flexible Text) question=

''Tested with: 1.90+, IE 6/7/8, FireFox 3.0, Safari 3.2''

This workaround allows a respondent to add or remove rows of an Array (Multi Flexible Text) question. It's useful to avoid the page being cluttered with unnecessary array rows.

A function is placed in the template.js file of your template (use template editor). This function hides all of the array rows except the first and inserts two elements that when clicked show or hide rows accordingly.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=53132&newtest;=Y&lang;=en|here].

It must be noted that you can not make this question Mandatory as the respondent will have no way to complete hidden fields. If you want the displayed fields to be mandatory you will need to validate them in another function or modify this function to only allow the addition of rows if all fields in the last row are completed and then disable those fields - that, however, is a little over the top for this example.

Implementation is as follows:

#Set up your survey to use JavaScript (See instructions [http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_|here])

#Add the following script to your ''template.js'' file.

#Replace "QQ" in the function call at the end with the question ID.

#Create one or more Array (Multi Flexible Text) questions

#If you want to apply it to more arrays on the same page simply add more calls with the appropriate question IDs. (eg. varLengthArray(1); varLengthArray(2);...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// A function to add or remove rows of an Array (Multi Flexible)(Text) question

function varLengthArray(qID) {

if ($('#question'+qID+'').length > 0) {

// The HTML content of the Add/Remove elements - modify as you wish

var addContent = '[+]';

var removeContent = '[-]';

// Create the Add and Remove elements & insert them

var el1 = document.createElement('div');

el1.setAttribute('id','addButton'+qID);

document.body.appendChild(el1);

var el2 = document.createElement('div');

el2.setAttribute('id','removeButton'+qID);

document.body.appendChild(el2);

// Move them to after the array

$( 'div#addButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent(]];

$( 'div#removeButton'+qID ).appendTo($( '#question' + qID + ' table.question' ).parent());

// Insert their HTML

$( 'div#addButton'+qID ).html( addContent );

$( 'div#removeButton'+qID ).html( removeContent );

// Style the elements - you can modify here if you wish

$( 'div#addButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

$( 'div#removeButton'+qID ).css({

'margin':'10px 0 0 10px',

'padding':'1px',

'text-align':'center',

'font-weight':'bold',

'width':'auto',

'cursor':'pointer',

'float':'left'

});

// Initially hide the Remove element

$( 'div#removeButton'+qID ).hide();

// Call the functions below when clicked

$( 'div#addButton'+qID ).click(function (event) {

addRow(qID);

});

$( 'div#removeButton'+qID ).click(function (event) {

removeRow(qID);

});

// Function to add a row, also shows the Remove element and hides the

//Add element if all rows are shown

function addRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

if ( $( arrayRow + ':eq(' + rowCount + ')' ).attr('name') == 'visible' ) {

$( 'div#addButton'+qID ).hide();

}

}

// Function to remove a row, also clears the contents of the removed row,

// shows the Add element if the last row is hidden and hides the Remove

// element if only the first row is shown

function removeRow(qID) {

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = $( arrayRow ).size() - 1;

$( arrayRow + '[name="visible"]:last input[type="text"]' ).val('');

$( arrayRow + '[name="visible"]:last' ).attr('name', 'hidden').hide();

$( 'div#addButton'+qID ).show();

if ( $( arrayRow + ':eq(1)' ).attr('name') == 'hidden' ) {

$( 'div#removeButton'+qID ).hide();

}

}

// Just some initialization stuff

var arrayRow = '#question' + qID + ' table.question tbody';

var rowCount = '';

// Initially hide all except first row or any rows with populated inputs

$( arrayRow ).each(function(i) {

if ( i > 0 ) {

// We also need to give the hidden rows a name cause IE doesn't

// recognize jQuery :visible selector consistently

$( this ).attr('name', 'hidden').hide();

$('input[type=text]', this).each(function(i) {

if ($(this).attr('value') != '') {

$(this).parents('tbody:eq(0)').attr('name', 'visible').show();

$( 'div#removeButton'+qID ).show();

}

});

rowCount = i;

}

});

}

}

// Call the function with a question ID

varLengthArray(QQ);

});

</syntaxhighlight>

=Expandable Array=

''Tested with: 1.90+, IE 6/7, FireFox 3.5, Safari 3.2''

This workaround allows you to present an array question incrementally. That is to say that initially only the first option (row) in the array is shown. When that option is answered the next is shown and so-on.

A JavaScript function is placed in the source of the array question. This function hides all of the array rows except the first and then displays them as options are answered.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=94958&newtest;=Y&lang;=en here].

The workaround supports following question types:
*Array (flexible labels)
*Array (flexible labels) by column
*Array (Yes/No/Uncertain)
*Array (Increase, Same, Decrease)
*Array (Flexible Labels) dual scale
*Array (10 point choice)

Implementation is as follows:
#Set up your survey to use JavaScript. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ documentation here])
#Create one or more Array questions
#In the source of the first array question add the following script.
#Replace "QQ" in the function call at the end of the script with the question ID of the array you would like to manipulate.
#If you want to apply it to more arrays on the same page, simply add more calls with the appropriate question IDs. (eg. expandingArray(1); expandingArray(2);...)

Onload code:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript">

$(document).ready(function() {

// A function to show subsequent rows of an array as options are checked

function expandingArray(qID) {

// Build an array of the question rows

var arrayRow = '#question' + qID + ' table.question tbody tr';

// Initially hide all rows unless an input was previously checked

$( arrayRow ).each(function(i) {

if ( $( arrayRow + ':eq(' + i + ') input.radio:checked' ).length != 0 ) {

$( this ).attr('name', 'clickedRow');

}

else {

$( this ).attr('name', 'hidden').hide();

}

});

// Now show the first hidden row

addRow();

// Add another row when an option is checked for the first time

$( '#question' + qID + ' td.answer input.radio' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

// The original function of the click event

checkconditions(this.value, this.name, this.type);

});

// Add another row when an table cell is clicked for the first time

$( '#question' + qID + ' table.question tbody td' ).click(function (event) {

if ($( this ).parents('tr:eq(0)').attr('name') != 'clickedRow') {

addRow();

$( this ).parents('tr:eq(0)').attr('name', 'clickedRow');

}

});

// Function to add a row

function addRow() {

$( arrayRow + '[name="hidden"]:first' ).attr('name', 'visible').show();

}

}

// Call the function with a question ID

expandingArray(QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - Multiple Options & List (radio) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround allows the answers of Multiple Options & List (radio) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last as in the image below:

[[File:random_336x179gif.gif]]

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

Some conditions on the use of this are:
*For Select/radio type questions it will only work if the [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Survey_Behavior $shownoanswer option] is set to 0 in config.php. ("No answer" is removed from the end of questions)
*You must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple Options or List (radio) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRand(11111, 22, 1); partRand(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in Multiple options and List/radio questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' td.answer li' ).each(function(i) {

ansCount = (i + 1);

});

// Place the last answer created at the end of the list

$( 'input#answer' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).parent().appendTo($( '#question' + qID + ' td.answer ul' ));

}

// Call the function with the SID, GID and QID

partRand(SSSSS, GG, QQ);

});

</script></syntaxhighlight>

=Partially Randomized Answers - List (dropdown) questions=

''Tested with: 1.90+, IE 6/7, FireFox 3.0, Safari 3.2''

This workaround, similar to the one above, allows the answers of List (dropdown) questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

There is a demo [http://www.partnersinc.biz/surveys//index.php?sid=89344&newtest;=Y&lang;=en here].

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more List (dropdown) questions with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers

//except the last one in List/dropdown questions

function partRandDD(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' select option' ).each(function(i) {

ansCount = i;

});

// Place the last answer created at the end of the list

$( 'option[value="' + ansCount + '"]' ).appendTo($( 'div#question' + qID + ' select' ));

}

// Call the function with the SID, GID and QID

partRandDD(89344, 72, 244);

});

</script>

</syntaxhighlight>

=Partially Randomized Answers - Multiple numerical input=

''Tested with: 1.90+, Safari 5.1''

This workaround, similar to the ones above, allows the answers of Multiple numerical input questions to be randomized while always keeping one answer at the end of the list. It's useful if you want to randomize, say, the first 4 of your answers but always have the fifth displayed last.

An onload function is placed in the source of a question. After the randomizing has occurred this function moves the answer with the highest answer code to the end of the list.

A condition is that you must use sequential numbers, starting at 1 as response codes. (See image below)

[[File:random_700x154.png]]

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions. (See [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here])
#Create one or more Multiple numerical input question with sequential response codes. Set the [http://docs.limesurvey.org/tiki-index.php?page=Question+attributes&structure;=English+Instructions+for+LimeSurvey#random_order random_order question attribute] to 1.
#In the source of the first question add the following onload function. (See [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here])
#Replace "SSSSS", "GG", "QQ" in the function call at the end with the survey ID, group ID and question ID respectively.
#If you want to apply it to more questions on the same page simply add more calls with the appropriate IDs. (eg. partRandDD(11111, 22, 1); partRandDD(11111, 22, 2); ...)

Onload code:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Function to allow randomization of all answers except the last one in multiple numeric input questions

function partRand(sID, gID, qID) {

// Find the number of answers

var ansCount = ''

$( 'div#question' + qID + ' div.answers li' ).each(function(i) {

ansCount = (i - 1);

});

// Place the last answer created at the end of the list - but before the first helping sum

$( 'li#javatbd' + sID + 'X' + gID + 'X' + qID + ansCount + '' ).insertBefore($( 'div#question' + qID + ' div.answers li.multiplenumerichelp' ).first());

}

// Call the function with the SID, GID and QID

partRand(SID, GID, QID);

});

</syntaxhighlight>

Using this solution for Multiple numerical input questions might be a bit more complicated than for other question types. All answers are organized in an unordered list (<ul>) structure. However, if advanced question settings like ''Equals sum value'' are used, LimeSurvey adds helping information (e.g. sum of all entries and remainder) to the same unordered list using the class ''multiplenumerichelp'' for these additional list items. The above example assumes that at least one of these list items is present and moves the last answer to the position right above the first helper item. Without such advanced settings, the code will most certainly need adaptation.

=Making one (or more) rows of an array mandatory=

''Tested with: 1.90+, IE 6/7, Firefox 3.0, Safari 3.2''

This workaround allows you to define one or more rows of an array question as mandatory (instead of all of them which the "Mandatory" question setting does). It is [http://www.partnersinc.biz/surveys//index.php?sid=26842&newtest;=Y&lang;=en demonstrated here].

A JavaScript function interrupts the submit function and checks if the inputs in the mandatory row(s) are populated. If not, an alert is popped up, the offending inputs are turned pink and the submit is aborted. Otherwise the submit goes ahead.

Implementation is as follows:
#Turn off ''$filterxsshtml'' to allow insertion of JavaScript in the questions (see [http://docs.limesurvey.org/tiki-index.php?page=Optional+settings&structure;=English+Instructions+for+LimeSurvey#Filtering_dangerous_HTML_tags_in_survey_objects documentation here]).
#Create the array question.
#In the source of the array question add the following script (see [http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ How to use script here]).
#Modify the warningText (line10)as required.
#Replace "QQ" (lines 13 and 14) with the question ID and add calls as necessary for more rows - the example code renders rows 1 and 3 mandatory.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function () {

// Interrupt the submit function

$('form#limesurvey').submit(function () {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var empty = 0;

var warningText = 'Please complete the highlighted inputs.';

// Call the mandatory row function with question IDs and row numbers

mandatoryRow(QQ, 1);

mandatoryRow(QQ, 3);

// A function to render rows of an array mandatory

function mandatoryRow(qID, rowNum) {

$('div#question' + qID + ' table.question tbody[id</div>="javatbd"]:eq(' + Number(rowNum - 1) + ') input[type="text"]').each(function (i) {

if ($(this).val() == '') {

$(this).css('background-color', 'pink');

empty = 1;

} else {

$(this).css('background-color', '#FFFFFF');

}

});

}

if (empty == 1) {

alert(warningText);

return false;

} else {

return true;

}

});

});

</script></syntaxhighlight>

=Randomly displaying one of a few YouTube videos, and recording which was displayed=

''Tested in 1.85+''

Jason Cleeland has created and documented a method to randomly display one of a number of youtube videos in a single question, and save which one was displayed.

http://www.aptigence.com.au/home/archives/23-Random-display-of-videos-in-a-question-2-YouTube.html

=Randomly displaying one of a few pictures, and recording which was displayed=

''Tested in 1.91+''

The following steps allow you to randomly display one of a few pictures and record in the dataset which picture was displayed. We use four pictures in this example, but you can easily adapt these scripts according to your needs.

1. Create a new sub-directory '''pic''' in your LimeSurvey folder.

2. Copy four pictures (named ''1.jpg'', ''2.jpg'', ''3.jpg'', and ''4.jpg'') in this pic sub-directory.

3. Deactivate the ''Filter HTML for XSS'' function in LimeSurvey's ''Global Settings''.

4. Create a '''Short free text''' question where you want these pictures to be displayed.

5. Figure out the [http://docs.limesurvey.org/SGQA+identifier SGQA Identifier] of this question (e.g., 12345X67X89).

6. Paste the following code as question text after activating the editor's ''Source'' view and replace both SSSSSXGGXQQ strings with your SGQA identifier:

<syntaxhighlight lang="javascript" enclose="div">

Please have a look at this picture:

<br />

<script>

$(document).ready(

function(){

// Find a random number (here between 1 and 4)

var randNumber = Math.floor(Math.random()*4 + 1);

// Save the number as answer of this question

$('input#answerSSSSSXGGXQQ').val(randNumber);

// Hide this answer field

document.getElementById("answerSSSSSXGGXQQ").style.display='none';

// Show the picture

picString = '<img src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<p>

</p>

<div id="pic">

</div>

</syntaxhighlight>

If you want to display the number of this picture in a later question, use the following code as question text (don't forget to replace the SSSSSXGGXQQ string acordingly):

<syntaxhighlight lang="javascript" enclose="div">

You saw picture number {INSERTANS:SSSSSXGGXQQ}.

</syntaxhighlight>

Perhaps you want to display the same picture again in a later question, but a little bit smaller (100px width, 100px height)? Just paste the following code as question text after activating the editor's ''Source'' view, and replace the SSSSSXGGXQQ string acordingly:

<syntaxhighlight lang="javascript" enclose="div">

Here you see the picture again: <br>

<script>

$(document).ready(

function(){

// Get the picture number from previous question

var randNumber = "{INSERTANS:SSSSSXGGXQQ}";

// Show picture

picString = '<img width="100" height="100" src="pic/' + String(randNumber) + '.jpg">';

document.getElementById('pic').innerHTML = picString;

}

);</script>

<div id="pic">

</div>

</syntaxhighlight>

=Multiple numerical input with max_num_value defined in token (personalized limit)=

''Tested in 1.85+''

<div class="simplebox">As of version 1.92, max_num_value can be an experession, so you can simply enter the {TOKEN} or other variable in that question attribute.</div>

To make personalized survey with multiple numerical input when max_num_value (Maximum sum value) is different for each user and is loaded from the token use following tricks:
*Create 1st group with numerical input field (1000X10X11). "Limit"
*Add java script into this question:

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

function Custom_On_Load(){

document.getElementById('answer1000X10X11').value='{TOKEN:ATTRIBUTE_1}';

document.getElementById('answer1000X10X11').readOnly=1;

}

</script>

</syntaxhighlight>

where:

TOKEN:ATTRIBUTE_1 is individual limit defined in token.

readOnly=1 // user shouldn't change it.
*Create 2nd group with multiple numerical input and add "Max value from SGQA" with 1000X10X11 as argument.

Note: If you don't want to show first field with numerical input (and show definied limit in different way) you can add 2 lines to above script to hide whole question:

<syntaxhighlight lang="javascript" enclose="div">

document.getElementById('question85').style.display='none';

document.getElementById('display85').value='';

</syntaxhighlight>

where:

question85 and display85 are field names.

Note: It's no possible to create it into one group, because all SGQA references can only refer to data on a previous page because when clicking next the answer is stored at the DB and the SGQA is replaced by querying the database.

=Default values in array questions=

''Tested with: 1.87+ (7557), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of Version 1.92, many more question types support default values.</div>

This workaround uses JavaScript to allow you to pre-check default answers in all sub-questions of an array type question. You can select a column of the array to be checked as the page loads. The script first checks to see if a sub-question has already been answered and, if not, checks the default answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#Create the array question.
#In the source of the array question add the following script.
#Replace"QQ" with the question ID and "CC" with the column number to be checked.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// A function to pre-check a column of an array

function checkedDefault(qID, column) {

var checkedCol = column - 1;

$('#question' + qID + ' table.question tbody tr').each(function(i) {

if ($('input.radio[checked=true]', this).length == 0) {

$('input.radio:eq(' + checkedCol + ')', this).attr('checked', true);

}

});

}

// Call the function with a question ID and column number

checkedDefault(QQ, CC);

});

</script>

</syntaxhighlight>

=Record group view time=

''Tested with: 1.87+ (8518), IE 6/7, Firefox 3.5, Safari 3.2''

<div class="simplebox">As of version 1.92, group view time is accurately recorded in the timings table if you choose the Record Timings survey option.</div>

This workaround uses JavaScript to populate a hidden question with the total time that a respondent views a group. If used in a group with only one question, it could be used to track the amount of time required to answer the question.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._ Set up your survey to use JavaScript].
#In the group, create a short-text question. We will hide this later with JavaScript and populate it with the elapsed time.
#Place the following script in the source of the short-text question.
#Replace "QQ" in line 6 with the ID of the short-text question.

The script populates the hidden question with the elapsed time since the group was opened. If a respondent leaves the group and then returns, the timer continues up from the elapsed time of the last visit.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// call the functions with the hidden timer question ID

runTimer(QQ);

function runTimer(timeQID) {

$('#question'+timeQID).hide();

var initSec = '0';

// Check for elapsed time from previous visits

if ($('#question'+timeQID+' input.text').val()) {

var initTime = $('#question'+timeQID+' input.text').val();

initTimeArr = initTime.split(':');

initSec = Number[[initTimeArr[0]*3600]]+Number[[initTimeArr[1]*60]]+Number(initTimeArr[2]);

}

// Run the timer update function

recordTime(initSec, timeQID);

}

});

// Timer update function

function recordTime(elapsedSec, timeQID){

elapsedSec++;

var h = Math.floor(elapsedSec / 3600);

var m = Math.floor(elapsedSec % 3600 / 60);

var s = Math.floor(elapsedSec % 3600 % 60);

var elapsedTime = [[h > 0 ? h + ":" : "00:") + (m > 0 ? (m < 10 ? "0" : "") + m + ":" : "00:") + (s < 10 ? "0" : "") + s);

$('#question'+timeQID+' input.text').val(elapsedTime);

// Run the timer update function every second

setTimeout('recordTime('+elapsedSec+', '+timeQID+')',1000);

}

</script>

</syntaxhighlight>

=Toggle visibility of groups=

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

<div class="simplebox">Version 1.92 supports group-level relevance, making this workaround obsolete.</div>

This workaround uses JavaScript to toggle the visibility of groups in an "all in one" survey. Initially the groups are hidden and there are links inserted to display the groups. It's useful to avoid the page being cluttered with many groups and lets the respondent focus on one at a time.

It's [http://www.partnersinc.biz/surveys//index.php?sid=33613&newtest;=Y&lang;=en|demonstrated here].

Implementation is as follows:

#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._|Set up your survey to use JavaScript].

#Set the survey to run in "all in one" mode.

#Add your groups and questions.

#Place the following script in the source of one of the questions in the first group.

The comments in the script are pretty self-explanatory but it does the following:

#initially hides all of the groups

#inserts a link above each one to toggle its display

#some styles are added to the clickable links but these could be done in template.css instead

#shows any groups that have an unanswered mandatory after a submit attempt

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function(){

// Insert show/hide elements before all group wrapper divs

$('<div class="groupToggler"><span></span></div>').insertBefore('div[id<div class="simplebox">="group-"]');

// Add some text to the show/hide elements

$('.groupToggler span').each(function(i) {

($( this ).text('Show/Hide Group '+(i+1)+'']];

});

// Add some styles to the show/hide elements

$('.groupToggler').css({

'padding':'5px 0 10px 0',

'text-align':'center'

});

$('.groupToggler span').css({

'text-decoration':'underline',

'cursor':'pointer'

});

// Add some hover effects to the show/hide elements

$(".groupToggler span").hover(

function () {

$(this).css({

'text-decoration':'none',

'font-weight':'bold'

});

},

function () {

$(this).css({

'text-decoration':'underline',

'font-weight':'normal'

});

}

);

// Initially hide all of the groups

// Toggle their visibility when the show/hide element is clicked

$('.groupToggler span').click(function() {

$(this).parent().next().toggle();

return false;

}).parent().next().hide();

// Display any groups that have unanswered mandatories

$('.errormandatory').parents('div[id</div>="group-"]').show();

});

</script>

</syntaxhighlight>

=Use jQuery Autocomplete plugin to suggest answers for text inputs=

== 1.90 and previous versions==

''Tested with: 1.90+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://docs.jquery.com/Plugins/Autocomplete jQuery Autocomplete] plugin to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

I've put together a small demonstration [http://www.partnersinc.biz/surveys//index.php?sid=78611&newtest;=Y&lang;=en here] and implementation is as follows.

'''Both methods:'''
*[http://docs.jquery.com/Plugins/Autocomplete Download the plugin]
*Place the files ''jquery.autocomplete.css'' and ''jquery.autocomplete.js'' in your template directory
*Add the following code inside the <head> element of startpage.pstpl

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.autocomplete.js"></script>

<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}jquery.autocomplete.css" /></syntaxhighlight>

'''Method 1 ("States" question in the demo):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete(states, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

'''Method 2 ("Countries" question in the demo):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var countriesArr = new Array();

$.getJSON(url,function(data){

$(data).each(function(i, item){

countriesArr.push(item);

});

$('#question'+qID+' input.text').autocomplete(countriesArr, {

matchContains: true,

minChars: 0

});

});

</script></syntaxhighlight>

== 1.91 and later versions==

''Tested with: 1.91+, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI to provide a respondent a list of suggested answers that the they can select from as they type in a text input.

Although the plugin allows for much more complex applications, the two that I use most frequently are outlined below. The first method uses a relatively small list of suggestions that is stored in an array locally. The second is a little more complex - it uses a remote CSV file of suggestions that is accessed through AJAX an PHP.

'''Both methods:'''
*Add the following styles to the end of your 'template.css' file

<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>

'''Method 1 (use local JavaScript array for data):'''
*Create a text input question
*Add the following script to the source of the text question
*Replace "QQ" with the ID of the text input question
*Replace the states with your list of suggestions (comma separated)

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var q1ID = QQ;

var states = "Alabama,Alaska,Arizona,Arkansas,California,Colorado,Connecticut,Delaware,

District of Columbia,Florida,Georgia,Hawaii,Idaho,Illinois,Indiana,Iowa,Kansas,Kentucky,

Louisiana,Maine,Montana,Nebraska,Nevada,New Hampshire,New Jersey,New Mexico,New York,

North Carolina,North Dakota,Ohio,Oklahoma,Oregon,Maryland,Massachusetts,Michigan,

Minnesota,Mississippi,Missouri,Pennsylvania,Rhode Island,South Carolina,South Dakota,

Tennessee,Texas,Utah,Vermont,Virginia,Washington,West Virginia,Wisconsin,Wyoming".split(',');

$('#question'+q1ID+' input.text').autocomplete({

source: states

});

});

</script></syntaxhighlight>

'''Method 2 (use remote CSV file for data):'''
*Place the CSV file of suggestions in your template directory (you can download my demo CSV [http://www.partnersinc.biz/surveys/templates/default_autocompleting_input/countries2.csv here])
*Place a PHP file containing the code below in your template directory
*Replace "countries2.csv" with your CSV filename (you could make this more universal by passing the filename in the URL)
*This file will grab the contents of the CSV and encode them in JSON format that the JavaScript can use
*Place the JavaScript code below in ths source of the text question
*Replace "QQ" with the ID of the text input question
*Replace "templates/yourTemplate/countries.php" with the path to the PHP file (from LimeSurvey root)
*This script will grab the jsonized data from the PHP file and load it into an array that the plugin can use

PHP code:

<syntaxhighlight lang="php" enclose="div"><?php

$countriesArr = array();

$file_handle = fopen("countries2.csv", "r");

while (!feof($file_handle) ) {

$line_of_text = fgetcsv($file_handle);

array_push($countriesArr, $line_of_text[0]);

}

fclose($file_handle);

echo json_encode($countriesArr);

?></syntaxhighlight>

JavaScript code:

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qID = QQ;

var url = "templates/yourTemplate/countries.php";

var dataArr = [];

$.getJSON(url,function(data){

$.each(data,function(i, item){

dataArr.push(item);

});

$('#question'+qID+' input.text').autocomplete({

source: dataArr

});

});

});

</script></syntaxhighlight>

== Use autocomplete to populate several fields==

''Tested with: 1.91+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses the [http://jqueryui.com/demos/autocomplete/ Autocomplete widget] included with jQuery UI and the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin to provide a respondent with a list of suggested answers as they type in a text input and then to automatically populate other fields depending on the selection.

For example, if you have 3 questions - "Name", "ID" and "Email" - you can use this workaround to autocomplete the "Name" question and then the "ID" and "Email" questions can be automatically populated with values associated with the selected name.
*Download the [http://plugins.jquery.com/project/csv jquery.csv.js] plugin and place it in your template folder
*Add the following line to your startpage.pstpl BEFORE the tag for template.js<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.csv.js"></script></syntaxhighlight>
*Create your CSV file with 3 columns (name, ID, email) as in this example and place it in your template folder<syntaxhighlight lang="php" enclose="div">Bob, Bob's ID, Bob's email

Andy, Andy's ID, Andy's email

Sam, Sam's ID, Sam's email

Tony, Tony's ID, Tony's email

Fred, Fred's ID, Fred's email</syntaxhighlight>
*Create your 3 questions - "Name", "ID" and "Email". They must be in the same group/page.
*Add the following styles to the end of your 'template.css' file<syntaxhighlight lang="php" enclose="div">/* Autocomplete styles */

ul.ui-autocomplete {

width: 250px !important;

padding: 5px 10px;

list-style: none;

}</syntaxhighlight>
*Add the following script to the source of one of the questions
*Replace:
**"NN" with the "Name" question ID
**"II" with the "ID" question ID
**"EE" with the "Email" question ID
*Modify the path to your CSV file<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

var qNameID = NN;

var qIDID = II;

var qEmailID = EE;

var url = "upload/templates/yourTemplate/yourCsvFile.csv";

// Create an array to hold the names

var namesArr = new Array();

// Grab the CSV contents

$.get(url,function(data){

// Convert CSV contents to an array of arrays

fullArray = jQuery.csv()(data);

// Load the names array

$(fullArray).each(function(i, item){

namesArr.push(item[0]);

});

// Initialise the autocomplete plugin

$('#question'+qNameID+' input.text').autocomplete({

source: namesArr,

// Event fired when a selection is made (ui.item.value refers to the selected item)

select: function(event, ui) {

// Find the "ID" and "Email" values associated with the selected name value and load those questions

$(fullArray).each(function(i, item){

if(item[0] == ui.item.value) {

// The value from column 2 of the CSV

$('#question'+qIDID+' input.text').val(item[1]);

// The value from column 3 of the CSV

$('#question'+qEmailID+' input.text').val(item[2]);

}

});

}

});

});

});

</script></syntaxhighlight>

=Drag and Drop Rankings=

==Drag and Drop Ranking - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround is a modification of the workaround below and also uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables]. Thanks to the author of that workaround.

[[File:Untitled-12.png]]

Modifications include:
*Allow for multiple drag-n-drop ranking questions on a page
*Handle minimum and maximum answers settings
*Allow double clicking of items to add or remove them from the ranking list
*Work with the new shipped jQuery UI

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the large script below in your template.js file.
#Place the small script below in the source a ranking question, (this applies the "dragDropRank" function to the question). Replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID].
**Note: the LimeSurvey translations will be automatically used for the "Choices" and "Rankings" header labels but can be overridden with custom labels - see the example calls below.
#Insert the CSS below at the end of template.css (these styles are for the default template).

NOTE: I have not tested this workaround with conditions.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRank(qID, choiceText, rankText) {

if(!choiceText) {

choiceText = $('#question'+qID+' td.label label').text();

}

if(!rankText) {

rankText = $('#question'+qID+' td.output tr:first td:eq(1)').text();

}

//Add a class to the question

$('#question'+qID+'').addClass('dragDropRanking');

// Hide the original question in LimeSurvey (so that we can replace with drag and drop)

$('#question'+qID+' .rank, #question'+qID+' .questionhelp').hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

//$('#display'+qID).val('off');

// Add connected sortables elements to the question

var htmlCode = '<table class="dragDropTable"> \

<tbody> \

<tr> \

<td> \

<span class="dragDropHeader choicesLabel">'+choiceText+'</span><br /> \

<div class="ui-state-highlight dragDropChoices"> \

<ul id="sortable1'+qID+'" class="connectedSortable'+qID+' dragDropChoiceList"> \

<li>Choices</li> \

</ul> \

</div> \

</td> \

<td> \

<span class="dragDropHeader rankingLabel">'+rankText+'</span><br /> \

<div class="ui-state-highlight dragDropRanks"> \

<ol id="sortable2'+qID+'" class="connectedSortable'+qID+' dragDropRankList"> \

<li>Ranks</li> \

</ol> \

</div> \

</td> \

</tr> \

</tbody> \

</table>';

$(htmlCode).insertAfter('#question'+qID+' table.rank');

// Remove placeholder list items (have to have one item so that LimeSurvey doesn"t remove the <ul>)

$('#sortable1'+qID+' li, #sortable2'+qID+' li').remove();

// Load any previously-set values

loadDragDropRank(qID);

// Find the number of LimeSurvey ranking inputs ("Maximum answers")

var maxAnswer = $('#question'+qID+' td.output input.text').length;

// Set up the connected sortable

$('#sortable1'+qID+', #sortable2'+qID+'').sortable({

connectWith: '.connectedSortable'+qID+'',

placeholder: 'ui-sortable-placeholder',

helper: 'clone',

revert: 50,

receive: function(event, ui) {

if($('#sortable2'+qID+' li').length > maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

$(ui.sender).sortable('cancel');

}

},

stop: function(event, ui) {

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

}).disableSelection();

// Get the list of choices from the LimeSurvey question and copy them as items into the sortable choices list

$('#CHOICES_' + qID).children().each(function(index, Element) {

var liCode = '<li class="ui-state-default" id="choice_' + $(this).attr("value") + '">' + this.text + '</li>'

$(liCode).appendTo('#sortable1'+qID+'');

});

// Allow users to double click to move to selections from list to list

$('#sortable1'+qID+' li').live('dblclick', function() {

if($('#sortable2'+qID+' li').length == maxAnswer) {

alert ('You can only rank a maximum of '+maxAnswer+' choices.');

return false;

}

else {

$(this).appendTo('#sortable2'+qID+'');

$('#sortable1'+qID+'').sortable('refresh');

$('#sortable2'+qID+'').sortable('refresh');

updateDragDropRank(qID);

}

});

$('#sortable2'+qID+' li').live('dblclick', function() {

$(this).appendTo('#sortable1'+qID+'');

$('#sortable2'+qID+'').sortable('refresh');

$('#sortable1'+qID+'').sortable('refresh');

updateDragDropRank(qID);

});

}

// This function copies the drag and drop sortable data into the LimeSurvey ranking list.

function updateDragDropRank(qID)

{

// Reload the LimeSurvey choices select element

var rankees = [];

$('#sortable2'+qID+' li').each(function(index) {

$(this).attr('value', index+1);

// Get value of ranked item

var liID = $(this).attr("id");

liIDArray = liID.split('_');

// Save to an array

rankees[rankees.length] = { "r_name":$(this).text(),"r_value":liIDArray[1] };

});

$('#question'+qID+' input[name<div class="simplebox">="RANK_"]').each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

//alert (rankees[index].r_value);

$(this).next('input').attr('value', rankees[index].r_value);

} else {

$(this).val('');

$(this).next().val('');

}

});

// Reload the LimeSurvey choices select element (we need this for "Minimum answers" code)

$('#question'+qID+' td.label select option').remove();

$('#sortable1'+qID+' li').each(function(index) {

var liText = $(this).text();

var liID = $(this).attr('id');

liIDArray = liID.split('_');

var optionCode = '<option value="'+liIDArray[1]+'">'+liText+'</option>';

$(optionCode).appendTo('#question'+qID+' td.label select');

});

// Hack for IE6

if ($.browser.msie && $.browser.version.substr(0,1)<7) {

$('#question'+qID+' select').show();

$('#question'+qID+' select').hide();

}

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadDragDropRank(qID)

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$('#question'+qID+' input[name</div>="RANK_"]').each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { "r_name":$(this).val(),"r_value":$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won"t* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

var liCode = '<li class="ui-state-default" id="choice_' + value.r_value + '">' + value.r_name + '</li>';

$(liCode).appendTo('#sortable2'+qID+'');

});

}

</syntaxhighlight>

'''Code in the source of the question(s) using the LimeSurvey translations for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ);

});

</script>

</syntaxhighlight>

'''Code in the source of the question(s) using custom text for the "Choices" and "Rankings" element header labels''' (replace "QQ" with the ranking [http://docs.limesurvey.org/SGQA+identifier&structure;=English+Instructions+for+LimeSurvey#General_Description question ID]):

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRank(QQ, 'Custom Choices Label', 'Custom Rankings Label');

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop ranking styles */

.dragDropTable {

border: 0 none;

border-collapse: collapse;

width: 100%;

}

.dragDropTable td {

vertical-align: top;

width: 50%;

padding-right: 20px;

}

.dragDropTable .dragDropHeader {

font-weight: bold;

}

.dragDropTable .dragDropChoices,

.dragDropTable .dragDropRanks {

margin: 5px 0 0 0;

background: transparent none;

border: 0 none;

}

.dragDropTable .dragDropChoiceList,

.dragDropTable .dragDropRankList {

float: left;

width: 100%;

min-height: 2.4em;

_height: 2.4em; /* IE6 and below hack */

margin: 0;

padding: 0;

list-style-type: none;

background: #FBFBFB none;

border: 1px solid #CCCCCC;

}

.dragDropTable .dragDropChoiceList li,

.dragDropTable .dragDropRankList li {

margin: 3px;

*margin-left: -13px; /* IE7 and below */

padding: 3px;

min-height: 1.3em;

_height: 1.3em; /* IE6 and below hack */

font-weight: normal;

cursor: move;

display: block; /* Force the li to full width */

}

</syntaxhighlight>

==Drag and Drop Ranking using Images - Version 1.90 and newer==

''Tested with: 1.90+ & 1.91RC4, IE 6/7/8, Firefox 3.6, Safari 3.2''

This workaround works in conjunction with the above workaround to allow ranking of images.

[[File:Untitled-11.png]]

There is a '''[http://www.partnersinc.biz/surveys//index.php?sid=36981&newtest;=Y&lang;=en demonstrated here]'''.

Implementation is as follows:

1) Follow the above workaround to get basic drag-n-drop functionality in your ranking question.

2) Insert your images in the ranking question text or help section after any text that you wish to have there (we'll move them later with JavaScript).

3) Give the images '''EXACTLY''' the same IDs as the answer code you would like them to be associated with:[[File:Untitled-8.png]]

4) Place the first script below in your template.js file.

5) Place the second script below in the source the ranking question '''AFTER''' the initial call for the dragDropRank function from the workaround above. Replace "QQ" with the ID of the ranking question (this applies the "dragDropRankImages" function to the question).

6) Insert the CSS below at the end of template.css. Replace "11" with your question ID. These styles are for the default template using 50x50px images (as in the demo) and may need to be modified for other templates or image sizes.

'''Code for template.js:'''

<syntaxhighlight lang="php" enclose="div">

function dragDropRankImages(qID) {

$('.connectedSortable'+qID+' li').each(function(i) {

// Remove any text in the sortable choice or rank items

$(this).text('');

// Move the images into the appropriate sortable list item

var liID = $(this).attr('id');

liIDArray = liID.split('_');

$('#question'+qID+' img#'+liIDArray[1]+'').appendTo(this);

});

}

</syntaxhighlight>

'''Code in the source of the question(s):'''

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

dragDropRankImages(QQ);

});

</script>

</syntaxhighlight>

'''Styles for template.css:'''

<syntaxhighlight lang="php" enclose="div">

/* Drag-n-drop for ranking images */
#question11 .dragDropTable {

width: auto;

}
#question11 .dragDropTable .dragDropChoiceList,
#question11 .dragDropTable .dragDropRankList {

min-height: 60px;

_height: 60px; /* IE6 and below hack */

width: auto;

min-width: 60px;

_width: 60px; /* IE6 and below hack */

}
#question11 .dragDropTable li {

background: 0 none;

border: 0 none;

height: 50px;

width: 50px;

}
#question11 .dragDropTable li img {

margin: 0;

padding: 0;

border: 0 none;

}

</syntaxhighlight>

==Drag and Drop Ranking for iPad - Version 1.91 and newer==

''Tested with: LimeSurvey 1.91, iPad 2''

This workaround extends the above workarounds to work with the touch interface on iPads.

1) Follow the "[http://docs.limesurvey.org/Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#Drag_and_Drop_Ranking_-_Version_1.90_and_newer Drag and Drop Ranking - Version 1.90 and newer]" workaround above to get basic drag-n-drop functionality in your ranking question.

2) Download the [https://github.com/furf/jquery-ui-touch-punch jQuery.ui.touch-punch.js plugin] and save it in your template directory.

3) Replace this line in your startpage.pstpl:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>With this:<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" src="{TEMPLATEURL}jquery.ui.touch-punch.js"></script>

<script type="text/javascript" src="{TEMPLATEURL}template.js"></script></syntaxhighlight>

==Drag and Drop Ranking - Version 1.86==

Tested with 1.86 on IE 7,8, FireFox 3, Chrome, and Safari 4

This workaround uses [http://jqueryui.com/demos/sortable/#connect-lists JQuery connected sortables] to modify a ranking question and allow the survey taker to drag and drop choices instead of clicking. The nice thing is that the choices can be easily re-arranged or removed from the ranking, all by drag and drop.

I used it for a voting application and some of the element names reflect that use.

It looks best when some CSS is added to control the appearance of the boxers around each choice.

[[File:drag-n-drop.png]]

<syntaxhighlight lang="php" enclose="div">

// Question ID global variable

var questionID;

$(document).ready(function() {

// Grab the question ID[[File:drag-n-drop.png]]

// This is something with a class of "ranking" and an ID that starts with "questionXXXXX". The X's represent the question ID

var entire_questionID = $(".ranking[id<div class="simplebox">='question']").attr('id');

// Get just the question number (ID)

var patt=/\d+$/;

questionID=patt.exec(entire_questionID);

// Hide the original quetion in LimeSurvey (so that we can replace with drag and drop)

$(".rank, .questionhelp").hide();

// Turn off display of question (to override error checking built into LimeSurvey ranking question)

$("#display"+questionID).val("off");

// Add connected sortables to the question

var html_code = "<table style='border: medium none ; width: 770px; margin-left: auto; \

margin-right: auto;'><tbody><tr><td style='width: 590px; vertical-align: top;'><h3>List of Candidates:</h3> \

<div class='ui-state-highlight' style='margin: 5px; float: left;' id='ballot_list'> \

<ul id='sortable1' class='connectedSortable'><li>Candidates</li></ul></div></td> \

<td style='vertical-align: top;'><h3>Your selections:</h3><div class='ui-state-highlight' \

style='margin: 5px; float: left;' id='voting_selections'><ol id='sortable2' class='connectedSortable'> \

<li>Voting Area</li></ol></div></td></tr></tbody></table>";

$(html_code).appendTo("#question" + questionID);

// Remove list items (have to have one item so that LimeSurvey doesn't remove the <ul>)

$("#sortable1 li, #sortable2 li").remove();

// Load any previously-set values

loadRanking();

// Load jQuery UI

$.getScript("/scripts/jquery/jquery-ui.js", function() {

// After JQuery UI finishes loading, set up the connected sortable.

$("#sortable1, #sortable2").sortable({

connectWith: '.connectedSortable',

placeholder: 'ui-sortable-placeholder',

stop: function(event, ui) {

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

}

}).disableSelection();

// Get the list of candidates from the built-in LimeSurvey question and copy them as items in sortable1

$("#CHOICES_" + questionID).children().each(function(index, Element) {

li_tag = "<li class='ui-state-default' id='choice_" + $(this).attr('value') + "'>" + this.text + "</li>"

$(li_tag).appendTo("#sortable1"); } );

// Make sure the submit button is showing

$(":submit[value|=' Submit']").show();

// Show a confirmation alert upon submit

$("form").submit(function() {

// Override the built-in "disable navigation buttons" feature

$('#moveprevbtn, #movenextbtn, #movesubmitbtn').attr('disabled', '');

var validated = confirm("Cast your ballot now?");

if (validated) { return true; } else { return false; }

});

// Allow users to double click to move to selection list

$("#sortable1 li").assignDblClick();

}); // End of JQuery UI loading

}); // End of JQuery ready function

// Define the actions when an item is double clicked

$.fn.assignDblClick = function()

{

$(this).dblclick(function(){

$(this).appendTo('#sortable2');

$("#sortable1").sortable("refresh");

$("#sortable2").sortable("refresh");

updateRanking();

});

}

// This function copies the drag and drop sortable data into the standard LimeSurvey ranking structure.

function updateRanking()

{

var rankees = [];

$('#sortable2 li').each(function(index) {

$(this).attr("value", index+1);

// Get value of person

li_tag = $(this).attr('id');

li_tag_array = li_tag.split("_");

// Save to an array

rankees[rankees.length] = { 'r_name':$(this).text(),'r_value':li_tag_array[1] };

});

$("input[name</div>='RANK_']").each(function(index) {

if (rankees.length > index) {

$(this).val(rankees[index].r_name);

$(this).next().val(rankees[index].r_value);

} else {

$(this).val("");

$(this).next().val("");

}

});

// Re-assign double click action to first list items and remove

// double click action from section list items

$('#sortable1 li').unbind('dblclick').assignDblClick();

$('#sortable2 li').unbind('dblclick');

}

// This function is called on page load to see if there are any items already ranked (from a previous visit

// or cached due to a page change. If so, the already-ranked items are loaded into the sortable list

function loadRanking()

{

var rankees = [];

// Loop through each item in the built-in LimeSurvey ranking list looking for non-empty values

$("input[name<div class="simplebox">='RANK_']").each(function(index) {

// Check to see if the current item has a value

if ($(this).val()) {

// Item has a value - save to the array

// Use this element to contain the name and the next for the value (numeric)

rankees[rankees.length] = { 'r_name':$(this).val(),'r_value':$(this).next().val() };

}

});

// Now that we have a list of all the pre-ranked items, populate the sortable list

// Note that the items *won't* appear in the main list because LimeSurvey has removed them.

$.each(rankees, function(index, value) {

// Create the items in the sortable

li_tag = "<li class='ui-state-default' id='choice_" + value.r_value + "'>" + value.r_name + "</li>";

$(li_tag).appendTo("#sortable2");

});

}

</syntaxhighlight>

=Create MaxDiff question type=

See the "[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Question+design%2C+layout+and+templating&structure;=English+Instructions+for+LimeSurvey Question design, layout and templating]" section for a workaround that uses JavaScript to convert an '''''Array (flexible labels) by column''''' question into a [http://en.wikipedia.org/wiki/MaxDiff MaxDiff] question type.

[[File:max_diff_596x253.gif]]

=In a checkbox matrix, have the 'none' option in a row disable all other columns in that row=

''Tested with: Limesurvey 1.90+''

The questionId parameter is the base ID of the question matrix (multiflexible).

numColumns and numRows speak for themselves

specialColumns is an array of the columns that have the special ability that when one of them

is checked, none of the others can be checked. E.g., a 'none of these' and/or a 'do now know' option.

<syntaxhighlight lang="php" enclose="div">

<script>

numColumns=13;

numRows=18;

questionId='28417X2X24';

specialColumns=[1,12,13];

function action(obj){

locator=obj.id.replace('cbox_'+questionId, '').split('_');

row=locator[0];

column=locator[1];

//alert('Action for row,column='+row+','+column);

my_id='#cbox_'+questionId+row+'_'+column+''

if($(my_id).attr('checked') == false) {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

$(id).attr('disabled',false);

}

} else {

for( var i=1; i<=numColumns; i++ ) {

if(i==column) continue;

id='#cbox_'+questionId+row+'_'+i

aid='#answer'+questionId+row+'_'+i

$(aid).val(0);

$(id).attr('checked',false);

$(id).attr('disabled',true);

}

}

}

function customOnLoad(){

for( var row=1; row<=numRows; row++ ) {

for( var k=0; k<specialColumns.length; k++ )

{

column=specialColumns[k];

$('#cbox_'+questionId+row+'_'+column).change(function() {

action(this);

});

}

}

}

jQuery(document).ready(

function(){

customOnLoad();

}

);

</script>

</syntaxhighlight>

=Last Option In Array (Numbers) (Checkboxes) Row Excludes All Others=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to make the last option of each Array (Numbers) (Checkboxes) row exclude all other options in the same row.

The script will uncheck all options in a row if the last option is checked and uncheck the last option in a row if any other options are checked.

It's [http://www.partnersinc.biz/surveys//index.php?sid=22532&newtest;=Y&lang;=en demonstrated here].

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following script in the source of the array question or the group description.
#Call the script by replacing "QQ" in line 6 with your array question ID (you can call the script for more array questions by copying this line with new IDs).

NOTE: Care should be taken when using this script and conditional questions on the same page.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the exclude function using question ID(s)

excludeOpt (QQ);

// A function to make the last option in each array row exclusive

function excludeOpt (qID) {

// Add some classes to the checkboxes so we can manipulate them

$('#question'+qID+' table.question tbody td').addClass('normalOpt');

$('#question'+qID+' table.question tbody').each(function(i) {

$('td:last', this).removeClass('normalOpt').addClass('exlusiveOpt')

});

// A listener on the checkbox cells

$('#question'+qID+' table.question tbody td').click(function (event) {

// Set some vars

var el = $(this).parent();

var optLength = $('td', el).length

// Uncheck the appropriate boxes in a row

if ($(this).hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el).attr('checked', false);

}

else {

$('td', el).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

// A listener on the checkboxes

$('#question'+qID+' table.question tbody td input[type=checkbox]').click(function (event) {

// Set some vars

var el2 = $(this).parent().parent();

var optLength = $('td', el2).length

// Uncheck the appropriate boxes in a row

if ($(this).parent().hasClass('normalOpt')) {

$('td:last input[type=checkbox]', el2).attr('checked', false);

}

else {

$('td', el2).each(function(i) {

if (i < (optLength - 1)) {

$('input[type=checkbox]', this).attr('checked', false);

}

});

}

});

}

});

</script>

</syntaxhighlight>

=Load SVG Code From Drawing Tool=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

This workaround uses JavaScript/jQuery to load a drawing tool and store the results in a huge-text question.

The drawing tool is supplied by [http://www.mainada.net/inputdraw/ mainada.net].

Implementation is as follows:
#Go to [www.mainada.net/inputdraw/downloads|www.mainada.net/inputdraw/downloads], download the latest package and install all files in the root of your LS installation (you only really need '''inputdraw.js''', '''inputdraw.non-commercial.v1.5.swf''' and '''swfobject.js''' but the others are cool to play with).
#Add the following to the <head> element of your template startpage.pstpl file to pull in the scripts:

+~hs<span style="color:hs</span>hs<span style="color:hs~<script src="swfobject.js" type="text/javascript"></script>

+~hs</span>hs<span style="color:hs</span>hs~<script src="inputdraw.js" type="text/javascript"></script>
#Create a huge-text question and add the following script to the source of that question.

The script will">
*Automatically find the ID of the first huge-text question on the page
*Insert the drawing element into the huge-text question
*Hide the textarea of that question
*Populate it with the SVG code generated by the drawing element.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey, group and question IDs

if($( 'input#fieldnames' ).length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

var gID = tmp[1];

var qIDStr = $('div.text-huge:eq(0)').attr('id');

var tmp2 = qIDStr.split('question');

var qID = tmp2[1];

}

var textAreaID = 'answer'+sID+'X'+gID+'X'+qID;

// Hide the textarea

$('#'+textAreaID+'').hide();

// Insert an element for the drawing tool

$('<div id="place"></div>').insertBefore($('#'+textAreaID+''));

// Load the drawing tool

var draw = new InputDraw('inputdraw.non-commercial.v1.5.swf', 'place', {

id:textAreaID,

width:'350',

height:'100',

stroke_style:'2 1 rgb(255,0,0)',

animation:60,

color:'#CCCCCC' ,

tools_color:'0xd6c004',

clean:'clear.png',

undo:'undo.png',

disable:'size opacity color' // Get rid of most of the tools

});

});

</script>

</syntaxhighlight>

=Add Navigation Buttons (Next and Previous) To Top Of Page=

''Tested with: 1.90+, IE 7/8, Firefox 3.6, Safari 3.2''

Add the following to the end of template.js. It will insert a new div after the progress bar and then insert clones of the nav buttons in the new div.

This example is for the default template in 1.90 or 1.91. The placement of the new div may need to be modified for other templates.

<syntaxhighlight lang="php" enclose="div">

$(document).ready(function() {

// Insert a new div after the progress bar

$('<div id="navigator2" />').insertAfter('#progress-wrapper');

// Style the new div

$('#navigator2').css({

'text-align':'center'

});

// Insert clones of the nav buttons in the new div

$('input.submit:eq(0)').clone().appendTo('#navigator2');

$('input.submit:eq(2)').clone().appendTo('#navigator2');

// Give the new buttons some new IDs

$('#navigator2 input.submit').each(function(i) {

var oldID = $(this).attr('id');

var newID = oldID + '2';

$(this).attr('id', newID)

});

});

</syntaxhighlight>

[[File:extra_buttons.png]]

=How to ''add'' an opt out link to your survey using javascript.=

Tested with: 1.91+, Firefox 5.0

This javascript inserts a link to opt out of the survey above the progress bar.

First see the section above entitled: "How to use Script (eg. JavaScript etc.) in LimeSurvey?".

Then insert the following code into to the source of a group description or a question. I used the group description.

<syntaxhighlight lang="php" enclose="div"> <script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Find the survey ID

if($('input#fieldnames').length != 0) {

var fieldNames = $('input#fieldnames').attr('value');

var tmp = fieldNames.split('X');

var sID = tmp[0];

}

// Insert a new div after the progress bar

$('<div id="optOutLink" />').insertBefore('#progress-wrapper');

// Style the new div

$('#optOutLink').css({

'text-align':'center'

});

// Insert opt out url in the new div

$('#optOutLink').html('<P><a href="optout.php?lang=en&sid;='+sID+'&token;={TOKEN}"> /

Click here to opt out of this survey.</a></p><br>');

});

</script></syntaxhighlight>

=Anonymously track respondents answers across multiple surveys=

''Tested with: 1.91+ and 1.92+''

This workaround uses JavaScript/jQuery to enable tracking of respondents across multiple surveys ensuring anonymity (it does not use tokens).

To do this you have to use this question in all the surveys you want to link respondents answers.

This workaround create an ID by asking some partial personal information (like initials, birth month ...). The ID will be encrypted using a one-way function (in this case SHA-1) and stored in a brief text answer.

Implementation is as follows:
#[http://docs.limesurvey.org/tiki-index.php?page=Workarounds%3A+Manipulating+a+survey+at+runtime+using+Javascript&structure;=English+Instructions+for+LimeSurvey#How_to_use_Script_eg._JavaScript_etc._in_LimeSurvey_ Set up your survey to use JavaScript].
#Place the following code in the source of a brief text question.
#Optional: you can also add other select field to avoid collisions (e.g. for large population sample)

<syntaxhighlight lang="php" enclose="div">

<p>This answers are used to generate your ID. These information will be encrypted, it will not be possible in any case to identify you neither from your answers nor from your ID.</p>

<table>

<tr>

<td>Initial of your name</td>

<td>

<select id="field1">

<option value=""></option>

<option value="A">A</option>

<option value="B">B</option>

<option value="C">C</option>

<option value="D">D</option>

<option value="E">E</option>

<option value="F">F</option>

<option value="G">G</option>

<option value="H">H</option>

<option value="I">I</option>

<option value="J">J</option>

<option value="K">K</option>

<option value="L">L</option>

<option value="M">M</option>

<option value="N">N</option>

<option value="O">O</option>

<option value="P">P</option>

<option value="Q">Q</option>

<option value="R">R</option>

<option value="S">S</option>

<option value="T">T</option>

<option value="U">U</option>

<option value="V">V</option>

<option value="W">W</option>

<option value="X">X</option>

<option value="Y">Y</option>

<option value="Z">Z</option>

</select>

</td>

</tr>

<tr>

<td>Your birth month</td>

<td>

<select id="field2">

<option value=""></option>

<option value="01">January</option>

<option value="02">February</option>

<option value="03">March</option>

<option value="04">April</option>

<option value="05">May</option>

<option value="06">June</option>

<option value="07">July</option>

<option value="08">August</option>

<option value="09">September</option>

<option value="10">October</option>

<option value="11">November</option>

<option value="12">December</option>

</select>

<td>

</tr>

</table>

<script type="text/javascript" src="http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/sha1.js"></script>

<script type="text/javascript">

$(document).ready(function() {

$("#answer{SGQ}").attr('readonly', 'readonly');

//$("#answer{SGQ}").css('display', 'none'); //uncomment this line for not displaying the code

});

$('#field1, #field2').bind('change keyup', function() {

if ($("#field1").val()=='' || $("#field2").val()=='')

$("#answer{SGQ}").val('');

else {

var sha1 = CryptoJS.algo.SHA1.create();

sha1.update($("#field1").val());

sha1.update($("#field2").val());

// sha1.update($("#otherfield").val());

var hash = sha1.finalize();

$("#answer{SGQ}").val(hash);

}

});

</script>

</syntaxhighlight>

=Check validity of international phone number in subquestion=

''Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an international phone number in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the phone function with the question ID and the row number

phoneTest(QQ, NN);

function phoneTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var phoneMatch = /^[0-9,+,(), ,]{1,}(,[0-9]+){0,}$/;

var msg1 = 'Please enter a valid phone number.';

// Test the input

var phoneInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(phoneInput != '' && !phoneMatch.test(phoneInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1136 regexlib.com blank]

=Check validity of email address in subquestion=

'Tested with: 1.91+, Firefox 8, Chrome 15''

</div>As of version 1.92, you can use the core Validation querstion option to validate multiple short text and array text questions. Any question that fails that validation check will have its background color changed to red.<div class="simplebox">

</div>Note, the below workaround will fail in version 1.92 because it contains a regular expression with curly braces. However, as described above, support for this feature is now built-in to version 1.92<div class="simplebox">

This workaround uses javascript to check the validity of an email address in a subquestion of multiple short text.

Add the following code to the source of your question.

Replace "QQ" with the question ID and "NN" with the row number that you want to validate.

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the email function with the question ID and the row number

emailTest(QQ, NN);

function emailTest(qID, inputNum) {

// Interrupt next/submit function

$('#movenextbtn, #movesubmitbtn').click(function(){

// Some vars - modify as required

var emailMatch = /^[a-zA-Z0-9\_\-]+[a-zA-Z0-9\.\_\-]*@([a-zA-Z0-9\_\-]+\.)+([a-zA-Z]{2,4}|travel|museum)$/;

var msg1 = 'Please enter a valid email address.';

// Test the input

var emailInput = $('#question'+qID+' li:eq('+(inputNum-1)+') input.text').val();

if(emailInput != '' && !emailMatch.test(emailInput)) {

alert(msg1);

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'pink' });

return false;

}

else {

$('#question'+qID+' li:eq('+(inputNum-1)+') input.text').css({ 'background':'' });

return true;

}

});

}

});

</script>

</syntaxhighlight>

The regex is from: [http://www.regexlib.com/REDetails.aspx?regexp_id=1653 regexlib.com blank]

=Hiding the help-text when it's empty=

Tested with: 1.91+

I had made a style in my template putting a border around my help-text. To avoid empty help-text to show up (and have lines instead of just 'nothing' when there was no help text, I used this piece of code in question.pstpl:

<syntaxhighlight lang="php" enclose="div">

<script type="text/javascript">

var questionhelp="{QUESTIONHELP}";

if (questionhelp=="") {

document.write("");}

else {

document.write('<tr><td class="survey-question-help">'+ questionhelp +'</td></tr>');}

</script>

</syntaxhighlight>

it can probably be optimized but it worked for me

=Disable or hide selected fields in a matrix question=

''Tested with: 1.92+, IE 7/8/9, FireFox 12/13''

TASK

Hide or disable selected fields in a Matrix, so that users cannot make any input.

(See example, where users should not make input into red framed fields)

[[File:snap035.gif]]

Fig. 1: Prevent users from input into first two fields (as an example)

SOLUTION

First find the name of the fields you want to hide / disable. In my case I used Firebug with firefox to figure that out.

[[File:snap037.gif]]

Fig. 2: Figure out the name(s) of the field(s)

Then put the following script-code into the HTML-source code as described above:

Note: you have to change the code to match the names of your fields!

<syntaxhighlight lang="javascript" enclose="div">

<script type="text/javascript" charset="utf-8">

$(document).ready(function() {

$('input[name="69965X2X10SQ001_SQ001"]').attr('disabled', 'disabled');

$('input[name="69965X2X10SQ001_SQ002"]').attr('hidden', 'hidden');

});

</script>

</syntaxhighlight>

[[File:snap039.gif]]

Fig. 3: Result: first field is diabled ("greyed out"), second one is completely hidden

I think this way one can apply many other attributes to a field like color etc. But did not try that myself.

Thanks to roB2009 for the input in the forum!

=Add prefix or suffix to question type "Array (Texts)"=

TASK

Add a prefix or suffix to the text fields in questions of the "Array (Texts)" type.

[[File:suffix.png]]

Fig. 1: Suffix

[[File:prefix.png]]

Fig. 1: Prefix

SOLUTION
*Set up your survey to use JavaScript.
*Add the following script to the source of the array. Replace "12345" with the array question ID and modify the suffixes/prefixes as required.
*The function call must consist of a question ID followed by the suffixes for each column. Suffixes/Prefixes must be enclosed in quotes and comma separated.
*In this example question ID 12345 will get an "in €" suffix in the first column and an "in %" in the next 3 columns.

<syntaxhighlight lang="php" enclose="div"><script type="text/javascript" charset="utf-8">

$(document).ready(function() {

// Call the function with the question ID followed by a comma-separated list of suffixes

addSuffix(12345, 'in €', 'in %', 'in %', 'in %');

function addSuffix() {

var qID = $(arguments)[0];

// Assign some column-specific classes

$('#question'+qID+' table.question tbody tr').each(function(i){

$('td', this).each(function(i){

$(this).addClass('answerCol-'+(i+1)+'');

});

});

// Some styling

$('#question'+qID+' table.question tbody input[type="text"]').css({

'width': '50%'

});

// Insert the suffixes

$(arguments).each(function(i, val){

if(i > 0) {

$('#question'+qID+' td.answerCol-'+i+' label').append(val);

}

});

}

});

</script></syntaxhighlight>

For adding a prefix you need to substitute the following line in the code

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').append(val);</syntaxhighlight>

with this

</syntaxhighlight>$('#question'+qID+' td.answerCol-'+i+' label').prepend(val);</syntaxhighlight>

Survey participants

2012-06-21T15:49:13Z

Holch:

__TOC__

<div class="simplebox">'''Note''': Tokens have changed alot in Version 1.85 and later. So if you are using an earlier version there will be differences between your version and the documentation. We recommend to upgrade as soon as possible.</div>

=Introduction=

On many occasions you will want to invite a group of people to participate in your survey, keep track of who has completed the survey, and ensure that each person can only participate once. The tokens feature allows you to do the following:
*Manually create invitations (name, email address, ...)
*Import a list of names and email addresses for participants (from a CSV file or an LDAP query)
*Add/Remove invitations
*Generate a unique token number for each participant (invitation code)
*Send an email invitation to each person in your list, by group or individually
*Send a reminder email to each person in your list who has not yet responded, by group or individually
*Track who from your list has responded
*Restrict access against people who have not got a token, and those with a token who have already responded
*Edit/change any details in your list

Once the survey is switched to Closed-access mode (you have enabled tokens for this survey), then '''only the people with a valid token code (not already used) can access the survey'''.

If you enable ''Auto-registration'' in the survey properties, participants will be able to register for your survey to have their personal token code automatically generated.

==Can a survey using tokens ensure anonymous answers?==

The answer to this question is '''Yes'''. Tokens can be used both for anonymous and non-anonymous surveys. This is determined when creating a survey. If a survey is not anonymous (or 'tracked') then the token list can be used to find the responses that an individual has made to the survey. If the survey is anonymous, then no link (technically: foreign key relationship) is available between the tokens table and the responses.

=How to activate tokens?=

There are two ways to activate tokens:
#After survey activation you will be asked if you want to activate tokens: [[File:Switch-to-closed-access-mode.png]]
# '''OR '''you can click on the tokens symbol [[File:tokens.png]] - even before the survey is activated.

=The token management tools=

[[File:token-menu2.png]]

After creating the tokens table you can click on the tokens icon to get to the token administration. The following is a brief rundown of the menu options in the tokens screen:
*'''Admin''': Returns to the main survey admin screen
*'''Summary''': Displays just the brief summary of tokens in the table (number of tokens, how many have been sent an invitation, and how many have responded). Also provides access to the Database Admin functions (see below). This is the default screen.
*'''Browse''': Displays the complete list of participants in the tokens table. From the browse screen you can edit or delete individual entries in the token table as well as perform a number of other useful functions (see browse section below)
*'''Add new token entry''': Allows you to add an entry to the tokens table
*'''Add dummy token''': Allows you to add 1 or more tokens to the token table
*'''Manage additional field attributes''': Allows you to add additional fields to the tokens table to store custom participant data
*'''Import from CSV''': Allows you to import information from a csv file
*'''Import from LDAP''': Allows you to import information from an LDAP query (tested on openLdap but should work in any LDAP compliant directory including ActiveDirectory)
*'''Export tokens to CSV file''': creates a standard CSV (comma delimited) file with a complete list of participants of your current tokens table
*'''Edit email templates''': Used to customize the templates used for the invitations, reminders, confirmations, and registration emails
*'''Send email invitation''': Sends bulk email invitations to all participants in the tokens table who have not already been sent an invitation.
*'''Send email reminder''': Sends bulk email reminders to all participants in the tokens table who have not yet responded, but have been sent their first invitation.
*'''Generate tokens''': Creates unique tokens for all individual entries in the tokens table that do not yet have one
*'''Drop token table''': delete the token table and set the survey to Open-access mode.
*'''Bounce settings''': Email bounce back settings. Bounce back settings can be set at the survey level or at the system level. This feature was added in version 1.91

=Editing/adding a token=

A typical token entry contains the following fields:

<center>[[File:token_editing2.png]]</center>
*'''First and last name''': .. of the participant (can be used in the emails & survey)
*'''Email''': the participant's email address
*'''Email status''': a field to keep track of bad emails. For instance, if the survey administrator received email error notifications from this email, the he can set this field to anything other than 'OK' (for instance 'user unknown', or 'mailbox quota exceeded'). Marking this token with an email status other than 'OK', will help skip this entry when sending invitation or reminder emails. Note that this is completely manual, unless you decide to implement a script which does update this field automatically.
*'''Token''': this is the invitation code. It is usually automatically generated by the 'Generate tokens' button
*'''Language''': if you want to set the default language for this participant
*'''Invite sent''': defaults to 'N', otherwise would contain the date when the invitation email was sent
*'''Reminder sent''': defaults to 'N', otherwise would contain the date when the reminder email was sent
*'''Completed''': defaults to 'N', otherwise would contain the date when the survey was submitted for not anonymous survey, or 'Y' for anonymous survey
*'''Uses left''': A counter of number of times the token can be used. ''Note:'' When increasing this value (default = 1) for a user who has already filled out the survey (which sets uses left to 0), you have to add "N" at the "completed" field.
*'''Valid from''' & '''Valid until''' : You can set a date/time range where this token would be allowed to use. You can leave these empty if you don't want to limit participation time frame for certain users. Note: If the user is answering the survey and the participation time ends then the user is locked out immediately and won't be able to finish the survey.
*'''Attribute1 to Attribute x''': These are user-definable attribute fields - see the next paragraph.

=Dummy Tokens=

Dummy Tokens were added in 1.91. Here is a typical screen:

<center>[[File:dummyToken.png]]</center>
*'''Number of tokens''': Number of tokens to be added. Default is 100.
*'''Token length''': Number of characters or length of token. Default 15
*'''First and last name''': .. of the participant.
*'''Email''': the participant's email address
*'''Language''': If you want to set the default language for this participant
*'''Uses left''': A counter of number of times the token can be used.
*'''Valid from''' & '''Valid until''' : You can set a date/time range where this token would be allowed to use. You can leave these empty if you don't want to limit participation time frame for certain users. Note: If the user is answering the survey and the participation time ends then the user is locked out immediately and won't be able to finish the survey.
*'''Attribute1 to Attribute x''': These are user-definable attribute fields - see the next paragraph.

Note that Name, email, language will be set to the same value for all dummy Tokens

=Bounce Settings=

Email bounce back processing was added in 1.91.

[[File:surveyBounseSettings.png]]
*'''Survey bounce email''': A valid email address for return mail. For faster bounce back processing, this email box should be limited to bounce back only.
*'''Bounce settings to be used''': There are three options: 1) None (default) - no bounce back processing, 2) Use settings below - Will set bounce back processing at the survey level, or 3) Use global settings -- Settings based on the system level.
*'''Server type''': Three options: 1) Off, 2) IMAP or 3) POP
*'''Server name & port''': Host name and port number. Port number isn't typically needed unless the email host uses a non-standard port. Example: mail.example.net:25 or imap.gmail.com:995
*'''User name''': User Name or User ID of the email account
*'''Password''': password of the email account
*'''Encryption type''': Three options: 1) None (default), 2) SSL, or 3) TLS

=User-defined attribute fields=

It is possible to add a number of additional fields to the tokens table to save additional data for a participant. By clicking on the [[File:token_manage.png]] icon you can manage these fields. You can add more attribute fields (by default they have a a length of 255 chars) and also set descriptions for each field - so they look nicer in the administration, when you browse tokens, when creating [[Setting conditions|conditions]] based on attribute fields or even when you export results for non-anonymous surveys.

=Using the browse screen and editing tokens=

[[File:token-browse.png]]

The browse screen will show you a list of all entries in the tokens table, as well as giving you some 'action' buttons that can perform specific tasks for that individual entry.

The top row of the table has three columns: The dialogue on the right gives options for displaying a number of records, and a starting point. In the middle is a search bar and the symbols on the left let you move backwards or forwards through your list.

The second row of the table (see image below) includes various criteria to sort the entries and for each a green arrow that - if clicked - will refresh the screen showing the tokens ordered by that criterion.

The "Actions" column gives a list of specific tasks that can be performed on that individual entry:

[[File:token-actions.png]]
*Do the survey using the unique token of this entry
*Edit this entry
*Delete this entry
*Send a invitation/reminder to this individual entry
*If the survey is a 'tracked' (ie: not anonymous) survey, another button will appear, allowing you to view the response from this individual entry.

=Database Admin=

[[File:token-summary.png]][[File:token-db-mgt.png]]

While the summary screen shows a brief summary of tokens in the table, it also provides access to the "Database Admin" features which include:
*Clear invites: Sets all records that an invitation has been sent out to 'N'. Obviously shouldn't normally be used.
*Clear tokens: Clears all tokens. Similarly shouldn't normally be used.
*Drop tokens: Allows you to remove the tokens feature from your script. Deletes the entire table and all records, and allows the survey to be accessed by anybody who knows the URL.

= Importing/exporting tokens=

== CSV import==

When you click the icon to import tokens you will be presented with the following screen:

[[File:uploadtoken.jpg]]

Your CSV file must be a standard [http://en.wikipedia.org/wiki/Comma-separated_values CSV (Comma Separated Value) file]. The first line of text is always the header information and will be used to identify the field data. Possible data fields are:

<syntaxhighlight lang="php" enclose="div">firstname,lastname,email,emailstatus,token,language code,tid,attribute_1,attribute_2, attribute_...</syntaxhighlight>

To obtain a full list of token field names, export an existing token table.

The fields can be in any order but ''firstname, lastname and email are mandatory'', and they must contain at least one character. Empty data (such as "") is not sufficient. If you would like to import data for attribute fields, you must add the desired attribute fields to the token table prior to importing token data.

A bare minimum CSV file could look like this:

<syntaxhighlight lang="php" enclose="div">firstname,lastname,email

John,Doe,john@doe.net

</syntaxhighlight>

'''Date format for token import'''

The date format for the "validfrom" and "validuntil" fields in the CSV token inport file is "YYYY-MM-DD HH:MM", e.g.:

<syntaxhighlight lang="php" enclose="div">2012-01-01 00:00</syntaxhighlight>

--would correspond to 1st January, 2012, at 12:00 AM.

'''Filtering duplicates'''

If you activate the option to filter for duplicates you can set which fields are used to identify duplicates. By default First name, Last name & Email-address are pre-selected. If a duplicate is found while importing the related line is omitted.

'''Troubleshooting the token import'''

A common error when users try to import tokens is an invalid CSV file. This is often caused by Microsoft Excel. Many users have a list of e-mail addresses saved as an XLS document. A file can be saved as CSV in Excel, however, Microsoft uses semi-colon (;) as the comma separator, while a standard CSV file uses comma (,) as the separator. If you try to import an Excel saved CSV file you will get an error message. A simple solution is to save your XLS document as a CSV file in Excel and then open the file in a raw text editor and replace all semi-colon characters with commas.

Recommended free raw text editors are: [http://www.pspad.com/ PSPad], [http://www.flos-freeware.ch/notepad2.html NotePad2] or [http://notepad-plus-plus.org/ Notepad++] for Windows, and [http://www.barebones.com/products/textwrangler/ TextWrangler] for Macintosh.

You can use [http://www.libreoffice.org/features/calc/ LibreOffice Calc] to export import your xls file and export your csv file.

== CSV export==

When you export your tokens the following fieldorder is exported:

<syntaxhighlight lang="php" enclose="div">tid,firstname,lastname,email,emailstatus,token,language code,attribute_1,attribute_2,etc..</syntaxhighlight>

== LDAP import==

[[File:token-Ldap-import.png]]
* Queries are manually defined by the system administrator in the config-ldap.php file
* Duplicates are identified by First Name, Last Name & Email-Address. If a duplicate is found while importing the related line is omitted, unless you have unchecked the Filter Duplicates checkbox.

== A tip for generating a large number of fake e-mail addresses==

Sometimes you may need a large number of fake e-mail addresses and tokens. You can use functions in a spreadsheet (e.g. OpenOffice Calc) to generate them. Let's assume you want thousands addresses in a form: 1@test.com, 2@test.com, 3@test.com... Put consecutive numbers in column A: 1 in the A1, then insert function =A1+1 in A2, then copy A2 down as many times as you need. In B1 use concatenation function to join A1 and "@test.com", which is =CONCATENATE(A1;"@test.com"). Then copy B1 down for each copied A. You may generate fake names in a similar way. Finally, save the file as CSV for import in LS.

With the 1.91, you can use "Generate dummy token" functionnality

== A tip for generating a large number of individual links which include the token already==

The structure of the survey link is the following:

http://url-to-your-limesurvey-installation/index.php?sid=XXXX&lang;=en&token;={TOKEN}

So you proceed similar to the example above for generating email adresses.
*First column: http://url-to-your-limesurvey-installation/index.php?sid=XXXX&lang;=en&token;= (the same for all, as long as the language is the same!)
*Second column: {TOKEN} (put your tokens here, of course they must be individual)
*Third column: use the CONCATENATE funtion to joint the first column with the second column.

= Emailing=

== Email placeholders==

The following field names are allowed in invitation/reminder email templates and must be entered in the survey properties. When sending out the emails these field names will be already replaced in the preview of your invitation/reminder email.

{|
|{ADMINEMAIL}||Email of the Survey admin
|-
|{ADMINNAME}||Name of Survey Admin
|-
|{SURVEYNAME}||Title of your survey
|-
|{SURVEYDESCRIPTION}||Description of your survey
|}

The following field names are allowed in invitation/reminder emails (subject and/or body) and will be replaced while sending out the mails:

{|
|{EMAIL}||Email of the recipient
|-
|{FIRSTNAME}||First Name
|-
|{LASTNAME}||Last Name
|-
|{SURVEYURL}||The URL pointing to the survey start - if you are sending HTML emails this will be a fully linked HTML version
|-
|@@SURVEYURL@@||The URL pointing to the survey start - this is the barebone link. Use this if you want to integrate the link in your custom HTML elements somewhere (available in v1.90 and later)
|-
|{OPTOUTURL}||The URL to deactivate sending of mail for this survey - this will be a fully linked HTML version
|-
|{TOKEN}||Token to access the survey
|-
|{ATTRIBUTE_1}||Attribute 1
|-
|{ATTRIBUTE_2}||Attribute 2 (...and so on for more attribute fields)
|}

If your survey is NOT anonymous, the following field names are available to insert token data in survey text and javascript:

{|
|{TOKEN:EMAIL}||Email of the recipient
|-
|{TOKEN:FIRSTNAME}||First Name
|-
|{TOKEN:LASTNAME}||Last Name
|-
|{TOKEN}||Token to access the survey
|-
|{TOKEN:ATTRIBUTE_1}||Attribute 1
|-
|{TOKEN:ATTRIBUTE_2}||Attribute 2 (and so on for more attribute fields)
|}

See examples on using [http://docs.limesurvey.org/tiki-index.php?page=Adding+A+Question+#Information_from_tokens_table information from tokens table].

<div class="simplebox">Starting in Version 1.92, you can use [[Expression Manager|Expression Manager]] to use expressions for tailoring an email. Please have a look at the [[Expression Manager HowTos|Expression Manager HowTos]] for an example.</div>

==Emails settings==
#'''Invitation Email Subject''': The subject line for the invitation email that gets sent out when tokens are used with your survey.
#'''Invitation Email''': This is the text for the invitation email that gets sent out when tokens are used with your survey. This is initially filled by the default invitation message (from the language files) but you can modify it to suit yourself. If you are using English as your base language, the default invitation and reminder text can be found in the limesurvey/tokens.php file. Of course if you don't plan to use tokens on your survey, whatever is in this field is irrelevant. You can use the following "form" fields to insert individualized information in each email:
**'''{FIRSTNAME}''' - gets replaced with the token table's "firstname" value
**'''{LASTNAME}''' - gets replaced with the token table's "lastname" value
**'''{SURVEYNAME}''' - gets replaced with your surveys name
**'''{SURVEYDESCRIPTION}''' - gets replaced with your surveys description
**'''{ATTRIBUTE_1}''' - gets replaced with the token table's "attribute_1" value
**'''{ATTRIBUTE_2}''' - gets replaced with the token table's "attribute_2" value and so on
**'''{SURVEYURL}''' - gets replaced with the fully qualified URL to this particular survey - in HTML emails this is a fully linked HTML link
**'''@@SURVEYURL@@''' - Gets replaced with the survey barebone link. Use this if you want to integrate the link in your custom email HTML (available in v1.90 and later)
**'''{OPTOUTURL}''' - gets replaced with the URL for a respondent to opt-out of this particular survey

Note that these "form fields" apply to the following email fields.
#'''Email Reminder Subject''': The subject line for the reminder email that gets sent out from the tokens tool
#'''Email Reminder''': This is the text for the reminder email that gets sent out when tokens are used with your survey. See "invitation email" for specific details on how this field is used.
#'''Confirmation Email Subject''': When tokens are used, this is the subject line of the email that gets automatically sent to participants after completion of the survey
#'''Confirmation Email''': This is the text of the email that gets sent to users after completion of the survey. Delete/blank this text remove the confirmation email sending.
#'''Public Registration Email Subject''': This is the subject line for the invitation email sent to members of the public who register for a survey.
#'''Public Registration Email''': This is the text for the invitation email sent to members of the public who register for a survey. The same "form fields" apply in this email as in the earlier ones.

==Sending emails==

=== Send invitations===

[[File:token-invite.png]]

You can skip tokens for which the email status field is different from 'OK', by choosing the 'Bypass token with failing email addresses' option.

==== Resending invitations====

Sometimes you might want to send invitations again to certain token entries / persons. When you use the '''send invitations'''-function only e-mail addresses that ''has not previously received an invitation'' will get one. This means that if you add new addresses to the token list after the first time you sent invitations, only these new addresses will receive an invitation the second time you send invitations.

This means that you can also edit/change an e-mail in a particular token entry that you got a bounce from and then send to only this edited address. Just substitute the date '''Invite sent?''' for a capital '''N''' (no) and click '''send invitations''' again.

==== Participant opt-out====

When you use the {OPTOUTURL} tag in your invitation/reminder email, your participants have the possibility to opt out of this particular survey by just clicking on the related URL in the email - so you don't harrass them with reminder emails. A participant that opted out of your survey will have the email status 'OptOut' set in the token.

=== Send reminders===

[[File:token-remind.png]]

When sending reminders you can:
* bypass tokens with failing email addresses
* skip tokens for which an email has been 'recently' sent
* skip tokens for which a given number of emails have already been sent

Note: A reminder will only be send to tokens where the "completed" field is not "N" (this means the respondent has either not taken or has not completed the survey).

=== Sending emails by batch===

When you have to send a lot of emails at the same time, LimeSurvey will only send a first batch of N emails (this threshold is set by the administrator in the Global Settings).

You'll then need to click "Next" to send the next batch, and so on untill all emails have been sent.

=== Confirmation email===

If you are using tokens and a participant fills out the survey, a confirmation email is sent to his/her email address.

If you don't want this message to be sent, remove all content from the "Confirmation email subject" and "Confirmation email" fields - [http://docs.limesurvey.org/tiki-index.php?page=General+FAQ#How_can_I_stop_the_system_from_sending_confirmation_emails see these instructions].

=== Spam problems===

Often users complain not having received an invitation/reminder email because the user’s spam filter treated the email as spam.

If an email is treated as spam mostly depends on the spam filter being used and its settings. A spam filter usually checks the sender address and the email subject and content, so there are ways and means to influence how they treat your Limesurvey invitation and reminder emails.

At [http://www.limesurvey-consulting.com/how-to-prevent-limesurvey-email-invitations-or-reminders-being-treated-as-spam/ this blog post] on limesurvey-consulting.com a lot of possible issues and solutions are listed.

= Public registration=

==Allowing public registration==

You may want to open your survey to the public, but utilize the sort of respondent control available when using tokens. This is possible: If you initialize your tokens table, and have chosen to Allow Public Registration in the main survey setup, people who visit your survey's URL without a token, will be given the opportunity to register. If they provide an email address that is not already in the current survey's tokens table, an entry in the tokens table will be created, and they will be emailed an invitation containing their unique Token. All tokens provided to "registering" visitors will begin with the letter "R".

==Captchas in public registration==

To protect your survey from robot registration there is a captcha feature on all Registration, Save and Load forms. (starting from version 1.48) This feature is only available if you have GD-support activated in your PHP configuration. (see [[Installation|Installation Requirements]])