{"id":2031,"date":"2007-09-14T04:47:24","date_gmt":"2007-09-14T04:47:24","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/recent-love\/"},"modified":"2010-03-28T01:54:14","modified_gmt":"2010-03-28T01:54:14","slug":"recent-love","status":"publish","type":"plugin","link":"https:\/\/ast.wordpress.org\/plugins\/recent-love\/","author":19327,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.5","stable_tag":"0.5","tested":"2.9.2","requires":"1.5","requires_php":"","requires_plugins":"","header_name":"Recent Love - A List of Recent Comments","header_author":"Ron Rothman","header_description":"","assets_banners_color":"","last_updated":"2010-03-28 01:54:14","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/ronrothman.com\/public\/leftbraned\/wordpress-plugin-recent-love-a-list-of-recent-comments","header_plugin_uri":"http:\/\/ronrothman.com\/public\/leftbraned\/wordpress-plugin-recent-love-a-list-of-recent-comments\/","header_author_uri":"http:\/\/ronrothman.com\/public\/leftbraned\/","rating":0,"author_block_rating":0,"active_installs":20,"downloads":8297,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.5","0.5c"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[107,4429],"plugin_category":[44],"plugin_contributors":[88247],"plugin_business_model":[],"class_list":["post-2031","plugin","type-plugin","status-publish","hentry","plugin_tags-comments","plugin_tags-recent-comments","plugin_category-discussion-and-community","plugin_contributors-ronr","plugin_committers-ronr"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/recent-love.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><em>Displays a list (typically, in your sidebar) of your visitors' recent comments.\nBy default, shows the latest comment from each of the last five commented-on posts.<\/em><\/p>\n\n<p>You control:<\/p>\n\n<ul>\n<li>how many recent comments to display<\/li>\n<li>how many characters of the post title to display<\/li>\n<li>how to style each comment in the list (with open\/close tags)<\/li>\n<li>whether to include or omit trackbacks\/pingbacks<\/li>\n<li>whether to include or omit comments from the post's author<\/li>\n<li>a list of users for whom never to display comments (e.g., yourself; or use this to create a blacklist).<\/li>\n<\/ul>\n\n<p>See \"Installation\" for easy setup instructions.<\/p>\n\n<h3>History<\/h3>\n\n<p>A few months ago, I wanted to display a list of recent comments in my blog's\nsidebar.  After searching through the countless plugins which return lists of\ncomments, I finally decided on Scott Reilly's <a href=\"http:\/\/www.coffee2code.com\/archives\/2004\/07\/08\/plugin-toprecent-commenters\/\">Top\/Recent\nCommenters<\/a> plug-in.<\/p>\n\n<p>Unfortunately, I had to tweak Scott's code to get it to work the way I wanted.\nOne tweak led to another (you know how it is) until I finally just scrapped\nthe original code and rolled my own.  (You can see it in action on my blog's\n<a href=\"http:\/\/ronrothman.com\/public\/leftbraned\/\">front page<\/a>.)<\/p>\n\n<h3>What It Does<\/h3>\n\n<p>Adds a single template function:<\/p>\n\n<pre><code>rr_recent_comments (\n    $num_recent_posts = 5,\n    $before = '&lt;li&gt;',\n    $after = '&lt;\/li&gt;'\n)\n<\/code><\/pre>\n\n<p>The function <code>rr_recent_comments()<\/code> returns a list of recent comments.<\/p>\n\n<p>When invoked with no parameters, it returns a list containing the latest comment from\neach of the most recent 5 posts.  <em>Only one comment (the most recent one) per\npost is listed.<\/em><\/p>\n\n<p>By default, any comments made by the author of the post are <em>not<\/em>\nincluded in the list.  (This behaviour can be configurably modified.)  Long\npost titles are truncated to a length which you can configure.  Trackbacks and\npingbacks are not included in the list by default.<\/p>\n\n<p>You can exlcude certain posters, based on various criteria (author email,\nauthor name, etc.).  This is helpful, for example, to exclude yourself from\nthe list.<\/p>\n\n<p>You can customize your list two ways: tag parameters and global config\noptions.<\/p>\n\n<h4>Parameters<\/h4>\n\n<p>The function <code>rr_recent_comments()<\/code> takes three parameters, all of which are optional.<\/p>\n\n<ol>\n<li><code>$num_recent_posts<\/code><br \/>\nThe [maximum] number of comments to display.<br \/>\n<em>Default<\/em>: 5<\/li>\n<li><code>$before<\/code><br \/>\nThe text to display before each comment.<br \/>\n<em>Default<\/em>: '&lt;li&gt;'<\/li>\n<li><code>$after<\/code><br \/>\nThe text to display after each comment.<br \/>\n<em>Default<\/em>: '&lt;\/li&gt;'<\/li>\n<\/ol>\n\n<h4>Configuration Options<\/h4>\n\n<p>The behaviour of <code>rr_recent_comments()<\/code> can be customized on a\nglobal basis by editing some values in the plugin file, <code>rr_recent_comments.php<\/code>.\nWith the possible exception of <code>$max_title_length<\/code>,\nmost installations will probably not need to\nfutz with these, but they're there if you want 'em.<\/p>\n\n<ul>\n<li><p><code>$max_title_length<\/code> (<em>Default<\/em>: 38)\nThis value represents the longest length that a post title\nmay be without it being truncated for display.  Titles longer than this will\nbe indiscriminately chopped, and an ellipses will be appended to them.  Set to\n0 to disable truncation altogether (not recommended).<\/p><\/li>\n<li><p><code>$exclude_authors_comments<\/code> (<em>Default<\/em>: true)\nSet to true to exclude an author's comments from his\/her\nown posts.  Set to false to include them.<\/p><\/li>\n<li><p><code>$link_to_commenters_websites<\/code> (<em>Default<\/em>: true)\nSet to true to hyperlink the comment author's name to the\nwebsite they enter on your comment form.  Set to false to suppress\nhyperlinking.<\/p><\/li>\n<li><p><code>$suppress_trackbacks<\/code> (<em>Default<\/em>: true)\nIf true, trackbacks and pingbacks are excluded from the\ncomment list.  Set to false to include them.<\/p><\/li>\n<li><p><code>$identify_authors_by<\/code> and <code>$excludes_sql_list<\/code>\n(<em>Default<\/em>: no exclusions)\nThese two fields work in conjunction to allow you to\nspecify a list of comments whose comments should <em>never<\/em> be included in\nthe list.  (Note that most blog installation will not need to use this\nfunctionality.)<br \/>\nFirst, choose the criterion by which you want to identify the\nexcluded comments and set <code>$identify_authors_by<\/code> to one of:<\/p>\n\n<ul>\n<li><code>'comment_author'<\/code>,<\/li>\n<li><code>'comment_author_url'<\/code> or<\/li>\n<li><code>'comment_author_email'<\/code>.<br \/>\nThen add the excluded commenters to the list <code>$excludes_sql_list<\/code>;\nbe careful to follow the correct format, which is: <code>('COMMENTER_1', 'COMMENTER_2', ..., 'COMMENTER_N')<\/code>.<br \/>\nYou must specify the COMMENTERs in a way that matches the value of <code>$identify_authors_by<\/code>.  I.e., if <code>$identify_authors_by<\/code>\nis <code>'comment_author_email'<\/code>, then the COMMENTERs in <code>$excludes_sql_list<\/code> must all be email addresses.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h3>Revision History<\/h3>\n\n<p>0.1 <em>(May 1, 2005)<\/em>: Initial revision.<\/p>\n\n<p>0.2 <em>(October 30, 2005)<\/em>: Rewrite and add new features.<\/p>\n\n<p>0.3 <em>(November 11, 2005)<\/em>: Clean up for publication.<\/p>\n\n<p>0.4 <em>(?)<\/em><\/p>\n\n<p>0.5 <em>(April 4, 2007)<\/em>: Add <code>$link_to_commenters_websites<\/code> option.<\/p>\n\n<!--section=installation-->\n<h3>How to Install It<\/h3>\n\n<ol>\n<li>Download the plugin file, and put it file in your WordPress plugin directory, <code>wp-content\/plugins<\/code>.\n(Make sure to name it <code>rr_recent_love<\/code><strong><code>.php<\/code><\/strong>.<\/li>\n<li>Enable the plugin in the WordPress Plugin Admin panel.<\/li>\n<\/ol>\n\n<h3>How to Use It<\/h3>\n\n<p>Just insert the following call into your theme files, wherever you want the\ncomment list to appear (e.g., <code>sidebar.php<\/code>):<\/p>\n\n<pre><code>&lt;?php echo rr_recent_comments(); ?&gt;\n<\/code><\/pre>\n\n<p>Just insert the following call into your theme files, wherever you want the\ncomment list to appear (e.g., <code>sidebar.php<\/code>):<\/p>\n\n<pre><code>&lt;ul class='recent_comments'&gt;\n    &lt;?php echo rr_recent_comments(); ?&gt;\n&lt;\/ul&gt;\n<\/code><\/pre>\n\n<!--section=faq-->\n<dl>\n<dt>Where can I send suggestions for new features?<\/dt>\n<dd><p>Please see the <a href=\"http:\/\/ronrothman.com\/public\/leftbraned\/wordpress-plugin-recent-love-a-list-of-recent-comments\" title=\"WordPress plug-in Recent Love\">Recent Love home page<\/a>.<\/p><\/dd>\n\n<\/dl>","raw_excerpt":"Displays a list of recent comments.  Several configuration options exist.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/2031","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=2031"}],"author":[{"embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ronr"}],"wp:attachment":[{"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=2031"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=2031"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=2031"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=2031"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=2031"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ast.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=2031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}