WordPress.org

1. Download the plugin.

2. Unzip.

3. Upload "post-avatar" directory to your plugin folder (/wp-content/plugins).

4. Activate the plugin from the Plugin Management screen.

5. Set plugin options in Options - Post Avatar.

   • Path to Images Folder - location of your images folder in relation to your WordPress installation.

   • Show image in Write Post Page - Place a tick mark if you want to see a thumbnail of the post avatar in the Write Post screen.

   • Scan the images directory and its sub-directories - Place a tick mark if you want to list all images including those in sub-directories of the image folder.

   • Show avatar in post - Place a tick mark to show avatar automatically on your blog post. Disable to use the template tag.

   These options help you further customize the display of your post avatar

   • Customize HTML/CSS - These options help you customize the look of your post avatar

   1. Before and After HTML - enter the HTML you want to display before and after the post avatar. Example: Before: / After: Output:

   2. CSS Class - enter the name of the css class that you would like to associate with the post avatar image. Can be left blank. Example: The class name is: postimage Output:

   If you use both the css class and the before and after html you will get the following output:

   • Others

   1. Get image size? - Turned on by default to determine the image's width and height. If you encounter any getimagesize errors, turn this feature off.

   2. Show in feeds? - Turned off by default. Check this option to display post avatars in your RSS feeds.

Upgrading

From versions lower than 1.2 down: If you are upgrading from previous versions of Post Avatar, deactivate and activate the plugin to enable role capabilities. If you don't do this, even administrators will not be able to select avatars.

Usage

A. UPLOAD IMAGES

Upload the images that you intend to use to the folder defined in the Post Avatar options.

B. ADDING AN AVATAR TO A POST

1. To add an image to a post, go to the Post Avatar section. For versions older than WordPress 2.5, the post avatar selection box is below the Custom Fields. For WordPress 2.5 and 2.6, the selection box is below the Categories. In WordPress 2.7 the selection box is below the Excerpt but you can move it to a different location.

2. Select the image name from the list.

3. Save your entry.

For Theme Developers

For improved integration with third-party WordPress themes, Post Avatar has two additional tags to help producing custom output in additional functions.

In case users automatic display of avatars set to on, use the tag: gkldevoverride(true); Place at the start of your theme's functions.php

To produce your own output with post avatar data, use the function: gklgetpostavatar(); This lets you create a array containing the url to the avatar, image height and width, post title, post id and boolean value to let you know if the getimagesize option has been turned on or not.

Please visit the Post Avatar Page for details on customizing the avatar display.