WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

People Lists

Provides a shortcode [people-lists list=example-list] that can insert a People List on any page,post or even sidebar to list selected users.

I've activated the plugin, now where do I go??

Under Settings on the dashboard, click on People Lists to create a new list! Also, under Users on the dashboard, click Your Profile to see the rich-text (WYSIWYG) editor and the same area where added fields will be displayed, as well as the User Avatar image display, which I have suggested you download because it has been built and uses the code %thumbnail% to pull the image that this plugin stores.

I've added my list, but need to create a new field that WordPress doesn't provide, what should I do??

After creating a list, you will notice a tab named "Profile Settings" and after clicking on this, you simply have to enter the name of your new field and we will do the rest for you! Don't worry about remembering the template code because we will provide it for you in the template section. This new field is added to the Your Profile section (under 'Contact Info') and extends the default WordPress fields to accommodate any fields you require like a mobile number, job title, height or even the user's favourite pizza topping!

I've got my list, fields and have gotten User Avatar, but what's this template thing about??

When you add a new list or visit the list page of a previously created list, you'll notice a link called "Template Info", which will toggle and display a tabbed area with default and added field codes. Default codes are based off of the default WordPress fields for user profile information, while added field codes are the fields that you create in the "Profile Settings" page of this plugin. To the right of the tabbed area is a default template for displaying user information, which can be customized to add different template codes or styled by CSS to change the appearance of how they are displayed on a page or post. The possibilities here are endless to help fit the needs of all users, so spend some time creating the perfect template for you!

I've set up the list and template, but how do I get a list to display in a page??

There are two ways to insert a list onto a page or post! The easy method is to use the People Lists media button (the happy face :D) above the WYSIWYG on Pages and Posts. That will popup an overlay where you simply select the list you want to insert and the shortcode for it with automatically be added to the editor. The second method is to copy the shortcode from your list's management page and the only benefit to this method would be that you can insert this code in the sidebar if you had a very simple template and styled it to fit there. Of course I would suggest clicking the happy face because I drew it myself and I think it's super awesome! :D

I have a super long available people's list, but how do I drag it to the selected people's list, which is off the page??

We even thought about this and have provided pin/unpin functionality, so the selected list goes where you go, making it easy for you to find the person you want on your list! No problem.

How to you work the filters to add fields additional user fields?

=

Instead of modifying the plugin and not benefit from any future updates. I created filters that can easily be used to add additional fields eather not included by the plugin or created by a different plugin.

here is some example code.

<?php 
/* test filters */
add_filter("people_list_custom_fields",'test_display_custom_fields');
function test_display_custom_fields($array){
    
    $array[] = "%this%"; //this is the string that is displayed in your template
    return $array;
}

add_filter("people_list_fields_display",'test_display_field',10,3);
function test_display_field($display_list,$user, $list)
{
    // $user // not being used but is the user object from the of a particular user. 
    // do doing something like $user->ID try something like var_dump($user) to see the whole object
    
    // $list refers to a particular list and is the variable used 
    // this way you can target a particular list 
    $display_list[] = "replace text"; // this is the text that is 
    return $display_list;
}
?>

Requires: 3.3 or higher
Compatible up to: 3.3.2
Last Updated: 2012-1-27
Downloads: 21,335

Ratings

4 stars
4.5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2
88,8,7 60,5,3
100,1,1
8,12,1 75,4,3 100,1,1
100,1,1 100,1,1 100,2,2
100,1,1
67,3,2 100,2,2 100,4,4
0,1,0 75,4,3
83,6,5 0,1,0 100,1,1
100,1,1
0,1,0 100,1,1
17,6,1
0,2,0
0,2,0
0,5,0
0,1,0
0,2,0
0,1,0