Vicky Arulsingam

Allow authors to select an image from a pre-defined list while in the Post Editor screen. This image will be displayed together with a post.
Post Avatar is similar in concept to Livejournal userpics wherein authors choose images uploaded by the site owner. Developed with Dominik Menke.
<h4>Features</h4>
<ul>
<li>Easy selection of images from within the Post Editor screen.</li>
<li>Scans images in sub-directories of the image option folder.</li>
<li>Allows the following file types: .jpg, .jpeg, .gif and .png.</li>
<li>Flexible with customizing avatar display.
<ul>
<li>Display avatars using the default HTML/CSS tags.</li>
<li>HTML/CSS tags can be edited from with the Settings screen.</li>
<li>Use template tags and custom filters within themes for advanced customization.</li>
</ul>
</li>
<li>International language support for Belorussian, Czech, Dutch, French, German, Hindi, Irish, Italian, Polish, Romanian, Serbo-Croatian, Spanish</li>
<li>Does not display missing images.</li>
<li>Can be further extended to show images for pages and custom post types</li>
</ul>
<h4>Bug Submission and Forum Support</h4>
<a href="https://wordpress.org/support/plugin/post-avatar/" rel="ugc">WordPress Forum</a>
<a href="http://garinungkadol.com/plugins/post-avatar/support/" rel="nofollow ugc">Post Avatar home page</a>
<h4>Please Vote and Review</h4>
Your votes and feedback are greatly appreciated. Thanks.
<h3>Advanced Customization</h3>
<h4>For Front End Display</h4>
By default, the plugin hooks into the following filters: <a href="https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content" rel="nofollow ugc">the_content()</a> and <a href="https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content" rel="nofollow ugc">the_excerpt()</a>.
OVERRIDE HTML DISPLAY USING FILTER HOOK: gklpa_the_postavatar
The <code>gklpa_the_postavatar</code> filter takes two parameters:
<ol>
<li>
<code>$post_avatar_text</code> – Original HTML display
</li>
<li>
<code>$post_avatar</code> – Post Avatar data in array format. The keys are:
<pre><code>avatar_url: The URL to the image 
show_image_dim: 1 indicates to show image dimensions, 0 to hide them 
image_height: integer value of image height or null if image dimensions is turned off 
image_width: integer value of image width or null if image dimensions is turned off 
post_id: ID of current post 
post_title: Post title for the image attribute 
image_name: Image file name
</code></pre>
</li>
</ol>
Example: Display a default image if no avatar is selected
This example makes use of the HTML/CSS settings defined by the site admin.
<pre><code> add_filter( 'gklpa_the_postavatar', 'prefix_show_default_image', 10, 2 );
 function prefix_show_default_image( $post_avatar_html, $post_avatar_array ){
 global $post, $gklpa_plugin_settings;

 // Display default image;
 if( is_null( $post_avatar_array ) ){
 if( !empty( $gklpa_plugin_settings['css_class'] ) {
 $css = 'class="' . $gkl_plugin_settings['css_class']. '"';
 }
 $post_avatar_html = $gklpa_plugin_settings['html_before' ] . '<img '. $css . ' src="http://wplatest.dev/images/default-image.jpg" alt="' . esc_attr(strip_tags($post->post_title) ) . '" />'. $gklpa_plugin_settings['html_after'];
 }
 return $post_avatar_html;
 }
</code></pre>
OVERRIDE HTML DISPLAY WITH CUSTOM CONTENT HOOK
If you want to change the HTML completely or override the option to display avatars automatically, use the <a href="https://codex.wordpress.org/Function_Reference/remove_filter" rel="nofollow ugc">remove_filter()</a> like so: 
 remove_filter(‘the_content’, ‘gkl_postavatar_filter’, 99 ); 
 remove_filter(‘the_excerpt’, ‘gkl_postavatar_filter’, 99 );
You can then define your own <code>the_content</code> filter function that makes use of the <code>gkl_postavatar()</code> or <code>gkl_get_postavatar()</code> functions
You will need to use the function <code>gkl_get_postavatar()</code> which takes the post object and returns the array of post avatar information.
<ol>
<li>
<code>$post_avatar_array</code> – Post Avatar data in array format. The keys are:
<pre><code>avatar_url: The URL to the image

show_image_dim: 1 indicates to show image dimensions, 0 to hide them

image_height: integer value of image height or null if image dimensions is turned off

image_width: integer value of image width or null if image dimensions is turned off

post_id: ID of current post

post_title: Post title for the image attribute

image_name: Image file name
</code></pre>
</li>
</ol>
Example:
<pre><code> add_filter( 'the_content', 'my_custom_post_avatar' );
 function my_custom_post_avatar( $content ){
 global $post;

 $current_avatar = gkl_get_postavatar( $post );
 $html_before = '';
 $html_after = '';
 // Display default image
 if( is_null( $current_avatar ) ) {
 $image_url = 'http://wplatest.dev/images/default-image.jpg';
 $alt_text = esc_attr(strip_tags($post->post_title) );
 } else {
 $image_url = $current_avatar['avatar_url'];
 $alt_text = $current_avatar['post_title'];
 }
 $post_avatar_html = $html_before . '<img src="'. $image_url . '" alt="' . $alt_text . '" />'. $html_after;

 return $post_avatar_html; 
 }
</code></pre>
OVERRIDE HTML DISPLAY WITH template tag <code>gkl_postavatar</code>
If you want the post avatar to appear outside of the content, e.g. with the entry’s meta information, make use of the <code>gkl_postavatar()</code> template tag.
It takes four paramters:
<pre><code> class: CSS class to use in the `<img>` tag. 
 before: HTML to appear before the image. 
 after: HTML to appear after the image. 
 do_what: Use `echo` to display the post avatar, `return` to pass it to a variable. Defaults to `echo`.
</code></pre>
Example: In a template file:
<pre><code> <div class="entry-meta"> 
 <?php gkl_postavatar('', "", "" );?>

 -- more template tags here --
 </div>
</code></pre>
Or you can make your own template tag function like in the example for “Override HTML display with custom content hook”, except you call the function directly in your template instead of hooking into <code>the_content()</code>.
<h4>For Administration Screens</h4>
Add Post Avatar to Pages and Custom Post Types
Use the filter hook <code>gklpa_allowed_post_types</code> to add further post types that you want the Post Avatar selection to appear on.
It takes an array of post type slugs as a parameter.
<pre><code> add_filter( 'gklpa_allowed_post_types', 'prefix_my_custom_post_types' );
 function prefix_my_custom_post_types( $current_post_types ){
 $current_post_types = array( 'post', 'page', 'review', 'event' );
 return $current_post_types;
 }
</code></pre>
Enable Image Selection for Folder Outside of WordPress Installation
By default, Post Avatar looks for your images folder in relation to your WordPress installation. If you want to move your folder elsewhere, use these pair of filter hooks: <code>gklpa_image_url</code> and <code>gklpa_image_dir</code>. They take a single parameter: Image folder url and absolute path to the image folder, respectively.
<pre><code> add_filter( 'gklpa_image_url', 'prefix_change_folder_url' );
 function prefix_change_folder_url( $current_url ){
 return esc_url( 'http://mysite.com/images/' );
 }

 add_filter( 'gklpa_image_dir', 'prefix_change_folder_dir' );
 function prefix_change_folder_dir ){
 return '/user/public_html/images/';
 }
</code></pre>
Please visit the <a href="http://www.garinungkadol.com/plugins/post-avatar/" rel="nofollow ugc">Post Avatar Page</a> for details on customizing the avatar display.
<h4>Translations</h4>
Post Avatar is translation-ready and supports a number of languages. If you can’t find your language here, please consider contributing a language pack.
If you’re interested, please check out the <a href="https://wordpress.org/extend/plugins/codestyling-localization/" rel="ugc">“Codestyling Localization” plugin</a> and for validating the <a href="http://www.poedit.net/" rel="nofollow ugc">“Poedit Editor”</a>.
Send in your translations to vix@garinungkadol.com
Thanks to the following for their language packs.
<ul>
<li>Belorussian (ru_RU) Fat Cower</li>
<li>Czech (cz_CZ) Lelkoun</li>
<li>Dutch (nl_NL) Jay August</li>
<li>French (fr_FR) Mathieu Haratyk</li>
<li>German (de_DE) Dominik Menke</li>
<li>Hindi (hi_IN_Hindi) Outshine Solutions </li>
<li>Irish (ga_IR) Ray S.</li>
<li>Italian (it_IT) Gianni Diurno</li>
<li>Polish (pl_PL) Meloniq</li>
<li>Romanian (ro_RO) Webhosting Geeks</li>
<li>Serbo-Croatian (sr_RS) Webhosting Hub</li>
<li>Spanish (es_ES) gogollack</li>
</ul>

Post Avatar

Choose an avatar from a pre-defined list to include in a post.

Kybernetik Services

Martin Stehle

WP Cool Tools

Make up custom-tailored preview lists of your website’s contents easily and place them in widget areas and post contents.
Promote your website’s content with many kinds of post lists. No programming skills are necessary. No fiddling with templates. With just a few keyboard entries and clicks you get a customized posts list.
The plugin Ultimate Post List for WordPress gives you an easy-to-use toolbox to make lists of posts. You can insert the lists
<ul>
<li>as widgets in every widget area per drag’n’drop easily</li>
<li>via configurable shortcodes in every post content</li>
<li>via calls of the function upl_get_html() in PHP code</li>
</ul>
You can switch between a vertical list layout or a responsive grid layout. A few options help you to get a nice layout without any need to code.
You can filter the posts by their post type “Post” or/and “Page” and by multiple categories. For filtering by custom post types check out <a href="https://www.kybernetik-services.com/shop/wordpress/plugin/ultimate-post-list-pro/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=ultimate-post-list&utm_content=update-notice-readme" rel="nofollow ugc">Ultimate Post List Pro</a>.
You can switch on a “Load more posts” link or button which loads further posts without leaving the page. Its text is controlled easily for you.
The plugin is multi-widget capable. That is, you can have several widgets of Ultimate Post List on your blog, each with its own settings!
You can clone (duplicate, copy) every list with a single click on the action link.
The plugin is available in English, German (Deutsch) and Greek (Ελληνικά). It does not collect any personal data, so it is ready for EU General Data Protection Regulation (GDPR) compliance.
<h4>Demo</h4>
You want to test Ultimate Post List before installing on your site? Try it out on your individual and free dummy site and <a href="https://demo.tastewp.com/ultimate-post-list" rel="nofollow ugc">click here</a>.
<h4>Options you can set</h4>
The free version of Ultimate Post List offers you many options to type and click customized post lists easily. These are the options:
<ul>
<li>List Options
<ul>
<li>List Display Options
<ul>
<li>List Visibility</li>
<li>Text if no posts</li>
</ul>
</li>
<li>List Title Options
<ul>
<li>List title</li>
<li>URL of list title</li>
<li>HTML element of list title</li>
</ul>
</li>
</ul>
</li>
<li>Post List Options
<ul>
<li>Post List Options In General
<ul>
<li>Number of posts</li>
<li>Posts offset</li>
<li>Hide current viewed post in list</li>
<li>Show sticky posts on top of the list</li>
</ul>
</li>
<li>Posts Sort Order
<ul>
<li>Order by
<ul>
<li>Post date</li>
<li>Post title</li>
<li>Post author</li>
</ul>
</li>
<li>Order direction
<ul>
<li>Ascending</li>
<li>Descending</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li>Post Filter Options
<ul>
<li>Post Type Filter
<ul>
<li>Show posts of selected types: posts or/and pages</li>
</ul>
</li>
<li>Category Filter
<ul>
<li>Show posts of selected categories only</li>
<li>Show only posts that are in all selected categories</li>
</ul>
</li>
</ul>
</li>
<li>Post List Item Options
<ul>
<li>Post Data Order
<ul>
<li>Position of post thumbnail</li>
<li>Position of post title</li>
<li>Position of post date</li>
<li>Position of post author name</li>
<li>Position of post excerpt</li>
</ul>
</li>
<li>Post Display Options
<ul>
<li>Show post thumbnail (default)</li>
<li>Show post title (default)</li>
<li>Show post date</li>
<li>Show post author name</li>
<li>Show post excerpt</li>
</ul>
</li>
<li>Post Links Options
<ul>
<li>Set post title clickable (default)</li>
<li>Set post thumbnail clickable (default)</li>
<li>Set post date clickable, pointing to the month archive</li>
<li>Set post author clickable, pointing to the author’s archive</li>
<li>Set post excerpt clickable</li>
<li>Open post links in new windows</li>
</ul>
</li>
<li>Post Title Options
<ul>
<li>Maximum length of post title</li>
<li>Text after shortened title</li>
</ul>
</li>
<li>Post Date Options
<ul>
<li>Format of the post date (over 100 options available)</li>
</ul>
</li>
<li>Post Thumbnail Options
<ul>
<li>Source of the post thumbnail
<ul>
<li>Featured image</li>
<li>First post content image if previously uploaded to the media library</li>
<li>Featured image if the first post content image is not available</li>
<li>First post content image if the featured image is not available</li>
<li>Avatars of post authors</li>
</ul>
</li>
<li>Use post title as the alternative text for the thumbnail</li>
<li>Use default thumbnail if no image could be ascertained
<ul>
<li>URL of default thumbnail</li>
<li>Thumbnail size </li>
</ul>
</li>
<li>Width of thumbnail in px</li>
<li>Height of thumbnail in px</li>
<li>Use aspect ratios of original images</li>
<li>Alignment of thumbnail
<ul>
<li>Align left</li>
<li>Align center</li>
<li>Align right</li>
</ul>
</li>
<li>Top image margin width in px</li>
<li>Bottom image margin width in px</li>
<li>Left image margin width in px</li>
<li>Right image margin width in px</li>
<li>Flow of text at the thumbnail (wrap right/left or side by side)</li>
</ul>
</li>
<li>Post Excerpt Options
<ul>
<li>Maximum length of post excerpt</li>
<li>Text after shortened excerpt</li>
<li>Ignore post excerpt field as excerpt source</li>
<li>Ignore post content as excerpt source</li>
</ul>
</li>
</ul>
</li>
<li>“More” Element Options
<ul>
<li>“More” Element Appearance
<ul>
<li>Show a clickable “More” element for loading further list items at the bottom of the list</li>
<li>“More” element type
<ul>
<li>Show element as a link</li>
<li>Show element as a button</li>
</ul>
</li>
<li>Label of “More” element</li>
<li>Show icon while new posts are loaded</li>
<li>Icon style
<ul>
<li>Small icons
<ul>
<li>Small gray circle with rotating dot</li>
<li>Small turning wheel</li>
</ul>
</li>
<li>Big icons
<ul>
<li>Big gray circle with rotating dot</li>
<li>Big turning wheel</li>
</ul>
</li>
</ul>
</li>
<li>Text that appears when no further posts have been found</li>
</ul>
</li>
</ul>
</li>
<li>List Layout Options
<ul>
<li>List Layout Type: vertical list or responsive grid</li>
<li>Grid item width in px</li>
<li>Minimal height of grid item in px</li>
<li>List Item Margin Options
<ul>
<li>Top item margin in px</li>
<li>Bottom item margin in px</li>
<li>Left item margin in px</li>
<li>Right item margin in px</li>
</ul>
</li>
</ul>
</li>
</ul>
<h4>Additional options in the Pro version</h4>
The Pro version has all the options of the free version and many additional options for layouts, numbered lists, colors, custom post types and much more. <a href="https://www.kybernetik-services.com/plugins/ultimate-post-list-pro/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=ultimate-post-list&utm_content=update-notice-readme" rel="nofollow ugc">Go to Ultimate Post List Pro</a>.
Pro users get premium support whilst free support is offered in the WordPress forums in our spare time.
<h4>Support</h4>
Support for this plugin will be provided in the form of Product Support. This means that we intend to fix any confirmed bugs, listen to ideas for this plugin and improve the user experience when enhancements are identified and can reasonably be accommodated.
Pro users get premium support whilst free support is offered in the WordPress forums in our spare time. If you are having trouble with this plugin in your particular installation of WordPress, we will not be able to help you troubleshoot the problem.

Ultimate Post List

Make up custom-tailored preview lists of the contents easily and place them in widget areas and post contents.

Post Avatar vs Ultimate Post List