summaryrefslogtreecommitdiff
path: root/modules/comment/helpers/comment.php
blob: 3b6c0240e465e097143ee74b4a1ec94686769441 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<?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.
 */

/**
 * This is the API for handling comments.
 *
 * Note: by design, this class does not do any permission checking.
 */
class comment_Core {
  const SECONDS_IN_A_MINUTE = 60;
  const SECONDS_IN_AN_HOUR = 3600;
  const SECONDS_IN_A_DAY = 86400;
  const SECONDS_IN_A_MONTH = 2629744;
  const SECONDS_IN_A_YEAR = 31556926;

  /**
   * Create a new comment.
   * @param string  $author author's name
   * @param string  $email author's email
   * @param string  $text comment body
   * @param integer $item_id id of parent item
   * @param string  $url author's url
   * @return Comment_Model
   */
  static function create($author, $email, $text, $item_id, $url=null) {
    $comment = ORM::factory("comment");
    $comment->author = $author;
    $comment->email = $email;
    $comment->text = $text;
    $comment->item_id = $item_id;
    $comment->url = $url;
    $comment->ip_addr = Input::instance()->ip_address();
    $comment->user_agent = Kohana::$user_agent;
    $comment->created = time();

    // @todo Figure out how to mock up the test of the spam_filter
    if (module::is_installed("spam_filter") && TEST_MODE == 0) {
      try {
        SpamFilter::instance()->check_comment($comment);
      } catch (Exception $e) {
        Kohana::log("error", print_r($e, 1));
        $comment->state = "unpublished";
      }
    } else {
      $comment->state = "published";
    }

    $comment->save();
    module::event("comment_created", $comment);

    return $comment;
  }

  /**
   * Update an existing comment.
   * @param Comment_Model $comment
   * @param string  $author author's name
   * @param string  $email author's email
   * @param string  $text comment body
   * @param string  $url author's url
   * @return Comment_Model
   */
  static function update($comment, $author, $email, $text, $url) {
    $comment->author = $author;
    $comment->email = $email;
    $comment->text = $text;
    $comment->url = $url;
    $comment->ip_addr = Input::instance()->ip_address();
    $comment->user_agent = Kohana::$user_agent;

    // @todo Figure out how to mock up the test of the spam_filter
    if (module::is_installed("spam_filter") && TEST_MODE == 0) {
      SpamFilter::instance()->check_comment($comment);
    }

    $comment->save();
    if ($comment->saved) {
      module::event("comment_updated", $comment);
    }

    return $comment;
  }

  static function get_add_form($item) {
    $form = new Forge("comments", "", "post");
    $group = $form->group("add_comment")->label(t("Add comment"));
    $group->input("author")  ->label(t("Author"))          ->id("gAuthor");
    $group->input("email")   ->label(t("Email"))           ->id("gEmail");
    $group->input("url")     ->label(t("Website (hidden)"))->id("gUrl");
    $group->textarea("text") ->label(t("Text"))            ->id("gText");
    $group->hidden("item_id")->value($item->id);
    $group->submit(t("Add"));
    $form->add_rules_from(ORM::factory("comment"));
    return $form;
  }

  static function get_edit_form($comment) {
    $form = new Forge("comments/{$comment->id}?_method=put", "", "post");
    $group = $form->group("edit_comment")->label(t("Edit comment"));
    $group->input("author") ->label(t("Author"))          ->id("gAuthor")->value($comment->author);
    $group->input("email")  ->label(t("Email"))           ->id("gEmail") ->value($comment->email);
    $group->input("url")    ->label(t("Website (hidden)"))->id("gUrl")   ->value($comment->url);
    $group->textarea("text")->label(t("Text"))            ->id("gText")  ->value($comment->text);
    $group->submit(t("Edit"));
    $form->add_rules_from($comment);
    return $form;
  }
}