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()

Content is king as they say. I got rid of all the trendy buttons and overdone details. Most importantly I took some time to re-structure the menu and pages hoping to make it a little easier to navigate.

To celebrate I’m releasing Shortcodes Pro on the WordPress repository.

Thanks for stopping by!

This is a post from: Matt Varone

Back In White

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

wp_install() {
        latest="http://wordpress.org/latest.zip"
        curl -O $latest
        unzip latest.zip
        rm -rf __MACOSX latest.zip
        cp -rf ./wordpress/* ./
        rm -rf ./wordpress/
        mkdir ./wp-content/uploads/
        mv wp-config-sample.php wp-config.php
        touch .htaccess
        mate wp-config.php
        open https://api.wordpress.org/secret-key/1.1/salt/
}
# Note: If you are not a TextMate owner, change the line:
# mate wp-config.php
# to
# vi wp-config.php

Feel free to fork it at GitHub.

This is a post from: Matt Varone

Install WordPress from the OSX Terminal