Threaded Comments

I’m happy to announce version 1.5 of Brian’s Threaded Comments.
As of this version, I will no longer support previous versions of WordPress. I’ll leave the old files, but I will not make any more updates to them.

Brian’s Threaded Comments is a threaded comments plugin for WordPress 1.5.
An older version exists for WordPress 1.2 and WordPress 1.3, but it is unsupported.

Since there are already threaded comments plugins out there, and since “nested comments” is actually a more accurate term, I decided to name my plugin just that, and then I tacked my name on it for my megalomaniacal branding pleasure.

When this was first released, it was named “Brian’s Nested Comments”, but since that means I would never come up if people search for “threaded comments”, I decided to rename the plugin to threaded comments.
Installation for 1.5/2.0 version

1. Download the featured version from the google code project page.
2. Unzip.
3. Follow instructions in install.txt

Installation for 1.2/1.3 version

1. Download and unzip the plugin files from briansnestedcomments.zip
2. Copy the briansnestedcomments.php file to your plugins directory
3. Make a backup of your existing wp-comments-post.php and wp-comments.php
4. Copy wp-comments.php and wp-comments-post.php to your wp root folder
5. Activate the plugin from your plugin administration page (you would be surprised how many people have forgotten this step).

Assumptions

• The plugin assumes that your default database user has the priviledges to alter tables
• The plugin assumes that the default content DIV tag has the ID “content”
• The plugin might also assume other things about the structure of your document, so it’s safest to use the included wp-comments.php and modify it, unless you can understand the javascript well enough to see what you need to copy from the included comments.php (or wp-comments.php if you are using 1.2/1.3) to your own comments page

Support and discussion
Please use the project forums for support requests and discussion about the plugin.

Bugs and limitations
To report bugs, please add an issue to the google code project page.

• Collapsing fails in Internet Explorer, due to the fact that IE is a crappy browser.
• The plugin currently only works with WordPress 1.2.
• Doesn’t work with wp-comments-popup.php.
• Browsers that are really old and don’t have javascript DOM functionality probably wont be able to reply to a specific post. Browsers that are so old they don’t have javascript wont be able to post at all.
• A few people have had problems with the plugin not working at all. They way you can tell if this is happening to you is if you get javascript errors when trying to submit a comment. I can’t reproduce this, but I am trying to track down the problem.
  If this happens you, deactivate the plugin, restore your original .php files files, and wait for me to announce that is has been fixed
• If you have a in your , clicking the “reply to this comment” link will cause you to be tossed to your front page. For now, the only solution is to remove the tag.

FAQ

• Q: Does the plugin alter the database?
  A: Yes, it adds a column to the comments table.
• Q: Will the added column interfere with anything?
  A: Not as far as I can imagine.
• Q: If I remove the plugin again, will it destroy or alter my comments?
  A: No, but it will leave the column in the database. You can then delete it manually, or leave it there in case you ever want to use threaded comments again. All comments that were threaded when the plugin was active will just be shown “flat” and in chronological order – as if the plugin had never been there. If you reactivate the plugin and didn’t delete the column, your comments will be threaded again.
• Q: Will it work with the information stored from other threaded comments plugins/hacks?
  A: I can’t guarantee it, but there’s a very good change it would – I chose the name of the column because other peoples threaded comments were already using the same name.

---

Update 2005-03-04:
I am sorry for the wait for the 1.5 version, but as I have mentioned earlier, I am quite overwhelmed by work and private projects – I do plan on releasing it as soon as I can though.
Don’t give up hope Update 2005-03-15
The WordPress 1.5 version is here.Update 2005-01-15
BTC has been tested to work with WordPress 1.5 and WordPress 2.0 with the default theme.