Skip to content

04 ‐ Application Usage

Jump to bottom
LRVT edited this page Aug 8, 2024 · 2 revisions

The VoucherVault web application should be self-explanatory.

Nonetheless, we will handle some key aspects in this wiki.

Internationalization

VoucherVault supports internationalization since v1.5.3.

Currently, two languages are supported:

  • German
  • English

You can toggle between languages in the web application's sidebar.

The Dashboard

In the left side navigation pane of the web application, you will find a Dashboard field.

Click it and you access the VoucherVault dashboard.

The Inventory

In the left side navigation pane of the web application, you will find a Inventory field.

Click it and you will see all items available in VoucherVault.

Futhermore, you can use the search bar to filter and find specific items.

Creating Items

In the left side navigation pane of the web application, you will find a Create New Item field.

Click it and you can create a new item.

Some cool features:

  • The redeem code input field can be filled out manually by typing or by using your webcam/smartphone camera. Just tap the camera icon, wait until it blinks in red color and scan the QR/EAN13 code. Once the QR/EAN13 code was read successfully, the camera icon stops blinking and the redeem input field is filled out with the scanned QR/EAN13 code.
  • The upload function allows you to upload an image (jpg, jpeg, png) or PDF (pdf) file into VoucherVault. Therefore, you can make a screenshot of your physical voucher, coupon, loyalty or giftcard and store it securely within VoucherVault.
  • If you choose the item type Coupon, you can toggle the Value input field from a monetary value to percentage. This is for example helpful, if the coupon itself has no specific monetary value but provides a % discount. Just click the small button and it will switch from money to percent.

Warning

The QR/EAN13 code scanning by camera does only work if VoucherVault is run behind a reverse proxy with TLS or accessed via 127.0.0.1 or localhost. The browser feature getUserMedia() used by the ZXing JavaScript library requires a secure context (HTTPS). Furthermore, you are tasked to approve camera access for the first time using the camera scan feature.

Whether scanning works, depends on your camera in use. Quality, focus, brightness and QR/EAN13 code readability are important factors.

Caution

Samsung smartphones using chrome-based browsers (Google Chrome, Samsung Browser, Opera) are known to have issues with getUserMedia() and selecting a rear camera with auto-focus support (see this). Often, a wide-angle rear camera is selected that cannot autofocus and therefore fails to scan small QR/EAN13 codes close to the camera. If you use such a device + browser and scanning often fails, please use a different mobile browser like FireFox. This is currently a wont-fix issue.

Inspecting an Item

Just browse the Inventory application area and click a specific item.

This will redirect you to the detailed item view.

This view will:

  • Showcase all item details such as issue date, expiry date, monetary or percentage value and the description. Also the PIN field if one was set. Additionally, a file download button is displayed if you have priorly uploaded a file. Moreover, the redeem code is displayed as QR code or EAN13 barcode. To protect this sensitive code (e.g. against shoulder-surfing), the redeem code is displayed blurred. Just click or tap the blurred image to unblur.
  • Allow you to edit and delete the item
  • Allow you to mark the item as used. This will define the item's value to 0 and mark it as used.
  • Allow you to add a redemption to the transaction history if the item's type is giftcard. Just provide a small description about the redemption and the amount you have redeemed from the giftcard. This will add the new entry to the transaction history and subtract the redeemed value from the remaining item value. Made a mistake during submission? No issue, just delete the individual transaction history entry.

Switching Themes

Via the sun icon in the header of the web application, you can toggle between light and dark theme.

The default theme defined is dark.

Your selection will create a new item in your browser's local storage to keep track of your theme choice.

Profile Settings

Via the top right profile icon you can access your user-related settings.

This area allows you to:

  • Change your current user password to a new one
  • Configure Apprise URLs for expiry notifications
  • Logout from the VoucherVault application and terminate your user session
  • If you are a superuser, you will also find a link to the admin panel

Django Admin

The Django admin panel can be access via /admin.

There, you can access Django's database models and entries. Please refraim from manupulating model entries, expect if you know what you are doing.

Finally, you can adjust the periodic task cronjob for expiry checking to your needs.

Clone this wiki locally