Post Avatar

1. 

   Post Avatar meta box in the Post Editor.

2. 

   Post Avatar settings page.

Installation Instructions

Manual Installation

1. After downloading the zip file from WordPress.org, extract the contents onto your computer. This will create a folder, post-avatar, containing the plugin files.
2. Connect to your webserver and upload the post-avatar folder to where your plugins are installed, typically, /wp-content/plugins.
3. To activate the plugin go to the Plugins menu in your WordPress admin. Click “Activate” for the “Post Avatar” plugin

Automatic Installation

1. From the Plugins menu, click Add New and search for Post Avatar
2. Click “Install Now” so that WordPress will download and install the plugin
3. Once the installation is complete, you will be asked to click Activate Plugin

See Also: “Installing Plugins” article on the WP Codex

Upgrading

The Plugins section of your WordPress admin provides notification if there are new updates for the plugin.

For a manual upgrade, delete the folder post-avatar from the plugins folder and follow the new installation instructions.

For automatic upgrade, click on ** Upgrade Now**.

Configuration

You can change default options by going to the Post Avatar link in the Settings menu at your WordPress admin.

• Path to Images Folder – location of your images folder in relation to your WordPress installation. Defaults to wp-content/uploads.

• Show avatar in post? Disable to use template tag. – Tick this so that the chosen post avatar will be automatically displayed in your post, just prior to your post content. Enabled by default.

• Scan the images directory and its sub-directories – Tick this to include images stored in sub-directories of the images folder during the avatar selection. Enabled by default.

• Get image dimensions? Disable this feature if you encounter getimagesize errors – Turned on by default, a tick mark here will determine the image’s width and height. If you encounter any getimagesize errors, turn this feature off.

• Show post avatars in RSS feeds? – Turned off by default, place a tick mark here to include avatars in your RSS feeds.

• Customize HTML/CSS – These options help you further customize how post avatars will look.

  A. Use this HTML before/after the post avatar image – Enter the HTML code that will wrap around the image. Can be left blank. The plugin defaults to <div class="postavatar"></div>.

  Example: Before: <div class="myimage"> / After: </div>
  Output: <div class="myimage"><img src="http://mydomain.com/images/chosen-image.jpg" height="120" width="180" alt="post-title" /></div>

  B. CSS Class – Define the CSS class associated with the post avatar image. Can be left blank. It is empty by default.

  Example: The class name is: postimage
  Output: <img class="postimage" src="http://mydomain.com/images/chosen-image.jpg" height="120" width="180" alt="post-title" />

Using both HTML and CSS class will result in the following output:

The “Advanced Customization” section of this readme has more advanced customization tips.

Usage

UPLOAD IMAGES

The plugin does not handle image uploads. You will need to use your FTP or a file manager to upload photos. There are also a number of plugins that handle file uploads

Upload images, using your preferred upload method, to the folder defined in the Post Avatar settings page.

ADDING AN AVATAR TO A POST

1. Go to the Post Editor screen. Below the content text area you will find the Post Avater section.

2. Select the image name from the dropdown list. You can also use the next and previous arrow buttons on either side of the dropdown to scroll through images.

3. Once you’ve made your selection, click Publish for a new post or Update for a previously saved one.

Can I upload images with the Post Avatar plugin?

No. Post Avatar does not support image uploads. It simply looks up the list of images that you’ve defined in the plugin settings. Images will need to be transferred via FTP or a file manager.
However, there are a few workarounds:
1. Make your image folder the same as your WordPress uploads folder to include images from the Media Library in the Post Avatar list. Or,
2. Install a plugin that will let you upload images to a folder other than the WordPress uploads folder.

How is Post Avatar different from Featured Images?

Post Avatar pre-dates Featured Images by 3 years and while both attach an image to a post, Post Avatar makes use of the same images while Featured Images is more for a unique image.

I designed Post Avatar so I can select images right from the Post Editor screen.
Also, I prefer to use images with smaller dimensions (usually 250px by 250px and lower).
Post Avatar is more efficient when used with a relatively short list of images (anything in the range of more thousands of images and I suggest you stay with Featured Images).

I’m new to WordPress. How can I change the styling of the image I’ve chosen?

You can make use of the HTML/CSS options in the Post Avatar settings page to make sure that the image’s look is in line with your theme. See Configuration options.

Can I have multiple Post Avatar boxes for different folder locations in the Editor screen?

No. Post Avatar only displays a single list of images scanned from the folder you specified in the Post Avatar settings screen.

Can I use Post Avatar with custom post types?

Not by default. If you’re comfortable with editing your theme’s function.php file you can use the custom filter ‘gklpa_allowed_post_types’ to enable the Post Avatar functionality on custom post types and pages. Please see the Developer section for more details

1.6

• 03/31/2015
• Version Upgrade: Minimum supported version is now 3.9
• Fixed: Javascript bug that prevented cycling forward to the start of image list (Uncaught TypeError: Cannot read property ‘text’ of undefined).
• Added: Custom filter to allow displaying Post Avatar meta boxes on post types other than posts.
• Added: Custom filters to control image list and post avatar display.
• Added: Translations for Serb-Croatian, Romanian and Hindi. Thanks to Borisa Djuraskovic, Alexander Ovsov and Chandel
• Added: Upgrade facility to convert plugin options and handle future database/feature changes
• Revised: Changed plugin options into a single array.
• Revised: Changed plugin settings to use the Settings API.
• Deprecated: gkl_check_phpself(), gkl_validate_checked().
• General code refactoring in keeping with good practices e.g. common prefix labels, using appropriate hooks for enqueuing styles and scripts

1.5.1

• 02/04/2013
• Fixed: Improved SEO for alt tag by removing titles with dashes. Now uses escaped text.

1.5

• 05/11/2012
• Fixed: Performance issue resulting in “Maximum execution time” errors or slow loading page or footer scripts not working properly. Bug was caused by missing image folder.
• Revised: Change the hook where stylesheets are included. Using wp_enqueue_scripts instead of wp_print_styles.
• Revised: Using wp_localize_script() for JavaScript variables. Removed gkl_admin_head().
• Revised: Logic change for enqueing of scripts in gkl_display_css().
• Revised: Moved loading of plugin text domain to gkl_init().
• Added: esc_attr() to all settings.
• Removed: unneccessary option gklpa_showinwritepage.

1.4.2

• 07/13/2011
• Added: Gaellic translation. Thanks to Ray.
• Fixed: Exclude revisions from post avatar saving routine

1.4.1

• 06/27/2011
• Fixed: Spaces in image filenames were being removed by esc_url.

1.4

• 06/20/2011
• Added: Improved security checks when saving post meta data and options as well as displaying data.
• Added: Activation hook to process capabilities and default options
• Added: Improved compatibility with WordPress 3.0 and above.
• Deprecated functions: gkl_unescape_html and gkl_dev_override
• Notice: This will be the last version to support PHP 4

1.3.2

• 04/13/2011
• Added: Polish translation. Thanks to Meloniq.
• Fixed: Duplication of post avatar when “apply_filters” tag is used in other plugins.
• Fixed: Improved data validation. Now using wp_kses when validating HTML.

1.3.1

• 08/23/2010
• Added: French translation. Thanks to Mathieu Haratyk.

1.3

• 05/14/2010
• Version Upgrade: Removed usage of deprecated WordPress functions. This version supports WordPress 2.8 and greater.

1.2.7.1

• 03/11/2010
• Added: Spanish translation. Thanks to gogollack.
• Added: Czech translation. Thanks to Lelkoun.

1.2.7

• 02/12/2010
• Fixed: IE preview problems when reselecting an image. Thanks spedney
• Fixed: removed border=”0″ in image display for XHTML compliance. Thanks Jay August

1.2.5.4

• 08/21/2009
• Added: Dutch translation. Thanks to Jay August.

1.2.5.3

• 08/06/2009
• Added: Belorussian translation. Thanks to Fat Cower

1.2.5.2

• 06/02/2009
• Added: Italian translation. Thanks to Gianni Diurno

1.2.5

• 12/15/2008)
• Fixed: Incorrect display of css class
• Fixed: Bugs in image display (height/width switched up)
• Fixed: “Cannot modify header information” errors when saving posts when plugin is used in conjunction with search unleashed plugin
• Added: Theme developer override option for automatic avatar display
• Added: template tag gkl_get_postavatar, to return post avatar data in an array.

1.2.4

• 03/31/2008
• Added: Slideshow effect to navigate for next and previous images
• Fixed: Display of avatar in Write Post page and navigation effects work in IE6+
• Added: HTML for meta boxes in WordPress 2.5+
• Added: Option to include avatars in RSS feeds

1.2.3

• 10/06/2007
• Added: Role capabilities that allow admins, editors and authors to post avatars
• Added: HTML and CSS classes inside the options page
• Added: Include automatic avatar display in post excerpts
• Added: Option to display image dimensions
• Fixed: Stop avatars from displaying in feeds

1.2.2

• 02/12/2007
• Fixed: Additional checks in updating posts to make sure that comment posting don’t delete post avatars

1.2.1

• 01/11/2007
• Added: Compatibility for WordPress 2.1
• Added: Option to display image automatically without have to use template tag

1.2

• 12/09/2006
• Added: Scan subdirectories for images
• Added: Created external scriptfile to make extending script easier
• Added: Check if PHP_SELF contains substring (for subdomain installations)
• Fixed: Improved image display in Write Post screen
• Added: Check image existence using absolute path instead of url (for those without Allow_url_fopen)

1.1

• 09/06/2006
• Added: Live preview of avatar in Write Post screen (tested in Mozilla)
• Fixed: gkl_postavatar template tag produces correct (X)HTML
• Speed optimization
• Improved parameters ($before, $after, $class)
• Added: Translation support

1.0

• 08/26/2006
• Initial release