Weston Ruter

Ryan Hellyer

Glen Scott

<p>Allows a user to associate a profile photo with their account through their “Your Profile” page. Admins may<br />
add a user profile photo by accessing the “Edit User” page. Uploaded images are resized to fit the dimensions specified<br />
on the options page; a thumbnail image correspondingly is also generated.<br />
User photos may be displayed within a post or a comment to<br />
help identify the author. New template tags introduced are:</p>
<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>
<p><em>Important: all of these “template tags” must appear inside of PHP script blocks (see examples below).</em><br />
The first two should be placed in the posts loop near <code>the_author()</code>, and the second two in the comments<br />
loop near <code>comment_author()</code> (or their respective equivalents). Furthermore, <code>userphoto_the_author_photo()</code><br />
and <code>userphoto_the_author_thumbnail()</code> may be called anywhere (i.e. sidebar) if <code>$authordata</code> is set.</p>
<p>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>,<br />
as in: <code>userphoto_the_author_photo($before, $after, $attributes, $default_src)</code>.<br />
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<br />
prefixed and suffixed to the generated <code>img</code> tag (a common pattern in WordPress). If attributes are provided in the <code>$attributes</code><br />
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><br />
Just added in 0.8.1 release are these two new template tags:</p>
<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>
<p>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<br />
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.</p>
<p>Here’s an example that shows a few ways of inserting a user’s photo into the post loop:<br />
    //this will display the user’s avatar if they don’t have a user photo,</p>
<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(
                '<b>Photo of me: ',
                '</b>',
                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>
<p>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:</p>
<pre><code><?php userphoto($posts[0]->post_author); ?>
</code></pre>
<p>If you want to display a user’s photo their author page, you may do this:</p>
<pre><code><?php userphoto($wp_query->get_queried_object()) ?>
</code></pre>
<p>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.<br />
Argument <code>$user</code> may be user object, ID, or login name. This function can be used along with avatars:</p>
<pre><code><?php
if(userphoto_exists($user))
    userphoto($user);
else
    echo get_avatar($user->ID, 96);
?>
</code></pre>
<p>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:</p>
<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>
<p>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”<br />
option is enabled:</p>
<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>
<p>Both options “Serve Avatar as Fallback” and “Override Avatar with User Photo” require that the ‘Avatar Display’ setting under Discussion be set to “Show”.</p>
<p>Uploaded images may be moderated by administrators via the “Edit User” page.</p>
<p>Localizations included for Spanish, German, Dutch, Polish, Russian, French, Hungarian, Brazilian Portuguese, Italian, and Catalan.</p>
<p>If you value this plugin, <em>please donate</em> to ensure that it may continue to be maintained and improved.</p>

User Photo

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

<h4>EOL Notice</h4>
<p>This plugin has been sunset as of 5/21/2026. Big thank you to all the users who have contributed over the past 16 years – this was not an easy decision, but unfortunately, Facebook’s aggressive stance towards developers has just made it too difficult for a solo dev to maintain. Please see <a href="https://www.justin-klein.com/projects/facebook-photo-fetcher" rel="nofollow ugc">here</a> for details & a full explanation.</p>
<h4>Description</h4>
<p>Social Photo Fetcher (previously called “Facebook Photo Fetcher”) allows you to quickly and easily generate WordPress photo galleries from Facebook albums.</p>
<p>The idea was inspired by <a href="https://wordpress.org/extend/plugins/fotobook/" rel="ugc">Fotobook</a>, though its approach is fundamentally different: while Fotobook’s emphasis is on automation, this plugin allows a great deal of customization.  With it you can create galleries in any Post or Page you like, right alongside your regular content. You do this simply by putting a “magic HTML tag” in the post’s content – much like <a href="https://codex.wordpress.org/Gallery_Shortcode" rel="nofollow ugc">WordPress Shortcode</a>. Upon saving, the tag will instantly be populated with the Facebook album content. Presentation is fully customizable via parameters to the “magic tag” – you can choose to show only a subset of an album’s photos, change the number of photos per column, show photo captions, and more.  Plus, Social Photo Fetcher doesn’t limit you to just your own albums: it can create galleries from fanpages as well.</p>
<p>Features:</p>
<ul>
<li>Uses Facebook’s API to instantly create WordPress photo galleries from Facebook albums.</li>
<li>Galleries are fully customizable: you can import complete albums, select excerpts, random excerpts, album descriptions, photo captions, and more.</li>
<li>Galleries can be organized however you like: in any post or page, alone or alongside your other content.</li>
<li>Simple PHP template function allows programmers to manually embed albums in any template or widget.</li>
<li>Built-in LightBox: Photos appear in attractive pop-up overlays without the need for any other plugins.</li>
<li>Admin panel handles all the setup for you: Just login and you’re ready to start making albums.</li>
<li>No custom database tables required; galleries live in regular post content.</li>
</ul>
<p>For a Demo Gallery, see the <a href="https://www.justin-klein.com/projects/facebook-photo-fetcher" rel="nofollow ugc">plugin’s homepage</a>.</p>
<h3>Donate</h3>
<p>Many hours have gone into developing & maintaining this plugin, far beyond my own personal needs. If you find it useful, please consider <a href="https://www.justin-klein.com/projects/facebook-photo-fetcher/#donate" rel="nofollow ugc">making a donation</a> to help support its continued development.</p>
<h3>Privacy</h3>
<p>This plugin uses the Facebook API to fetch photo albums from Facebook. Facebook’s security rules require that apps must authorize from one specific, known location. In order comply with this requirement, when you first authorize the plugin from its admin panel, a Facebook dialog will be initiated via my own authentication server. The dialog itself is shown directly by Facebook, and Facebook handles the entire login process – no personal information will be transferred via my server, as Facebook only supplies a single-use token which I then hand back to your site to be stored. This is what the plugin uses in order to fetch the photos. For more information about how the Facebook authorization process works, please see <a href="https://developers.facebook.com/docs/facebook-login/web" rel="nofollow ugc">Facebook’s documentation</a>.</p>
<p>Usage of this plugin means the site administrator is consenting to <a href="https://www.facebook.com/policy.php" rel="nofollow ugc">Facebook’s data policy</a>. Fetched album data will be stored in your WordPress database, in posts or pages of your choosing. It can be removed by deleting those posts or pages. You are solely responsible for the security and protection of the fetched data, as it resides on and is hosted within your own WordPress site.</p>
<h3>Support</h3>
<p>Please direct all support requests <a href="https://www.justin-klein.com/projects/facebook-photo-fetcher#feedback" rel="nofollow ugc">here</a></p>


Social Photo Fetcher

The author responded quickly for my support request and the plugin offers several hooks to tweak it and make it work how you want.

Good support and flexible

Allows you to automatically create Wordpress photo galleries from Facebook albums.  Simple to use and highly customizable.

User Photo vs Social Photo Fetcher