This is a quick-and-dirty introduction the ComicComment plugin for ComicCMS.

INSTALLATION
----------------
NOTE: YOU must be running at least version 0.2 of ComicCMS
  Step 1: Download the plugin (comiccomment.php)  to your local hard drive
  Step 2: Login to the admin page, click on the plugins icon, and then click on the "Install Plugin" link. 
  Step 3: Follow the instructions to upload and activate the plugin

CONFIGURATION
-------------------
  Step 1: click on the plugins icon, find the Comic Comments area on the page, and click on "Edit Plugin"
  Step 2: Configure your settings as you like, but make sure that the redirect URL is not blank.
              If for some reason it is blank, "http://your_website-here/?id={{comic_id}}" is a good default.
              Also, unless you want to be nagged, enable either reCAPTCHA or BanHTML (or even both!)

ADDING COMMENTS TO A TEMPLATE
------------------------------------------
Step 1: Make sure the template you are using has comics. Without a Comics, no comments will be loaded.
Step 2: Add the following code (or something similar) in the right place in your template:

{{foreach:comic_comment}}
    {{if:comment_author_email}}<img src="http://www.gravatar.com/avatar/{{comment_author_email:md5}}?s=45&d=wavatar" alt="Gravatar" title="Posted by {{comment_author_name}}" class="commentavatar"/>{{endif}}
    <span class="commentdetail">Posted at {{comment_hour}}:{{comment_minute}}<br />{{comment_weekday:shortname}} {{comment_day}} {{comment_month:shortname}} {{comment_year}}<br /> by {{comment_author_name}}</span>
   {{comment_post:rich}}
{{endeach:comic_comment}}

{{if:comic_tag:!==closed}}
<form action="http:///admin/?type=action&amp;a=comiccomment&amp;id={{comic_id}}" method="post" class=formbox>
  <input type="text" name="name"  tabindex="1" /><label for="comment_name"><small>NAME &mdash; <a href="http://gravatar.com">Get a Gravatar</a></small></label> <br />
  <input type="text" name="email"  tabindex="2" /><label for="comment_email"><small>EMAIL &mdash; Required / not published </small></label><br />
  <input type="text" name="website"  tabindex="3"  /><label for="comment_websites"><small>WEBSITE</small></label><br />
  <label for="comment_post">Comment</label><br />
  <textarea name="post"  cols="50" rows="6" tabindex="4" ></textarea><br /> 
  {{plugin:recaptcha}}
  <input type="submit" value="Add Comment" /> 
 </form>

{{else}}

<h2><em>This discussion thread is closed</em></h2>

{{endif}}

Step 3: Edit your CSS file (ie. commentavatar, commentdetail, formbox, add some other classes for divs, etc.) to control the appearance of the comments and form
Step 4: To prevent comments from being added to a comics, add the "closed" tag to the comic using the "edit comic data" link from the admin panel.

Note: Gravatars are not required for Comments, but are a common request so I have included in them here.

EDITING/DELETING A COMMENT
 Step 1: Click on the plugins icon, find the Comic Comments area on the page, and click on "Use Plugin"
 Step 2: Locate the comment you wish to edit/delete.
 Step 3: Click on the comment title to edit it, or on the "X" to delete it.


UNINSTALLING THE PLUGIN
-----------------------------
Use the normal procedure to remove the plugin. Note that this will delete all of the comments and is not recoverable.
 Step 1: Click on the plugins icon, find the Comic Comments area on the page, and click on "Remove Plugin"
 Step 2: Follow the instructions.

TROUBLESHOOTING
-------------------------
Q: I get redirected to a blank/invalid screen after a successful add
A: Make sure the URL is correct in the module settings

Q: I did a ComicCMS update and things are not working
A: Re-check that your module settings were not altered during the update. 

Q: Hey, I was able to make a comment with HTML when "Ban HTML" was enabled. What gives?
A: You were logged into your ComicCMS account. The check is only enforced for Guests.

Q: What is the "Log Bad Posts" option in Settings?
A: Enabling this causes all comments rejected as likely spam to be logged to admin/BADLOG.txt for later review.

Q: Why doesn't my Gravatar's show up? I swear I have one.
A: If you are a Guest (not logged in), you likely entered a trailing space. If you have a ComicCMS account and were logged in, check your account email settings (which override anything in the form).

Q: Do I have to use reCaptcha? It irritates some of my users.
A: No. You can just "Ban HTML" and that should filter out many (but not all) spam. Still, enabling both is recommended.