Plugin WordPress

Apri come Markdown

Il plugin Vimine per WordPress porta sul sito dell’associazione le tre funzioni base, lato server (nessun token nel browser, nessuna dipendenza JavaScript):

Accedi con Vimine — il socio entra con il proprio account (OAuth 2.1 con PKCE; il plugin è un client riservato e scambia il codice con il secret sul server);
Tessera — la tessera del socio connesso, immagine con QR (GET /v1/me/membership/card.svg);
Iscrizione — il modulo di tesseramento dell’associazione (Embed).

Installazione

In WordPress apri Plugin → Aggiungi nuovo plugin, cerca «Vimine», installa e attiva: il plugin è nella directory di WordPress.org.
Nella console Sviluppatori registra un client riservato. Come URI di reindirizzamento usa quello mostrato in Impostazioni → Vimine del sito (di norma https://tuosito/vimine-callback/); scegli i permessi (almeno profile:read membership:read).
In Impostazioni → Vimine inserisci client ID e secret (il secret non è più mostrato dopo il salvataggio).
Per il modulo di iscrizione: in Associazione › Tesseramento aggiungi l’indirizzo del sito (https://tuosito) ai Domini autorizzati all’incorporamento (iframe). Vimine mostra il modulo solo nei siti elencati lì: altrove il riquadro resta vuoto.

Uso

Shortcode	Blocco	Cosa fa
`[vimine_signin label="" return_to="" scope=""]`	Vimine — Accedi	pulsante «Accedi con Vimine»; «Esci» quando il socio è connesso (revoca + uscita anche da Vimine)
`[vimine_card]`	Vimine — Tessera	la tessera del visitatore connesso; invita ad accedere se non lo è
`[vimine_enroll slug="…" height="900" lang="" scheme="" accent="" background="" font=""]`	Vimine — Iscrizione	il modulo di iscrizione dell’associazione, nella lingua del sito (se Vimine la parla, altrimenti in italiano; `lang` per sceglierne una); a chi ha già un account Vimine offre Continua su Vimine, che apre la pagina in una nuova scheda dove si aderisce in un passo (perché una nuova scheda)
`[vimine_events slug="…" filter="upcoming" limit="10"]`	Vimine — Eventi	gli eventi dell’associazione con i posti disponibili (quelli pubblici per i visitatori, tutti per un socio connesso); ogni evento rimanda alla sua pagina su Vimine, dove avviene l’iscrizione (guida)

I blocchi sono nell’editor sotto «Widget», con le stesse opzioni.

Come funziona la sessione

Al ritorno dalla pagina di accesso il plugin scambia il codice (con verifier PKCE e secret), salva i token in un transient di WordPress e mette nel browser solo un identificativo di sessione (cookie HttpOnly, SameSite=Lax). L’access token viene rinnovato da solo con il refresh token; «Esci» revoca il refresh token e passa da /oauth/logout di Vimine, così la sessione termina anche lì. Un socio senza tessera nell’associazione vede il messaggio corrispondente; un’associazione senza API attiva riceve api_disabled.

Personalizzazione

Il modulo di iscrizione prende da solo i colori del tema, quando il tema li dichiara (i temi a blocchi lo fanno): lo sfondo, il colore dei pulsanti e il carattere, se è uno di quelli che il modulo serve; altrimenti è chiaro. In Impostazioni → Vimine si scelgono per tutto il sito lo schema colori, il colore d’accento, lo sfondo e il carattere; gli attributi scheme, accent, background e font dello shortcode, o il pannello Aspetto del blocco, li cambiano per un modulo solo, con i valori dell’aspetto del modulo (e font="vimine" per il carattere del modulo stesso).

Il foglio di stile è minimo e usa le variabili --vimine-accent e --vimine-accent-contrast; ogni elemento ha una classe vimine-…. Per usi più avanzati (dati del socio nel tema, iscrizioni dal gestionale) usa direttamente l’API o l’SDK server con le stesse credenziali del plugin.