=======================
      thx-fcm 
=======================


Nei vari progetti sta nascendo l'esigenza di utilizzare messaggi di tipo push 
per inviare notifiche informative ai vari frontend; come servizio per l'invio è stato
scelto è `Firebase Cloud Messaging (FCM)`_.

Per semplificare la configurazione e l'interazione con FCM, è stato creato thx-fcm 
come wrapper del pacchetto ``django-fcm``.

Per installare il pacchetto: aggiungere nel setup.py ``thx-fcm`` e poi installare con il sistema corrente (pip, buildout …)

Assolutamente necessario creare un progetto su https://console.firebase.google.com/ e inserire la chiave FCM generata nel settings ``FCM_APIKEY``

Di seguito gli altri settings:

| ``THX_FCM_DEVICE_ADMIN_USER`` = 'thux'
| Serve per impostare l'utente creator di default

| ``THX_FCM_DEVICE_DELETE_INVALID_REG_ID`` = False
| Serve per decidere se elminare o meno il device registrato nel caso FCM risponda con un messaggio di dispositivo invalido

| ``FCM_DEVICE_MODEL`` = 'thx_fcm.Device'
| Indica il modello che si occupa di rappresentare il Device.

Per gli altri settings vedere https://django-fcm.readthedocs.io/en/latest/


.. automodule:: thx.fcm.models

.. automodule:: thx.fcm.api.views


.. _`Firebase Cloud Messaging (FCM)`: https://firebase.google.com/products/cloud-messaging