1. Open your microkids-related-posts.php file, and find this code around line 442:

   $title = MRP_get_title($options['title'], $post_type );

   and replace it with this following code:

   $title = MRP_get_title( __($options['title'], 'microkids-related-posts'), $post_type );

   The purpose of this modification is to translate the “Related Posts” text (default) that defined in the options page by the author. This text will be shown at the bottom of your post content.

2. Find again this code:

   <p><input name="MRP_title" type="text" id="MRP_title" value="<?=$options['title']?>" style="width:300px;" /></p>

   then replace it with this following code:

   <p><input name="MRP_title" type="text" id="MRP_title" value="<?php echo $options['title']?>" style="width:300px;" /></p>

   Find again this code:

   <input type="text" name="MRP_text_if_empty" id="MRP_text_if_empty" value="<?=$options['text_if_empty']?>" <?php if( $options['hide_if_empty'] ) : ?>disabled="disabled"<?php endif; ?> style="width:250px;" />

   then replace it with this following code:

   <input type="text" name="MRP_text_if_empty" id="MRP_text_if_empty" value="<?php echo $options['text_if_empty']; ?>" <?php if( $options['hide_if_empty'] ) : ?>disabled="disabled"<?php endif; ?> style="width:250px;" />

   The purpose of this modification is to avoid using <?= tag for PHP version compatibility. Always using <?php tag, as well as WordPress suggest, too, of course.

3. Still in that file, go to around line 135, find this code:

   echo '<div class="MRP_tab'.$current.'"><a href="#" rel="MRP_post_type'.$ext.'">'.__( $post_type_details->labels->name ).' (<span id="MRP_related_count'.$ext.'" class="MRP_related_count">'.$related_posts_count.'</span>)</a></div>';

   then replace it with this following code:

   echo '<div class="MRP_tab'.$current.'"><a href="#" rel="MRP_post_type'.$ext.'">'.__( $post_type_details->labels->name, 'microkids-related-posts' ).' (<span id="MRP_related_count'.$ext.'" class="MRP_related_count">'.$related_posts_count.'</span>)</a></div>';

   The purpose of this modification is to append the ‘microkids-related-posts’ domain name to the translation, so if you are running a multilingual website content, you will know that this translation is coming from the related plugin.

4. Still in the same file, go to around line 481, and find this code:

   $title = str_replace( '%posttype%', __( $post_type->label ), $title );

   then replace it with this following code:

   $title = str_replace( '%posttype%', __( $post_type->label, 'microkids-related-posts' ), $title );

   The purpose of this modification is to append the ‘microkids-related-posts’ domain name to the translation, so if you are running a multilingual website content, you will know that this translation is coming from the related plugin.

5. Open your microkids-related-posts-widget.php file, and find this code around line 8:

   $widget_ops = array('classname' => 'widget_related_posts', 'description' => __( "Display related posts as a widget") );

   then replace it with this following code:

   $widget_ops = array('classname' => 'widget_related_posts', 'description' => __( "Display related posts as a widget", "microkids-related-posts") );

   The purpose of this modification is to append the ‘microkids-related-posts’ domain name to the translation, so if you are running a multilingual website content, you will know that this translation is coming from the related plugin.

6. Find also this code still in the same file above this step:

   $this->WP_Widget('related_posts', __('Related Posts'), $widget_ops);

   then replace it with this following code:

   $this->WP_Widget('related_posts', __('Related Posts', 'microkids-related-posts'), $widget_ops);

Well, actually, there are some words/terms that still don’t have the domain name in the _e() function. They are located in the microkids-related-posts-widget.php file. Hopefully the author will be able to complete them. Thanks.

However, if you want to use the multi language version of MicroKid Related Posts version 2.5 plugin, please download microkids-related-posts_multi-language. If you feel curious with the modification that I had made, you can compare the changes with the original version 2.5 one by using a tool such as WinMerge.

As usual, extract the .zip file to your wp-content/plugins/ sub directory and then activate it from your wp admin if you use it for the very first time. If you have already used it, then simply extract and replace the old version with this new one.

1. You can now add drafts and planned posts as related posts, without them appearing on your site before they are properly published.
2. Added shortcode support: you can now place the [ related-posts ] shortcode within the content of your post to display the related posts anywhere you want.
3. (For advanced users) Added a parameter to the MRP_get_related_posts function to optionally get the related posts in an object, so you can easily use it in other plugins or your own custom way of displaying the list of related posts. For documentation on this, see [the API section](http://www.microkid.net/wordpress/related-posts/#API “Microkids Related Posts API functions”).
4. (For advanced users) Added a parameter to the MRP_get_related_posts function to optionally include unpublished posts to the related posts list. For documentation on this, see [the API section](http://www.microkid.net/wordpress/related-posts/#API “Microkids Related Posts API functions”).

After the automatically-upgrade process was completed, I remembered that I had modified this Microkids Related Post plugin before via this article: Adjust MicroKid Related Posts v2.3 with qTranslate v2.4.3 Plugins. It meant that I had to adjust its new script again in order it compatible with qTranslate plugin.

So here was I made:

1. Open mrp-search.php file, find this code:

   52	foreach( $results as $result ) {

   replace with:

   52 53

   foreach( $results as $result ) { $related_post_title = wp_specialchars(qtrans_useCurrentLanguageIfNotFoundUseDefaultLanguage($result->post_title));

   find this code:

   60	echo $result->post_title;

   replace with:

   60	// echo $result->post_title;

   find this code:

   64	echo '</a> <a href="'.get_permalink( $result->ID ).'" title="View this post" class="MRP_view_post" target="_blank">&rsaquo;</a></li>';

   replace with:

   64	echo $related_post_title.'</a> <a href="'.get_permalink( $result->ID ).'" title="View this post" class="MRP_view_post" target="_blank">&rsaquo;</a></li>';

   then save this file.

2. Open microkids-related-posts.php file, and find this code:

   104	echo '<li id="related-post-'.$related_post->ID.'"><span>'.$post_title.'</span><span><a class="MRP_deletebtn" onclick="MRP_remove_relationship(\'related-post-'.$related_post->ID.'\')">X</a></span>';

   replace with:

   104	echo '<li id="related-post-'.$related_post->ID.'"><span>'.wp_specialchars(qtrans_useCurrentLanguageIfNotFoundUseDefaultLanguage($post_title)).'</span><span><a class="MRP_deletebtn" onclick="MRP_remove_relationship(\'related-post-'.$related_post->ID.'\')">X</a></span>';

   find this code:

   328 329 330 331 332

   $output .= "<ul>\n"; foreach( $related_posts as $related_post ) { $output .= "<li><a href=\"".get_permalink( $related_post->ID )."\" title=\"$related_post_title\">".$related_post->post_title."</a></li>\n"; } $output .= "</ul></div>\n";

   replace with:

   328 329 330 331 332

   $output .= "<ol>\n"; foreach( $related_posts as $related_post ) { $output .= "<li><a href=\"".get_permalink( $related_post->ID )."\" title=\"$related_post_title\">".wp_specialchars(qtrans_useCurrentLanguageIfNotFoundUseDefaultLanguage($related_post->post_title))."</a></li>\n"; } $output .= "</ol></div>\n";

   find this code:

   375 376 377 378 379

   echo "<ul>\n"; foreach( $related_posts as $related_post_id => $related_post_title ) { echo "<li><a href=\"".get_permalink( $related_post_id )."\" title=\"$related_post_title\">".$related_post_title."</a></li>\n"; } echo "</ul></div>";

   replace with:

   375 376 377 378 379 380

   echo "<ol>\n"; foreach( $related_posts as $related_post_id => $related_post_title ) { echo "<li><a href=\"".get_permalink( $related_post_id )."\" title=\"$related_post_title\">".wp_specialchars(qtrans_useCurrentLanguageIfNotFoundUseDefaultLanguage($related_post_title))."</a></li>\n"; } echo "</ol> </div>";

This has been tested and working good in Microkids Related Posts version 2.4 and qTranslate version 2.4.3.