¿Cómo usar mi propio valor de sesión personalizado en WordPress?

EDITADO: "EL PLUGIN A CONTINUACIÓN YA NO ESTÁ DISPONIBLE, POR FAVOR UTILICE ESTE PLUGIN EN SU LUGAR: WordPress Session Plugin"

Existe un buen plugin para WordPress adaptado de la clase Session de CodeIgniter: WP Sessions Plugin.

Cuando activas el plugin, puedes comenzar a usar el objeto $session desde cualquier parte de tu tema (el objeto $session está disponible como global). Por ejemplo, para usar el objeto $session en el archivo header.php, simplemente añade este código:

global $session;

Si eres desarrollador de plugins y deseas adaptar este plugin con el tuyo, también puedes encontrar la versión standalone en el paquete. La documentación del plugin proporciona más información para desarrolladores sobre cómo adaptarlo a tu proyecto.

Aquí hay algunas funciones útiles tanto para desarrolladores de temas como de plugins.

Puedes agregar datos de sesión de esta manera:

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

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

$session->set_userdata( $array );

Para recuperar datos de sesión:

$session->userdata( 'username' );

Para obtener todos los datos de sesión:

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

Para eliminar un elemento de la sesión:

$session->unset_userdata( 'username' );

Para eliminar varios elementos de la sesión:

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

También puedes usar Flashdata, que son datos de sesión que solo estarán disponibles para la siguiente solicitud al servidor y luego se borrarán automáticamente. Estos pueden ser muy útiles cuando los usas para mensajes informativos o de estado (por ejemplo, "El producto ha sido eliminado").

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

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

// Conservar Flashdata 
// (si necesitas conservar los datos flash a través de una solicitud adicional, 
// puedes usar esta función):
$session->keep_flashdata( 'item' );

Para destruir la sesión:

$session->sess_destroy();

El plugin también admite shortcodes. Puedes imprimir cualquier dato de sesión en tus publicaciones o páginas:

[session key="username"]

Para acceder a una segunda clave:

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

Espero que esto le sea útil a alguien.