Este plugin permite crear shortcodes personalizados que muestren datos dependientes del usuario en WordPress. Incluye integraciones con WooCommerce, WooCommerce Memberships, WooCommerce Subscriptions, Easy Digital Downloads, BuddyPress y el plugin para añadir campos personalizados al registro de WooCommerce.

Para crear un nuevo shortcode basta con ir a Shortcodes > Añadir shortcode, añadir como título el texto que generará el shortcode, seleccionar en el desplegable qué dato mostrará el shortcode y guardar.

El shortcode mostrado estará listo para usarse en cualquier lugar de la web, mostrando al usuario el dato seleccionado. Si no hay usuario conectado (se visita la web como invitado) no se mostrará ningún dato. Si se quiere mostrar un texto cuando el usuario no está conectado (invitados) se puede usar el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_invitado', function ($texto) {
	return 'Texto para usuarios no identificados';
	}, 10, 1);

Si quieres mostrar un texto diferente en función del shortcode de que se trate, hazme una petición de soporte.

La mayoría de códigos para functions.php mostrados en esta documentación permiten también mostrar diferentes resultados para diferentes shortcodes, aunque éstos estén configurados para mostrar el mismo dato. Si necesitas hacer algo así, hazme una petición de soporte.

Datos de WordPress

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Correo electrónico del usuario

Muestra el correo electrónico de registro del usuario conectado.

Rol de usuario

Muestra el rol del usuario conectado. Si queremos obtener el ID de rol en lugar del nombre se puede usar el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_nombre_rol', '__return_false');

Nombre de usuario

Muestra el nombre de usuario (username) del usuario conectado (el nombre de usuario no se puede editar en el perfil de WordPress).

Nombre

Muestra el nombre («nombre de pila») del usuario conectado.

Apellidos

Muestra los apellidos del usuario conectado.

Nombre y apellidos

Muestra conjuntamente el nombre y los apellidos del usuario conectado (útil si quieres mostrarlo así, para no tener que crear dos shortcodes separados con cada uno de estos datos).

Alias del usuario

Muestra el alias del usuario conectado (el alias sí se puede editar en el perfil de WordPress).

Nombre visible del usuario

Muestra el nombre para mostrar públicamente del usuario conectado.

Web

URL de la web del usuario.

Gravatar

Muestra el Gravatar del usuario, si tiene alguno registrado en Gravatar.com. Si no, muestra el Gravatar por defecto.

El plugin permite ajustar el tamaño del Gravatar mostrado, hasta un tamaño máximo de 150×150 píxeles. Si quieres mostrar un tamaño mayor puedes usar el siguiente código en tu archivo functions.php:

add_filter ('wp_shortcodes_usuarios_gravatar_tamano', function ($size) {
	return 250;
	}, 10, 1);

Puede mostrarse un Gravatar por defecto personalizado (en caso de que el usuario no esté registrado en Gravatar.com) usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_gravatar_default', function ($url) {
	return 'https://example.com/ruta/imagen.jpg';
	}, 10, 1);

Datos de WooCommerce

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Datos de facturación de WooCommerce

• Datos completos de facturación
• Nombre
• Apellidos
• Nombre de la empresa
• NIF/CIF (en caso de estar utilizando el plugin para pedir el NIF en los pedidos de WooCommerce)
• Dirección 1
• Dirección 2
• Código postal
• Localidad/Ciudad
• País/Región
• Provincia/Departamento/Estado
• Teléfono
• Correo electrónico

Datos de envío de WooCommerce

Por defecto no se rellenan estos datos, a no ser que el usuario lo haga desde la sección Mi cuenta o completando el apartado ¿Enviar a una dirección diferente? del checkout de WooCommerce.

• Datos completos de envío
• Nombre
• Apellidos
• Nombre de la empresa
• Dirección 1
• Dirección 2
• Código postal
• Localidad/Ciudad
• País/Región
• Provincia/Departamento/Estado

Los datos de envío en WooCommerce no incluyen teléfono ni correo electrónico.

Productos comprados

Permite mostrar los productos que el usuario ha comprado, tal como WooCommerce los muestra en la tienda o en las páginas de categoría, resultados de búsqueda, etcétera, es decir, mostrando la imagen destacada, precio, precio de oferta, botón de Añadir al carrito o Seleccionar opciones, etcétera.

El plugin permite establecer el número máximo de productos que se mostrarán. No se muestran los productos incluidos en los pedidos del usuario que estén en los estados Reembolsado, Fallido o Cancelado. Es posible excluir otros estados de pedido usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_quita_estados', function ($estados) {
	$estados[] = 'wc-on-hold'; //Por ejemplo, para pedidos en espera
	return $estados;
	}, 10, 1);

Número de pedidos

Muestra el número total de pedidos realizados por el cliente conectado, sin contar los pedidos que estén en los estados Reembolsado, Fallido o Cancelado. Es posible excluir otros estados de pedido usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_quita_estados', function ($estados) {
	$estados[] = 'wc-on-hold'; //Por ejemplo, para pedidos en espera
	return $estados;
	}, 10, 1);

Cantidad total gastada

Muestra la cantidad total que ha gastado el cliente en la tienda, con el formato de moneda establecido en los ajustes de WooCommerce. Si se quiere obtener la cantidad en número, sin formato, se puede usar el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_formato_cantidad', '__return_false');

Pedido mínimo

Muestra el pedido mínimo establecido en la tienda para el cliente conectado según su rol de usuario, en formato de precio (con el símbolo de moneda y los decimales según se hayan establecido en los ajustes de WooCommerce). Es necesario estar usando el plugin para establecer un pedido mínimo en WooCommerce.

Si el rol de usuario asignado al cliente no tiene establecido un pedido mínimo, se mostrará cero. Para mostrar un texto personalizado cuando un cliente no tiene establecido un pedido mínimo se puede usar el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_sin_minimo', function ($texto) {
	return 'Texto a mostrar si no hay pedido mínimo';
	}, 10, 1);

Tabla de pedidos

Muestra una tabla de pedidos igual a la que genera WooCommerce en Mi cuenta > Pedidos. Si no hay pedidos, se mostrará un aviso igual al que muestra WooCommerce. El shortcode incluye una opción para establecer el número máximo de pedidos que incluirá la tabla (no admite paginación).

Se puede personalizar el texto que se mostrará a un usuario cuando todavía no ha realizado ningún pedido usando el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_no_pedidos', function ($texto) {
	return 'Texto a mostrar si no hay pedidos';
	}, 10, 1);

Al igual que hace WooCommerce los pedidos se ordenan en la tabla con los últimos realizados ocupando las primeras posiciones. Si queremos ordenarlos al contrario, mostrando los más antiguos primero, podemos usar el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_pedidos_descendentes', '__return_true');

Tabla de descargas

Muestra una tabla de descargas igual a la que genera WooCommerce en Mi cuenta > Descargas. Si no hay descargas, se mostrará un aviso igual al que muestra WooCommerce. Se puede personalizar el texto que se mostrará a un usuario cuando todavía no tiene ninguna descarga disponible usando el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_no_descargas', function ($texto) {
	return 'Texto a mostrar si no hay descargas';
	}, 10, 1);

Tabla de cupones disponibles

Muestra los cupones específicos para el usuario (no los generales) que hay disponibles (es decir, no caducados o usados la cantidad máxima de veces). La tabla muestra:

• Código del cupón.
• Descripción del cupón.
• Descuento.
• Usos restantes (∞ si el número de usos no está limitado).

Se puede personalizar el texto que se mostrará a un usuario cuando no tiene ningún cupón disponible usando el siguiente código en functions.php:

add_filter ('wp_shortcodes_usuarios_no_cupones', function ($texto) {
	return 'Texto a mostrar si no hay cupones para el usuario';
	}, 10, 1);

Datos personalizados del formulario de registro

Se puede mostrar cualquier dato recogido con el plugin para campos personalizados del registro de WooCommerce. Para ello no es necesario hacer nada: si el plugin está activo, el selector para el dato del shortcode te mostrará los campos creados con dicho plugin, de forma que puedas configurar el shortcode para que muestre el dato recogido con cada campo.

Datos de WooCommerce Subscriptions

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Tabla de suscripciones

Muestra una tabla de suscripciones igual a la que genera WooCommerce Subscriptions en Mi cuenta > Subscriptions. Esta tabla, al contrario de la generada por WooCommerce Subscriptions, cuenta con traducción al español.

Es posible hacer que la tabla no muestre la columna de acciones de la suscripción. Para ello se puede añadir el siguiente código al archivo functions.php:

add_filter ('wp_shortcodes_usuarios_suscripciones_acciones', '__return_false');

Fecha de fin de periodo de prueba

Muestra la fecha de finalización del periodo de prueba, siempre que el usuario esté en dicho periodo. Si no lo está muestra la frase «No hay ningún periodo de prueba activo». El formato de la fecha es el que se haya establecido para el sitio web en los ajustes generales de WordPress.

Fecha de fin de la suscripción

Muestra la fecha de finalización de la suscripción, siempre que el usuario tenga una suscripción activa. El formato de la fecha es el que se haya establecido para el sitio web en los ajustes generales de WordPress.

Fecha de próxima renovación

Muestra la fecha de la próxima renovación, siempre que el usuario tenga una suscripción activa. Si no, muestra la frase «No hay suscripciones activas». El formato de la fecha es el que se haya establecido para el sitio web en los ajustes generales de WordPress.

Cantidad a pagar en la siguiente renovación

Muestra la cantidad a pagar en la próxima renovación de la suscripción del usuario, con el formato de precio establecido en los ajustes de WooCommerce.

Datos de WooCommerce Memberships

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Tabla de membresías

Muestra una tabla igual a la generada por WooCommerce Memberships en Mi cuenta > Memberships. Esta tabla, al contrario de la generada por WooCommerce Memberships, cuenta con traducción al español. En caso de que el usuario no tenga ninguna membresía (en ningún estado) se mostrará la frase «No hay ninguna membresía».

Es posible que la tabla sólo muestre las membresías actualmente activas usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_membresias_activas', '__return_true');

En caso de no tener el usuario ninguna membresía activa se mostrará la frase «No hay ninguna membresía activa».

Membresías activas del usuario

Muestra el nombre de las membresías activas del usuario, separadas por comas en caso de tener más de una. En caso de que el usuario no tenga ninguna membresía activa muestra el texto «No tiene membresías activas».

Fecha de fin de la membresía

Muestra la fecha de fin de la membresía activa del usuario.

Datos de Easy Digital Downloads

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Número de cliente

Muestra el número de cliente de EDD (no coincide con el ID de usuario) del usuario activo. En caso de ser un usuario registrado pero no un cliente EDD, se puede hacer que se muestre un mensaje personalizado usando el siguiente código en functions.php:

 add_filter ('wp_shortcodes_usuarios_edd_no_cliente', function ($texto) {
	return 'Aún no eres cliente.';
	}, 10, 1);

Cantidad total gastada

Muestra la cantidad total gastada por el cliente en la tienda, en el formato de moneda establecido en los ajustes de EDD. Se puede mostrar la cantidad numérica, sin formato, usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_edd_formato', '__return_false');

Número de pedidos

Muestra el número de pedidos que ha realizado el cliente en la tienda.

Fecha de creación del cliente

Muestra la fecha en que se creó el cliente, en el formato establecido en los ajustes generales de WordPress. Normalmente esta fecha coincide con la del primer pedido realizado (pero no necesariamente es siempre así).

IDs de las transacciones

Muestra una lista, separada por comas, con los IDs de los pedidos del cliente.

Datos de BuddyPress

Están disponibles para mostrar mediante shortcode personalizado los siguientes datos:

Enlace al perfil

Muestra un enlace al perfil en BuddyPress del usuario conectado, usando el nombre del usuario como texto ancla.

URL del perfil

Muestra la URL del perfil en BuddyPress del usuario conectado.

Imagen de perfil

Muestra la imagen de perfil del usuario conectado. El shortcode permite seleccionar el tamaño de la imagen, hasta un máximo de 100×100 píxeles. Si se quiere usar un tamaño de imagen mayor (no es recomendable por motivos de calidad de la imagen) se puede usar el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_bp_imagen_perfil', function ($size) {
	return 200; //200x200
	}, 10, 1);

Imagen de portada

Muestra la imagen de portada del usuario. Si el usuario no ha establecido una imagen de portada no se mostrará nada.

Número de grupos creados por el usuario

Muestra el número de grupos que ha creado el usuario.

Lista de grupos creados por el usuario

Muestra una lista de los grupos que ha creado el usuario, con un enlace a cada uno de ellos. Se puede hacer que la lista no incluya enlaces (siendo entonces tan sólo una lista de los nombres de los grupos) usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_bp_grupos_creador_enlace', '__return_false');

Número de grupos de los que es miembro

Muestra el número de grupos de los que el usuario es miembro.

Lista de grupos de los que es miembro

Muestra una lista de los grupos de los que el usuario es miembro, con un enlace a cada uno de ellos. Se puede hacer que la lista no incluya enlaces (siendo entonces tan sólo una lista de los nombres de los grupos) usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_bp_grupos_miembro_enlace', '__return_false');

Número de amigos

Muestra el número de amigos confirmados del usuario.

Listas de amigos

Hay tres shortcodes disponibles para generar una lista de los amigos del usuario:

• Por orden alfabético
• De más nuevo a más antiguo
• Activos recientemente

En los tres casos la lista muestra los nombres de los amigos, con un enlace al perfil de cada uno de ellos. Se puede hacer que no se incluya el enlace al perfil (se convierte entonces en una lista sólo de nombres) usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_bp_lista_amigos_enlace', '__return_false');

En caso de que el usuario no tenga ningún amigo confirmado no se mostrará nada. Se puede mostrar un texto en este caso usando el siguiente código en el archivo functions.php:

add_filter ('wp_shortcodes_usuarios_bp_lista_amigos_ninguno', function ($mensaje) {
	return 'No tienes ningún amigo :(';
	}, 10, 1);