{"id":41426,"date":"2016-01-25T20:01:53","date_gmt":"2016-01-25T20:01:53","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/engaging-buttons\/"},"modified":"2021-03-03T19:01:05","modified_gmt":"2021-03-03T19:01:05","slug":"engaging-buttons","status":"publish","type":"plugin","link":"https:\/\/szl.wordpress.org\/plugins\/engaging-buttons\/","author":10464561,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.6","stable_tag":"trunk","tested":"5.7.15","requires":"4.0","requires_php":"","requires_plugins":"","header_name":"Engaging Buttons","header_author":"Center for Media Engagement","header_description":"","assets_banners_color":"c3b3ac","last_updated":"2021-03-03 19:01:05","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/utdirect.utexas.edu\/apps\/utgiving\/online\/nlogon\/?menu=COEN","header_plugin_uri":"https:\/\/github.com\/engagingnewsproject\/engaging-buttons","header_author_uri":"https:\/\/mediaengagement.org\/","rating":5,"author_block_rating":0,"active_installs":10,"downloads":2767,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"jeryj","date":"2016-01-25 20:25:50"},"1.0.1":{"tag":"1.0.1","author":"jeryj","date":"2016-01-27 19:15:24"},"1.0.2":{"tag":"1.0.2","author":"jeryj","date":"2016-01-29 22:17:02"},"1.0.3":{"tag":"1.0.3","author":"jeryj","date":"2016-02-04 15:46:07"},"1.0.4":{"tag":"1.0.4","author":"jeryj","date":"2016-02-26 16:39:11"},"1.0.5":{"tag":"1.0.5","author":"jeryj","date":"2016-04-05 14:07:33"}},"upgrade_notice":{"Engaging Buttons 1.0.5":"<ul>\n<li>Plugin now works with local WAMP servers and PHP set-ups without short_open_tag enabled. This update does not bring any functionality changes.<\/li>\n<\/ul>","Engaging Buttons 1.0.4":"<ul>\n<li>Added partial support for PHP v5.2. If you have Engaging Buttons activated on your site now, then this update should not affect anything for you.<\/li>\n<\/ul>","Engaging Buttons 1.0.3":"<ul>\n<li>Performance improvements &amp; PHP v5.3 support! Engaging Buttons now only adds ~2kb to your site weight (if GZIP enabled). A savings of ~500%.<\/li>\n<li>Use Open Sans Font with the buttons if they&#039;re not displaying quite right on your site.<\/li>\n<\/ul>","Engaging Buttons 1.0.2":"<ul>\n<li>Change the color of your buttons with a simple color chooser.<\/li>\n<\/ul>","Engaging Buttons 1.0.1":"<ul>\n<li>Fixed svg icon not displaying on Firefox<\/li>\n<\/ul>","Engaging Buttons 1.0":"<ul>\n<li>Initial release<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":2486040,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":2486040,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1554x500.jpg":{"filename":"banner-1554x500.jpg","revision":2486040,"resolution":"1554x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":2486040,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":1335827,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":1335827,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":1335827,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":1335827,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":1335827,"resolution":"5","location":"assets","locale":""},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":1335827,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"A close-up of one of the Engaging Buttons styles.","2":"A demo page using the Engaging Buttons and displaying the Most Respected Posts list.","3":"A demo comment section using the Respect Button.","4":"All the one-click button styles for you to use on your site. You can create custom styles with CSS as well.","5":"In Settings &gt; Engaging Buttons, choose which button style you want to use.","6":"In Settings &gt; Engaging Buttons, set-up one or more buttons."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[172,307,156,27221,80],"plugin_category":[43,44,53],"plugin_contributors":[93368,196917],"plugin_business_model":[],"class_list":["post-41426","plugin","type-plugin","status-publish","hentry","plugin_tags-buttons","plugin_tags-engagement","plugin_tags-like","plugin_tags-research-based","plugin_tags-shortcode","plugin_category-customization","plugin_category-discussion-and-community","plugin_category-ratings-and-reviews","plugin_contributors-jeryj","plugin_contributors-luke-carl","plugin_committers-jeryj","plugin_committers-luke-carl"],"banners":{"banner":"https:\/\/ps.w.org\/engaging-buttons\/assets\/banner-772x250.jpg?rev=2486040","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/engaging-buttons\/assets\/icon-128x128.jpg?rev=2486040","icon_2x":"https:\/\/ps.w.org\/engaging-buttons\/assets\/icon-256x256.jpg?rev=2486040","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-1.jpg?rev=1335827","caption":"A close-up of one of the Engaging Buttons styles."},{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-2.jpg?rev=1335827","caption":"A demo page using the Engaging Buttons and displaying the Most Respected Posts list."},{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-3.jpg?rev=1335827","caption":"A demo comment section using the Respect Button."},{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-4.jpg?rev=1335827","caption":"All the one-click button styles for you to use on your site. You can create custom styles with CSS as well."},{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-5.jpg?rev=1335827","caption":"In Settings &gt; Engaging Buttons, choose which button style you want to use."},{"src":"https:\/\/ps.w.org\/engaging-buttons\/assets\/screenshot-6.jpg?rev=1335827","caption":"In Settings &gt; Engaging Buttons, set-up one or more buttons."}],"raw_content":"<!--section=description-->\n<p>It\u2019s easy to click \u201cLike\u201d on a heartwarming story about a local hero. But what about a fair, but counter-attitudinal, post in a comment section? That may make it a little more challenging to \u201cLike.\u201d<\/p>\n\n<p>Through <a href=\"http:\/\/mediaengagement.org\/research\/engagement-buttons\/\">our research on social media buttons<\/a>, we found that <strong>people were more likely to click \u201cRespect\u201d over \u201cLike\u201d<\/strong> in comment sections, and significantly more likely to click \u201cRespect\u201d when the view expressed differed from their own.<\/p>\n\n<p><strong>The Engaging Buttons WordPress plugin allows you to easily set-up and configure alternative buttons to \u201cLike\u201d (and lots more!) on your website.<\/strong><\/p>\n\n<p>The Engaging Buttons plugin is made by the <a href=\"http:\/\/mediaengagement.org\">Center for Media Engagement<\/a>. The Center for Media Engagement (CME) provides research-based techniques for engaging online audiences in commercially viable and democratically beneficial ways.<\/p>\n\n<p><strong>Features<\/strong><\/p>\n\n<ul>\n<li><strong>Create buttons<\/strong> for your website: Respect, Recommend, Important, Useful, and\/or Thoughtful<\/li>\n<li><strong>Customize your button<\/strong> by selecting the design and colors that best fits your website.<\/li>\n<li><strong>Easily display your Top Posts<\/strong> with the Engaging Button widget, shortcode, or with one click from the settings page.<\/li>\n<li>(Optional) Send click data back to the Center for Media Engagement so we can continue to provide free, research-based, high-quality plugins and update the plugin with high-engagement words.<\/li>\n<li><strong>Customizable\u00a0by developers<\/strong> via CSS and PHP (WordPress filters and hooks).<\/li>\n<li><strong>Lightweight &amp; Performance-focused<\/strong>: Only adds 2 files and ~2kb to your site (with GZIP compression).\nThere's a shortcode and widget for displaying the most Respected\/Important\/etc posts\/pages\/comments\/etc on your site. Here's instructions for how to use them.<\/li>\n<\/ul>\n\n<h3>[engaging-posts] Shortcode<\/h3>\n\n<p>By default, this shortcode displays a list of 5 links to the most clicked button posts (any active post type for that button except comments) for each active button.<\/p>\n\n<p>You can customize the output of the list by adding in a few optional parameters:<\/p>\n\n<p><strong>slug=\"your_active_button_slug\"<\/strong>\nExample: <strong>[engaging-posts slug=\"respect\"]<\/strong> would output a list of the top 5 \"Respected\" posts (of any post type except comments).<\/p>\n\n<p><strong>Accepted slug Values<\/strong>\n- respect\n- important\n- recommend\n- thoughtful\n- useful<\/p>\n\n<p><strong>type=\"your_active_post_type\"<\/strong>\nExample: <strong>[engaging-posts slug=\"respect\" type=\"comments\"]<\/strong> would output a list of the top 5 \"Respected\" comments.<\/p>\n\n<p><strong>Accepted type Values<\/strong>: Any active post type or comments that you have activated and have chosen in your Engaging Buttons options panel.\nCommon values:\n- comment\n- page\n- post\n- your_custom_post_type_slug<\/p>\n\n<p><strong>how-many=\"2\"<\/strong>\nLimits how many post links to display. Default is 5. Minimum is 1, maximum is 20.<\/p>\n\n<p><strong>Accepted how-many Values<\/strong>\n- Integer from 1 - 20<\/p>\n\n<h3>Engaging Posts Widget<\/h3>\n\n<p>This plugin adds an optional widget to your Appearance &gt; Widgets page that you can use to display the pages that have the most clicks of your chosen button. It's powered by the [engaging-posts] shortcode.<\/p>\n\n<p>To set it up:<\/p>\n\n<ol>\n<li>Go to Appearance &gt; Widgets from your WordPress Dashboard<\/li>\n<li>Drag the \"Engaging Posts\" widget to an active widget area where you'd like it to display.<\/li>\n<li>Enter the title<\/li>\n<li>Choose the button you want to get the most clicked posts from (this is a dropdown that only displays your active buttons)<\/li>\n<li>Choose the active post type you want to get the most clicked posts from.<\/li>\n<li>Enter how many post links you want to display (minimum of 1, maximum of 20).<\/li>\n<\/ol>\n\n<p><strong>NOTE: Popular Button Data is Rebuilt every 5 minutes<\/strong><\/p>\n\n<p>Future versions may include a setting option to set this to rebuild instantly on click, or at a length of time you specify (every 1 minute, 600 minutes, etc). Right now it rebuilds every 5 minutes to save your server resources.<\/p>\n\n<h3>Developers<\/h3>\n\n<p><strong>Developer Extensions<\/strong>\nTo see how to query the Engaging Buttons objects or use available filters and hooks, go to our <a href=\"https:\/\/github.com\/engagingnewsproject\/engaging-buttons\">github repository for the Engaging Buttons plugin<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Download the plugin .zip file<\/li>\n<li>Go to your WordPress admin panel, and go to Plugins &gt; Add New<\/li>\n<li>Click the \"Upload Plugin\" button<\/li>\n<li>Choose the plugin .zip file from your computer and click the \"Install Now\" button<\/li>\n<li>Activate the plugin after it's done installing.<\/li>\n<li>Go to Settings &gt; Engaging Buttons to create your button(s), where you want the button(s) displayed, and configure other settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='why%20isn%27t%20my%20most%20popular%20posts%20list%20being%20updated%3F'><h3>Why isn't my Most Popular Posts list being updated?<\/h3><\/dt>\n<dd><p>The Most Popular Posts get recalculated every 5 minutes in order to save your server resources and keep things loading quickly. Wait 5 minutes, then reload your page. The Popular Posts lists should have updated.<\/p><\/dd>\n<dt id='why%20do%20my%20buttons%20look%20strange%20or%20why%20aren%27t%20my%20button%20color%20changes%20showing%20up%3F'><h3>Why do my buttons look strange OR Why aren't my button color changes showing up?<\/h3><\/dt>\n<dd><p>Your theme's CSS is probably overly-specific. We coded the Engaging Buttons plugin to be unobtrusive, but sometimes we were <em>too<\/em> unobtrusive. Send us your site URL and we'll send you back some CSS fixes to add to your theme's CSS stylesheet.<\/p><\/dd>\n<dt id='i%20have%20a%20word%20idea%20for%20a%20button%20that%20you%20haven%27t%20included.%20how%20can%20i%20add%20it%3F'><h3>I have a word idea for a button that you haven't included. How can I add it?<\/h3><\/dt>\n<dd><p>Great! Send us your ideas to katie.steiner [at] austin.utexas [dot] edu. We review the ideas with our research team to see which would be the most effective to add.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>Engaging Buttons 1.0.5<\/h4>\n\n<ul>\n<li>Added long PHP start tags (&lt;?php) for greater reliability.<\/li>\n<\/ul>\n\n<h4>Engaging Buttons 1.0.4<\/h4>\n\n<ul>\n<li>Engaging Buttons can be activated in PHP v5.2.<\/li>\n<\/ul>\n\n<h4>Engaging Buttons 1.0.3<\/h4>\n\n<ul>\n<li>Engaging Buttons now works in PHP v5.3 and greater.<\/li>\n<li>Fixed \"Powered by...\" text displaying under comment sections, even when that option was turned off.<\/li>\n<li>Minified all CSS files and removed CSS sourcemaps. Each file is now only ~1kb (Gzipped).<\/li>\n<li>Minified Javascript file to only ~1kb (Gzipped).<\/li>\n<li>Fixed minor Javascript warnings.<\/li>\n<li>Added Open Sans Font option to use if the buttons are not displaying quite right.<\/li>\n<li>Advanced CSS fields only show if a custom color is chosen (otherwise the field is empty)<\/li>\n<li>Advanced CSS classes are all prefixed with 'body' to give it a better chance of overriding the default CSS while still keeping best practices in mind.<\/li>\n<\/ul>\n\n<h4>Engaging Buttons 1.0.2<\/h4>\n\n<ul>\n<li>Color picker for customizing buttons.<\/li>\n<li>Advanced CSS output for easier overriding.<\/li>\n<\/ul>\n\n<h4>Engaging Buttons 1.0.1<\/h4>\n\n<ul>\n<li>Fixed svg icon not displaying on Firefox<\/li>\n<li>Moved to inline SVG for easier customization by users<\/li>\n<\/ul>\n\n<h4>Engaging Buttons 1.0 - January 25th, 2015<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Easily add research-based, engaging buttons (such as &quot;Respect&quot; or &quot;Important&quot;) to your site.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/41426","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=41426"}],"author":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jeryj"}],"wp:attachment":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=41426"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=41426"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=41426"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=41426"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=41426"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=41426"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}