Questa pagina è stata tradotta dall'API Cloud Translation.

Scopri Firebase per il web

1. Panoramica

In questo codelab apprenderai alcune delle nozioni di base di Firebase per creare applicazioni web interattive. Creerai un'app di chat per la partecipazione a un evento e il libro degli ospiti utilizzando diversi prodotti Firebase.

screenshot di questo passaggio

Cosa imparerai a fare

Autentica gli utenti con Firebase Authentication e FirebaseUI.
Sincronizzare i dati con Cloud Firestore.
Scrivi regole di sicurezza Firebase per proteggere un database.

Che cosa ti serve

Un browser a tua scelta, ad esempio Chrome.
Accesso a stackblitz.com (non è necessario un account o l'accesso).
Un Account Google, ad esempio un account Gmail. Ti consigliamo di utilizzare l'account email che utilizzi già per il tuo account GitHub. In questo modo puoi utilizzare le funzionalità avanzate di StackBlitz.
Il codice di esempio del codelab. Per scoprire come ottenere il codice, consulta il passaggio successivo.

2. Ottieni il codice di partenza

In questo codelab, creerai un'app utilizzando StackBlitz, un editor online in cui sono integrati diversi flussi di lavoro Firebase. Stackblitz non richiede l'installazione di software o un account StackBlitz speciale.

StackBlitz consente di condividere i progetti con altre persone. Altre persone che dispongono dell'URL del tuo progetto StackBlitz possono vedere il tuo codice e creare un fork del tuo progetto, ma non possono modificarlo.

Vai a questo URL per il codice di avvio: https://stackblitz.com/edit/firebase-gtk-web-start
Nella parte superiore della pagina StackBlitz, fai clic su Fork:

screenshot di questo passaggio

Ora hai una copia del codice iniziale come progetto StackBlitz personale, che ha un nome univoco e un URL univoco. Tutti i file e le modifiche vengono salvati in questo progetto StackBlitz.

3. Modifica informazioni evento

I materiali di partenza per questo codelab forniscono una certa struttura per l'app web, inclusi alcuni fogli di stile e un paio di contenitori HTML per l'app. Più avanti in questo codelab, collegherai questi contenitori a Firebase.

Per iniziare, diamo un'occhiata all'interfaccia di StackBlitz.

In StackBlitz, apri il file index.html.
Individua event-details-container e description-container, quindi prova a modificare alcuni dettagli dell'evento.

Mentre modifichi il testo, il ricaricamento automatico della pagina in StackBlitz mostra i nuovi dettagli dell'evento. Fantastico, sì?

<!-- ... -->

<div id="app">
  <img src="..." />

  <section id="event-details-container">
     <h1>Firebase Meetup</h1>

     <p><i class="material-icons">calendar_today</i> October 30</p>
     <p><i class="material-icons">location_city</i> San Francisco</p>

  </section>

  <hr>

  <section id="firebaseui-auth-container"></section>

  <section id="description-container">
     <h2>What we'll be doing</h2>
     <p>Join us for a day full of Firebase Workshops and Pizza!</p>
  </section>
</div>

<!-- ... -->

L'anteprima dell'app dovrebbe avere il seguente aspetto:

Anteprima dell'app

screenshot di questo passaggio

4. Crea e configura un progetto Firebase

La visualizzazione delle informazioni sugli eventi è ottima per i tuoi ospiti, ma la semplice visualizzazione degli eventi non è molto utile per nessuno. Aggiungiamo alcune funzionalità dinamiche a questa app. Per farlo, devi collegare Firebase alla tua app. Per iniziare a utilizzare Firebase, devi creare e configurare un progetto Firebase.

Creare un progetto Firebase

Accedi a Firebase.
Nella console Firebase, fai clic su Aggiungi progetto (o Crea un progetto), poi assegna al progetto Firebase il nome Firebase-Web-Codelab.
Fai clic sulle varie opzioni di creazione del progetto. Accetta i termini di Firebase, se richiesto. Nella schermata di Google Analytics, fai clic su "Non abilitare", perché non utilizzerai Analytics per questa app.

Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.

Abilitare e configurare i prodotti Firebase nella console

L'app che stai creando utilizza diversi prodotti Firebase disponibili per le app web:

Firebase Authentication e Firebase UI per consentire facilmente agli utenti di accedere alla tua app.
Cloud Firestore per salvare i dati strutturati sul cloud e ricevere notifiche immediate quando i dati subiscono modifiche.
Regole di sicurezza di Firebase per proteggere il database.

Alcuni di questi prodotti richiedono una configurazione speciale o devono essere attivati utilizzando la console Firebase.

Per consentire agli utenti di accedere all'app web, utilizzerai il metodo di accesso Email/password per questo codelab:

Nel riquadro laterale sinistro della console Firebase, fai clic su Crea > Autenticazione. Quindi fai clic su Inizia. A questo punto ti trovi nella dashboard Autenticazione, dove puoi visualizzare gli utenti registrati, configurare i provider di accesso e gestire le impostazioni.
Seleziona la scheda Metodo di accesso (o fai clic qui per andare direttamente alla scheda).
Fai clic su Email/Password tra le opzioni del provider, imposta l'opzione su Attiva e poi fai clic su Salva.

Configura Cloud Firestore

L'app web utilizza Cloud Firestore per salvare i messaggi di chat e riceverne di nuovi.

Ecco come configurare Cloud Firestore nel tuo progetto Firebase:

Nel riquadro a sinistra della console Firebase, espandi Build e seleziona Database Firestore.
Fai clic su Crea database.
Lascia l'ID database impostato su (default).
Seleziona una posizione per il database, poi fai clic su Avanti.
Per un'app reale, scegli una posizione vicina ai tuoi utenti.
Fai clic su Avvia in modalità di test. Leggi il disclaimer sulle regole di sicurezza.
Più avanti in questo codelab aggiungerai Regole di sicurezza per proteggere i tuoi dati. Non distribuire o esporre pubblicamente un'app senza aggiungere regole di sicurezza per il tuo database.
Fai clic su Crea.

5. Aggiungere e configurare Firebase

Ora che hai creato il progetto Firebase e hai attivato alcuni servizi, devi indicare al codice che vuoi utilizzare Firebase, nonché il progetto Firebase da utilizzare.

Aggiungere le librerie Firebase

Affinché la tua app possa utilizzare Firebase, devi aggiungere le librerie Firebase all'app. Esistono diversi modi per farlo, come descritto nella documentazione di Firebase. Ad esempio, puoi aggiungere le librerie dalla rete CDN di Google oppure installarle localmente utilizzando npm e poi impacchettarle nella tua app se utilizzi Browserify.

StackBlitz fornisce il bundling automatico, quindi puoi aggiungere le librerie Firebase utilizzando le istruzioni di importazione. Utilizzerai le versioni modulari (v9) delle librerie, che consentono di ridurre le dimensioni complessive della pagina web tramite un processo chiamato "tree shaking". Per scoprire di più sugli SDK modulari, consulta la documentazione.

Per creare questa app, utilizza le librerie Firebase Authentication, FirebaseUI e Cloud Firestore. Per questo codelab, le seguenti istruzioni di importazione sono già incluse nella parte superiore del file index.js e importeremo altri metodi da ogni libreria Firebase man mano che procediamo:

// Import stylesheets
import './style.css';

// Firebase App (the core Firebase SDK) is always required
import { initializeApp } from 'firebase/app';

// Add the Firebase products and methods that you want to use
import {} from 'firebase/auth';
import {} from 'firebase/firestore';

import * as firebaseui from 'firebaseui';

Aggiungi un'app web Firebase al tuo progetto Firebase

Torna nella console Firebase e vai alla pagina Panoramica del progetto facendo clic su Panoramica del progetto in alto a sinistra.
Al centro della pagina Panoramica del progetto, fai clic sull'icona web per creare una nuova app web Firebase.
Registra l'app con il nickname Web App.
Per questo codelab, NON selezionare la casella accanto a Configura anche Firebase Hosting per questa app. Per il momento utilizzerai il riquadro di anteprima di StackBlitz.
Fai clic su Registra app.
Stackblitz gestisce le dipendenze per te, quindi puoi saltare il passaggio npm install firebase visualizzato nella console.
Copia l'oggetto di configurazione Firebase negli appunti.
Fai clic su Continua alla console. Aggiungi l'oggetto di configurazione Firebase alla tua app:
Torna a StackBlitz e vai al file index.js.
Individua la riga di commento Add Firebase project configuration object here, quindi incolla lo snippet di configurazione appena sotto il commento.

Aggiungi la chiamata alla funzione initializeApp per configurare Firebase utilizzando la configurazione univoca del tuo progetto Firebase.

// ...
// Add Firebase project configuration object here
const firebaseConfig = {
  apiKey: "random-unique-string",
  authDomain: "your-projectId.firebaseapp.com",
  databaseURL: "https://your-projectId.firebaseio.com",
  projectId: "your-projectId",
  storageBucket: "your-projectId.firebasestorage.app",
  messagingSenderId: "random-unique-string",
  appId: "random-unique-string",
};

// Initialize Firebase
initializeApp(firebaseConfig);

6. Aggiungere l'accesso utente (RSVP)

Ora che hai aggiunto Firebase all'app, puoi configurare un pulsante di risposta che registri le persone utilizzando Firebase Authentication.

Avrai bisogno di un pulsante di risposta che chieda all'utente di accedere con il proprio indirizzo email. Puoi farlo collegando FirebaseUI a un pulsante di risposta. FirebaseUI è una libreria che fornisce un'interfaccia utente predefinita su Firebase Auth.

FirebaseUI richiede una configurazione (consulta le opzioni nella documentazione) che consente di eseguire due operazioni:

Indica a FirebaseUI che vuoi utilizzare il metodo di accesso Email/password.
Gestisce il callback per un accesso riuscito e restituisce false per evitare un reindirizzamento. Non vuoi che la pagina venga aggiornata perché stai creando un'app web di una sola pagina.

Aggiungi il codice per inizializzare FirebaseUI Auth

In StackBlitz, vai al file index.js.

In alto, individua l'istruzione di importazione firebase/auth, quindi aggiungi getAuth e EmailAuthProvider in questo modo:

// ...
// Add the Firebase products and methods that you want to use
import { getAuth, EmailAuthProvider } from 'firebase/auth';

import {} from 'firebase/firestore';

Salva un riferimento all'oggetto auth subito dopo initializeApp, in questo modo:
```
initializeApp(firebaseConfig);
auth = getAuth();
```
Tieni presente che la configurazione di FirebaseUI è già fornita nel codice iniziale. È già configurato per utilizzare il provider di autenticazione email.

Nella parte inferiore della funzione main() in index.js, aggiungi l'istruzione di inizializzazione di FirebaseUI, come segue:

async function main() {
  // ...

  // Initialize the FirebaseUI widget using Firebase
  const ui = new firebaseui.auth.AuthUI(auth);
}
main();

Aggiungi un pulsante di risposta all'HTML

In StackBlitz, vai al file index.html.
Aggiungi il codice HTML per un pulsante "Parteciperai?" all'interno di event-details-container, come mostrato nell'esempio di seguito.

Fai attenzione a utilizzare gli stessi valori id mostrati di seguito perché, per questo codelab, nel file index.js sono già presenti hook per questi ID specifici.

Tieni presente che nel file index.html è presente un contenitore con l'ID firebaseui-auth-container. Questo è l'ID che passerai a FirebaseUI per conservare il tuo accesso.
```


<section id="event-details-container">
    
    
    <button id="startRsvp">RSVP</button>
</section>
<hr>
<section id="firebaseui-auth-container"></section>

```
Anteprima dell'app
Imposta un listener sul pulsante RSVP e chiama la funzione di avvio FirebaseUI. Questo indica a FirebaseUI che vuoi visualizzare la finestra di accesso.

Aggiungi il seguente codice alla fine della funzione main() in index.js:
```
async function main() {
  // ...

  // Listen to RSVP button clicks
  startRsvpButton.addEventListener("click",
   () => {
        ui.start("#firebaseui-auth-container", uiConfig);
  });
}
main();
```

Testare l'accesso all'app

Nella finestra di anteprima di StackBlitz, fai clic sul pulsante RSVP per accedere all'app.
- Per questo codelab, puoi utilizzare qualsiasi indirizzo email, anche uno falso, poiché non stai configurando un passaggio di verifica email per questo codelab.
- Se viene visualizzato un messaggio di errore "auth/operation-not-allowed" o "The given sign-in provider is disabled for this Firebase project", verifica di aver attivato Email/password come provider di accesso nella Console Firebase.
Anteprima dell'app
Vai alla dashboard Autenticazione nella console Firebase. Nella scheda Utenti dovresti vedere i dati dell'account che hai inserito per accedere all'app.

Aggiungi lo stato dell'autenticazione alla UI

Successivamente, assicurati che l'interfaccia utente rifletta il fatto che hai eseguito l'accesso.

Utilizzerai il callback dell'ascoltatore dello stato di Firebase Authentication, che riceve una notifica ogni volta che cambia lo stato di accesso dell'utente. Se al momento è presente un utente che ha eseguito l'accesso, l'app sostituirà il pulsante "Rispondi" con un pulsante "Uscire".

In StackBlitz, vai al file index.js.

In alto, individua l'istruzione di importazione firebase/auth, quindi aggiungi signOut e onAuthStateChanged, come segue:

// ...
// Add the Firebase products and methods that you want to use
import {
  getAuth,
  EmailAuthProvider,
  signOut,
  onAuthStateChanged
} from 'firebase/auth';

import {} from 'firebase/firestore';

Aggiungi il seguente codice in fondo alla funzione main():

async function main() {
  // ...

  // Listen to the current Auth state
  onAuthStateChanged(auth, user => {
    if (user) {
      startRsvpButton.textContent = 'LOGOUT';
    } else {
      startRsvpButton.textContent = 'RSVP';
    }
  });
}
main();

Nell'ascoltatore del pulsante, controlla se è presente un utente corrente e scollegalo. Per farlo, sostituisci l'attuale startRsvpButton.addEventListener con quanto segue:

// ...
// Called when the user clicks the RSVP button
startRsvpButton.addEventListener('click', () => {
  if (auth.currentUser) {
    // User is signed in; allows user to sign out
    signOut(auth);
  } else {
    // No user is signed in; allows user to sign in
    ui.start('#firebaseui-auth-container', uiConfig);
  }
});

A questo punto, il pulsante nell'app dovrebbe mostrare DISCONNESSIONE e, dopo aver fatto clic, dovrebbe tornare alla pagina RSVP.

Anteprima dell'app

screenshot di questo passaggio

7. Scrivi messaggi in Cloud Firestore

Sapere che gli utenti arrivano è fantastico, ma diamo loro qualcos'altro da fare nell'app. E se potessero lasciare messaggi in un guestbook? Possono spiegare perché sono entusiasti di venire o chi sperano di incontrare.

Per archiviare i messaggi della chat scritti dagli utenti nell'app, utilizzerai Cloud Firestore.

Modello dei dati

Cloud Firestore è un database NoSQL e i dati archiviati nel database sono suddivisi in raccolte, documenti, campi e sottoraccolte. Ogni messaggio della chat verrà archiviato come documento in una raccolta di primo livello chiamata guestbook.

Grafica del modello di dati di Firestore che mostra una raccolta di libri degli ospiti con più documenti di messaggio

Aggiungere messaggi a Firestore

In questa sezione aggiungerai la funzionalità che consente agli utenti di scrivere nuovi messaggi nel database. Innanzitutto, aggiungi il codice HTML per gli elementi dell'interfaccia utente (campo del messaggio e pulsante di invio). Quindi, aggiungi il codice che collega questi elementi al database.

Per aggiungere gli elementi dell'interfaccia utente di un campo del messaggio e un pulsante di invio:

In StackBlitz, vai al file index.html.

Individua guestbook-container, quindi aggiungi il seguente codice HTML per creare un modulo con il campo di immissione del messaggio e il pulsante di invio.

<!-- ... -->

 <section id="guestbook-container">
   <h2>Discussion</h2>

   <form id="leave-message">
     <label>Leave a message: </label>
     <input type="text" id="message">
     <button type="submit">
       <i class="material-icons">send</i>
       <span>SEND</span>
     </button>
   </form>

 </section>

<!-- ... -->

Anteprima dell'app

screenshot di questo passaggio

Un utente che fa clic sul pulsante INVIA attiverà lo snippet di codice riportato di seguito. Aggiunge i contenuti del campo di immissione del messaggio alla raccolta guestbook del database. Nello specifico, il metodo addDoc aggiunge i contenuti del messaggio a un nuovo documento (con un ID generato automaticamente) nella raccolta guestbook.

In StackBlitz, vai al file index.js.

In alto, individua l'istruzione di importazione firebase/firestore, quindi aggiungi getFirestore, addDoc e collection in questo modo:

// ...

// Add the Firebase products and methods that you want to use
import {
  getAuth,
  EmailAuthProvider,
  signOut,
  onAuthStateChanged
} from 'firebase/auth';

import {
  getFirestore,
  addDoc,
  collection
} from 'firebase/firestore';

Ora salveremo un riferimento all'oggetto Firestore db subito dopo initializeApp:
```
initializeApp(firebaseConfig);
auth = getAuth();
db = getFirestore();
```

Nella parte inferiore della funzione main(), aggiungi il seguente codice.

Tieni presente che auth.currentUser.uid è un riferimento all'ID univoco generato automaticamente che Firebase Authentication assegna a tutti gli utenti che hanno eseguito l'accesso.

async function main() {
  // ...

  // Listen to the form submission
  form.addEventListener('submit', async e => {
    // Prevent the default form redirect
    e.preventDefault();
    // Write a new message to the database collection "guestbook"
    addDoc(collection(db, 'guestbook'), {
      text: input.value,
      timestamp: Date.now(),
      name: auth.currentUser.displayName,
      userId: auth.currentUser.uid
    });
    // clear message input field
    input.value = '';
    // Return false to avoid redirect
    return false;
  });
}
main();

Mostrare il libro degli ospiti solo agli utenti che hanno eseguito l'accesso

Non vuoi che chiunque possa vedere la chat degli ospiti. Un'azione che puoi intraprendere per proteggere la chat è consentire solo agli utenti che hanno eseguito l'accesso di visualizzare il libro degli ospiti. Detto questo, per le tue app ti consigliamo di proteggere anche il database con le regole di sicurezza di Firebase. Ulteriori informazioni sulle regole di sicurezza saranno disponibili più avanti nel codelab.

In StackBlitz, vai al file index.js.

Modifica il listener onAuthStateChanged per nascondere e mostrare il guestbook.

// ...

// Listen to the current Auth state
onAuthStateChanged(auth, user => {
  if (user) {
    startRsvpButton.textContent = 'LOGOUT';
    // Show guestbook to logged-in users
    guestbookContainer.style.display = 'block';
  } else {
    startRsvpButton.textContent = 'RSVP';
    // Hide guestbook for non-logged-in users
    guestbookContainer.style.display = 'none';
  }
});

Testare l'invio di messaggi

Assicurati di aver eseguito l'accesso all'app.
Inserisci un messaggio, ad esempio "Un saluto da Google", quindi fai clic su INVIA.

Questa azione scrive il messaggio nel tuo database Cloud Firestore. Tuttavia, non vedrai ancora il messaggio nell'app web effettiva perché devi ancora implementare il recupero dei dati. Dovrai farlo nel passaggio successivo.

Tuttavia, puoi vedere il messaggio appena aggiunto nella Console Firebase.

Nella dashboard Database Firestore della console Firebase, dovresti vedere la raccolta guestbook con il messaggio appena aggiunto. Se continui a inviare messaggi, la raccolta del libro degli ospiti conterrà molti documenti, ad esempio:

Console Firebase

screenshot di questo passaggio

8. Leggere i messaggi

Sincronizzare i messaggi

È fantastico che gli ospiti possano scrivere messaggi nel database, ma non li vedono ancora nell'app.

Per visualizzare i messaggi, dovrai aggiungere listener che si attivano quando i dati cambiano, quindi creare un elemento UI che mostri i nuovi messaggi.

Aggiungerai il codice che rileva i messaggi appena aggiunti dall'app. Innanzitutto, aggiungi una sezione nel codice HTML per visualizzare i messaggi:

In StackBlitz, vai al file index.html.

In guestbook-container, aggiungi una nuova sezione con l'ID guestbook.

<!-- ... -->

  <section id="guestbook-container">
   <h2>Discussion</h2>

   <form><!-- ... --></form>

   <section id="guestbook"></section>

 </section>

<!-- ... -->

Poi, registra l'ascoltatore che rileva le modifiche apportate ai dati:

In StackBlitz, vai al file index.js.

In alto, individua l'istruzione di importazione firebase/firestore, quindi aggiungi query, orderBy e onSnapshot in questo modo:

// ...
import {
  getFirestore,
  addDoc,
  collection,
  query,
  orderBy,
  onSnapshot
} from 'firebase/firestore';

Nella parte inferiore della funzione main(), aggiungi il seguente codice per eseguire un ciclo per tutti i documenti (messaggi del libro degli ospiti) nel database. Per scoprire di più su cosa succede in questo codice, leggi le informazioni sotto lo snippet.

async function main() {
  // ...

  // Create query for messages
  const q = query(collection(db, 'guestbook'), orderBy('timestamp', 'desc'));
  onSnapshot(q, snaps => {
    // Reset page
    guestbook.innerHTML = '';
    // Loop through documents in database
    snaps.forEach(doc => {
      // Create an HTML entry for each document and add it to the chat
      const entry = document.createElement('p');
      entry.textContent = doc.data().name + ': ' + doc.data().text;
      guestbook.appendChild(entry);
    });
  });
}
main();

Per ascoltare i messaggi nel database, hai creato una query su una raccolta specifica utilizzando la funzione collection. Il codice riportato sopra ascolta le modifiche nella raccolta guestbook, in cui sono archiviati i messaggi di chat. I messaggi sono inoltre ordinati per data, utilizzando orderBy('timestamp', 'desc') per visualizzare i messaggi più recenti in alto.

La funzione onSnapshot accetta due parametri: la query da utilizzare e una funzione di callback. La funzione di callback viene attivata quando vengono apportate modifiche ai documenti che corrispondono alla query. Ad esempio, se un messaggio viene eliminato, modificato o aggiunto. Per saperne di più, consulta la documentazione di Cloud Firestore.

Eseguire il test di sincronizzazione dei messaggi

Cloud Firestore sincronizza in modo automatico e istantaneo i dati con i client abbonati al database.

I messaggi che hai creato in precedenza nel database dovrebbero essere visualizzati nell'app. Non esitare a scrivere nuovi messaggi, che dovrebbero essere visualizzati immediatamente.
Se apri l'area di lavoro in più finestre o schede, i messaggi verranno sincronizzati in tempo reale tra le schede.
(Facoltativo) Puoi provare a eliminare, modificare o aggiungere manualmente i nuovi messaggi direttamente nella sezione Database della console Firebase; eventuali modifiche dovrebbero essere visibili nell'interfaccia utente.

Complimenti! Stai leggendo i documenti di Cloud Firestore nella tua app.

Anteprima dell'app

screenshot di questo passaggio

9. Configura le regole di sicurezza di base

Inizialmente configuri Cloud Firestore per l'utilizzo della modalità di test, vale a dire che il database è aperto per operazioni di lettura e scrittura. Tuttavia, devi utilizzare la modalità di test solo nelle primissime fasi di sviluppo. Come best practice, devi configurare regole di sicurezza per il database mentre sviluppi l'app. La sicurezza deve essere parte integrante della struttura e del comportamento della tua app.

Le regole di sicurezza consentono di controllare l'accesso ai documenti e alle raccolte nel database. La sintassi flessibile delle regole ti consente di creare regole che corrispondono a qualsiasi cosa, da tutte le scritture all'intero database alle operazioni su un documento specifico.

Puoi scrivere regole di sicurezza per Cloud Firestore nella console Firebase:

Nella sezione Compilazione della console Firebase, fai clic su Database Firestore e poi seleziona la scheda Regole (o fai clic qui per andare direttamente alla scheda Regole).
Dovresti vedere le seguenti regole di sicurezza predefinite, con un limite di tempo per l'accesso pubblico tra un paio di settimane da oggi.

screenshot di questo passaggio

Identificare le collezioni

Innanzitutto, identifica le raccolte in cui l'app scrive i dati.

Elimina la clausola match /{document=**} esistente, in modo che le regole abbiano il seguente aspetto:
```
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
  }
}
```

In match /databases/{database}/documents, identifica la raccolta che vuoi proteggere:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /guestbook/{entry} {
     // You'll add rules here in the next step.
  }
}

Aggiungere regole di sicurezza

Poiché hai utilizzato l'UID di autenticazione come campo in ogni documento del guestbook, puoi ottenere l'UID di autenticazione e verificare che chiunque cerchi di scrivere sul documento abbia un UID di autenticazione corrispondente.

Aggiungi le regole di lettura e scrittura al set di regole come mostrato di seguito:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /guestbook/{entry} {
      allow read: if request.auth.uid != null;
      allow create:
        if request.auth.uid == request.resource.data.userId;
    }
  }
}

Fai clic su Pubblica per implementare le nuove regole.Ora, per il guestbook, solo gli utenti che hanno eseguito l'accesso possono leggere i messaggi (qualsiasi messaggio), ma puoi crearne uno solo utilizzando il tuo ID utente. Inoltre, non sono ammesse modifiche o eliminazioni dei messaggi.

Aggiungere regole di convalida

Aggiungi la convalida dei dati per assicurarti che nel documento siano presenti tutti i campi previsti:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /guestbook/{entry} {
      allow read: if request.auth.uid != null;
      allow create:
      if request.auth.uid == request.resource.data.userId
          && "name" in request.resource.data
          && "text" in request.resource.data
          && "timestamp" in request.resource.data;
    }
  }
}

Fai clic su Pubblica per implementare le nuove regole.

Reimpostare gli ascoltatori

Poiché ora la tua app consente solo agli utenti autenticati di accedere, devi spostare la query del guestbook firestore all'interno dell'Authentication Listener. In caso contrario, si verificheranno errori di autorizzazione e l'app verrà disconnessa quando l'utente si disconnette.

In StackBlitz, vai al file index.js.

Estrai l'ascoltatore onSnapshot della raccolta del libro dei visitatori in una nuova funzione denominata subscribeGuestbook. Inoltre, assegna i risultati della funzione onSnapshot alla variabile guestbookListener.

Il listener onSnapshot Firestore restituisce una funzione di annullamento dell'iscrizione che potrai utilizzare per annullare il listener di snapshot in un secondo momento.

// ...
// Listen to guestbook updates
function subscribeGuestbook() {
  const q = query(collection(db, 'guestbook'), orderBy('timestamp', 'desc'));
  guestbookListener = onSnapshot(q, snaps => {
    // Reset page
    guestbook.innerHTML = '';
    // Loop through documents in database
    snaps.forEach(doc => {
      // Create an HTML entry for each document and add it to the chat
      const entry = document.createElement('p');
      entry.textContent = doc.data().name + ': ' + doc.data().text;
      guestbook.appendChild(entry);
    });
  });
}

Aggiungi una nuova funzione sotto denominata unsubscribeGuestbook. Controlla se la variabile guestbookListener non è null, quindi chiama la funzione per annullare l'ascoltatore.

// ...
// Unsubscribe from guestbook updates
function unsubscribeGuestbook() {
  if (guestbookListener != null) {
    guestbookListener();
    guestbookListener = null;
  }
}

Infine, aggiungi le nuove funzioni al callback onAuthStateChanged.

Aggiungi subscribeGuestbook() in fondo a if (user).

Aggiungi unsubscribeGuestbook() nella parte inferiore dell'istruzione else.

// ...
// Listen to the current Auth state
onAuthStateChanged(auth, user => {
  if (user) {
    startRsvpButton.textContent = 'LOGOUT';
    // Show guestbook to logged-in users
    guestbookContainer.style.display = 'block';
    // Subscribe to the guestbook collection
    subscribeGuestbook();
  } else {
    startRsvpButton.textContent = 'RSVP';
    // Hide guestbook for non-logged-in users
    guestbookContainer.style.display = 'none';
    // Unsubscribe from the guestbook collection
    unsubscribeGuestbook();
  }
});

10. Passaggio bonus: metti in pratica ciò che hai imparato

Registrare lo stato di risposta a invito di un partecipante

In questo momento, la tua app consente solo alle persone di iniziare a chattare se sono interessate all'evento. Inoltre, l'unico modo per sapere se qualcuno sta arrivando è se lo pubblica nella chat. Cerchiamo di organizzarci e facciamo sapere quante persone parteciperanno.

Aggiungerai un pulsante di attivazione/disattivazione per registrare le persone che vogliono partecipare all'evento, quindi registrerai il numero di partecipanti.

In StackBlitz, vai al file index.html.

In guestbook-container, aggiungi un insieme di pulsanti SÌ e NO, in questo modo:

<!-- ... -->
  <section id="guestbook-container">
   <h2>Are you attending?</h2>
     <button id="rsvp-yes">YES</button>
     <button id="rsvp-no">NO</button>

   <h2>Discussion</h2>

   <!-- ... -->

 </section>
<!-- ... -->

Anteprima dell'app

screenshot di questo passaggio

Quindi, registra il listener per i clic sui pulsanti. Se l'utente fa clic su SÌ, utilizza il suo UID di autenticazione per salvare la risposta nel database.

In StackBlitz, vai al file index.js.

In alto, individua l'istruzione di importazione firebase/firestore, quindi aggiungi doc, setDoc e where in questo modo:

// ...
// Add the Firebase products and methods that you want to use
import {
  getFirestore,
  addDoc,
  collection,
  query,
  orderBy,
  onSnapshot,
  doc,
  setDoc,
  where
} from 'firebase/firestore';

Nella parte inferiore della funzione main(), aggiungi il seguente codice per ascoltare lo stato della risposta:

async function main() {
  // ...

  // Listen to RSVP responses
  rsvpYes.onclick = async () => {
  };
  rsvpNo.onclick = async () => {
  };
}
main();

Quindi, crea una nuova raccolta chiamata attendees, quindi registra un riferimento a un documento se fai clic su uno dei pulsanti RSVP. Imposta il riferimento su true o false a seconda del pulsante su cui viene fatto clic.

Innanzitutto, per rsvpYes:

// ...
// Listen to RSVP responses
rsvpYes.onclick = async () => {
  // Get a reference to the user's document in the attendees collection
  const userRef = doc(db, 'attendees', auth.currentUser.uid);

  // If they RSVP'd yes, save a document with attendi()ng: true
  try {
    await setDoc(userRef, {
      attending: true
    });
  } catch (e) {
    console.error(e);
  }
};

Poi, fai lo stesso per rsvpNo, ma con il valore false:

rsvpNo.onclick = async () => {
  // Get a reference to the user's document in the attendees collection
  const userRef = doc(db, 'attendees', auth.currentUser.uid);

  // If they RSVP'd yes, save a document with attending: true
  try {
    await setDoc(userRef, {
      attending: false
    });
  } catch (e) {
    console.error(e);
  }
};

Aggiornare le regole di sicurezza

Poiché hai già configurato alcune regole, i nuovi dati che aggiungi con i pulsanti verranno rifiutati.

Consentire l'aggiunta di elementi alla raccolta `attendees`

Dovrai aggiornare le regole per consentire l'aggiunta alla raccolta attendees.

Per la raccolta attendees, poiché hai utilizzato l'UID di autenticazione come nome del documento, puoi recuperarlo e verificare che il attendees dell'utente che ha inviato il documento corrisponda a quello del documento che sta scrivendo. Consentirai a tutti di leggere l'elenco dei partecipanti (poiché non sono presenti dati privati), ma solo il creator dovrebbe essere in grado di aggiornarlo.
```
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // ... //
    match /attendees/{userId} {
      allow read: if true;
      allow write: if request.auth.uid == userId;
    }
  }
}
```
Fai clic su Pubblica per eseguire il deployment delle nuove regole.

Aggiungere regole di convalida

Aggiungi alcune regole di convalida dei dati per assicurarti che nel documento siano presenti tutti i campi previsti:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // ... //
    match /attendees/{userId} {
      allow read: if true;
      allow write: if request.auth.uid == userId
          && "attending" in request.resource.data;

    }
  }
}

Non dimenticare di fare clic su Pubblica per implementare le regole.

(Facoltativo) Ora puoi visualizzare i risultati dei clic sui pulsanti. Vai alla dashboard di Cloud Firestore nella Console Firebase.

Leggi lo stato della risposta a invito

Ora che hai registrato le risposte, vediamo chi parteciperà e rifletteremo questa informazione nell'interfaccia utente.

In StackBlitz, vai al file index.html.

In description-container, aggiungi un nuovo elemento con l'ID number-attending.

<!-- ... -->

 <section id="description-container">
     <!-- ... -->
     <p id="number-attending"></p>
 </section>

<!-- ... -->

Quindi, registra il listener per la raccolta attendees e conta il numero di risposte YES:

In StackBlitz, vai al file index.js.

Nella parte inferiore della funzione main(), aggiungi il seguente codice per ascoltare lo stato della risposta e conteggiare i clic su SÌ.

async function main() {
  // ...

  // Listen for attendee list
  const attendingQuery = query(
    collection(db, 'attendees'),
    where('attending', '==', true)
  );
  const unsubscribe = onSnapshot(attendingQuery, snap => {
    const newAttendeeCount = snap.docs.length;
    numberAttending.innerHTML = newAttendeeCount + ' people going';
  });
}
main();

Infine, evidenzia il pulsante corrispondente allo stato attuale.

Crea una funzione che controlli se l'UID di autenticazione corrente ha una voce nella raccolta attendees, quindi imposta la classe del pulsante su clicked.

// ...
// Listen for attendee list
function subscribeCurrentRSVP(user) {
  const ref = doc(db, 'attendees', user.uid);
  rsvpListener = onSnapshot(ref, doc => {
    if (doc && doc.data()) {
      const attendingResponse = doc.data().attending;

      // Update css classes for buttons
      if (attendingResponse) {
        rsvpYes.className = 'clicked';
        rsvpNo.className = '';
      } else {
        rsvpYes.className = '';
        rsvpNo.className = 'clicked';
      }
    }
  });
}

Inoltre, creiamo una funzione per annullare l'iscrizione. Verrà utilizzato quando l'utente si disconnette.

// ...
function unsubscribeCurrentRSVP() {
  if (rsvpListener != null) {
    rsvpListener();
    rsvpListener = null;
  }
  rsvpYes.className = '';
  rsvpNo.className = '';
}

Chiama le funzioni dall'ascoltatore Authentication.

// ...
// Listen to the current Auth state
  // Listen to the current Auth state
  onAuthStateChanged(auth, user => {
    if (user) {
      startRsvpButton.textContent = 'LOGOUT';
      // Show guestbook to logged-in users
      guestbookContainer.style.display = 'block';

      // Subscribe to the guestbook collection
      subscribeGuestbook();
      // Subscribe to the user's RSVP
      subscribeCurrentRSVP(user);
    } else {
      startRsvpButton.textContent = 'RSVP';
      // Hide guestbook for non-logged-in users
      guestbookContainer.style.display = 'none'
      ;
      // Unsubscribe from the guestbook collection
      unsubscribeGuestbook();
      // Unsubscribe from the guestbook collection
      unsubscribeCurrentRSVP();
    }
  });

Prova ad accedere con più utenti e guarda l'aumento del conteggio ogni volta che fai clic sul pulsante SÌ in più.

Anteprima dell'app

screenshot di questo passaggio

11. Complimenti!

Hai utilizzato Firebase per creare un'applicazione web interattiva in tempo reale.

Argomenti trattati

Firebase Authentication
UI Firebase
Cloud Firestore
Regole di sicurezza Firebase

Passaggi successivi

Vuoi saperne di più sul flusso di lavoro degli sviluppatori di Firebase? Consulta il codelab sull'emulatore Firebase per scoprire come testare ed eseguire la tua app completamente localmente.
Vuoi saperne di più su altri prodotti Firebase? Forse vuoi archiviare i file immagine caricati dagli utenti? Oppure inviare notifiche ai tuoi utenti? Consulta il codelab web di Firebase per consultare un codelab che approfondisce molti altri prodotti Firebase per il web.
Vuoi saperne di più su Cloud Firestore? Vuoi saperne di più sulle sottoraccolte e sulle transazioni? Consulta il codelab web di Cloud Firestore per un codelab che approfondisce Cloud Firestore. In alternativa, dai un'occhiata a questa serie di YouTube per scoprire Cloud Firestore.

Scopri di più

Sito Firebase: firebase.google.com
Canale YouTube di Firebase

Com'è andata?

Saremmo felici di ricevere il tuo feedback. Compila un modulo (molto) breve qui.

Scopri Firebase per il web

1. Panoramica

Cosa imparerai a fare

Che cosa ti serve

2. Ottieni il codice di partenza

3. Modifica informazioni evento

Anteprima dell'app

4. Crea e configura un progetto Firebase

Creare un progetto Firebase

Abilitare e configurare i prodotti Firebase nella console

Abilitare l'accesso con email per Firebase Authentication

Configura Cloud Firestore

5. Aggiungere e configurare Firebase

Aggiungere le librerie Firebase

Aggiungi un'app web Firebase al tuo progetto Firebase

6. Aggiungere l'accesso utente (RSVP)

Autenticare gli utenti con l'accesso via email e FirebaseUI

Aggiungi il codice per inizializzare FirebaseUI Auth

Aggiungi un pulsante di risposta all'HTML

Testare l'accesso all'app

Aggiungi lo stato dell'autenticazione alla UI

Anteprima dell'app

7. Scrivi messaggi in Cloud Firestore

Modello dei dati

Aggiungere messaggi a Firestore

Anteprima dell'app

Mostrare il libro degli ospiti solo agli utenti che hanno eseguito l'accesso

Testare l'invio di messaggi

Console Firebase

8. Leggere i messaggi

Sincronizzare i messaggi

Eseguire il test di sincronizzazione dei messaggi

Anteprima dell'app

9. Configura le regole di sicurezza di base

Identificare le collezioni

Aggiungere regole di sicurezza

Aggiungere regole di convalida

Reimpostare gli ascoltatori

10. Passaggio bonus: metti in pratica ciò che hai imparato

Registrare lo stato di risposta a invito di un partecipante

Anteprima dell'app

Aggiornare le regole di sicurezza

Consentire l'aggiunta di elementi alla raccolta attendees

Aggiungere regole di convalida

Leggi lo stato della risposta a invito

Anteprima dell'app

11. Complimenti!

Argomenti trattati

Passaggi successivi

Scopri di più

Com'è andata?

Consentire l'aggiunta di elementi alla raccolta `attendees`