Weston Ruter

Ryan Hellyer

Glen Scott

Allows a user to associate a profile photo with their account through their “Your Profile” page. Admins may 
add a user profile photo by accessing the “Edit User” page. Uploaded images are resized to fit the dimensions specified 
on the options page; a thumbnail image correspondingly is also generated. 
User photos may be displayed within a post or a comment to 
help identify the author. New template tags introduced are:
<ul>
<li><code>userphoto_the_author_photo()</code></li>
<li><code>userphoto_the_author_thumbnail()</code></li>
<li><code>userphoto_comment_author_photo()</code></li>
<li><code>userphoto_comment_author_thumbnail()</code></li>
</ul>
Important: all of these “template tags” must appear inside of PHP script blocks (see examples below). 
The first two should be placed in the posts loop near <code>the_author()</code>, and the second two in the comments 
loop near <code>comment_author()</code> (or their respective equivalents). Furthermore, <code>userphoto_the_author_photo()</code> 
and <code>userphoto_the_author_thumbnail()</code> may be called anywhere (i.e. sidebar) if <code>$authordata</code> is set.
The output of these template tags may be modified by passing four parameters: <code>$before</code>, <code>$after</code>, <code>$attributes</code>, and <code>$default_src</code>, 
as in: <code>userphoto_the_author_photo($before, $after, $attributes, $default_src)</code>. 
If the user photo exists (or <code>$default_src</code> is supplied), then the text provided in the <code>$before</code> and <code>$after</code> parameters is respectively 
prefixed and suffixed to the generated <code>img</code> tag (a common pattern in WordPress). If attributes are provided in the <code>$attributes</code> 
parameter, then they are returned as attributes of the generated <code>img</code> element. For example: <code>userphoto_the_author_photo('', '', array(style => 'border:0'))</code> 
Just added in 0.8.1 release are these two new template tags:
<ul>
<li><code>userphoto($user, $before = '', $after = '', $attributes = array(), $default_src = '')</code></li>
<li><code>userphoto_thumbnail($user, $before = '', $after = '', $attributes = array(), $default_src = '')</code></li>
</ul>
By using these, it is uneccessary to set the global <code>$authordata</code> to display a photo. Just pass <code>$authordata</code>, <code>$curauth</code> or 
whatever variable you have which contains the user object, or (as of version 0.9), pass in a user ID or a user login name.
Here’s an example that shows a few ways of inserting a user’s photo into the post loop: 
 //this will display the user’s avatar if they don’t have a user photo,
<pre><code><?php while (have_posts()) : the_post(); ?>
 <div class="post" id="post-<?php the_ID(); ?>">
 <h2><a href="<?php the_permalink() ?>"><?php the_title(); ?></a></h2>
 <div class="meta">
 <?php the_time('F jS, Y') ?>
 by <?php the_author() ?>

 
 <?php userphoto_the_author_photo() ?>
 <?php userphoto_the_author_thumbnail() ?>

 
 <?php userphoto($authordata) ?>
 <?php userphoto_thumbnail($authordata) ?>

 
 <?php userphoto_the_author_photo(
 'Photo of me: ',
 '',
 array('class' => 'photo'),
 get_template_directory_uri() . '/nophoto.jpg'
 ) ?>
 </div>
 <?php the_content('Read the rest of this entry &raquo;'); ?>
 </div>
<?php endwhile; ?>
</code></pre>
If you want to display the user’s photo in the sidebar, just get the user ID or object and pass it into <code>userphoto()</code> or <code>userphoto_thumbnail()</code> like this:
<pre><code><?php userphoto($posts[0]->post_author); ?>
</code></pre>
If you want to display a user’s photo their author page, you may do this:
<pre><code><?php userphoto($wp_query->get_queried_object()) ?>
</code></pre>
In version 0.9 the boolean function <code>userphoto_exists($user)</code> has been introduced which returns true if the user has a photo and false if they do not. 
Argument <code>$user</code> may be user object, ID, or login name. This function can be used along with avatars:
<pre><code><?php
if(userphoto_exists($user))
 userphoto($user);
else
 echo get_avatar($user->ID, 96);
?>
</code></pre>
Or if the new “Serve Avatar as Fallback” option is turned on, then the avatar will be served by any of the regular calls to display the user photo:
<pre><code><?php
//this will display the user's avatar if they don't have a user photo,
// and if "Serve Avatar as Fallback" is turned on
userphoto($user);
?>
</code></pre>
Additionally, all of the regular function calls to display the user photo may be done away with alltogether if the new “Override Avatar with User Photo” 
option is enabled:
<pre><code><?php
//both will display the user photo if it exists
// and if "Override Avatar with User Photo" is turned on
echo get_avatar($user_id);
echo get_avatar($user->user_email);
?>
</code></pre>
Both options “Serve Avatar as Fallback” and “Override Avatar with User Photo” require that the ‘Avatar Display’ setting under Discussion be set to “Show”.
Uploaded images may be moderated by administrators via the “Edit User” page.
Localizations included for Spanish, German, Dutch, Polish, Russian, French, Hungarian, Brazilian Portuguese, Italian, and Catalan.
If you value this plugin, please donate to ensure that it may continue to be maintained and improved.

User Photo

Allows a user to associate a photo with their account and for this photo to be displayed in their posts and comments.

jethin

This plugin allows editors to create a “People Page” that displays a list of selected site users with photos, bios, titles, profile and website links and more.
When activated via a page template, the plugin creates a drag and drop meta box which editors can use to select users and create headers. These users are listed on the people page template, along with links to their full profile when applicable.
The plugin also creates custom “Title” and “Photo” fields on the “User Edit” admin screen, which are used in theme pages. The plugin also supports “User Photo” plugin images and gravatars.
Three template files for both the “Twenty Twelve” and “Twenty Thirteen” themes are included within the /theme-templates/ directory:
<ul>
<li>“people-page.php” displays the people page index list</li>
<li>“author.php” displays a single user’s info page</li>
<li>“people-page.css” contains basic people page styles for each theme; this file can be customized</li>
</ul>
See “Other Notes” for more details and usage instructions. 
Required Theme Files
After installation a “people-page.php” template must be created inside your theme’s folder in order to use the plugin. Default templates (based on the Twenty Twelve and Twenty Thirteen themes) are included inside the plugin’s ‘theme-templates’ directory. Copy this file to your theme’s directory if you wish to use it. You can also create a custom template from your site’s theme:
<ol>
<li>Duplicate the “page.php” file in your theme’s folder and rename it “people-page.php”</li>
<li>Assign your new page as a template by entering the following comment directly after the first php tag: /* Template Name: People Page */</li>
<li>
Insert the people page index function after the WordPress loop (or wherever you’d like it to appear):
</li>
</ol>
Excerpt Length Argument (integer, optional): Set the character limit where “Biographical Info” will be excerpted. Default = 420.
A CSS stylesheet “people-page.css” that contains basic styles can be found in each of the ‘theme-templates’ subdirectories. Copy it into your theme’s directory to apply the default styles. The styles in this file can be altered to better match your theme.
You may also wish to customize your theme’s “author.php” template, which is used to display users’ profiles. A sample “author.php” file (based on the Twenty Twelve theme) is included in the ‘theme-templates’. To use your theme’s existing “author.php” file, insert the people page author function after the loop (or wherever you’d like it to appear):
<pre><code><?php echo people_page_author(); ?>
</code></pre>
The people page data is stored as an array of user IDs and heading strings. You can access this array directly in your theme using get_post_meta():
<pre><code><?php $people = get_post_meta( $post->ID, 'peeps', true ); ?>
</code></pre>
Using the Plugin
To activate the plugin, set a page’s template to use the “People Page” template and update the page. You should now see the people page meta box in the center column. Use this area to select and arrange users and create section headings if desired.
Additional User Edit / Profile Fields
“Title” and “Photo” fields (optional) are added to the bottom of the “Edit User” admin page when the plugin is activated. When set these fields are included in people page displays. If a photo is not set the plugin will attempt to display 1) a photo set using the “User Photo” plugin or 2) a gravatar. Gravatar size is 150 pixels by default.
Default Displays
People Page
<ul>
<li>Photo (if set; if not set and available: “User Photo” image; gravatar)</li>
<li>Name (linked if “Biographical Info” field is excerpted)</li>
<li>Title (if set)</li>
<li>[ posts | website ] (links if: User has posts (to profile) | website if field is set)</li>
<li>Biographical Info (includes link to profile if text is excerpted)</li>
</ul>
Author Page
<ul>
<li>Photo (if set; if not set and available: “User Photo” image; gravatar)</li>
<li>Name</li>
<li>Title (if set)</li>
<li>[ website ] (if set)</li>
<li>Biographical Info</li>
<li>Posts (last three; post details: date, and excerpt – if set: comment number, category, tags)</li>
</ul>

People Page

Create a "People Page" that displays a list of selected site users with photos, bios, titles, links and more.

User Photo vs People Page