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.

Ben Casey

Kelli Standish

So you’ve got an amazing book, and you want an easy way to market it on your web site? Now you can! The TotallyBooked plugin helps you present your books to readers in a classy, appealing way, while also supporting the book buyers and local bookstores who carry your book.
<h3>HOW IT WORKS:</h3>
Add your books to the TotallyBooked plugin, then organize them by genre, series, or even by author (if you have a co-writer).
Find the direct links to your book for eleven major online booksellers (Amazon, Audible, Barnes & Noble, Books-A-Million, Christianbook, Google Play, Indiebound, iTunes, Kobo, Smashwords, and Sony Reader Store) and paste them in our link boxes.
Wondering why we’ve included all these sellers rather than just an Amazon button? Because book buyers at some of these sellers will refuse to stock your books, if you don’t have a link to their site included on yours. We want to make sure that doesn’t happen to you.
Have an affiliate account at one or more of these sites? No problem. Build your affiliate link in the bookseller’s system first, then paste it into the applicable box in our system, and start earning affiliate credit immediately.
Once you’re done, our plugin generates a gorgeous Buy this Book section, with all your bookseller links displayed.
And that’s not all. We’ve heard first-hand stories from authors about local bookstores refusing to host book-signing events, because that author only included links to online retailers on their site. To protect you from that, our system also generates a local bookstore search, connected directly to Google maps. This shows your support for local bookstores, and helps readers find a nearby store where they can buy or request your title.
Last, our system automatically generates a page for each of your books, plus a page for each series, and page for each genre.
<h3>WHAT IF I ALREADY HAVE BOOKS PAGES ON MY SITE?</h3>
Many authors have already created pages on their web site for their books. We know you’ve worked hard to build your existing pages, and we don’t think you should have to delete them all, just to use our system. Plus, deleting your existing pages will break any inbound links to those pages from reviewers, book bloggers, etc, and generate 404 page errors for the search engines. THAT is never a good thing.
Besides the auto-generated pages the plugin creates, our system also allows you to embed your books via shortcode, on your existing pages. You can embed your books by series, by genre, or book by book, on any of your existing pages or in a blog post.
Ready to get started? Click the download button now. Have comments or feature requests? <a href="http://www.tigerstrikemedia.com/contact-us/" rel="nofollow ugc">We’d love to hear from you</a>. Oh, and our premium version of this plugin is releasing soon. Watch this space for details.
<h3>Shortcodes</h3>
You can use the following shortcodes to display your books on your site.
You can also display a gallery of a genre with the shortcode (You can grab this directly from the genre list page) 
 [tb_genre_gallery slug=”the-genre-slug”]
Or a series with the shortcode (You can grab this directly from the series list page) 
 [tb_series_gallery slug=”the-series-slug”]
You can display a book anywhere on your site like this (You can grab this directly from the book edit page) 
 [tb_book id=”ID”]
<h3>Advanced Usage</h3>
We have developed Totally Booked from the ground up to be friendly and easy to use for both developers (Or your web guy) and authors who have better things to do (like writing the next national bestseller!) than to mess with plugins and settings on their website for hours or days on end.
Out of the box it just works (If it doesn’t, please <a href="http://www.tigerstrikemedia.com/contact-us/" rel="nofollow ugc">Let Us Know</a>) but if you want to change things, you can by taking advantage of the following advanced functionality.
<h3>Templating</h3>
Advanced users or WordPress programmers can completely template the entire frontend output of the plugin.
Simply create the following directory in your current theme: <code>THEME_PATH/plugins/totally-booked/</code>
Into that, copy the file you need to modify into the above directory from the <code>totally-booked/templates</code> directory in the plugin directory, ensuring you keep the directory structure in the plugin.
EG: Say you wanted to modify the <code>gallery.php</code> file, you would need to copy that file to <code>THEME_PATH/plugins/totally-booked/loops/gallery.php</code>.
Ensuring that you never modify the plugins files will make sure that your changes are not lost when you need to upgrade the plugin.

Totally Booked

Turn your website into a book marketing machine! TotallyBooked allows you to add books, purchase buttons, and extras to your site in minutes.

Author Image(s) vs Totally Booked