{"id":7553,"date":"2009-12-17T15:03:36","date_gmt":"2009-12-17T15:03:36","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/spectacula-threaded-comments\/"},"modified":"2020-10-09T11:59:00","modified_gmt":"2020-10-09T11:59:00","slug":"spectacula-threaded-comments","status":"publish","type":"plugin","link":"https:\/\/ur.wordpress.org\/plugins\/spectacula-threaded-comments\/","author":1260653,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.3.4","stable_tag":"2.3.2","tested":"3.8.41","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Spectacu.la Discussion","header_author":"James R Whitehead, Tom J Nowell","header_description":"","assets_banners_color":"f7f8f2","last_updated":"2020-10-09 11:59:00","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/spectacu.la\/signup\/signup.php","header_plugin_uri":"http:\/\/spectacu.la\/","header_author_uri":"http:\/\/www.interconnectit.com\/","rating":4.5,"author_block_rating":0,"active_installs":70,"downloads":18603,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"spectacula","date":"2009-12-17 15:13:09"},"1.0.1":{"tag":"1.0.1","author":"spectacula","date":"2010-01-25 16:31:44"},"1.0.2":{"tag":"1.0.2","author":"spectacula","date":"2010-04-06 11:48:34"},"1.0.3":{"tag":"1.0.3","author":"spectacula","date":"2010-05-31 15:08:14"},"2.0.0":{"tag":"2.0.0","author":"spectacula","date":"2010-07-16 23:12:39"},"2.0.1":{"tag":"2.0.1","author":"spectacula","date":"2010-07-26 10:03:57"},"2.1.1":{"tag":"2.1.1","author":"spectacula","date":"2010-09-23 16:52:09"},"2.1.2":{"tag":"2.1.2","author":"spectacula","date":"2010-10-01 20:40:19"},"2.1.3":{"tag":"2.1.3","author":"spectacula","date":"2010-10-05 16:42:09"},"2.1.4":{"tag":"2.1.4","author":"spectacula","date":"2010-10-05 17:17:33"},"2.1.5":{"tag":"2.1.5","author":"spectacula","date":"2010-10-11 17:03:01"},"2.1.6":{"tag":"2.1.6","author":"spectacula","date":"2011-07-09 20:13:59"},"2.1.7":{"tag":"2.1.7","author":"TJNowell","date":"2012-03-02 11:12:23"},"2.2":{"tag":"2.2","author":"TJNowell","date":"2012-11-07 15:12:13"},"2.2.1":{"tag":"2.2.1","author":"TJNowell","date":"2012-11-07 16:19:59"},"2.2.2":{"tag":"2.2.2","author":"spectacula","date":"2012-11-08 16:53:47"},"2.3":{"tag":"2.3","author":"spectacula","date":"2013-10-23 15:39:03"},"2.3.1":{"tag":"2.3.1","author":"spectacula","date":"2014-02-13 18:28:16"},"2.3.2":{"tag":"2.3.2","author":"spectacula","date":"2020-10-09 11:59:00"}},"upgrade_notice":{"1.0.3":"<ul>\n<li>Moved the javascript to the footer and removed an unneeded script. Nothing\nserious, just tweaks.<\/li>\n<\/ul>","1.0.2":"<ul>\n<li>Not really required that you upgrade. Just added a single element to make it\neasier to translate this plug-in.<\/li>\n<\/ul>","1.0":"<ul>\n<li>Not many changes from the internal version no urgency in the upgrade.<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":"1","5":"1"},"assets_icons":[],"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":647824,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","2.0.0","2.0.1","2.1.1","2.1.2","2.1.3","2.1.4","2.1.5","2.1.6","2.1.7","2.2","2.2.1","2.2.2","2.3","2.3.1","2.3.2"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":2754561,"resolution":"1","location":"plugin"},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":2754561,"resolution":"2","location":"plugin"}},"screenshots":{"1":"Will work on both dark and light themes thanks to alternative stylesheet\naccessible from the control interface.","2":"The control interface for this plug-in."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[221,107,202],"plugin_category":[44],"plugin_contributors":[80834,80835,80836],"plugin_business_model":[],"class_list":["post-7553","plugin","type-plugin","status-publish","hentry","plugin_tags-ajax","plugin_tags-comments","plugin_tags-jquery","plugin_category-discussion-and-community","plugin_contributors-interconnectit","plugin_contributors-spectacula","plugin_contributors-tjnowell","plugin_committers-chiquita","plugin_committers-interconnectit","plugin_committers-sanchothefat","plugin_committers-spectacula"],"banners":{"banner":"https:\/\/ps.w.org\/spectacula-threaded-comments\/assets\/banner-772x250.jpg?rev=647824","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/spectacula-threaded-comments_f7f8f2.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/spectacula-threaded-comments\/trunk\/screenshot-1.jpg?rev=2754561","caption":"Will work on both dark and light themes thanks to alternative stylesheet\naccessible from the control interface."},{"src":"https:\/\/ps.w.org\/spectacula-threaded-comments\/trunk\/screenshot-2.jpg?rev=2754561","caption":"The control interface for this plug-in."}],"raw_content":"<!--section=description-->\n<p>Ever found your theme doesn't support threaded comments?  Would you like it to\nbe able to have P2 style live commenting on your site?  Spectacu.la Discussion\nis a plugin that replaces the commenting code in your theme with a fully Ajaxed\ncomments engine.<\/p>\n\n<p>The plugin uses memory tables for fast caching within the database (no pesky\npermission setting for you to worry about here) and adjustible polling times to\nsuit a wide range of server performance.<\/p>\n\n<p>The plugin is also developer friendly, meaning that you can easily add styles to\nyour theme so that should a user implement the plugin your meticulous design can\nbe carried through.  By default there are two styles that should work in most\ncases.  Read below for further instructions.<\/p>\n\n<p>Once installed this plug-in will replace your theme's comments template with its\nown fully Ajax comment template. This allows both submission and update of\ncomments without a page refres letting your visitors use it more as a chat room\nthan the more traditional comment system. You can also roll up replied which can\nbe told to trigger at any depth you feel is best using the settings page. Also\navailable on the plug-ins admin page is the option to use another or no\nstylesheet, toggle the live updating of comments and change the refresh period\nfor live update.<\/p>\n\n<p>As of version 2 you can now easily add new stylesheets to the available list by\neither copying them into the plug-in's style folder with a comment at the top of\nthe sheet that looks like this \/* comment style: Stylesheet name *\/ or adding a\ncommenting.css to your theme or child theme. Once added they will then be listed\nin the dropdown menu that shows on the admin page.<\/p>\n\n<p>The plugin is also, of course, Multisites compatible.<\/p>\n\n<p>=The filters=<\/p>\n\n<p>There are a few filters available for developers to intercept the javascript,\nparamerers passed to the javascript and the CSS file location<\/p>\n\n<ol>\n<li><strong>spec_comment_css<\/strong>\nPasses the URL of the stylesheet through to your function to replace\nwith your own file.<\/li>\n<li><strong>spec_comment_js<\/strong>\nPasses the URL to the jQuery file that controls the roll up and a few\nother elements.<\/li>\n<li><strong>spec_comment_local_js<\/strong>\nPasses in an array of localisation strings that are passed to the\njQuery code.<\/li>\n<\/ol>\n\n<p>To replace the CSS file you could add something like the following to your\nfunctions.php that would point to a comments.css file in the folder of your\ncurrent theme. This will then override any choice made by the user on the admin\npage.<\/p>\n\n<pre><code>&lt;?php\n    add_filter('spec_comment_css', 'my_css_file');\n\n    function my_css_file() {\n        return get_bloginfo('template_directory') . '\/comments.css';\n    }\n\n?&gt;\n<\/code><\/pre>\n\n<h4>Warning<\/h4>\n\n<p>Every effort has been made to make this work with as wide a variety of themes as\npossible but we can't cover every eventuality so some themes out there will\ncause problems with this plugin without you doing something to either the\nplug-in or the theme first. The most likely cause of problems is that some of\nthe CSS in the theme conflicts with the CSS in the comments. There are various\nother areas where problems could arise, such as if the theme doesn't call the\ncomments.php using the <code>comments_template();<\/code> template tag or if your theme\ndeals with comments in an unusual way, such as placing them in a sidebar or\ncalling them in using Ajax that conflicts with our own. A missing or unusual\nDOCTYPE could cause problems too, in fact there are lots of things that could\ncause strangeness. However with most of the themes I've tested this with it has\nworked without issue straight out of the gate and even if it doesn't look right\nyou need only disable the plug-in to go back to how things were, so nothing's\nlost.<\/p>\n\n<!--section=installation-->\n<h4>The install<\/h4>\n\n<p>You can either install the plugin using the WordPress auto-installer, or\nmanually:<\/p>\n\n<ol>\n<li>Upload <code>commenting.php<\/code> and all sub folders to\n    \/wp-content\/plugins\/spec-comments\/ or <code>\/wp-content\/mu-plugins\/<\/code> directory.\nIf the directory doesn't exist then create it.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>You should now see an extra menu show up under the settings menu in the main\nadmin sidebar.<\/li>\n<li>Check a page on your site with comments and see that everything is as you'd\nhope. If it's not then proceed to the config menu and see if what you want\ncan be set from there.<\/li>\n<\/ol>\n\n<h4>The config<\/h4>\n\n<ol>\n<li>The first option with this plug-in is the option to define at which point\nthe comments roll up. Default is set so that all replies are hidden behind a\nclick but with the drop down you could specify that replies to replies are\nhidden or replies to replies of replies and so on...<\/li>\n<li>The next block is for controlling the titles that show above the comment\nblock and the trackback block if your theme separates them out.<\/li>\n<li>Choose the stylesheet you want to use with your theme. At the moment there\nare two, the default style for use with light coloured themes and the dark\nstyle for use with dark themes. You can also disable the CSS here if you'd\nrather roll it into your theme's stylesheet. If you add more CSS files with\nthe special CSS comment to the style folder in the plug-in or add a\ncommenting.css to your theme's folder then that'll show up in this list too.<\/li>\n<li>The comment update block lets you control the frequency of comment update\nand whether they're enabled or not. The default status for \"Auto update\" is\noff, if you want to enable live commenting then check this box and set a\ntime interval in the box below that is appropriate to your server\/traffic\nlevels. The minimum amount of time you can set for the auto update is 10\nseconds any attempt to get it quicker than that will result in it returning\nto the default value of 30 seconds.<\/li>\n<li>The final option is to hide our credit link and is one we'd rather you\ndidn't do anything with but we've given you it anyway as we're nice like\nthat. We do understand that sometimes clients want things like that gone\nwe'd just like to ask in return for that is that you think about signing up\nwith us<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='why%20doesn%27t%20it%20quite%20look%2Fwork%20right%3F'><h3>Why doesn't it quite look\/work right?<\/h3><\/dt>\n<dd><p>Unfortunately it's not possible for us to check this code against every theme\nout there so from time to time you may run into some incompatibilities. It's\npossible that some CSS in your theme's style.css is causing issues. You could\ntry stripping out all commenting related CSS from it and see if that makes any\ndifference. If it's not that then it might be that your theme isn't calling\ncomments_template() to add the comments code, if that's the case then you're out\nof luck unless you know where to look in the theme code or you can get your\ntheme developer to change their theme.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.3.2<\/h4>\n\n<pre><code>For the few still using this I've just fixed a bug\/error that stopped all\ncomments from being posted by complaining that all fields were empty even\nwhen they weren't. This plug in should probably not be being used but for\nthose that are I'll fix critical bugs when then show up.\n<\/code><\/pre>\n\n<h4>2.3.1<\/h4>\n\n<ul>\n<li>Fixed: During the find process the action_id was always zero and not the ID\nof the last action that was retrieved. This meant that you would grab all\nrows since your last page load time. Not a huge problem but it did mean\nsomethings were being done more than once which caused problems from the\nfront end moderation and deletes.<\/li>\n<li>Changed: The link on the admin page pointed to something that no longer\nexists and hasn't existed in a long time.<\/li>\n<li>Fixed: Typo in function name, it was consistent throughout the code so\nwasn't a problem but it was ugly.<\/li>\n<\/ul>\n\n<h4>2.3<\/h4>\n\n<ul>\n<li>Fixed problems with SSL URLs.<\/li>\n<li>Added caching to the Ajax update requests if you a caching plug-in installed.<\/li>\n<li>Added front end moderation.<\/li>\n<\/ul>\n\n<h4>2.2.2<\/h4>\n\n<ul>\n<li>Fixed issue with approve\/delete\/spam buttons on recently loaded comments.<\/li>\n<li>Minified the JS again.<\/li>\n<\/ul>\n\n<h4>2.2.1<\/h4>\n\n<ul>\n<li>Fixed a bug on some sites with certain versions of jQuery that prevented the comment ID being sent correctly<\/li>\n<li>Added further validation checks<\/li>\n<\/ul>\n\n<h4>2.2<\/h4>\n\n<ul>\n<li>Added frontend moderation tools for Live Discussion<\/li>\n<li>Added a Comment Moderator role, same privilledges as a subscriber, but with the additional ability to approve\/spam\/trash comments<\/li>\n<\/ul>\n\n<h4>2.1.7<\/h4>\n\n<ul>\n<li>The default options are now passed through a filter<\/li>\n<\/ul>\n\n<h4>2.1.6<\/h4>\n\n<ul>\n<li>Added a check to see if the current post_type supports comments and that\ncomments are open before adding the JS.\nFixed JS issue with the disabled attribute on the submit button.<\/li>\n<\/ul>\n\n<h4>2.1.5<\/h4>\n\n<ul>\n<li>Added new version of the Japanese translation which covers the three missing\nstring.\nFixed issue with the stylesheet selection dropdown not remembering your\nchoice if you picked \"disabled\".\nFixed issue with CSS in latest Opera.<\/li>\n<\/ul>\n\n<h4>2.1.4<\/h4>\n\n<ul>\n<li>Added two filters to control the avatar size for those that want or need to\nroll their own layout. The filters are spec_avatar_size_large and\nspec_avatar_size_small.<\/li>\n<\/ul>\n\n<h4>2.1.3<\/h4>\n\n<ul>\n<li>Adding Japanese translation provided by - Chestnut http:\/\/staff.blog.bng.net\nFixed some missing translation domains from 2 elements of code and added\ntranslation wrapper around the credit link.\nAdded a few actions to the comment form area to allow easier insertion of\ncode via plug-ins. Actions are as follows: 'before_comment_respond',\n'after_comment_respond', 'before_comment_form', 'comment_form_start' and\n'after_comment_form'.<\/li>\n<\/ul>\n\n<h4>2.1.2<\/h4>\n\n<ul>\n<li>Fix for the autogrow text jQuery to cope with textareas that area hidden at\nstart up. Previously they would have a width of 0px that would result in\nendless newlines.<\/li>\n<\/ul>\n\n<h4>2.1.1<\/h4>\n\n<ul>\n<li>Added option to override the global option for auto comment update on a post\nby post basis.\nAdded option to remove the link button from each comment.\nAdded a new quote button to each comment that lets you quickly cite another\ncomment in the discussion. There is also the option to disable it should you\nnot want it.\nAdded a new floating quote thingy that should, if set up right, pop up a\nfloating button next to any text selection in the post body. You'll need to\nknow the class or ID of your post content to set this up.\nNumerous fixes.<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Development release<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Added an option to remove the avatar in the comment form.\nAdded an option to set a title for the comment form.\nAdded some script to allow highlight of new comments as they arrive and also\nstyled up the two default styles to make use of the new class and icon.\nChanged the exclamation icon to a GPL compatible one from\nhttp:\/\/19eighty7.com\/icons<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>There is now a completely new theme for the comments which has been updated\nfor both the dark an light versions and should work with more themes.\nComments are now ajaxed for both submit and update. You have control over\nupdate frequency and the code will respect your choices for comment order\ndepth and all the other settings in the discussion area of the settings.\nMade sure it works with all versions of WP from 2.7 up, including WP 3.0.\nNew stylesheet handling code that allows us to add more styles quickly. You\ncan now add stylesheet to your theme\/child theme directory and that'll be\npicked up by the plug-in and offered as an option on the plug-in's admin\npage.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Moved the javascript to the footer and removed an unneeded script.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Added the reply link text to the translation fields for this plug-in rather\nthan use WP's own reply to make it a little easier for people to translate\nevery element.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Very minor fix for ie6. Seems I was a little over zealous trying to fix a\nhasLayout bug. Should be good now.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>\n\n<h4>0.9<\/h4>\n\n<ul>\n<li>Internal version.<\/li>\n<\/ul>","raw_excerpt":"Spectacu.la Discussion adds threaded commenting with live AJAX comments to almost any WordPress Theme.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/7553","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=7553"}],"author":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/spectacula"}],"wp:attachment":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=7553"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=7553"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=7553"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=7553"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=7553"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=7553"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}