Display image (if present) and/or name for the author of a post, or for all authors on the blog.
Display image (if present) and/or name for the author of a post, or for all authors on the blog.
Use <?php c2c_the_author_image(); ?>
as a replacement for <?php the_author() ?>
or <?php get_avatar(); ?>
in index.php (and/or any other post templates) to display an image for a post’s author (inside “the loop”)
Use <?php c2c_wp_list_authors_images(); ?>
as a replacement for <?php wp_list_authors(); ?>
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:
Additional notes:
c2c_the_author_image()
are defined with class=”author_image” for stylesheet manipulationc2c_wp_list_authors_images()
are defined with class=”list_author_image” for stylesheet manipulationTip:: 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: Plugin Homepage | Plugin Directory Page | Author Homepage
The plugin provides three optional template tags for use in your theme templates.
function c2c_get_author_image( $args = array() )
Gets the image and/or name for an author.
function c2c_the_author_image( $before = '', $after = '', $image_dir = '', $width = '', $height = '' )
A drop-in replacement for WordPress’s the_author()
, allowing the author for the post to have an image displayed in lieu of the name (if an image can be found).
function c2c_wp_list_authors_images( $args = '' )
A drop-in replacement for WordPress’s wp_list_authors()
, allowing all authors for a blog to be listed with an image (if present).
This displays the image associated with a post’s categories.
$before
Optional argument. The text and/or HTML to appear before the author image/text, if any such text would be returned.
$after
Optional argument. The text and/or HTML to appear after the author image/text, if any such text would be returned.
$image_dir
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.
$width
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.
$height
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.
$author_id
Optional argument. The id of the author. If null, then gets the author for the current post. Default is null.
$args
(as used in c2c_get_author_image()
)
Optional argument. An array of configuration options.
$args
(as used in c2c_wp_list_authors_images
)
Optional argument. An array of configuration options. All but the last two match up with the supported arguments of the wp_list_authors()
function.
''
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?Show the author image for the current post’s author (must be “in the loop”)
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)
List all authors in the sidebar
Change some default options when listing authors
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.
The ‘c2c_get_author_image’ hook allows you to use an alternative approach to safely invoke c2c_get_author_image()
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:
c2c_get_author_image()
Example:
Instead of:
<?php $image = c2c_get_author_image( array( 'show_name' => false ) ); ?>
Do:
<?php $image = apply_filters( 'c2c_get_author_image', array( 'show_name' => false ) ); ?>
The ‘c2c_get_the_author_image’ hook allows you to use an alternative approach to safely invoke c2c_get_the_author_image()
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:
c2c_get_the_author_image()
Example:
Instead of:
<?php $image = c2c_get_the_author_image(); ?>
Do:
<?php $image = apply_filters( 'c2c_get_the_author_image', ''); ?>
The ‘c2c_the_author_image’ hook allows you to use an alternative approach to safely invoke c2c_the_author_image()
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:
c2c_the_author_image()
Example:
Instead of:
<?php c2c_the_author_image( '<span class="author">', '</span>', '/images' ); ?>
Do:
<?php echo do_action( 'c2c_the_author_image', '<span class="author">', '</span>', '/images' ); ?>
The ‘c2c_wp_list_authors_images’ hook allows you to use an alternative approach to safely invoke c2c_wp_list_authors_images()
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:
Example:
Instead of:
<?php echo c2c_wp_list_authors_images( array( 'hide_empty' => false ) ); ?>
Do:
<?php echo do_action( 'c2c_wp_list_authors_images', array( 'hide_empty' => false ) ); ?>
author-images.zip
inside the /wp-content/plugins/
directory (or install via the built-in WordPress plugin installer)<?php c2c_the_author_image(); ?>
and/orc2c_the_author_image()
, and/or add the class “list_author_image” to your CSS file to control the display of the images listed by c2c_wp_list_authors_images()
.Currently this plugin does not facilitate the uploading of images. It assumes you’ve already managed to get the author images onto your server into the appropriate directories.
Yes, called “Author Image(s)”.