Several large changes:

1) Changed the way that we get forms.  Now, if you want to get a form
   for a REST resource you prefix /form to the resource id.  So:
    /form/photo/1    : returns a form for editing photo id 1
    /form/comments/1 : returns a form for adding a comment to photo id 1
    /form/comment/1  : returns a form for editing comment id 1

2) Changed the comment module to have two controllers:
    comment:  deals with a single comment resource
    comments: deal with collections of comments attached to an item

Related stuff:
- Moved the comments js into the theme
- Reworked Comment_Helper for clarity
- Moved form generation code down into Comment_Helper
- Cleaned up routes (eliminating new comment ones added in recent rev)
- Added form() function to all REST controllers
- Changed comment module to use a block instead of an arbitrary helper call from the theme
- Comment controller only returns HTML currently, but returns a 201 Created status
  code when a new comment is added, which the Ajax code can catch and act upon.
- Got rid of a lot of extra views in comment module

1 files changed, 76 insertions, 0 deletions

diff --git a/modules/comment/controllers/comments.php b/modules/comment/controllers/comments.php
new file mode 100644
index 00000000..a0233a0b
--- /dev/null
+++ b/modules/comment/controllers/comments.php
@@ -0,0 +1,76 @@
+<?php defined("SYSPATH") or die("No direct script access.");
+/**
+ * Gallery - a web based photo album viewer and editor
+ * Copyright (C) 2000-2008 Bharat Mediratta
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or (at
+ * your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+class Comments_Controller extends REST_Controller {
+  protected $resource_type = "item";
+
+  /**
+   * Present a form for adding a new comment to this item
+   *  @see Rest_Controller::form($resource)
+   */
+  public function _form($item) {
+    $form = comment::get_add_form($item);
+    print $form->render("form.html");
+  }
+
+  /**
+   * Show the comment collection
+   *  @see Rest_Controller::_get($resource)
+   */
+  public function _get($item) {
+    print comment::get_comments($item);
+  }
+
+  /**
+   * Update existing comment collection.
+   *  @see Rest_Controller::_put($resource)
+   */
+  public function _put($item) {
+    throw new Exception("@todo Comment_Controller::_put NOT IMPLEMENTED");
+  }
+
+  /**
+   * Add a new comment to the collection
+   * @see Rest_Controller::_post($resource)
+   */
+  public function _post($item) {
+    $form = comment::get_add_form($item);
+    if ($form->validate()) {
+      $comment = ORM::factory('comment');
+      $comment->author = $this->input->post('author');
+      $comment->email = $this->input->post('email');
+      $comment->text = $this->input->post('text');
+      $comment->datetime = time();
+      $comment->item_id = $item->id;
+      $comment->save();
+
+      header("HTTP/1.1 201 Created");
+      header("Location: " . url::site("comment/{$comment->id}"));
+    }
+    print $form->render("form.html");
+  }
+
+  /**
+   * Delete existing comment collection.
+   *  @see Rest_Controller::_delete($resource)
+   */
+  public function _delete($item) {
+    throw new Exception("@todo Comment_Controller::_delete NOT IMPLEMENTED");
+  }
+}