Scott Reilly

Display image (if present) and/or name for the author of a post, or for all authors on the blog.
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”)
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.
The plugin also provides a simple widget for listing authors.
Process by which the image is located and/or text used:
<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>
Additional notes:
<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>
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.
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>
<h3>Template Tags</h3>
The plugin provides three optional template tags for use in your theme templates.
<h4>Functions</h4>
<ul>
<li>
<code>function c2c_get_author_image( $args = array() )</code> 
Gets the image and/or name for an author.
</li>
<li>
<code>function c2c_the_author_image( $before = '', $after = '', $image_dir = '', $width = '', $height = '' )</code> 
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).
</li>
<li>
<code>function c2c_wp_list_authors_images( $args = '' )</code> 
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).
</li>
</ul>
This displays the image associated with a post’s categories.
<h4>Arguments</h4>
<ul>
<li>
<code>$before</code> 
Optional argument. The text and/or HTML to appear before the author image/text, if any such text would be returned.
</li>
<li>
<code>$after</code> 
Optional argument. The text and/or HTML to appear after the author image/text, if any such text would be returned.
</li>
<li>
<code>$image_dir</code> 
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.
</li>
<li>
<code>$width</code> 
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.
</li>
<li>
<code>$height</code> 
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.
</li>
<li>
<code>$author_id</code> 
Optional argument. The id of the author. If null, then gets the author for the current post. Default is null.
</li>
<li>
<code>$args</code> (as used in <code>c2c_get_author_image()</code>) 
Optional argument. An array of configuration options.
<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>
<code>$args</code> (as used in <code>c2c_wp_list_authors_images</code>) 
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.
<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>
Show the author image for the current post’s author (must be “in the loop”)
</li>
<li>
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)
</li>
<li>
List all authors in the sidebar
<ul>
</ul>
</li>
<li>
Change some default options when listing authors
<ul>
 false, ‘show_name_if_no_image’ => true)); ?>
</ul>
<h3>Filters</h3>
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.
</li>
</ul>
<h4>c2c_get_author_image (filter)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_get_author_image()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php $image = c2c_get_author_image( array( 'show_name' => false ) ); ?>
</code></pre>
Do:
<pre><code> <?php $image = apply_filters( 'c2c_get_author_image', array( 'show_name' => false ) ); ?>
</code></pre>
<h4>c2c_get_the_author_image (filter)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_get_the_author_image()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php $image = c2c_get_the_author_image(); ?>
</code></pre>
Do:
<pre><code> <?php $image = apply_filters( 'c2c_get_the_author_image', ''); ?>
</code></pre>
<h4>c2c_the_author_image (action)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_the_author_image()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php c2c_the_author_image( '', '', '/images' ); ?>
</code></pre>
Do:
<pre><code> <?php echo do_action( 'c2c_the_author_image', '', '', '/images' ); ?>
</code></pre>
<h4>c2c_wp_list_authors_images (action)</h4>
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.
Arguments:
<ul>
<li>same as for c2c_wp_list_authors_images()</li>
</ul>
Example:
Instead of:
<pre><code> <?php echo c2c_wp_list_authors_images( array( 'hide_empty' => false ) ); ?>
</code></pre>
Do:
<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.

Kybernetik Services

Martin Stehle

WP Cool Tools

Make up custom-tailored preview lists of your website’s contents easily and place them in widget areas and post contents.
Promote your website’s content with many kinds of post lists. No programming skills are necessary. No fiddling with templates. With just a few keyboard entries and clicks you get a customized posts list.
The plugin Ultimate Post List for WordPress gives you an easy-to-use toolbox to make lists of posts. You can insert the lists
<ul>
<li>as widgets in every widget area per drag’n’drop easily</li>
<li>via configurable shortcodes in every post content</li>
<li>via calls of the function upl_get_html() in PHP code</li>
</ul>
You can switch between a vertical list layout or a responsive grid layout. A few options help you to get a nice layout without any need to code.
You can filter the posts by their post type “Post” or/and “Page” and by multiple categories. For filtering by custom post types check out <a href="https://www.kybernetik-services.com/shop/wordpress/plugin/ultimate-post-list-pro/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=ultimate-post-list&utm_content=update-notice-readme" rel="nofollow ugc">Ultimate Post List Pro</a>.
You can switch on a “Load more posts” link or button which loads further posts without leaving the page. Its text is controlled easily for you.
The plugin is multi-widget capable. That is, you can have several widgets of Ultimate Post List on your blog, each with its own settings!
You can clone (duplicate, copy) every list with a single click on the action link.
The plugin is available in English, German (Deutsch) and Greek (Ελληνικά). It does not collect any personal data, so it is ready for EU General Data Protection Regulation (GDPR) compliance.
<h4>Demo</h4>
You want to test Ultimate Post List before installing on your site? Try it out on your individual and free dummy site and <a href="https://demo.tastewp.com/ultimate-post-list" rel="nofollow ugc">click here</a>.
<h4>Options you can set</h4>
The free version of Ultimate Post List offers you many options to type and click customized post lists easily. These are the options:
<ul>
<li>List Options
<ul>
<li>List Display Options
<ul>
<li>List Visibility</li>
<li>Text if no posts</li>
</ul>
</li>
<li>List Title Options
<ul>
<li>List title</li>
<li>URL of list title</li>
<li>HTML element of list title</li>
</ul>
</li>
</ul>
</li>
<li>Post List Options
<ul>
<li>Post List Options In General
<ul>
<li>Number of posts</li>
<li>Posts offset</li>
<li>Hide current viewed post in list</li>
<li>Show sticky posts on top of the list</li>
</ul>
</li>
<li>Posts Sort Order
<ul>
<li>Order by
<ul>
<li>Post date</li>
<li>Post title</li>
<li>Post author</li>
</ul>
</li>
<li>Order direction
<ul>
<li>Ascending</li>
<li>Descending</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li>Post Filter Options
<ul>
<li>Post Type Filter
<ul>
<li>Show posts of selected types: posts or/and pages</li>
</ul>
</li>
<li>Category Filter
<ul>
<li>Show posts of selected categories only</li>
<li>Show only posts that are in all selected categories</li>
</ul>
</li>
</ul>
</li>
<li>Post List Item Options
<ul>
<li>Post Data Order
<ul>
<li>Position of post thumbnail</li>
<li>Position of post title</li>
<li>Position of post date</li>
<li>Position of post author name</li>
<li>Position of post excerpt</li>
</ul>
</li>
<li>Post Display Options
<ul>
<li>Show post thumbnail (default)</li>
<li>Show post title (default)</li>
<li>Show post date</li>
<li>Show post author name</li>
<li>Show post excerpt</li>
</ul>
</li>
<li>Post Links Options
<ul>
<li>Set post title clickable (default)</li>
<li>Set post thumbnail clickable (default)</li>
<li>Set post date clickable, pointing to the month archive</li>
<li>Set post author clickable, pointing to the author’s archive</li>
<li>Set post excerpt clickable</li>
<li>Open post links in new windows</li>
</ul>
</li>
<li>Post Title Options
<ul>
<li>Maximum length of post title</li>
<li>Text after shortened title</li>
</ul>
</li>
<li>Post Date Options
<ul>
<li>Format of the post date (over 100 options available)</li>
</ul>
</li>
<li>Post Thumbnail Options
<ul>
<li>Source of the post thumbnail
<ul>
<li>Featured image</li>
<li>First post content image if previously uploaded to the media library</li>
<li>Featured image if the first post content image is not available</li>
<li>First post content image if the featured image is not available</li>
<li>Avatars of post authors</li>
</ul>
</li>
<li>Use post title as the alternative text for the thumbnail</li>
<li>Use default thumbnail if no image could be ascertained
<ul>
<li>URL of default thumbnail</li>
<li>Thumbnail size </li>
</ul>
</li>
<li>Width of thumbnail in px</li>
<li>Height of thumbnail in px</li>
<li>Use aspect ratios of original images</li>
<li>Alignment of thumbnail
<ul>
<li>Align left</li>
<li>Align center</li>
<li>Align right</li>
</ul>
</li>
<li>Top image margin width in px</li>
<li>Bottom image margin width in px</li>
<li>Left image margin width in px</li>
<li>Right image margin width in px</li>
<li>Flow of text at the thumbnail (wrap right/left or side by side)</li>
</ul>
</li>
<li>Post Excerpt Options
<ul>
<li>Maximum length of post excerpt</li>
<li>Text after shortened excerpt</li>
<li>Ignore post excerpt field as excerpt source</li>
<li>Ignore post content as excerpt source</li>
</ul>
</li>
</ul>
</li>
<li>“More” Element Options
<ul>
<li>“More” Element Appearance
<ul>
<li>Show a clickable “More” element for loading further list items at the bottom of the list</li>
<li>“More” element type
<ul>
<li>Show element as a link</li>
<li>Show element as a button</li>
</ul>
</li>
<li>Label of “More” element</li>
<li>Show icon while new posts are loaded</li>
<li>Icon style
<ul>
<li>Small icons
<ul>
<li>Small gray circle with rotating dot</li>
<li>Small turning wheel</li>
</ul>
</li>
<li>Big icons
<ul>
<li>Big gray circle with rotating dot</li>
<li>Big turning wheel</li>
</ul>
</li>
</ul>
</li>
<li>Text that appears when no further posts have been found</li>
</ul>
</li>
</ul>
</li>
<li>List Layout Options
<ul>
<li>List Layout Type: vertical list or responsive grid</li>
<li>Grid item width in px</li>
<li>Minimal height of grid item in px</li>
<li>List Item Margin Options
<ul>
<li>Top item margin in px</li>
<li>Bottom item margin in px</li>
<li>Left item margin in px</li>
<li>Right item margin in px</li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Additional options in the Pro version</h4>
The Pro version has all the options of the free version and many additional options for layouts, numbered lists, colors, custom post types and much more. <a href="https://www.kybernetik-services.com/plugins/ultimate-post-list-pro/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=ultimate-post-list&utm_content=update-notice-readme" rel="nofollow ugc">Go to Ultimate Post List Pro</a>.
Pro users get premium support whilst free support is offered in the WordPress forums in our spare time.
<h4>Support</h4>
Support for this plugin will be provided in the form of Product Support. This means that we intend to fix any confirmed bugs, listen to ideas for this plugin and improve the user experience when enhancements are identified and can reasonably be accommodated.
Pro users get premium support whilst free support is offered in the WordPress forums in our spare time. If you are having trouble with this plugin in your particular installation of WordPress, we will not be able to help you troubleshoot the problem.

Ultimate Post List

Make up custom-tailored preview lists of the contents easily and place them in widget areas and post contents.

Author Image(s) vs Ultimate Post List