 |
 |
|---|---|
| Web form | Example results |
This field plug-in can be used to determine how many times each link has been clicked. You can use this to make sure the enumerator has clicked on all needed links before moving on in the form.
- Automatically detect each link in the form by searching for the
<a>HTML tag. - Detect the number of times a link has been clicked in a field.
- Remembers number of times links clicked even when leaving field and coming back.
- All of the capabilities of the select_one-select_multiple field plug-in.
Android: Android 7 or up
iOS and web browsers: Because web browsers and iOS devices are kept more up-to-date with the latest features, nearly all web browsers and iOS devices should support the field plug-in, but test it on your collection device beforehand to be sure.
The field value will be the selected choice.
The metadata will retrieve the URL of each link, and how many times it had been clicked. Each URL-number pair will be separated by a pipe |, and within each pair, the URL and number will be separated by a space. Here is an example:
https://docs.surveycto.com/04-monitoring-and-management/01-the-basics/03a.using-data-explorer.html 1|https://docs.surveycto.com/04-monitoring-and-management/01-the-basics/04.reviewing-and-correcting.html 0
Here, the first URL has been clicked once, and the second URL has not been clicked at all.
You can use the plug-in-metadata(), item-at(), and selected() functions to retrieve the data you need. Check out our documenation on using expressions to learn about these functions. The sample form also demonstrates this for you.
To use this plug-in as is:
- Download the sample form from this repo.
- Download the detect-clicked-link.fieldplugin.zip file from this repo.
- Upload the sample form to your server, with the field plug-in attached.
The field plug-in will automatically detect all links in the field using the <a> HTML tag, and it will track how many times each of those has been clicked.
This field plug-in has no parameters.
| Feature / Property | Support |
|---|---|
| Supported field type(s) | select_one, select_multiple |
| Default values | Yes |
| Custom constraint message | Yes |
| Custom required message | Yes |
| Read only | Yes |
| media:image | Yes |
| media:audio | Yes |
| media:video | Yes |
quick appearance |
Yes (select_one only) |
minimal appearance |
Yes (select_one only) |
compact appearance |
No |
compact-# appearance |
No |
quickcompact appearance |
No |
quickcompact-# appearance |
No |
likert appearance |
Yes (select_one only) |
likert-min appearance |
Yes* (select_one only) |
likert-mid appearance |
No |
label appearance |
Yes |
list-nolabel appearance |
Yes |
*Note: this plug-in works well for the likert-min appearance when the field label is short, and does not contain an image, audio, or video. This is currently a known limitation.
-
Developer documentation
Instructions and resources for developing your own field plug-ins.
https://github.com/surveycto/Field-plug-in-resources -
User documentation
How to get started using field plug-ins in your SurveyCTO form.
https://docs.surveycto.com/02-designing-forms/03-advanced-topics/06.using-field-plug-ins.html