Configurazione Plugin AssoFacile

 

Ultima versione del plugin scaricabile da: https://www.assofacile.it/plugin-wordpress/

### STEP 1 installa ed attiva il plugin

---

### STEP 2 — Configurare la Connessione AssoFacile

Percorso: `WordPress Admin → Impostazioni → AssoFacile`

Dalla barra laterale di WordPress, vai su **Impostazioni** e poi clicca su **AssoFacile** in fondo al menu.

Nella sezione **"Connessione AssoFacile"** trovi tre campi fondamentali:

- **ID Associazione**: Il numero identificativo della tua associazione fornito dallo STAFF di AssoFacile, incluso nel piano EXCLUSIVE. 

- **Slug Associazione**: La parte testuale dell'URL del tuo gestionale, per trovarla devi entrare dentro AssoFacile e segui questo percorso:

LA MIA ASSOCIAZIONE → Dati Generali  → Area Iscritti

Potrai trovare e personalizzare questo link, dovrà essere lo stesso sia dentro il gestionale AssoFacile che dentro il Plugin.

- **URL Area Riservata**: L'URL della pagina WordPress che contiene il blocco area riservata. Va compilato **obbligatoriamente** se si usa Elementor o altri page builder (altrimenti il rilevamento è automatico)

---

### STEP 3 — Personalizzare lo Stile del Plugin

Nella sezione **"Personalizzazione stile"** puoi adattare il plugin al tuo tema:

- **Nome visualizzato nel form di login**: Il titolo che appare in cima al form (es: "AssoFacile Gym")
- **Colore primario**: Colore per bottoni e link
- **Colore sfondo card**: Sfondo delle schede eventi
- **Colore testo**: Colore del testo
- **Colore bordi e input**: Bordi delle card e degli input
- **Raggio bordi**: Arrotondamento degli angoli (es: `20px`)
- **CSS personalizzato**: Codice CSS aggiuntivo caricato solo sulle pagine con blocchi AssoFacile

---

### STEP 4 — Configurare la WebApp Mobile (opzionale)

Nella sezione **"WebApp Mobile"** puoi abilitare un banner che invita gli utenti mobili ad installare la Progressive Web App:

- **URL WebApp**: Fornito da AssoFacile (es: `https://gestionale.assofacile.it/accessoApp/tuoslug`)
- **Banner di installazione**: Spunta per mostrarlo su dispositivi < 768px dopo il login
- **Titolo banner**: Il testo principale del banner

---

### STEP 5 — Salvare le Impostazioni

Clicca sul pulsante **"Salva impostazioni"** per confermare tutte le modifiche. Comparirà il messaggio verde **"Impostazioni salvate"**.

---

### STEP 6 — Inserire i Blocchi nelle Pagine

Nella stessa pagina di impostazioni, più in basso, trovi la guida agli shortcode:

**Per Avada / Fusion Builder**, inserisci un elemento "Testo HTML" o "Shortcode" e usa:

Funzionalità → Shortcode

Calendario eventi → [assofacile_calendario]
Calendario con eventi passati → [assofacile_calendario mostra_passati="1"]
Area riservata (login, profilo, quote...) → [assofacile_area_riservata]
Area riservata senza form registrazione → [assofacile_area_riservata mostra_registrazione="0"]
Area riservata aperta su tab profilo → [assofacile_area_riservata tab_default="profile"]

I valori validi per `tab_default` sono: `login`, `profile`, `quotes`, `documents`, `messaging`

Per Gutenberg, cerca il blocco **"AssoFacile"** nel selettore blocchi di WordPress e scegli tra:
- AssoFacile – Calendario: mostra il calendario eventi
- AssoFacile – Area Riservata: mostra login, profilo, quote, documenti, messaggistica

---

### STEP 7 — Collegamento Automatico tra Blocchi

Il plugin cerca **automaticamente** le pagine che contengono i due blocchi/shortcode e imposta i link "Accedi" e "Area Riservata →". Non è necessaria nessuna configurazione aggiuntiva, basta che le pagine siano pubblicate.

---

### STEP 8 — Usare il Calendario (Frontend)

Una volta inserito lo shortcode `[assofacile_calendario]` in una pagina:

1. Gli utenti vedono il **calendario mensile** con i punti che indicano giorni con eventi
2. Cliccando su un **giorno**, si espande la lista eventi in basso
3. Cliccando su **"Dettagli"** di un evento, si apre un **modal** con immagine, descrizione, email, telefono, link al sito, social e opzioni per aggiungere al calendario Google/Apple/Outlook

---

### STEP 9 — Area Riservata: Login e Registrazione (Frontend)

Con lo shortcode `[assofacile_area_riservata]`:

- Gli utenti non loggati vedono il **form di accesso** con email, password, bottone "Accedi" e link "Registrati"
- Cliccando **"Registrati"**, si apre il form di iscrizione multistep
- Poi si compila il form completo con i dati personali
- Cliccando su ACCEDI si esegue il login, il blocco mostra il **profilo dell'utente** con nome e tasto "Esci"
---

### STEP 10 — Debug e Test della Connessione API

In fondo alla pagina delle impostazioni trovi due strumenti di diagnostica:

**Debug — Struttura form registrazione**: Clicca "Ispeziona form registrazione" per verificare che l'API AssoFacile risponda correttamente e vedere i campi del form (regioni, comuni, tipo iscrizione, tipo candidato etc.).

**Debug — Test connessione API**: Usa i pulsanti "Test" accanto agli endpoint per verificare che il calendario e il form di registrazione siano raggiungibili con il tuo ID Associazione.

> Se il calendario funziona ma il form registrazione fallisce → il token è corretto ma mancano parametri per la registrazione. Se entrambi falliscono con "Token2 errato" → contatta AssoFacile per abilitare l'accesso API.

---

Riepilogo del Flusso Completo

1. Installa il plugin AssoFacile su WordPress
2. Vai in **Impostazioni → AssoFacile** e inserisci ID e Slug della tua associazione
3. Personalizza i colori e lo stile
4. Crea una pagina "Calendario" e incolla `[assofacile_calendario]`
5. Crea una pagina "Profilo" e incolla `[assofacile_area_riservata]`
6. Pubblica entrambe le pagine — il plugin collegherà automaticamente i link
7. Testa la connessione con gli strumenti di debug
8. I tuoi soci potranno vedere gli eventi, registrarsi e accedere alla loro area riservata!