indico / indico-checkin Goto Github PK

Conference check-in application. Scan QR codes in tickets produced by Indico and get real-time information about your participants. Works on Android and iOS.

License: GNU General Public License v3.0

JavaScript 74.02% HTML 25.07% CSS 0.90%

indico-checkin's Introduction

Warning

This application will be discontinued with the upcoming release of Indico 3.3 (Q1 2024) and replaced with a new Checkin-in app. We recommend everyone to use the new application starting with Indico 3.3.

Indico check in mobile application

This application was initially developed during the CERN OpenLab Summer Student Programme. An early description of the project (for historical purposes) can be found here.

Build

We leverage Apache Cordova's multi-platform capabilities to create a simple yet useful web application. First of all, you'll have to install Cordova (note: npm v7 or greater required):

$ npm install -g cordova

For Android development

You'll need to have the Android SDK Tools installed. Android Studio may also be of help if you intend to use an emulator instead of a physical phone.

Please note that the ANDROID_HOME environment variable needs to be properly set, otherwise Cordova won't be able to find the SDK.

$ cordova platform add android

Note: You need to have Android build tools 29.0.2 installed and not have installed any version greater than 29.0.2. Due to a bug in cordova-android < 10.0, which this project uses, it's not possible to specify the build tools version with --gradleArg=-PcdvBuildToolsVersion=29.0.2. Because of this, it will always try to use the latest installed and fail with Build-tool is missing DX if they are greater than 29.0.2.

If you intend to use the emulator you may need to create an AVD if you don't yet have one. If you want to use a physical device, just make sure you connect it via USB.

Regardless of what you choose, you'll only need to run:

$ cordova run android

iOS Development

You will need to have XCode installed. You will also need to install ios-deploy:

$ npm install -g ios-deploy

Similarly to what happens with Android, you may choose to use an emulator or actual phone.

$ cordova run ios

You may be required to associate the XCode project with a development team.

indico-checkin's People

Contributors

Stargazers

Watchers

Forkers

arescope dcmits bpedersen2 pferreir davidandreev adityamj driehle javfg albertvaka tomasr8 eingemaischt governmentplates

indico-checkin's Issues

Make permission errors clearer

Right now, 403 errors are not reported properly. E.g. when the app user has no management rights for an event and attempts to check in a registrant by scanning his QR.

Attendees list unsorted

In the Attendees view the attendees aren't sorted alphabetically making you have to scroll through them reading every name to find them

I think a default sorting order of alphabetical by Full Name, would make the most sense. In the future it would be good to let the user choose between First and Surnames for the sort order

Make phone number "clickable"

User suggestion. This would be super useful since the application is running on a phone. A link using the tel: scheme should be enough.

Feature request: Alphabetical sorting of attendees

Hello,
We had our first event with the indico website and the check in app. It turned out that for an easier use of the app one feature would be important: The participants should be sorted alphabetically and / or a search function should be included.

It would be great if that would be possible in the future.

Show all custom registration fields

We have a "T-Shirt" field in the registration. We'd like to be able to see this when checking someone in. It does not appear there is a way to do this in the Indico check-in app.

Would be great to show all the fields, or a configurable set.

Error on iOS app

When using the indico-checkin iOS app with our local Indico instance, the app produces an error on all actions:

The Android version of the app works fine with the same backend Indico instance.

Improve oauth security

Use the code+PCKE flow instead of implicit flow to get the token (depends on MrSwitch/hello.js#633)
Stop sending the access token via query string but as a header instead

Unless Indico 3.0 is released by the time we release this, we need to keep support for the old implicit flow (and confirm whether 2.3 supports the access token in a header) and only use the new one if the server is running on indico v3.

If we manage to improve this before the indico v3 release (and publish to both the iOS and Android app stores), the "Support implicit grant for the checkin app" commit in Indico should be be reverted as it won't be needed anymore.

Users from all registration forms are combined in single attendees list per event

The checkin app (only tested on android but probably uses the same code for ios) doesn't handle properly an event having more than 1 registration form as in the Attendees view it just combines them all together in one long list

The Events view should list the event & all its forms (with the form name) to give you the option to select which you want to deal with check-ins for, then the Attendees view would only those registered for that form

A nice to have improvement would be to have it only show the forms that have Tickets enabled for them

Current version of the views: