Skip to content

5. Personalizzazione

Marco Milesi edited this page May 31, 2022 · 12 revisions

Attributi SPID richiesti - sp_attributeconsumingservice

N.B. Effettuare questa operazione prima della richiesta di accreditamento tecnico in AGID. In caso di richiesta successiva, potrebbe essere necessario richiedere l'aggiornamento del metadata per l'effettiva variazione.

Di default il plugin richiede gli attributi ["name", "fiscalNumber", "email"]. Attenzione a seguire le pratiche GDPR adottando una minimizzazione dei dati richiesti by-design e by-default. Ogni trattamento di informazione andrà opportunamente catalogato e giustificato durante la procedura amministrativa AGID.

add_filter( 'spid_filter_sp_attributeconsumingservice', function( $v ) {
    return ["familyName","name","dateOfBirth", "fiscalNumber", "email"];
}, 10, 1 );

Opzioni: ["name", "fiscalNumber", "email", "spidCode", "familyName", "placeOfBirth", "countyOfBirth", "dateOfBirth", "gender", "mobilePhone", "address"]

Shortcode

Mostrare il pulsante di login (beta): [spid_login_button]

Parametri: [spid_login_button redirect_to="###"] - Replace ### with "CURRENT_URL" or another web link

URL di redirect

Il seguente filtro può personalizzare l'URL di redirect dopo un login/registrazione:

add_filter( 'spid_registration_default_login_redirect', function( $v ) {
    return 'https://CUSTOM_URL/';
}, 10, 1 );

Cambiare il testo di login

Il testo della form di login che separa i campi username/password di WordPress dal pulsante "Entra con SPID" può essere personalizzato. Analogamente anche il separatore tra i loghi degli IDP SPID e il link di login con username/password.

Login (prima del form) - Default "Oppure"

add_filter( 'spid_filter_login_or_pre', function( $v ) {
    return 'Sei un docente?';
}, 10, 1 );

Login (dopo aver cliccato sul pulsante SPID) - Default "Oppure"

add_filter( 'spid_filter_login_or_after', function( $v ) {
    return 'Sei un amministratore?';
}, 10, 1 );

Cambiare URL di accesso

Il plugin supporta l'indirizzo di login e di logout di default: /wp-login.php

I seguenti filtri possono modificare questo indirizzo, ad esempio per form di accesso custom o a seguito di utilizzo di plugin in grado di mascherare o variare l'URL di accesso. La maggior parte di questi plugin viene rilevata in automatico e non sono necessarie modifiche ulteriori.

Nel caso non vengano rilevate le variazioni o per comportamenti custom può essere impostato un nuovo URL generico tramite spid_filter_login_url_dir_default oppure uno specifico utilizzando spid_filter_login_url_dir_in per il login o spid_filter_login_url_dir_out per il logout.

add_filter( 'spid_filter_login_url_dir_in', function( $default_url ) {
    return 'NUOVO_LOGIN_URL';
}, 10, 1 );
add_filter( 'spid_filter_login_url_dir_out', function( $default_url ) {
    return 'NUOVO_LOGOUT_URL';
}, 10, 1 );
add_filter( 'spid_filter_login_url_dir_default', function( $default_url ) {
    return 'NUOVO_URL';
}, 10, 1 );