Come utilizzare un valore di sessione personalizzato in WordPress?

MODIFICA: "IL PLUGIN QUI SOTTO NON È PIÙ DISPONIBILE, QUINDI UTILIZZATE QUESTO PLUGIN AL SUO POSTO: WordPress Session Plugin"

C'è un buon plugin per WordPress adattato dalla classe CodeIgniter Session: WP Sessions Plugin.

Quando attivi il plugin, puoi iniziare a utilizzare l'oggetto $session da qualsiasi parte del tuo tema (l'oggetto $session è disponibile come variabile globale). Ad esempio, per utilizzare l'oggetto $session nel file header.php, aggiungi semplicemente questo codice:

global $session;

Se sei uno sviluppatore di plugin e vuoi adattare questo plugin al tuo progetto, nel pacchetto troverai anche una versione standalone. La documentazione del plugin fornisce ulteriori informazioni per gli sviluppatori su come adattarlo al proprio progetto.

Ecco alcune funzioni utili per gli sviluppatori di temi e plugin.

Puoi aggiungere dati alla sessione in questo modo:

// Un singolo valore
$session->set_userdata( 'username', 'john' );

// Passando un array
$array = array(
    'username' => 'john',
    'email'    => 'john@gmail.com'
);

$session->set_userdata( $array );

Per recuperare i dati della sessione:

$session->userdata( 'username' );

Per ottenere tutti i dati della sessione:

$session->all_userdata(); // restituisce un array

Per rimuovere un elemento dalla sessione:

$session->unset_userdata( 'username' );

Per rimuovere più elementi dalla sessione:

$array = array(
    'username' => '',
    'email'    => ''
);
$session->unset_userdata( $array );

Puoi anche utilizzare i Flashdata, ovvero dati di sessione che saranno disponibili solo per la prossima richiesta al server, per poi essere automaticamente cancellati. Questi possono essere molto utili per messaggi informativi o di stato (es. "Prodotto eliminato").

// Aggiungere Flashdata
$session->set_flashdata( 'item', 'value' );

// Recuperare Flashdata
$session->flashdata( 'item' );

// Preservare flashdata 
// (se hai bisogno di preservare i flashdata attraverso una richiesta aggiuntiva, 
// puoi utilizzare questa funzione):
$session->keep_flashdata( 'item' );

Per distruggere la sessione:

$session->sess_destroy();

Il plugin supporta anche gli shortcode. Puoi stampare qualsiasi dato della sessione nei tuoi post o pagine:

[session key="username"]

Per accedere a una chiave secondaria:

[session key="user_data" sec_key="display_name"]

Spero che questo sia utile per qualcuno.