Click here to learn more.

This is a post from: Matt Varone

Simple WordPress Gallery to Slideshow

Here is a simple example of WP_User_Query in action:

// prepare arguments
$args  = array(
// search only for Authors role
'role' => 'Author',
// order results by display_name
'orderby' => 'display_name',
// check for two meta_values
'meta_query' => array(
	array(
		// uses compare like WP_Query
		'key' => 'some_user_meta_key',
		'value' => 'some user meta value',
		'compare' => '>'
		),
	array(
		// by default compare is '='
		'key' => 'some_other_user_meta_key',
		'value' => 'some other meta value',
		),
	// add more
));
// Create the WP_User_Query object
$wp_user_query = new WP_User_Query($args);
// Get the results
$authors = $wp_user_query->get_results();
// Check for results
if (!empty($authors))
{
	echo '<ul>';
	// loop trough each author
	foreach ($authors as $author)
	{
		// get all the user's data
		$author_info = get_userdata($author->ID);
		echo '<li>'.$author_info->first_name.' '.$author_info->last_name.'</li>';
	}
	echo '</ul>';
} else {
	echo 'No authors found';
}

Parameters

To tweak the search terms the WP_User_Query constructor allows the following parameters:

blog_id (int)
The blog id on a multisite environment. Defaults to the current blog id.

role (string)
The user’s role.

meta_key (string)
meta_value (string)
meta_compare (string)
Same as WP_Query ( view ).

include (array)
Array of users id to include.

exclude (array)
Array of users id to exclude.

search (string)
Searches for possible string matches on columns user_email, user_login,ID,user_url, user_login and user_nicename.

orderby (string)
login, 'nicename', 'email', 'url', 'registered'. Defaults to login.

order (string)
Defaults to ASC (ascending order).

offset (int)
Offset results ( handy for pagination ).

count_total (boolean)
If true returns the total of users found.

number (int)
Limit of users to retrieve.

fields (all)
Which fields to return. Defaults to all.

Conclusion

Now it’s awesomely simple to create users listings. I would suggest pagination and caching results for websites with lots of users as these queries can get pretty heavy.

Hope you find the code useful, if you have any comments or suggestions please feel free to leave them in the comments. Thanks for reading!

This is a post from: Matt Varone

List users with WP_User_Query

The code below is for my custom Walker which is actually the same code as the navigation Walker shipped with WordPress minus the echo of default CSS classes and ids. To make this work simply drop the code in your theme’s functions.php.

<?php
class MV_Cleaner_Walker_Nav_Menu extends Walker {
	var $tree_type = array( 'post_type', 'taxonomy', 'custom' );
	var $db_fields = array( 'parent' => 'menu_item_parent', 'id' => 'db_id' );
	function start_lvl(&$output, $depth) {
		$indent = str_repeat("\t", $depth);
		$output .= "\n$indent<ul class=\"sub-menu\">\n";
	}
	function end_lvl(&$output, $depth) {
		$indent = str_repeat("\t", $depth);
		$output .= "$indent</ul>\n";
	}
	function start_el(&$output, $item, $depth, $args) {
		global $wp_query;
		$indent = ( $depth ) ? str_repeat( "\t", $depth ) : '';
		$class_names = $value = '';
		$classes = empty( $item->classes ) ? array() : (array) $item->classes;
		$classes = in_array( 'current-menu-item', $classes ) ? array( 'current-menu-item' ) : array();
		$class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item, $args ) );
		$class_names = strlen( trim( $class_names ) ) > 0 ? ' class="' . esc_attr( $class_names ) . '"' : '';
		$id = apply_filters( 'nav_menu_item_id', '', $item, $args );
		$id = strlen( $id ) ? ' id="' . esc_attr( $id ) . '"' : '';
		$output .= $indent . '<li' . $id . $value . $class_names .'>';
		$attributes  = ! empty( $item->attr_title ) ? ' title="'  . esc_attr( $item->attr_title ) .'"' : '';
		$attributes .= ! empty( $item->target )     ? ' target="' . esc_attr( $item->target     ) .'"' : '';
		$attributes .= ! empty( $item->xfn )        ? ' rel="'    . esc_attr( $item->xfn        ) .'"' : '';
		$attributes .= ! empty( $item->url )        ? ' href="'   . esc_attr( $item->url        ) .'"' : '';
		$item_output = $args->before;
		$item_output .= '<a'. $attributes .'>';
		$item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after;
		$item_output .= '</a>';
		$item_output .= $args->after;
		$output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
	}
	function end_el(&$output, $item, $depth) {
		$output .= "</li>\n";
	}
}
?>

Then make sure to specify the new custom Walker when calling wp_nav_menu().

<?php
 wp_nav_menu( array( 'walker' => new MV_Cleaner_Walker_Nav_Menu() ) );
?>

Example:

<ul id="menu-main" class="menu">
	<li><a href="http://www.mattvarone.com/about/">About</a></li>
	<li><a href="http://www.mattvarone.com/featured-content/">Featured</a></li>
	<li><a href="http://www.mattvarone.com/contact/">Contact</a></li>
	<li><a href="http://www.mattvarone.com/blog/">Blog</a></li>
</ul>

This is a post from: Matt Varone

Cleaner output for wp_nav_menu()

Little useful ( free ) app to quickly install the latest version of WordPress on any given folder. Made from this shell script.

Download the app Here

Feel free to leave comments and suggestions.

* Awesome icon by TurboMilk

This is a post from: Matt Varone

WP Install: AppleScript for Mac

Shortcode Code:

if ( is_user_logged_in() )
return $content;
else
return $atts['message'];

This is a post from: Matt Varone

Easy Members Only with Shortcodes Pro

/*
|--------------------------------------------------------------------------
| BROWSER CLASSES
|--------------------------------------------------------------------------
*/
if ( ! function_exists( 'mv_browser_body_class' ) )
{
	function mv_browser_body_class( $classes ) {
		global $is_lynx, $is_gecko, $is_IE, $is_opera, $is_NS4, $is_safari, $is_chrome, $is_iphone;
		if( $is_lynx ) $classes[] = 'lynx';
		elseif( $is_gecko ) $classes[] = 'gecko';
		elseif( $is_opera ) $classes[] = 'opera';
		elseif( $is_NS4 ) $classes[] = 'ns4';
		elseif( $is_safari ) $classes[] = 'safari';
		elseif( $is_chrome ) $classes[] = 'chrome';
		elseif( $is_IE ) {
			$classes[] = 'ie';
			if( preg_match( '/MSIE ( [0-9]+ )( [a-zA-Z0-9.]+ )/', $_SERVER['HTTP_USER_AGENT'], $browser_version ) )
			$classes[] = 'ie' . $browser_version[1];
		} else $classes[] = 'unknown';
		if( $is_iphone ) $classes[] = 'iphone';
		return $classes;
	}
	add_filter( 'body_class','mv_browser_body_class' );
}

This is a post from: Matt Varone

WordPress Browser Body Classes Function