Does your website utilize categories and tags? Does it use custom taxonomies? If so, this plugin will find similar content\nbased on all your taxonomies. There are two ways to show related posts within your page.<\/p>\n\n
The Widget included with this plugin gives you the option to limit the amount of posts; it allows you to determine which\nfields to show: Featured Image, Author, Date, and Excerpt (Title is required); it allows you to determine which \nvariant of the featured image to show: thumbnail, medium, large, or full. As of version 2.0, you can now decide whether the\n'similar posts' sorting prefers posts that are newer or posts that were created closer to the date of the post you're\nviewing.<\/p>\n\n
If you find the Widget doesn't meet your needs or is too limiting, you can call the functionality programmatically using\nthis function:<\/p>\n\n
pk_related_return($post->ID, $args);\n<\/code><\/pre>\n\nWhere $post->ID is the ID of the post for which you are wanting to show related articles.<\/p>\n\n
The $args parameter is an array with the following values available to you (more coming soon):<\/p>\n\n
\n- posts_per_page (int defaults to 5)<\/li>\n
- thumbnail_size (string consisting of one of these values: \"thumbnail\", \"medium\", \"large\", \"full\". Defaults to thumbnail).<\/li>\n
- sort_prefer (string consisting of one of these values: \"newest\", \"closest\". Defaults to newest).<\/li>\n<\/ul>\n\n
An example might be:<\/p>\n\n
<?php\n$args = array (\n 'posts_per_page' => 6,\n 'thumbnail_size' => 'medium',\n 'sort_prefer' => 'closest'\n);\n<\/code><\/pre>\n\nThe return value of pk_related_return is an array of objects that includes most of the fields within WordPress's posts\ntable plus permalink and featured image.<\/p>\n\n
Future Additions:<\/p>\n\n
Allow the user to specify only certain content types (posts, pages, custom) in a request. This would allow you to specify\nonly products get returned, or only blog posts. This would only be an issue if content types share taxonomies.<\/p>\n\n\n
\n- Upload
similar-posts-ontology<\/code> to the \/wp-content\/plugins\/<\/code> directory<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n
- If you want the widget, go to 'Appearance' -> 'Widgets' and look for Similar Posts Ontology widget. If you prefer to call programmatically, use the pk_related_return function in your theme.<\/li>\n<\/ol>\n\n\n
\nHow does this plugin work?<\/h3><\/dt>\nThere are two aspects to it. First, it finds all similarly tagged, categorized, and otherwise taxonomically created content\non your site, then sorts it by what has the most similarities. Second, if there is a tie between two posts it will give\nthe edge to the newest content, or content posted closer to the time your current post was posted, depending how you configure it.<\/p><\/dd>\n
Why Ontology? What's an Ontology?<\/h3><\/dt>\nOntology is the study of the nature of 'being'. This plugin uses the ontological philosophy of determining an entities \nplacement within its own 'type' by studying the entities relationships.<\/p><\/dd>\n
Why am I not seeing any content when I install this?<\/h3><\/dt>\nYou can use this in two ways. Either by calling pk_related_return() in your theme or by placing the widget on your site.\nIf you are using the widget, remember that it only works on any \"single\" page (where is_single() would return true). The\npk_related_return() can theoretically work anywhere as long as you provide a proper post ID. Try var_dump() with \npk_related_return() and look at the description for proper usage of this function.<\/p><\/dd>\n
Why are my results coming back with weird content that I wouldn't expect?<\/h3><\/dt>\nThis issue may be your taxonomies. The content for which you're trying to find related content needs to have tags, \ncategories, and\/or custom taxonomies. Also, to properly find your content, tags\/categories\/taxonomies must be used on\nthe related<\/em> content as well. The more you intentionally use your tags and categories, the better your results set will be.<\/p><\/dd>\n\n<\/dl>\n\n\n2.1<\/h4>\n\n
Release Date - July 31st, 2016<\/em>\n* Include some base styles to look better with common theme conventions\n* Fixed bug where author URL was broken\n* Tested up to 4.6<\/p>\n\n2.0<\/h4>\n\n
Release Date - August 15th, 2015<\/em>\n* Optimized query to allow for the option of specifying sorting preferences.<\/p>\n\n1.0.1<\/h4>\n\n
Release Date - January 11th, 2015<\/em>\n* Made the widget include HTML and classes that are best practice.<\/p>\n\n1.0<\/h4>\n\n
Release Date - January 10th, 2015<\/em>\n* First Version<\/p>","raw_excerpt":"Show a list of related posts that are similar to another post.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/33899","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=33899"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cfischer83"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=33899"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=33899"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=33899"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=33899"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=33899"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=33899"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}