# Notify of changes to vehicle/ home location

## Feature description

Sometimes there could be changes made to a certain vehicle or home zone. The users should be notified about these changes before the user is able to start using the vehicle. These notifications come up as a pop up on the app when the user starts the usage of the vehicle with a notification. The management of the notifications can be done in Control Center.

## Notification parameters

A notification can have the following parameters:

1. **Expiry date:** Changes to a vehicle or homezone could be temporary. Therefore this is an optional field if the notification should only be shown until a certain date.
2. **Title:** The title of the notification dialog. This is the text that is shown on the top of the dialog.
3. **Message:** The content of the notification dialog.
4. **Trigger**: This is the moment when the notification should be shown to the user. Currently there are 2 options: after the user creates the reservation & after the user starts the reservation.
5. **Repeat**: This is how often the notification should be shown to the user when it is triggered. The options to this repeat value are `once`, `always`, `daily`, `weekly` & `monthly`. 

Multi language is supported for the title and the content. To add a title and content of a certain language, first choose the language from the dropdown, and either create a new notification or edit an existing one.

Do note that if the notification has an expiration date that has already passed, the notification will never be shown to the user even if the repeat value is set to `always` .

## Configuration in Control Center

The notifications can be managed for the home zone of a vehicle. To add a notification for a certain home zone, go in Control Center to "Home zones", select the home zone and open the "app notifications" tab. Here you can create a notification, remove it and edit the values. To add a notification, click on the "Create notification" button on the top left of the page. To edit or delete a notification, click on the title of the existing notification and edit or delete the selected notification. Home zones with a notification are displayed on the overview page with an "announcement"-icon on the bottom right of the home zone icon.

### Necessary permissions to create, edit and delete a notification

An admin must have the permission `userAppTriggers:create` to be able to create notifications. To edit and delete notifications the permission `userAppTriggers:edit` is needed.