內容簡介
本外掛可顯示文章作者的圖像（若有）和/或名稱，或是網誌上所有作者的資訊。您可以在 index.php（以及其他文章範本）中使用 <?php c2c_the_author_image(); ?> 來顯示文章作者的圖像（置於「迴圈」內），以替代 <?php the_author() ?> 或 <?php get_avatar(); ?>。您可以在網誌的側邊欄使用 <?php c2c_wp_list_authors_images(); ?> 以替代 <?php wp_list_authors(); ?> 來列出所有作者的圖像和/或名稱。此外，本外掛還提供了簡單的小工具列出作者。當尋找圖像和/或名稱時，流程如下：
若帖子定義了「作者圖像」自訂欄位，則外掛會檢查其值是否是已定義圖像目錄中有效的圖像名稱。如果不是，則逐一加入定義圖像副檔名，然後檢查圖像能否被找到。
如果目前尚未找到任何圖像，則外掛會在圖像目錄中尋找以作者登入名稱命名且副檔名符合定義圖像副檔名之檔案。
如果目前尚未找到任何圖像，則外掛會在圖像目錄中尋找以作者 ID 命名且副檔名符合定義圖像副檔名之檔案。
如果目前尚未找到任何圖像，且啟用了 Gravatar 支援，則請求 Gravatar 提供與作者相關聯的頭像（基於作者的電子郵件地址）。
如果目前尚未找到任何圖像，且定義了空白/一般圖像，則將其作為作者頭像使用。
如果找到圖像，且「也顯示作者名稱？」設定為 true，或者未找到作者圖像且「若有找到作者圖像則顯示作者名稱？」設定為 true，則會附加/使用作者名稱。
其他注意事項：
外掛的管理選項頁面可讓您控制作者名稱是否應該與作者圖像一同顯示，如果未找到作者圖像是否仍需顯示作者名稱、圖像目錄、支援的圖像副檔名，以及您想要哪些作者圖像連結到哪裡。
由 c2c_the_author_image() 輸出的圖像定義為 class=”author_image”，供樣式表操作。
由 c2c_wp_list_authors_images() 輸出的圖像定義為 class=”list_author_image”，供樣式表操作。
技巧提示： 您可以利用 $image_dir 參數在不同情境下顯示不同的作者圖像，例如將圖像放在不同的目錄中「wp-content/images/authors/small/」和「wp-content/images/authors/large/」，然後根據情境決定從哪裡獲取圖像。更多資訊請參閱本外掛的網站、WordPress 外掛目錄和作者主頁。本外掛提供三個可選的模板標籤供您在佈景模板中使用。
外掛標籤
開發者團隊
原文外掛簡介
Display image (if present) and/or name for the author of a post, or for all authors on the blog.
Use as a replacement for or in index.php (and/or any other post templates) to display an image for a post’s author (inside “the loop”)
Use as a replacement for 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:
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.
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.
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.
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).
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.
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.
Additional notes:
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.
Images output by c2c_the_author_image() are defined with class=”author_image” for stylesheet manipulation
Images output by c2c_wp_list_authors_images() are defined with class=”list_author_image” for stylesheet manipulation
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: Plugin Homepage | Plugin Directory Page | Author Homepage
Template Tags
The plugin provides three optional template tags for use in your theme templates.
Functions
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.
Arguments
$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.
author_id : default of current post author; the id of the author to get the image for
before : default of ”; text to show before each author
after : default of ”; text to show after each author
image_dir : default of ”; directory containing author images, relative to wp-content directory
width : default of ”; width to display image
height : default of ”; height to display image
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?
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)
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?
class : default of ”; array or string of classes to apply to author image tag
use_gravatar : default of plugin settings; should Gravatar be consulted for an author image if no local image for the author was found?
$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.
optioncount : default of false;
exclude_admin : default of true; should the admin user be excluded from the listing?
hide_empty : default of true; should authors who have not made any posts be excluded from the listings?
feed : default of ”
feed_image : default of ”
echo : default of true; should the listing be echoed to the page?
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?
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)
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?
before : default of ”; text to show before each author
after : default of ”; text to show after each author
image_dir : default of ”; directory containing author images, relative to wp-content directory
width : default of ”; width to display image
height : default of ”; height to display image
class : default of ”; array or string of classes to apply to author image tag
use_gravatar : default of plugin settings; should Gravatar be consulted for an author image if no local image for the author was found?
Examples
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
false, ‘show_name_if_no_image’ => true)); ?>
Filters
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.
c2c_get_author_image (filter)
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:
same as for c2c_get_author_image()
Example:
Instead of:
false ) ); ?>
Do:
false ) ); ?>
c2c_get_the_author_image (filter)
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:
same as for c2c_get_the_author_image()
Example:
Instead of:
Do:
c2c_the_author_image (action)
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:
same as for c2c_the_author_image()
Example:
Instead of:
', '', '/images' ); ?>
Do:
', '', '/images' ); ?>
c2c_wp_list_authors_images (action)
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:
same as for c2c_wp_list_authors_images()
Example:
Instead of:
false ) ); ?>
Do:
false ) ); ?>
