Creazione e gestione dell'area riservata

##Creare un'area riservata grazie ai plugin User Role Editor e User Access Manager ###(di Christian Ghellere) In questo mini tutorial verrà spiegato come creare una area riservata con l'ausilio dei plugin User Role Editor (autore Vladimir Garagulya), User Access Manager (autore Alexander Schneider) e Widget Logic (autore Alan Trewartha). Grazie ai primi due plugin si gestirà la riservatezza, mentre il terzo tornerà utile per la gestione della visualizzazione dei contenuti nell'area riservata.

N.B. Si informa che modificare i ruoli è una operazione delicata e un eventuale errore potrebbe creare dei problemi nel corretto funzionamento del sito. Si invita pertanto di fare molta attenzione e per i meno pratici di wordpress effettuare solo quanto descritto in questo tutorial.

Tutto il tutorial è scritto al fine di creare una area riservata per un sito scolastico che utilizza il template Pasw2015. Per avere un tutorial con delle spiegazioni passo a passo, si ipotizza la creazione di un'area riserva per un Istituto Comprensivo, costituito da una Scuola Primaria e una Scuola Secondaria. Indice 1. Installazione plugin

###1. Installazione plugin La prima operazione da eseguire è l'installazione dei plugin sopra citati: dall'area di amministrazione in bacheca selezionare il menù plugin voce aggiungi nuovo.

Nella videata che comparirà, in alto a destra, c'è il campo ricerca: inserire il nome del primo plugin e confermare (es. User Role Editor). Individuare il plugin nei risultati della ricerca e procedere con la sua installazione attraverso il pulsante installa adesso.

Terminata l'installazione procedere con l'attivazione del plugin.

L'operazione sopra descritta dovrà essere ripetuta per l'installazione degli altri due plugin: User Access Manager (autore Alexander Schneider) e Widget Logic (autore Alan Trewartha)

###2. Creazione dei ruoli In questa sezione del tutorial verrà spiegato come procedere con la creazione dei ruoli. I ruoli scelti per l'Istitutto di esempio sono:

• Docenti-Primaria
• Docenti-Secondaria
• Personale-ATA
• Area-Riservata

La creazione dei ruoli è una operazione relativamente semplice grazie al plugin User Role Editor.

Procediamo passo a passo:

Innanzitutto bisogna portarsi nell'area di gestione dei ruoli che il plugin ha creato nel pannello di controllo: Bacheca → Utenti [1] → User Role Editor [2]

![Immagine 03] (http://s26.postimg.org/603xqvtll/ar_03.png)

Prima di procedere con la creazione dei ruoli si consiglia di lavorare su quelle che Wordpress chiama Capabilities ovvero Capacità o Permessi, ossia l'autorizzazione che un utente appartenente ad un determinato gruppo o ruolo ha di compiere determinate azioni. Dobbiamo quindi aggiungere delle nuove capability, che torneranno utili in un secondo momento, per la visualizzazione dei widget in modo selettivo e dettagliato.

Per aggiungere una nuova capability, all'interno dell'area di gestione dei ruoli, premere sul pulsante Add Capability [3] (funzionalità)

![Immagine 04] (http://s26.postimg.org/6e9v4832x/ar_04.png)

Al fine di avere delle capability chiare e parlanti (leggendo il loro nome viene subito alla mente l'azione che permettono di svolgere o dove vengono utilizzate) si consiglia di utilizzare come id termini simili a quelli dell'esempio sotto riportato:

• read_area_ris_doc_primaria (area riservata docenti primaria)
• read_area_ris_doc_secondaria (area riservata docenti primaria)
• read_area_ris_ata (area riservata personale ata)

Inserire quindi il nome scelto per la nuova capability nel campo Capability name(ID)[4] e confermare premendo il pulsante Add Capabilty

![Immagine 05] (http://s26.postimg.org/6sb73tn6h/ar_05.png)

Inserire tutte le capability necessarie ripetendo le operazioni identificate dai punti 3-4-5, alla fine si dovrebbe avere una situazione simile a quella in immagine, con la presenza delle nuove voci create.

![Immagine 06] (http://s26.postimg.org/51s62c5nd/ar_06.png)

Ora è il momento di procedere alla creazione dei veri e propri ruoli. Il tutorial prevede la creazione dei seguenti ruoli:

• docenti primaria (ruolo con permesso di lettura + capability read_ris_doc_primaria)
• docenti secondaria (ruolo con permesso di lettura + capability read_ris_doc_secondaria)
• personale ata (ruolo con permesso di lettura + capability read_ris_ata)
• area riservata (ruolo con permesso di lettura)

Il ruolo area-riservata è un ruolo generico che verrà utilizzato per dare una riservatezza di base ai documenti presenti nell'area riservata. La creazione dei ruoli avviene sempre dal menù Utenti → User Role Editor, ma questa volta il pulsante da premere è Add Role [6]

![Immagine 07] (http://s26.postimg.org/9c6txxaqh/ar_07.png)

Si procede a questo punto con la compilazione dei campi richiesti per la creazione del nuovo ruolo.

• inserire l'ID (per comodità sempre in minuscolo e parlante, usare – o _ al posto dello spazio) [7]
• inserire il nome del ruolo [8]
• confermare con Add Role [9]

![Immagine 08] (http://s26.postimg.org/il9081jmh/ar_08.png)

Ora si procede assegnando i permessi al ruolo appena creato. Al ruolo Area-Riservata si assegna solo il permesso base di sola lettura [11], per confermare premere su update [12]

![Immagine 09] (http://s26.postimg.org/6knk7bc7t/ar_09.png)

Ripetere le operazioni di inserimento ruolo al fine di creare i ruoli Docente Primaria – Docente Secondaria – Personale ATA. Questa volta oltre al permesso di lettura è necessario assegnare la capability associata, creata in precedenza, scegliendola tra le Custom Capabilities. [13], [14], [15]. Confermare sempre premendo il pulsante Update [16].

![Immagine 10] (http://s26.postimg.org/nditjheah/ar_10.png)

###3. Creazione dei gruppi In questa sezione del tutorial si spiegherà come procedere con la creazione dei seguenti gruppi:

• Docenti-Primaria
• Docenti-Secondaria
• Personale-ATA
• Area-Riservata

Dopo aver creato i ruoli con i relativi permessi si procede con la creazione dei vari gruppi e con l'associazione Gruppo-Ruolo. Per la creazione dei gruppi si utilizzerà il plugin User Access Manager.

Sempre dal pannello di amministrazione si seleziona il menù UAM [17] → Manage user user groups [18]. Si ricorda che questi menù saranno presenti solo dopo che si è installato e attivato il plugin User Access Manager.

![Immagine 11] (http://s26.postimg.org/q90i437o9/ar_11.png)

Per la creazione del gruppo compilare i campi nel pannello di gestione che si aprirà:

• inserire il nome del gruppo [19] (per chiarezza tutto minuscolo, al posto dello spazio si può utilizzare – o _ )
• inserire una descrizione del gruppo [20]
• associare il gruppo ad uno dei ruoli in precedenza creati [21]

![Immagine 12] (http://s26.postimg.org/9zac16x09/ar_12.png)

Ripetere l'operazione per tutti i gruppi necessari. Alla fine della procedura si dovrà avere una situazione simile a quella sotto riportata.

![Immagine 13] (http://s26.postimg.org/ojrew0ryx/ar_13.png)

In questa prima fase è stato creato lo zoccolo dell'area riservata nel prossimo punto del tutorial si mostrerà come strutturare l'area riservata sfruttando le categorie degli articoli.

###4. Creazione delle Categorie per l'area riservata

Si procede a questo punto con la creazione della struttura delle categorie articoli che andranno a costituire l'area riservata. [23] e [24].

![Immagine 14] (http://s26.postimg.org/ik3nsd76h/ar_14.png)

Per l'area riservata del nostro istituto di esempio si può ipotizzare una struttura simile:

• Area Riservata (categoria madre)
  • notizie (categoria figlia utile ai docenti di entrambi i gradi e al personale ata)
  • dsa (categoria figlia utile ai docenti di entrambi i gradi)
  • stranieri (categoria figlia utile ai docenti di entrambi i gradi)
  • aggiornamento (categoria figlia utile ai docenti di entrambi i gradi)

La creazione della categoria madre e delle sue figlie non presenta nulla di particolare, è solo necessario fare attenzione alla parte Set up user groups: in questa zona è possibile assegnare una gruppo di default per la categoria (questo gruppo imposta la riservatezza che verrà assegnata in modo automatico a tutti gli articoli appartenenti alla categoria).

Si procede quindi in questo modo:

• si crea la categoria Area Riservata [25],
• si pone la spunta sul gruppo base che in questo tutorial è area_riservata[26],
• si conferma la creazione della categoria con add new category [27].

![Immagine 15] (http://s26.postimg.org/tkysxdzfd/ar_15.png)

Con le stesse impostazioni si procede alla creazione delle categorie figlie, anche in queste si seleziona il gruppo Area_Riservata. Al termine di tutto questa è la situazione, se fate attenzione tutte le categorie hanno come gruppo di accesso Area_Riservata

![Immagine 16] (http://s26.postimg.org/7aaxxf255/ar_16.png)

###5. Configurazione del plugin UAM

Nel menù Settings del plugin UAM è possibile impostare vari limiti nella visualizzazione dei contenuti, per semplificare il tutto, in questo esempio, è stata variata solo l'opzione Hide complete posts di default su no [28]: dopo aver attivato l'opzione (yes) gli articoli riservati saranno visibili solo agli utenti abilitati.

![Immagine 17] (http://s26.postimg.org/oc3rzih09/ar_17.png)

###6. Creazione dei contenuti riservati Fino ad ora è stato preparato l'ambiente per gestire le riservatezze, sono stati creati ruoli – gruppi e categorie ora è giunto il momento di creare i contenuti che andranno ad alimentare l'area riservata.

La procedura per l'inserimento di un articolo riservato non cambia rispetto a quella di un articolo normale, se non per il fatto che questo deve essere visibile ad un ristretto gruppo di persone.

Una prima riservatezza viene data dalla categoria: in precedenza sono state associate alcune categorie al gruppo Area-Riservata e questo fa si che i documenti assegnati a quelle determinate categorie siano visibili solo a quel gruppo. È importante che al gruppo Area Riservata non vengano assegnati utenti (gruppo vuoto), in questo modo i contenuti associati alle categorie riservate verranno visti solo dall'amministratore del sito fino a quando non verranno assegnati a specifici gruppi di utenti.

![Immagine 18] (http://s26.postimg.org/ip7f21ehl/ar_18.png)

Una seconda protezione viene data utilizzando il modulo Access, che compare nella schermata di creazione/modifica articolo a seguito dell'attivazione del plugin UAM. Questa funzionalità permette di estendere la visibilità del documento ad ulteriori gruppi di utenti. Ad esempio, se si vuole assegnare la visibilità del documento X posto in Aggiornamento Docenti (e quindi riservato e non visibile per default) ai soli docenti della scuola primaria risulta sufficiente mettere la spunta nel modulo Access alla casella corrispondente alla voce Docenti_Primaria come da immagine.

![Immagine 19] (http://s26.postimg.org/sb0zic5nd/ar_19.png)

Una volta pubblicato l'articolo anche la voce Area_Riservata verrà attivata in modo non modificabile, in quanto ereditata dalla categoria scelta [a]

![Immagine 20] (http://s26.postimg.org/60d4id8d5/ar_20.png)

L'ereditarietà del gruppo Area_Riservata dalla categoria garantisce una riservatezza del documento nel caso in cui un articolo venga pubblicato prima di aver inserito un valore in Access: i documenti con il solo Access = Area_Riservata sono visibili ai soli admin, in quanto il gruppo è e dovrà rimanere vuoto.

###7. Assegnazione del gruppo all'utente

Per assegnare un gruppo ad un utente già esistente è sufficiente inserire il ruolo nel profilo dell'utente. Quindi dal pannello di amministrazione Utenti → Tutti gli utenti selezionare l'utente desiderato e andare in Modifica → ruolo.

![Immagine 21] (http://s26.postimg.org/j5x827rmh/ar_21.png)

Nel caso di un nuovo utente, invece, l'operazione di assegnazione del ruolo può essere effettuata durante la fase di creazione.

![Immagine 22] (http://s26.postimg.org/4b8mo1i1l/ar_22.png)

###8. Creazione della pagina Area Riservata

A questo punto rimane solo una cosa da fare per poter visualizzare i contenuti: creare la pagina per l'area riservata. La creazione della pagina Area Riservata dinamica è veramente semplice con il tema pasw2015. Di seguito verrà spiegato come sfruttare il template Home e quindi la gestione di contenuti dinamici per mezzo di widget, grazie all'uso del plugin Widget Logic.

Si crea una pagina dal titolo Area Riservata e al modulo Attributi pagina si assegna il template di pagina ((Modello) Home page, fatto questo si procede con la pubblicazione. Con questa operazione la pagina Area-Riservata sarà gestita tramite i widget allo stesso modo della home del sito.

![Immagine 23] (http://s26.postimg.org/ld1gq4wwp/ar_23.png)

Se a questo punto si va alla pagina dell'area riservata i contenuti saranno identici a quelli della home del sito, in quanto fino ad ora ci si è limitati a preparare l'ambiente, senza gestire in alcun modo i widget presenti nelle sidebar home. Per gestire la visualizzazione dei widget in questo tutorial si utilizzerà il plugin widget logic. Una prima azione è quella impostare gli attuali widget per la sola visualizzazione in home. Questa operazione si effettua inserendo in ogni widget già presente la seguente stringa is_page('home') nel riquadro Widget logic, come da immagine, e premere su Salva.

![Immagine 24] (http://s26.postimg.org/5g2otf4ih/ar_24.png)

Una volta modificati i widget presenti, la pagina Area Riservata risulterà vuota. Ora sarà sufficiente inserire i nuovi widget categoria e questa volta la stringa da inserire nel campo Widget logic sarà is_page('area-riservata'). Si consiglia di controllare lo slug della propria pagina, che nel nostro esempio è appunto area-riservata).

![Immagine 25] (http://s26.postimg.org/hvzen5xuh/ar_25.png)

Grazie al plugin e alle due stringhe utilizzate in precedenza è stato possibile separare i widget per la home da quelli per l'area riservata. Ora si potrebbe procedere in modo maggiormente specifico e gestire in un'unica pagina le aree riservate di ciascun gruppo, andando ad inserire widget mirati per i vari gruppi e facendoli apparire solo se rispecchiano determinate condizioni. Vediamo qualche es:

• la stringa che segue fa vedere il widget solo se la pagina è area-riservata e l'utente rientra nei gruppi con capability read_area_ris_doc_primaria o read_area_ris_doc_secondaria (create e assegnate in precedenza ai gruppi docenti-primaria o docenti secondaria) (current_user_can('read_area_ris_doc_primaria')||current_user_can('read_area_ris_doc_secondaria'))&&is_page('area-riservata')

• la stringa che segue invece fa vedere il widget solo se la pagina è area-riservata e l'utente rientra nei gruppi con capability read_area_ris_ata personale ata

  current_user_can('read_area_ris_ata')&&is_page('area-riservata')

Grazie a questa configurazione è possibile fare un' area riservata dinamica dai contenuti variabili a seconda del login eseguito.

Si precisa che conoscendo l'url esatto di un allegato questo sarà comunque raggiungibile, anche se inserito all'interno di un documento protetto.

Si ringrazia Renata Durighello per l'aiuto dato nella formattazione del tutorial

![Immagine Licenza] (http://s26.postimg.org/bjk9dbus5/licenza.png)

Quest'opera è distribuita con Licenza Creative Commons Attribuzione - Non commerciale - Condividi allo stesso modo 4.0 Internazionale

##Videotutorial, Youtube

• Creazione e gestione dell'area riservata, a cura di Christian Ghellere