La clase Charitable_User te permite acceder a información sobre un usuario en particular.
Charitable_User es una subclase de WP_User.
Obtener una instancia de Charitable_User
Dado un ID de usuario, puedes recuperar una instancia de Charitable_User de una de estas dos maneras:
$user_id = 123;
// Get instance from cache
$user = charitable_get_user( $user_id );
// Direct instantiation
$user = new Charitable_User( $user_id );La ventaja de usar charitable_get_user es que utiliza la caché de objetos para retener la instancia de Charitable_User.
Propiedades
Charitable_User tiene acceso a las mismas propiedades que WP_User:
https://codex.wordpress.org/Class_Reference/WP_User
Métodos
get_donor_id()
Devuelve el ID del donante para este usuario. Si este usuario nunca ha donado, esto devolverá false.
get_donor()
Esto devuelve un único registro de la tabla wp_charitable_donor para el donante.
is_donor()
Esto devuelve si el usuario es un donante.
is_verified()
is_verified()Esto devuelve si el usuario ha verificado su dirección de correo electrónico.
mark_as_verified( $verified )
Esto establece si la cuenta del usuario está verificada.
Parámetros$verified
Booleano. Si la cuenta del usuario está verificada.
obtener_correo_electronico()
Devuelve la dirección de correo electrónico del usuario.
obtener_nombre()
Devuelve el nombre completo del usuario. Ten en cuenta que si el usuario no ha proporcionado un nombre, solo se devolverá el apellido; y viceversa.
get_first_name()
Devuelve el nombre del usuario.
get_last_name()
Devuelve el apellido del usuario.
obtener_ubicacion()
Devuelve la ubicación del usuario.
Si está disponible, esto mostrará la ciudad del usuario, seguida de su país; si no se establece una ciudad, mostrará el estado del usuario, seguido de su país. Si no se muestra ni ciudad ni estado, esto devolverá el país del usuario.
Si no se establece ningún país, solo se mostrará la ciudad o el estado.
get_address( $donation_id = '' )
Devuelve la dirección imprimible del usuario. Si se especifica un ID de donación, esto devolverá la dirección utilizada para la donación.
Parámetros$donation_id
Opcional. Si se establece, esto devolverá la dirección de la donación. De lo contrario, esto devolverá la dirección almacenada en el perfil del donante.
get_donations( $distinct_donations = false)
Esto devolverá una matriz de todas las donaciones realizadas por el usuario.
Parámetros$distinct_donations
Booleano. Si es true, esto solo mostrará donaciones únicas.
count_donations( $distinct_donations = false)
Esto devuelve el número de donaciones realizadas por el donante.
Parámetros$distinct_donations
Booleano. Si es true, esto solo contará donaciones únicas.
count_campaigns_supported()
Esto devuelve el número de campañas a las que el usuario ha donado.
get_total_donated( $campaign_id = false )
Devuelve la cantidad total donada por el usuario, o el total donado a una campaña en particular por el usuario.
Parámetros:$campaign_id
Opcional. Si se establece, esto solo obtendrá la cantidad total donada por el donante a la campaña dada. Por defecto, esto está establecido en false.
obtener_avatar( $tamano = 100 )
Devuelve el HTML para mostrar el avatar del donante. Por defecto, esto devolverá el Gravatar asociado a la dirección de correo electrónico del donante.
Parámetros$size
Opcional. Establece el ancho y la altura del avatar a devolver. Por defecto, el avatar se devuelve con un ancho y una altura de 100 píxeles.
get_avatar_src( $size = 100 )
Devuelve el archivo de origen de la imagen del avatar.
Parámetros$size
Opcional. Establece el ancho y la altura del avatar a devolver. Por defecto, el avatar se devuelve con un ancho y una altura de 100 píxeles.
get_campaigns( $args = array() )
Devuelve un objeto WP_Query con todas las campañas creadas por el donante.
Parámetros$args
Opcional. Argumentos adicionales que se pasarán a WP_Query.
get_current_campaigns( $args = array() )
Devuelve un objeto WP_Query con todas las campañas creadas por el donante que están actualmente activas.
Parámetros$args
Opcional. Argumentos adicionales que se pasarán a WP_Query.
has_current_campaigns()
Devuelve si el donante tiene alguna campaña actual.
get_activity( $args = array() )
Devuelve un objeto WP_Query con todas las donaciones y campañas creadas por el donante, ordenadas por fecha.
Parámetros$args
Opcional. Argumentos adicionales que se pasarán a WP_Query.
