gallery3/modules/comment/controllers/comments.php

<?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 = "comment";

  /**
   * Display comments based on criteria.
   *  @see Rest_Controller::_index()
   */
  public function _index() {
    $item_id = $this->input->get('item_id');

    if (empty($item_id)) {
      /* We currently do not support getting all comments from the entire gallery. */
      header("HTTP/1.1 400 Bad Request");
      return;
    }
    print comment::get_comments($item_id, $this->get_output_format());
  }

  /**
   * Add a new comment to the collection.
   * @see Rest_Controller::_create($resource)
   */
  public function _create($comment) {
    $form = comment::get_add_form($this->input->post('item_id'));
    if ($form->validate()) {
      $comment->author = $this->input->post('author');
      $comment->email = $this->input->post('email');
      $comment->text = $this->input->post('text');
      $comment->datetime = time();
      $comment->item_id = $this->input->post('item_id');
      $comment->save();

      header("HTTP/1.1 201 Created");
      header("Location: " . url::site("comments/{$comment->id}"));
    }
    // @todo Return appropriate HTTP status code indicating error.
    print $form;
  }

  /**
   * Display an existing comment.
   *  @todo Set proper Content-Type in a central place (REST_Controller::dispatch?).
   *  @see Rest_Controller::_show($resource, $output_format)
   */
  public function _show($comment, $output_format) {
    switch ($output_format) {
    case "xml":
      header("Content-Type: application/xml");
      print xml::to_xml($comment->as_array(), array("comment"));
      break;

    case "json":
      header("Content-Type: application/json");
      print json_encode($comment->as_array());
      break;

    default:
      $v = new View("comment.$output_format");
      $v->comment = $comment;
      print $v;
    }
  }

  /**
   * Change an existing comment.
   *  @see Rest_Controller::_update($resource)
   */
  public function _update($comment) {
    $form = comment::get_edit_form($comment);
    if ($form->validate()) {
      $comment->author = $this->input->post('author');
      $comment->email = $this->input->post('email');
      $comment->text = $this->input->post('text');
      $comment->save();
      return;
    }
    // @todo Return appropriate HTTP status code indicating error.
    print $form;
  }

  /**
   * Delete existing comment.
   *  @see Rest_Controller::_delete($resource)
   */
  public function _delete($comment) {
    throw new Exception("@todo Comment_Controller::_delete NOT IMPLEMENTED");
  }

  /**
   * Present a form for adding a new comment to this item or editing an existing comment.
   *  @see Rest_Controller::form($resource)
   */
  public function _form($resource, $form_type) {
	// This code will be clearer if we split form() into two functions.
    if ($form_type == "edit") {
      $form = comment::get_edit_form($resource);
    } else {
      $form = comment::get_add_form($resource);
    }
    print $form;
  }
}