QRCode Checkin allows you to send an email that contains a scanable code to the registered participants for your event.
Your registration workers can use any freely available QR Code scanning software on their phones to scan the code and open the encoded web address on their browser.
When they do, they will get the status information about the registration, for example:
With one click, the registration worker can change their status from registered to attended.
The extension is licensed under AGPL-3.0.
Once enabled, each event configuration screen will have a new checkbox underneath the existing "Is this Event Active?" checkbox:
This setting can be set on any number of events at a time.
After setting the checkbox for your event, search for all contacts that are registered for the event and place them in a group.
Then, send an email to the group, that includes the QR Code image token. There will be a token for each QR Code-enabled event that:
Recipients will get an email that includes the QR Code as an embedded image:
Now onto the event... At the event, be sure to have all registration workers download a QR Code scanner to their phones (there are plenty of free scanners available for Android, here's one called QR Code Reader and on the iPhone it is built into the camera - so no extra software necessary).
Next, the registration worker should login to CiviCRM on their phones.
Since registration workers are often volunteers who should not have full access to your CiviCRM installation, you can create a role for them that must minimally have the following permissions:
When a registration worker scans a QR Code, they will see a web address and be given the option to open it in their web browser.
In their web browser, they will be presented with clear information about the participant status, for example:
The registration worker can simply click the button to switch them to attended and off they go.
If they have already checked in and have been coded as Attended (uh oh - someone re-using a registration qr code?), you will see:
If they have any other status, it will be displayed in red:
Tokens are generated for each event configured to use QR Codes. There are two tokens per event you can use:
When composing your email the tokens are searchable by your event's name (you don't need to know the event ID).
If you wish to override the values of the qrcode tokens / change the contents of the QR Code you can implement
hook_civicrm_qrcodecheckin_tokenValues
. You'll need to iterate through an array of possible tokens as they are dynamically
determined by virtue of the events that have QR support enabled.
eg.
function myextension_civicrm_qrcodecheckin_tokenValues(&$values, $contact_id, &$handled) {
foreach ($values as $key => $value) {
$event_id = preg_replace('/\D/', '', $key);
$link = 'http://example.org/qrcodes/' . $event_id . '/' . $contact_id . '/myqrcode.png';
if (strpos($key, 'url')) {
$value = $link;
}
else {
$value = '<p><img alt="QR Code with participant details" src="https://github.com/progressivetech/net.ourpowerbase.qrcodecheckin/raw/master/' . $link . '">Overirrden HTML</p>';
}
}
// If we handled the generation of the QRCode and URL set $handled=TRUE
$handled = TRUE;
}
This extension has not yet been published for installation via the web UI.
Sysadmins and developers may download the .zip
file for this extension and
install it with the command-line tool cv.
cd <extension-dir>
cv dl net.ourpowerbase.qrcodecheckin@https://github.com/progresssivetech/net.ourpowerbase.qrcodecheckin/archive/master.zip
Sysadmins and developers may clone the Git repo for this extension and install it with the command-line tool cv.
git clone https://github.com/progressivetech/net.ourpowerbase.qrcodecheckin.git
cv en qrcodecheckin
None so far.