Scott Reilly

<p>Display image (if present) and/or name for the author of a post, or for all authors on the blog.</p>
<p>Use <code><?php c2c_the_author_image(); ?></code> as a replacement for <code><?php the_author() ?></code> or <code><?php get_avatar(); ?></code> in index.php (and/or any other post templates) to display an image for a post’s author (inside “the loop”)</p>
<p>Use <code><?php c2c_wp_list_authors_images(); ?></code> as a replacement for <code><?php wp_list_authors(); ?></code> in the sidebar section of your site to list all authors for the blog using an image and/or text.</p>
<p>The plugin also provides a simple widget for listing authors.</p>
<p>Process by which the image is located and/or text used:</p>
<ol>
<li>If a post has an ‘author_image’ custom field defined, the plugin checks if the value is the valid name of an image in the defined image directory.  If not, it appends each of the defined image extensions, in turn, to the custom field’s value, then checks if an image can be found.</li>
<li>If no image has been found yet, it looks in the image directory for a file with a name that is the author’s login name with a file extension matching one of the ones defined in image extensions.</li>
<li>If no image has been found yet, it looks in the image directory for a file with a name that is the author’s ID with a file extension matching one of the ones defined in image extensions.</li>
<li>If no image has been found yet and Gravatar support is enabled, it then asks Gravatar for the avatar associated with the author (based on author’s email address).</li>
<li>If no image has been found yet and a blank/generic image has been defined, then the blank image is used as the author’s avatar.</li>
<li>If an image has been found and the “Show author name as well?” setting is true, or if no author image has been found and “Show author name if image is found?” setting is true, then the author’s name is appended/used.</li>
</ol>
<p>Additional notes:</p>
<ul>
<li>The plugins admin options page allows you to control if the author’s name should appear alongside the author image or not, if the author name should be shown in the event no author image could be found, the image directory, the support image extensions, and if and what you want the author image to link to.</li>
<li>Images output by <code>c2c_the_author_image()</code> are defined with class=”author_image” for stylesheet manipulation</li>
<li>Images output by <code>c2c_wp_list_authors_images()</code> are defined with class=”list_author_image” for stylesheet manipulation</li>
</ul>
<p>Tip:: You can take advantage of the $image_dir argument to display different author images under different contexts, i.e. locate your images in different directories ‘wp-content/images/authors/small/’ and ‘wp-content/images/authors/large/’ and decide on context where to get the image(s) from.</p>
<p>Links: <a href="http://coffee2code.com/wp-plugins/author-images/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/extend/plugins/author-images/" rel="ugc">Plugin Directory Page</a> | <a href="http://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Template Tags</h3>
<p>The plugin provides three optional template tags for use in your theme templates.</p>
<h4>Functions</h4>
<ul>
<li>
<p><code>function c2c_get_author_image( $args = array() )</code><br />
Gets the image and/or name for an author.</p>
</li>
<li>
<p><code>function c2c_the_author_image( $before = '', $after = '', $image_dir = '', $width = '', $height = '' )</code><br />
A drop-in replacement for WordPress’s <code>the_author()</code> , allowing the author for the post to have an image displayed in lieu of the name (if an image can be found).</p>
</li>
<li>
<p><code>function c2c_wp_list_authors_images( $args = '' )</code><br />
A drop-in replacement for WordPress’s <code>wp_list_authors()</code>, allowing all authors for a blog to be listed with an image (if present).</p>
</li>
</ul>
<p>This displays the image associated with a post’s categories.</p>
<h4>Arguments</h4>
<ul>
<li>
<p><code>$before</code><br />
Optional argument.  The text and/or HTML to appear before the author image/text, if any such text would be returned.</p>
</li>
<li>
<p><code>$after</code><br />
Optional argument.  The text and/or HTML to appear after the author image/text, if any such text would be returned.</p>
</li>
<li>
<p><code>$image_dir</code><br />
Optional argument.  The directory, relative to the root of your blog, in which to find the author images.  If not set, it defaults to the value configured via the plugin’s admin options page.</p>
</li>
<li>
<p><code>$width</code><br />
Optional argument.  The forced width of the image (will cause browser to resize if image is of different width). Leave blank to retain image’s original width (or for the width to be scaled in proportion to a specified height). It is recommended that images exist at the desired size.</p>
</li>
<li>
<p><code>$height</code><br />
Optional argument.  The forced height of the image (will cause browser to resize if image is of different height). Leave blank to retain image’s original height (or for the height to be scaled in proportion to a specified width). It is recommended that images exist at the desired size.</p>
</li>
<li>
<p><code>$author_id</code><br />
Optional argument. The id of the author. If null, then gets the author for the current post. Default is null.</p>
</li>
<li>
<p><code>$args</code> (as used in <code>c2c_get_author_image()</code>)<br />
Optional argument.  An array of configuration options.</p>
<ul>
<li>author_id : default of current post author; the id of the author to get the image for</li>
<li>before : default of ”; text to show before each author</li>
<li>after : default of ”; text to show after each author</li>
<li>image_dir : default of ”; directory containing author images, relative to wp-content directory</li>
<li>width : default of ”; width to display image</li>
<li>height : default of ”; height to display image</li>
<li>show_name : default of ” which means it’ll abide by the plugin’s setting value; should the name of the author be shown in addition to the image?</li>
<li>show_fullname : default of false; should the user’s first and last name be shown instead of the author’s configured display name? (be sure to set ‘show_name’ to true if you want the name to appear in the first place)</li>
<li>show_name_if_no_image : default of ” which means it’ll abide by the plugin’s setting value; should the author’s name be shown if the author doesn’t have an image?</li>
<li>class : default of ”; array or string of classes to apply to author image tag</li>
<li>use_gravatar : default of plugin settings; should Gravatar be consulted for an author image if no local image for the author was found?</li>
</ul>
</li>
<li>
<p><code>$args</code> (as used in <code>c2c_wp_list_authors_images</code>)<br />
Optional argument.  An array of configuration options.  All but the last two match up with the supported arguments of the <code>wp_list_authors()</code> function.</p>
<ul>
<li>optioncount : default of false;</li>
<li>exclude_admin : default of true; should the admin user be excluded from the listing?</li>
<li>hide_empty : default of true; should authors who have not made any posts be excluded from the listings?</li>
<li>feed : default of ”</li>
<li>feed_image : default of ”</li>
<li>echo : default of true; should the listing be echoed to the page?</li>
<li>show_name : default of ” which means it’ll abide by the plugin’s setting value; should the name of the author be shown in addition to the image?</li>
<li>show_fullname : default of false; should the user’s first and last name be shown instead of the author’s configured display name? (be sure to set ‘show_name’ to true if you want the name to appear in the first place)</li>
<li>show_name_if_no_image : default of <code>''</code> which means it’ll abide by the plugin’s setting value; should the author’s name be shown if the author doesn’t have an image?</li>
<li>before : default of ”; text to show before each author</li>
<li>after : default of ”; text to show after each author</li>
<li>image_dir : default of ”; directory containing author images, relative to wp-content directory</li>
<li>width : default of ”; width to display image</li>
<li>height : default of ”; height to display image</li>
<li>class : default of ”; array or string of classes to apply to author image tag</li>
<li>use_gravatar : default of plugin settings; should Gravatar be consulted for an author image if no local image for the author was found?</li>
</ul>
</li>
</ul>
<h3>Examples</h3>
<ul>
<li>
<p>Show the author image for the current post’s author (must be “in the loop”)</p>
</li>
<li>
<p>Get the author image from a different directory when on a post’s permalink page (for instance, show a larger image on the permalink page)</p>
</li>
<li>
<p>List all authors in the sidebar</p>
<ul>
</ul>
</li>
<li>
<p>Change some default options when listing authors</p>
<ul>
   false, ‘show_name_if_no_image’ => true)); ?>
</ul>
<h3>Filters</h3>
<p>The plugin exposes two filters and two actions for hooking.  Typically, customizations utilizing these hooks would be put into your active theme’s functions.php file, or used by another plugin.</p>
</li>
</ul>
<h4>c2c_get_author_image (filter)</h4>
<p>The ‘c2c_get_author_image’ hook allows you to use an alternative approach to safely invoke <code>c2c_get_author_image()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_get_author_image()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php $image = c2c_get_author_image( array( 'show_name' => false ) ); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php $image = apply_filters( 'c2c_get_author_image', array( 'show_name' => false ) ); ?>
</code></pre>
<h4>c2c_get_the_author_image (filter)</h4>
<p>The ‘c2c_get_the_author_image’ hook allows you to use an alternative approach to safely invoke <code>c2c_get_the_author_image()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_get_the_author_image()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php $image = c2c_get_the_author_image(); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php $image = apply_filters( 'c2c_get_the_author_image', ''); ?>
</code></pre>
<h4>c2c_the_author_image (action)</h4>
<p>The ‘c2c_the_author_image’ hook allows you to use an alternative approach to safely invoke <code>c2c_the_author_image()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_the_author_image()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php c2c_the_author_image( '<span class="author">', '</span>', '/images' ); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php echo do_action( 'c2c_the_author_image', '<span class="author">', '</span>', '/images' ); ?>
</code></pre>
<h4>c2c_wp_list_authors_images (action)</h4>
<p>The ‘c2c_wp_list_authors_images’ hook allows you to use an alternative approach to safely invoke <code>c2c_wp_list_authors_images()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for c2c_wp_list_authors_images()</li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php echo c2c_wp_list_authors_images( array( 'hide_empty' => false ) ); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php echo do_action( 'c2c_wp_list_authors_images', array( 'hide_empty' => false ) ); ?>
</code></pre>


Author Image(s)

Display image (if present) and/or name for the author of a post, or for all authors on the blog.

andergmartins

Steve Burge

Kevin Behrens

PublishPress

ojopaul

<p><a href="https://publishpress.com/authors/" rel="nofollow ugc">PublishPress Authors</a> allows you to create, manage and display authors for all your WordPress content. The plugin provides author boxes that can display one author, coauthors, multiple authors or even guest authors. The boxes have the author bio, name, avatar, description and more. You can also place the author boxes in widgets, shortcodes and Gutenberg blocks.</p>
<p>Here are the some most important features of PublishPress Authors:</p>
<ul>
<li><strong>Author Boxes</strong>. As soon as you install PublishPress Authors, you’ll see an author box under every post. You can add all the profile details you need for each author.</li>
<li><strong>Multiple Authors</strong>. By default, WordPress only allows one author per post. PublishPress Authors allows you to add an unlimited number of authors to each post. This is very useful if you have a busy site and need to manage and give credit to coauthors.</li>
<li><strong>Guest Authors</strong>. You can create two types of Guest Authors. You can add authors to a new “Guest Author” user role, or add them without a connected account.</li>
<li><strong>Author Categories</strong>. Categorize your authors as Coauthors, Reviews, Editors, Photographers, and more.</li>
<li><strong>Author Fields</strong>. Customize the user details for each author with fields for social media, job details, and more.</li>
<li><strong>Author Lists</strong>. Create a custom display of all your authors. You can sort, order, and filter to show only the authors you want.</li>
<li><strong>Author Pages</strong>. Showcase the work of each individual author with customizable author pages where you decide which post information is displayed.</li>
</ul>
<h3>PublishPress Authors Pro</h3>
<blockquote>
<p><strong>Upgrade to Authors Pro</strong><br />
  This plugin is the free version of the PublishPress Authors plugin. The Pro version comes with all the features you need to create beautiful and useful author profiles. <a href="https://publishpress.com/authors" title="Authors Pro" rel="nofollow ugc">Click here to purchase the best premium WordPress author box plugin now!</a></p>
</blockquote>
<h3>Author Boxes</h3>
<p>PublishPress Authors gives you multiple ways to show author profiles. You can display authors under your content, in a widget, using shortcodes and more.</p>
<p>The Author Boxes feature in PublishPress Authors provides five default layouts. You can use these layouts, customize them or click “New Author Box” and create your own layouts.</p>
<p><a href="https://publishpress.com/knowledge-base/customize-author-boxes/" rel="nofollow ugc">Click here to see how to customize author boxes</a>.</p>
<p>On the frontend of your site. PublishPress Authors gives you several different options to display the authors’ box:</p>
<ul>
<li>Replacing the default author display.</li>
<li>At the bottom of your content.</li>
<li>In a widget or a Gutenberg block.</li>
<li>Using shortcodes.</li>
<li>Adding filters and actions in your template files.</li>
</ul>
<p><a href="https://publishpress.com/knowledge-base/display-multiple-authors/" rel="nofollow ugc">Click here to read about displaying authors</a>.</p>
<h3>Multiple Authors</h3>
<p>With PublishPress Authors, you can set multiple authors for each post. When you write a post, you’ll see a box in the right sidebar. Here you can choose from all the users on your site, and assign them as coauthors.</p>
<p><a href="https://publishpress.com/knowledge-base/authors-getting-started/" rel="nofollow ugc">Click here to get started with PublishPress Authors</a>.</p>
<h3>Guest Authors</h3>
<p>Using PublishPress Authors, you can create Guest Authors who don’t need an account on your site. PublishPress will treat Guest Authors identically to Authors who are linked users.</p>
<p>You will be able to select and display Guest Authors in exactly the same way as for registered users. Each Guest Author can have a full profile, plus an avatar, and their own archive page for blog posts.</p>
<p>You can create two types of Guest Authors. You can add authors to a new “Guest Author” user role, or add them without a connected account.</p>
<p><a href="https://publishpress.com/knowledge-base/add-guest-authors-wordpress/" rel="nofollow ugc">Click here to see how to create Guest Authors</a>.</p>
<h3>Author Categories</h3>
<p>Author Categories is a feature that allows you to have different types of authors for WordPress post. For example, you can label one user as an “Author”, one as “Contributor” and one as an “Editor”. This enables you to give different types of credit to the all the people who work on your content.</p>
<p>PublishPress Authors Pro has a feature that allows you do more with Author Categories. You can create an “Author Categories Box”. This is a display format for your images that is specifically designed to group authors together in their categories.</p>
<p><a href="https://publishpress.com/knowledge-base/introduction-to-author-categories/" rel="nofollow ugc">Click here to see how to use Author Categories</a>.</p>
<h3>Author Fields</h3>
<p>PublishPress Authors allows you to customize the user details for each author. This is possible with the “Author Fields” feature. These fields can be displayed using the Author Boxes feature. There are several fields available in the Free version of the Authors plugin including First Name, Last Name, Email, Website, Job Title.</p>
<p><a href="https://publishpress.com/knowledge-base/field-types-ma/" rel="nofollow ugc">Click here to see how to use Author Fields</a></p>
<h3>Author Lists</h3>
<p>The Author Lists feature allows you to show a custom display of authors. For example, the “Author Index” view can organize your authors alphabetically. There will be a row of letters on the top of this display. If you click on any of the letters, you’ll be able to drill down to view only the authors whose names begin with that letter. There’s also a “Author Recent” view that allows you to show your authors, together with their most recent posts.</p>
<p><a href="https://publishpress.com/knowledge-base/authors-list/" rel="nofollow ugc">Click here to see how to use Author Lists</a>.</p>
<h3>Author Pages</h3>
<p>PublishPress Authors can replace the default WordPress author pages. The URLs of the pages will not change, but you can customize the pages using the settings on this screen.</p>
<p>Your author page will appear with an author box on the top of the screen and the author’s posts underneath. You can choose a “List” or a “Grid” option and you’re also free to create your own layouts.</p>
<p><a href="https://publishpress.com/knowledge-base/author-pages/" rel="nofollow ugc">Click here to see how to use Author Pages</a>.</p>
<h3>Custom Fields for Author Profiles (Pro version)</h3>
<p>PublishPress Authors Pro enables you to create author fields and enhance your author profiles. You can add Text, WYSIWYG, Link and email address fields. Then you can place those author fields in author bio profiles using custom layouts. The Pro version of Authors supports Facebook, Twitter, Instagram, Linkedin, YouTube, TikTok and more.</p>
<p><a href="https://publishpress.com/knowledge-base/custom-fields/" rel="nofollow ugc">Click here to see how to use Custom Fields</a>.</p>
<h3>Join PublishPress and get the Pro plugins</h3>
<p>The Pro versions of the PublishPress plugins are well worth your investment. The Pro versions have extra features and faster support. <a href="https://publishpress.com/pricing/" rel="nofollow ugc">Click here to join PublishPress</a>.</p>
<p>Join PublishPress and you’ll get access to these Pro plugins:</p>
<ul>
<li><a href="https://publishpress.com/authors" rel="nofollow ugc">PublishPress Authors Pro</a> allows you to add multiple authors and guest authors to WordPress posts.</li>
<li><a href="https://publishpress.com/blocks" rel="nofollow ugc">PublishPress Blocks Pro</a> has everything you need to build professional websites with the WordPress block editor.</li>
<li><a href="https://publishpress.com/capabilities" rel="nofollow ugc">PublishPress Capabilities Pro</a> is the plugin to manage your WordPress user roles, permissions, and capabilities.</li>
<li><a href="https://publishpress.com/checklists" rel="nofollow ugc">PublishPress Checklists Pro</a> enables you to define tasks that must be completed before content is published.</li>
<li><a href="https://publishpress.com/future" rel="nofollow ugc">PublishPress Future Pro</a> is the plugin for managing and scheduling WordPress content.</li>
<li><a href="https://publishpress.com/permissions" rel="nofollow ugc">PublishPress Permissions Pro</a>  is the plugin for advanced WordPress permissions.</li>
<li><a href="https://publishpress.com/publishpress" rel="nofollow ugc">PublishPress Planner Pro</a> is the plugin for managing and scheduling WordPress content.</li>
<li><a href="https://publishpress.com/revisions" rel="nofollow ugc">PublishPress Revisions Pro</a> allows you to update your published pages with teamwork and precision.</li>
<li><a href="https://publishpress.com/series" rel="nofollow ugc">PublishPress Series Pro</a> enables you to group content together into a series.</li>
<li><a href="https://publishpress.com/shortlinks" rel="nofollow ugc">PublishPress Shortlinks Pro</a> allows you to create custom URLs for your posts and external links. </li>
<li><a href="https://publishpress.com/statuses" rel="nofollow ugc">PublishPress Statuses Pro</a> enables you to create additional publishing steps for your posts.</li>
</ul>
<p>Together, these plugins are a suite of powerful publishing tools for WordPress. If you need to create a professional workflow in WordPress, with moderation, revisions, permissions and more… then you should try PublishPress.</p>
<h4>Bug Reports</h4>
<p>Bug reports for PublishPress Authors are welcomed in our <a href="https://github.com/publishpress/publishpress-authors" rel="nofollow ugc">repository on GitHub</a>. Please note that GitHub is not a support forum, and that issues that aren’t properly qualified as bugs will be closed.</p>
<h4>Thank You</h4>
<p>This plugin is partly based on Co-Authors Plus, which includes the work of batmoo, danielbachhuber and automattic. This plugin also uses work from the Bylines plugin by danielbachhuber.</p>


Co-Authors, Multiple Authors and Guest Authors in an Author Box with PublishPress Authors


I wish I could add different text in a box under a post and on autor's page. Hope it'll be added sometime in future.


works fine


Works well and it makes the posts much cooler!


So cool

PublishPress Authors is the best plugin for adding authors, co-authors, multiple authors and guest authors to WordPress posts.

Author Image(s) vs Co-Authors, Multiple Authors and Guest Authors in an Author Box with PublishPress Authors