fix 1.2.7

resources/views/help/pdf.blade.php

@@ -62,6 +62,7 @@
     <ol>
         <li><a href="#webdav">WebDAV / Nextcloud</a></li>
         <li><a href="#googledrive">Google Drive</a></li>
+        <li><a href="#calendario">Google Calendar</a></li>
         <li><a href="#tipologie">Tipologie e Gestione Dati</a></li>
         <li><a href="#email">Email / SMTP</a></li>
         <li><a href="#installazione">Guida all'Installazione</a></li>
@@ -182,8 +183,72 @@
 
 <div class="page-break"></div>
 
-{{-- 3. Tipologie e Dati --}}
-<h2 id="tipologie">3. Tipologie e Gestione Dati</h2>
+{{-- 3. Google Calendar --}}
+<h2 id="calendario">3. Google Calendar</h2>
+
+<h3>Cos'è</h3>
+<p>Integrazione con Google Calendar per sincronizzare gli eventi tra l'app e il tuo calendario Google. Supporta import, export e sincronizzazione bidirezionale.</p>
+
+<h3>Requisiti</h3>
+<ol>
+    <li>Un account Google / Google Workspace</li>
+    <li>Un progetto sulla <strong>Google Cloud Console</strong> con l'API Google Calendar abilitata</li>
+    <li>Credenziali OAuth 2.0 (Client ID e Client Secret)</li>
+</ol>
+
+<h3>Passo 1: Creare il progetto Google Cloud</h3>
+<ol>
+    <li>Vai su <strong>Google Cloud Console</strong> (console.developers.google.com)</li>
+    <li>Crea un nuovo progetto o selezionane uno esistente</li>
+    <li>Vai a <strong>API e servizi → Libreria</strong></li>
+    <li>Cerca "<strong>Google Calendar API</strong>" e <strong>abilitala</strong></li>
+    <li>Vai a <strong>API e servizi → Credenziali</strong></li>
+    <li>Clicca "<strong>Crea credenziali → ID client OAuth</strong>"</li>
+    <li>Tipo applicazione: "<strong>Applicazione Web</strong>"</li>
+    <li><strong>URI di reindirizzamento autorizzato:</strong> aggiungi <code>https://developers.google.com/oauthplayground</code></li>
+    <li>Completa la creazione e <strong>copia Client ID e Client Secret</strong></li>
+</ol>
+
+<h3>Passo 2: Ottenere il Refresh Token</h3>
+<p>A differenza di Google Drive, per Google Calendar il refresh token va ottenuto manualmente tramite il Google OAuth Playground:</p>
+<ol>
+    <li>Vai su <strong>Google OAuth Playground</strong> (developers.google.com/oauthplayground)</li>
+    <li>Clicca l'ingranaggio ⚙️ in alto a destra</li>
+    <li>Spunta "<strong>Use your own OAuth credentials</strong>"</li>
+    <li>Incolla <strong>Client ID</strong> e <strong>Client Secret</strong> creati al Passo 1</li>
+    <li>Nella colonna sinistra, espandi "<strong>Google Calendar API v3</strong>" e seleziona lo scope <code>https://www.googleapis.com/auth/calendar</code></li>
+    <li>Clicca "<strong>Authorize APIs</strong>" e autorizza con l'account Google</li>
+    <li>Clicca "<strong>Exchange authorization code for tokens</strong>"</li>
+    <li><strong>Copia il Refresh Token</strong> generato</li>
+</ol>
+
+<h3>Passo 3: Configurazione nell'app</h3>
+<ol>
+    <li>Vai in <strong>Impostazioni → Calendario</strong></li>
+    <li>Clicca "<strong>Nuova Connessione</strong>"</li>
+    <li>Inserisci un nome descrittivo (es. "Calendario Lavoro")</li>
+    <li>Seleziona tipo <strong>Google Calendar</strong></li>
+    <li>Incolla <strong>Client ID</strong>, <strong>Client Secret</strong> e il <strong>Refresh Token</strong> ottenuto</li>
+    <li><strong>Calendar ID (opzionale):</strong> lascia <code>primary</code> per il calendario principale, oppure inserisci l'ID di un calendario specifico</li>
+    <li>Seleziona la <strong>direzione di sincronizzazione</strong> (import, export o bidirezionale)</li>
+    <li>Clicca "<strong>Salva</strong>"</li>
+</ol>
+
+<h3>Test connessione</h3>
+<p>Dopo aver salvato, usa il pulsante <strong>Test</strong> nella tabella delle connessioni per verificare che l'autorizzazione funzioni correttamente.</p>
+
+<h3>Sincronizzazione</h3>
+<p>Dopo aver configurato la connessione, puoi sincronizzare gli eventi manualmente cliccando <strong>Sync</strong>. La sincronizzazione automatica viene eseguita in base all'intervallo impostato (richiede il cron di Laravel configurato).</p>
+
+<div class="callout callout-info">
+    <h4>Refresh Token permanente</h4>
+    <p>Il Refresh Token è permanente finché non viene revocato dall'utente. Se la connessione smette di funzionare, potrebbe essere necessario rigenerarlo ripetendo il Passo 2.</p>
+</div>
+
+<div class="page-break"></div>
+
+{{-- 4. Tipologie e Dati --}}
+<h2 id="tipologie">4. Tipologie e Gestione Dati</h2>
 
 <h3>Tipologie Documenti</h3>
 <p>Le tipologie classificano i documenti (avatar, galleria, documento, statuto, altro).</p>
@@ -210,8 +275,8 @@
 
 <div class="page-break"></div>
 
-{{-- 4. Email / SMTP --}}
-<h2 id="email">4. Email / SMTP</h2>
+{{-- 5. Email / SMTP --}}
+<h2 id="email">5. Email / SMTP</h2>
 
 <h3>Configurazione Email</h3>
 <p>Vai in <strong>Impostazioni → Email</strong> per configurare la posta elettronica.</p>
@@ -264,8 +329,8 @@
 
 <div class="page-break"></div>
 
-{{-- 5. Installazione --}}
-<h2 id="installazione">5. Guida all'Installazione</h2>
+{{-- 6. Installazione --}}
+<h2 id="installazione">6. Guida all'Installazione</h2>
 
 <h3>Panoramica</h3>
 <p>L'installazione avviene tramite l'interattivo <code>install.php</code> che guida passo-passo. Supporta due modalità:</p>
@@ -411,8 +476,8 @@ sudo systemctl reload apache2</pre>
 
 <div class="page-break"></div>
 
-{{-- 6. Backup e Migrazione --}}
-<h2 id="backup">6. Backup e Migrazione Server</h2>
+{{-- 7. Backup e Migrazione --}}
+<h2 id="backup">7. Backup e Migrazione Server</h2>
 
 <h3>Cos'è</h3>
 <p>Il sistema di backup crea un archivio ZIP contenente tutto il necessario per ripristinare l'applicazione su un nuovo server. Include database, file caricati e configurazione.</p>
@@ -591,8 +656,8 @@ sudo certbot --apache -d glastree.esempio.it</pre>
 
 <div class="page-break"></div>
 
-{{-- 7. Docker --}}
-<h2 id="docker">7. Docker</h2>
+{{-- 8. Docker --}}
+<h2 id="docker">8. Docker</h2>
 
 <h3>Creare un'immagine Docker con dati di base</h3>
 <p>Puoi creare un'immagine Docker pronta all'uso che include l'applicazione e i dati di base (tipologie documenti, tipologie eventi, ruoli). Scegli la configurazione in base alle tue esigenze:</p>