comment.module 55.7 KB
Newer Older
1
<?php
2
// $Id$
Dries Buytaert's avatar
 
Dries Buytaert committed
3

Dries Buytaert's avatar
   
Dries Buytaert committed
4
5
$GLOBALS["cmodes"] = array(1 => t("Flat list - collapsed"), 2 => t("Flat list - expanded"), 3 => t("Threaded list - collapsed"), 4 => t("Threaded list - expanded"));
$GLOBALS["corder"] = array(1 => t("Date - newest first"), 2 => t("Date - oldest first"));
Dries Buytaert's avatar
   
Dries Buytaert committed
6

Dries Buytaert's avatar
   
Dries Buytaert committed
7
function comment_help() {
Dries Buytaert's avatar
   
Dries Buytaert committed
8
  $output .= "<p>The comment module enables users to submit posts that are directly associated with a piece of content.  These associated posts are called <i>comments</i>.  Comments may be <i>threaded</i>, which means that Drupal keeps track of multiple subconversations around a piece of content.  Threading helps to keep the comment conversation more organized.  Users are presented with several ways to view the comment conversation, and if desired, users may easily choose a <i>flat</i> presentation of comments instead of threaded.  Further, users may choose to order their comments view by <i>newest first</i> or by <i>oldest first</i>.  Finally, users may view a folded list or an expanded list of comments.  Folded limits the comment display to <i>subject</i> only.  Drupal remembers the comment view preference of each registered user whenever he changes a view setting.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
9
  $output .= "<p>Users may also choose to view a maximum number of comments; if there are more comments, navigation links are dispayed.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
10
  $output .= "<p>Since a busy site generates lots of comments, Drupal takes care to present a personalized view of comments for each user.  The home page lists displays the number of read and unread comments for a given post for the current user.  Also, the tracker module (when installed) displays all recent comments on the site.  Finally, comments which the user has not yet read are highlighted with a red star (this graphic may depend on the current theme).</p>";
Kjartan Mannes's avatar
Kjartan Mannes committed
11
  $output .= "<p>Comments behave like other user submissions in Drupal.  Specifically, ". la("filters", array("mod" => "system", "type" => "filter")) ." like smileys and HTML work fine if the administrator has enabled them.  Also, throttles are usually enabled to prevent a single user from spamming the web site with too many comments in a short period of time.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
12
  $output .= "<p>Administrators may control which persons are allowed to submit and administer comments.  These controls appear in the ". la("user permissions", array("mod" => "user", "op" => "permission")) ." administration page.  Additionally, administrators may edit or search through comments on the ". la("comments admininistration page", array("mod" => "comment")) .", as well as set the default display view for new users. Administrators can also state whether a certain role will have their comments published immediately, or just put in a queue to be reviewed.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
13
  $output .= "<p>If you really have a lot of comments, you can enable moderation. You assign moderation permissions to role(s), then setup some \"moderation votes\"; these votes will appear to moderators in a dropdown menu near the comment. You also have to assign, for every role and every vote, a value, which can be either positive or negative; use the moderation matrix to do this. This allows for some roles having greater \"weight\" in their moderation, if you wish. If you set a value to 0, that vote won't be available to that role. When a user moderates, the value of their vote is added or subtracted to the score of that comment. Finally, you may want to setup the comment threshholds: these are floor/ceiling values which users see in the comment control panel. Threshholds are useful for hiding poorly rated comments while reading your site.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
14
15
16
17

  return $output;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
18
function comment_system($field) {
19
  $system["description"] = t("Enables user to comment on content (nodes).");
20
21
22
  return $system[$field];
}

Dries Buytaert's avatar
   
Dries Buytaert committed
23
24
function comment_conf_options() {
  global $cmodes, $corder;
Dries Buytaert's avatar
   
Dries Buytaert committed
25

Dries Buytaert's avatar
   
Dries Buytaert committed
26
27
  $output .= form_select("Default display mode", "comment_default_mode", variable_get("comment_default_mode", 4), $cmodes, "The default view for comments. Expanded views display the body of the comment. Threaded views keep replies together.");
  $output .= form_select("Default display order", "comment_default_order", variable_get("comment_default_order", 1), $corder, "The default sorting for new users and anonymous users while viewing comments. These users may change their view using the comment control panel. For registered users, this change is remembered as a persistent user preference.");
Dries Buytaert's avatar
   
Dries Buytaert committed
28
  $output .= form_textfield("Default comments per page", "comment_default_per_page", variable_get("comment_default_per_page", "50"), 5, 5, "Default number of comments for each page; more comments are distributed in several pages.");
Dries Buytaert's avatar
   
Dries Buytaert committed
29

Dries Buytaert's avatar
   
Dries Buytaert committed
30
31
32
  $result = db_query("SELECT fid, filter FROM moderation_filters");
  while ($filter = db_fetch_object($result)) {
    $thresholds[$filter->fid] = ($filter->filter);
Dries Buytaert's avatar
   
Dries Buytaert committed
33
34
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
35
  $output .= form_select("Default threshold", "comment_default_threshold", variable_get("comment_default_threshold", 0), $thresholds, "Thresholds are values below which comments are hidden. These threshholds are useful for busy sites which wan tto hide poor comments from most users.");
Dries Buytaert's avatar
   
Dries Buytaert committed
36

Dries Buytaert's avatar
   
Dries Buytaert committed
37
38
39
  $output .= form_select("Preview comment", "comment_preview", variable_get("comment_preview", 1), array("optional", "required"), "Must users preview comments before submitting?");
  $output .= form_select("New comment form", "comment_new_form", variable_get("comment_new_form", 0), array("disabled", "enabled"), "New comment form in the node page?");
  $output .= form_select("Comment controls", "comment_controls", variable_get("comment_controls", 0), array("above comments", "below comments", "above and below"), "Position of the comment controls box.");
Dries Buytaert's avatar
   
Dries Buytaert committed
40

Dries Buytaert's avatar
   
Dries Buytaert committed
41
  return $output;
Dries Buytaert's avatar
   
Dries Buytaert committed
42
43
}

Dries Buytaert's avatar
   
Dries Buytaert committed
44
45
46
47
48
49
50
51
function comment_user($type, $edit, &$user) {
  switch ($type) {
    case "view_public":
      return form_item(t("Signature"), check_output($user->signature, 1));
    case "view_private":
      return form_item(t("Signature"), check_output($user->signature, 1));
    case "edit_form":
      // when user tries to edit his own data
Dries Buytaert's avatar
   
Dries Buytaert committed
52
      return form_textarea(t("Signature"), "signature", $edit["signature"], 70, 3, t("Your signature will be publicly displayed at the end of your comments.") ."<br />". t("Allowed HTML tags") .": ". htmlspecialchars(variable_get("allowed_html", "<a> <b> <dd> <dl> <dt> <i> <li> <ol> <u> <ul>")));
Dries Buytaert's avatar
   
Dries Buytaert committed
53
54
55
    case "edit_validate":
      // validate user data editing
      return array("signature" => filter($edit["signature"]));
Dries Buytaert's avatar
   
Dries Buytaert committed
56
57
58
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
59
function comment_access($op, $comment) {
Dries Buytaert's avatar
   
Dries Buytaert committed
60
61
  global $user;

Dries Buytaert's avatar
   
Dries Buytaert committed
62
63
64
65
66
67
68
69
70
71
72
  if ($op == "edit") {

    /*
    ** Authenticated users can edit their comments as long they have
    ** not been replied to.  This, in order to avoid people changing
    ** or revising their statements based on the replies their posts
    ** got. Furthermore, users can't reply to their own comments and
    ** are encouraged to extend their original comment.
    */

    return $user->uid && $user->uid == $comment->uid && comment_num_replies($comment->cid) == 0;
Dries Buytaert's avatar
   
Dries Buytaert committed
73
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
74

Dries Buytaert's avatar
   
Dries Buytaert committed
75
76
77
78
79
80
81
82
83
84
85
}

function comment_form($edit) {
  global $user;

  $form .= "<a name=\"comment\"></a>\n";

  // name field:
  $form .= form_item(t("Your name"), format_name($user));

  // subject field:
Dries Buytaert's avatar
   
Dries Buytaert committed
86
  $form .= form_textfield(t("Subject"), "subject", $edit["subject"], 50, 64);
Dries Buytaert's avatar
   
Dries Buytaert committed
87
88

  // comment field:
Dries Buytaert's avatar
   
Dries Buytaert committed
89
  $form .= form_textarea(t("Comment"), "comment", $edit["comment"] ? $edit["comment"] : $user->signature, 70, 10, t("Allowed HTML tags") .": ". htmlspecialchars(variable_get("allowed_html", "<a> <b> <dd> <dl> <dt> <i> <li> <ol> <u> <ul>")));
Dries Buytaert's avatar
   
Dries Buytaert committed
90
91

  // preview button:
Dries Buytaert's avatar
   
Dries Buytaert committed
92
  $form .= form_hidden("cid", $edit["cid"]);
Dries Buytaert's avatar
   
Dries Buytaert committed
93
  $form .= form_hidden("pid", $edit["pid"]);
Dries Buytaert's avatar
   
Dries Buytaert committed
94
  $form .= form_hidden("nid", $edit["nid"]);
Dries Buytaert's avatar
   
Dries Buytaert committed
95

Dries Buytaert's avatar
   
Dries Buytaert committed
96
  if (!$edit["comment"] && variable_get("comment_preview", 1)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
97
98
99
100
101
102
103
    $form .= form_submit(t("Preview comment"));
  }
  else {
    $form .= form_submit(t("Preview comment"));
    $form .= form_submit(t("Post comment"));
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
104
  return form($form, "post", drupal_url(array("mod" => "comment", "op" => "reply", "id" => $edit["nid"]), "module"));
Dries Buytaert's avatar
   
Dries Buytaert committed
105
106
}

Dries Buytaert's avatar
   
Dries Buytaert committed
107
108
109
function comment_edit($cid) {
  global $user;

Dries Buytaert's avatar
   
Dries Buytaert committed
110
  $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.cid = '%d' AND c.status != 2", $cid));
Dries Buytaert's avatar
   
Dries Buytaert committed
111
112
113
114
115
116
117

  if (comment_access("edit", $comment)) {
    comment_preview(object2array($comment));
  }
}

function comment_reply($pid, $nid) {
118
  global $theme;
Dries Buytaert's avatar
   
Dries Buytaert committed
119

120
  if (user_access("access comments")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
121
122
123
124
125

    /*
    ** Show comment
    */

Dries Buytaert's avatar
   
Dries Buytaert committed
126
    if ($pid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
127
128
      $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.cid = '%d' AND c.status = 0", $pid));
      comment_view($comment);
Dries Buytaert's avatar
   
Dries Buytaert committed
129
130
131
132
133
    }
    else {
      node_view(node_load(array("nid" => $nid)));
      $pid = 0;
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
134

Dries Buytaert's avatar
   
Dries Buytaert committed
135
136
137
138
    /*
    ** If possible, show reply form
    */

Dries Buytaert's avatar
   
Dries Buytaert committed
139
140
    if (node_comment_mode($nid) == 1) {
      $theme->box(t("Reply"), t("This discussion is closed: you can't post new comments."));
Kjartan Mannes's avatar
Kjartan Mannes committed
141
142
    }
    else if (user_access("post comments", $context)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
143
144
145
146
147
      $theme->box(t("Reply"), comment_form(array("pid" => $pid, "nid" => $nid)));
    }
    else {
      $theme->box(t("Reply"), t("You are not authorized to post comments."));
    }
Kjartan Mannes's avatar
Kjartan Mannes committed
148
149
  }
  else {
Dries Buytaert's avatar
   
Dries Buytaert committed
150
    $theme->box(t("Reply"), t("You are not authorized to view comments."));
Dries Buytaert's avatar
   
Dries Buytaert committed
151
152
153
154
155
156
  }
}

function comment_preview($edit) {
  global $theme, $user;

Dries Buytaert's avatar
   
Dries Buytaert committed
157
158
159
160
161
  foreach ($edit as $key => $value) {
    $comment->$key = filter($value);
  }

  /*
Dries Buytaert's avatar
   
Dries Buytaert committed
162
  ** Attach the user and time information:
Dries Buytaert's avatar
   
Dries Buytaert committed
163
164
165
166
167
168
169
170
171
172
  */

  $comment->uid = $user->uid;
  $comment->name = $user->name;
  $comment->timestamp = time();

  /*
  ** Preview the comment:
  */

Dries Buytaert's avatar
   
Dries Buytaert committed
173
  comment_view($comment);
Dries Buytaert's avatar
   
Dries Buytaert committed
174
175

  $theme->box(t("Reply"), comment_form($edit));
Kjartan Mannes's avatar
Kjartan Mannes committed
176
177

  if ($edit["pid"]) {
Dries Buytaert's avatar
   
Dries Buytaert committed
178
179
    $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.cid = '%d' AND c.status = 0", $edit["pid"]));
    comment_view($comment);
Kjartan Mannes's avatar
Kjartan Mannes committed
180
181
182
183
184
  }
  else {
    node_view(node_load(array("nid" => $edit["nid"])));
    $edit["pid"] = 0;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
185
186
187
}

function comment_post($edit) {
Dries Buytaert's avatar
   
Dries Buytaert committed
188
  global $user;
Dries Buytaert's avatar
   
Dries Buytaert committed
189

Dries Buytaert's avatar
   
Dries Buytaert committed
190
  if (user_access("post comments") && node_comment_mode($edit["nid"]) == 2) {
Dries Buytaert's avatar
   
Dries Buytaert committed
191

Dries Buytaert's avatar
   
Dries Buytaert committed
192
193
194
195
196
197
198
199
200
201
202
203
204
    /*
    ** Validate the comment's subject.  If not specified, extract
    ** one from the comment's body.
    */

    $edit["subject"] = strip_tags(($edit["subject"] ? $edit["subject"] : substr($edit["comment"], 0, 29)));

    /*
    ** Validate the comment's body.
    */

    $edit["comment"] = filter($edit["comment"]);

Dries Buytaert's avatar
   
Dries Buytaert committed
205
206
207
208
    if ($edit["comment"] == "") {
      return array(t("Empty comment"), t("The comment you submitted is empty."));
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
209
210
211
212
213
    /*
    ** Check for duplicate comments.  Note that we have to use the
    ** validated/filtered data to perform such check.
    */

Dries Buytaert's avatar
   
Dries Buytaert committed
214
    $duplicate = db_result(db_query("SELECT COUNT(cid) FROM comments WHERE pid = '%d' AND nid = '%d' AND subject = '%s' AND comment = '%s'", $edit["pid"], $edit["nid"], $edit["subject"], $edit["comment"]), 0);
Dries Buytaert's avatar
   
Dries Buytaert committed
215
216

    if ($duplicate != 0) {
Dries Buytaert's avatar
   
Dries Buytaert committed
217
      watchdog("warning", "comment: duplicate '". $edit["subject"] ."'");
Dries Buytaert's avatar
   
Dries Buytaert committed
218
      return array(t("Duplicate comment"), t("The comment you submitted has already been inserted."));
Dries Buytaert's avatar
   
Dries Buytaert committed
219
220
221
    }
    else {

Dries Buytaert's avatar
   
Dries Buytaert committed
222
      if ($edit["cid"]) {
Dries Buytaert's avatar
   
Dries Buytaert committed
223

Dries Buytaert's avatar
   
Dries Buytaert committed
224
225
226
227
228
229
        /*
        ** Update the comment in the database.  Note that the update
        ** query will fail if the comment isn't owned by the current
        ** user.
        */

Dries Buytaert's avatar
   
Dries Buytaert committed
230
231
232
233
234
235
236
        db_query("UPDATE comments SET subject = '%s', comment = '%s' WHERE cid = '%d' AND uid = '$user->uid'", $edit["subject"], $edit["comment"], $edit["cid"]);

        /*
        ** Fire a hook
        */

        module_invoke_all("comment", "update", $edit);
Dries Buytaert's avatar
   
Dries Buytaert committed
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255

        /*
        ** Add entry to the watchdog log:
        */

        watchdog("special", "comment: updated '". $edit["subject"] ."'");
      }
      else {
        /*
        ** Check the user's comment submission rate.  If exceeded,
        ** throttle() will bail out.
        */

        throttle("post comment", variable_get("max_comment_rate", 60));

        /*
        ** Add the comment to database:
        */

Dries Buytaert's avatar
   
Dries Buytaert committed
256
257
258
259
260
261
262
263
264
265
266
267
268
269
        $status = user_access("post comments without approval") ? 0 : 1;
        $roles = variable_get("comment_roles", array());
        $score = $roles[$user->rid] ? $roles[$user->rid] : 0;
        $users = serialize(array(0 => $score));

        $edit["cid"] = db_next_id("comments");

        db_query("INSERT INTO comments (cid, nid, pid, uid, subject, comment, hostname, timestamp, status, score, users) VALUES ('%d', '%d', '%d', '$user->uid', '%s', '%s', '%s', '%s', '%s', $score, '%s')", $edit["cid"], $edit["nid"], $edit["pid"], $edit["subject"], $edit["comment"], getenv("REMOTE_ADDR"), time(), $status, $users);

        /*
        ** Tell the other modules a new comment has been submitted:
        */

        module_invoke_all("comment", "insert", $edit);
Dries Buytaert's avatar
   
Dries Buytaert committed
270
271
272
273

        /*
        ** Add entry to the watchdog log:
        */
Dries Buytaert's avatar
   
Dries Buytaert committed
274

Dries Buytaert's avatar
   
Dries Buytaert committed
275
276
        watchdog("special", "comment: added '". $edit["subject"] ."'");
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
277
278
279
280

      /*
      ** Clear the cache:
      */
Dries Buytaert's avatar
   
Dries Buytaert committed
281
282

      cache_clear();
Dries Buytaert's avatar
   
Dries Buytaert committed
283

Dries Buytaert's avatar
   
Dries Buytaert committed
284
285
286
287
288
289
      /*
      ** TODO: we'd prefer to invalidate the page or pages with the newly
      ** inserted comment.
      **
      ** db_query("DELETE FROM cache WHERE cid LIKE '%s'", "%id=".$edit["nid"]."%");
      */
Dries Buytaert's avatar
   
Dries Buytaert committed
290
291
    }
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
292
293
294
295
  else {
    watchdog("error", "comment: unauthorized comment submitted or comment submitted to a closed node '". $edit["subject"] ."'");
    return array(t("Error"), t("You are not authorized to post comments, or this node doesn't accept new comments."));
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
296
297

  /*
Dries Buytaert's avatar
   
Dries Buytaert committed
298
  ** Redirect the user the node he commented on, or explain queue
Dries Buytaert's avatar
   
Dries Buytaert committed
299
300
  */

Dries Buytaert's avatar
   
Dries Buytaert committed
301
302
  if ($status == 1) {
    return array(t("Comment queued"), t("Your comment has been queued for moderation by site administrators and will be published after approval."));
Dries Buytaert's avatar
   
Dries Buytaert committed
303
304
305
306
  }
}

function comment_links($comment, $return = 1) {
Dries Buytaert's avatar
   
Dries Buytaert committed
307
  global $user, $theme;
Dries Buytaert's avatar
   
Dries Buytaert committed
308

Dries Buytaert's avatar
   
Dries Buytaert committed
309
310
  $links = array();

Dries Buytaert's avatar
   
Dries Buytaert committed
311
312
313
314
  /*
  ** If we are viewing just this comment, we link back to the node
  */

Dries Buytaert's avatar
   
Dries Buytaert committed
315
  if ($return) {
Dries Buytaert's avatar
   
Dries Buytaert committed
316
    $links[] = l(t("return"), array("id" => $comment->nid), "node", $comment->cid);
Dries Buytaert's avatar
   
Dries Buytaert committed
317
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
318

Dries Buytaert's avatar
   
Dries Buytaert committed
319
320
321
322
  /*
  ** Admin link
  */

Dries Buytaert's avatar
   
Dries Buytaert committed
323
  if (user_access("administer comments")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
324
    $links[] = la(t("administer"), array("mod" => "comment", "op" => "edit", "id" => $comment->cid));
Dries Buytaert's avatar
   
Dries Buytaert committed
325
    // $links[] = lm(t("unpublish"), array ("mod" => "comment", "op" => "Moderate comment", "moderation[$comment->cid]" => "offline", "edit[nid]" => $comment->nid), "", array ("title" => t("hide this comment by marking it non-published")));
Dries Buytaert's avatar
   
Dries Buytaert committed
326
327
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
328
  /*
Dries Buytaert's avatar
   
Dries Buytaert committed
329
  ** Possibly show edit and reply links
Dries Buytaert's avatar
   
Dries Buytaert committed
330
  */
Dries Buytaert's avatar
   
Dries Buytaert committed
331

Dries Buytaert's avatar
   
Dries Buytaert committed
332
333
334
  if (node_comment_mode($comment->nid) == 2) {
    if (user_access("post comments")) {
      if (comment_access("edit", $comment)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
335
        $links[] = lm(t("edit your comment"), array("mod" => "comment", "op" => "edit", "id" => $comment->cid), "", array("title" => t("Make changes to your comment.")));
Dries Buytaert's avatar
   
Dries Buytaert committed
336
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
337
      $links[] = lm(t("reply to this comment"), array("mod" => "comment", "op" => "reply", "id" => $comment->nid, "pid" => $comment->cid));
Dries Buytaert's avatar
   
Dries Buytaert committed
338
339
    }
    else {
Dries Buytaert's avatar
   
Dries Buytaert committed
340
      $links[] = theme_invoke("comment_post_forbidden");
Dries Buytaert's avatar
   
Dries Buytaert committed
341
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
342
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
343
344
345
346

  if ($moderation = comment_moderation_form($comment)) {
    $links[] = $moderation;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
347
348

  return $theme->links($links);
Dries Buytaert's avatar
   
Dries Buytaert committed
349
350
}

Dries Buytaert's avatar
   
Dries Buytaert committed
351
352
353
354
355
function comment_view($comment, $links = "", $visible = 1) {

  /*
  ** Switch to folded/unfolded view of the comment
  */
Dries Buytaert's avatar
   
Dries Buytaert committed
356
357

  if (comment_is_new($comment)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
358
    $comment->new = 1;
Dries Buytaert's avatar
   
Dries Buytaert committed
359
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
360

Dries Buytaert's avatar
   
Dries Buytaert committed
361
362
363
  print "<a name=\"$comment->cid\">\n";

  if ($visible) {
Dries Buytaert's avatar
   
Dries Buytaert committed
364
    theme_invoke("comment", $comment, $links);
Dries Buytaert's avatar
   
Dries Buytaert committed
365
366
  }
  else {
Dries Buytaert's avatar
   
Dries Buytaert committed
367
    theme_invoke("comment_folded", $comment);
Dries Buytaert's avatar
   
Dries Buytaert committed
368
369
370
371
  }
}


Dries Buytaert's avatar
   
Dries Buytaert committed
372
373
function comment_render($node, $cid = 0) {
  global $user, $theme, $mode, $order, $threshold, $comment_page;
Dries Buytaert's avatar
   
Dries Buytaert committed
374
375
376
377
378
379
380

  if (user_access("access comments")) {

    /*
    ** Pre-process variables:
    */

Dries Buytaert's avatar
   
Dries Buytaert committed
381
    $nid = $node->nid;
Dries Buytaert's avatar
   
Dries Buytaert committed
382
383
    if (empty($nid)) {
      $nid = 0;
Dries Buytaert's avatar
   
Dries Buytaert committed
384
385
386
    }

    if (empty($mode)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
387
      $mode = $user->mode ? $user->mode : variable_get("comment_default_mode", 4);
Dries Buytaert's avatar
   
Dries Buytaert committed
388
389
390
    }

    if (empty($order)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
391
      $order = $user->sort ? $user->sort : variable_get("comment_default_order", 1);
Dries Buytaert's avatar
   
Dries Buytaert committed
392
393
394
    }

    if (empty($threshold)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
395
      $threshold = $user->uid ? $user->threshold : variable_get("comment_default_threshold", 0);
Dries Buytaert's avatar
   
Dries Buytaert committed
396
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
397
    $threshold_min = db_result(db_query("SELECT minimum FROM moderation_filters WHERE fid = '%d'", $threshold));
Dries Buytaert's avatar
   
Dries Buytaert committed
398

Dries Buytaert's avatar
   
Dries Buytaert committed
399
400
401
    if (empty($comment_page)) {
      $comment_page = 1;
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
402

Dries Buytaert's avatar
   
Dries Buytaert committed
403
404
405
    $comments_per_page = $user->comments_per_page ? $user->comments_per_page : variable_get("comment_default_per_page", "50");

    print "<a name=\"comment\"></a>\n";
Dries Buytaert's avatar
   
Dries Buytaert committed
406
407


Kjartan Mannes's avatar
Kjartan Mannes committed
408
    if ($cid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
409
410
411
412
413
414
415
416
417
418

      /*
      ** Single comment view
      */

      print "<form method=\"post\" action=\"". drupal_url(array("mod" => "comment"), "module") ."\">\n";
      print form_hidden("nid", $nid);

      $result = db_query("SELECT c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.cid = '%d' AND c.status = 0 GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users", $cid);

Dries Buytaert's avatar
   
Dries Buytaert committed
419
420
421
      if ($comment = db_fetch_object($result)) {
        comment_view($comment, comment_links($comment));
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
422

Dries Buytaert's avatar
   
Dries Buytaert committed
423
424
425
426
      if ((user_access("administer comments") || comment_user_can_moderate($node)) && $user->uid != $comment->uid && !(comment_already_moderated($user->uid, $comment->users))) {
        print "<div align=\"center\">". form_submit(t("Moderate comment")) ."</div><br />";
      }
      print "</form>";
Dries Buytaert's avatar
   
Dries Buytaert committed
427
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
428
    else {
Dries Buytaert's avatar
   
Dries Buytaert committed
429

Dries Buytaert's avatar
   
Dries Buytaert committed
430
431
432
433
434
435
436
437
      /*
      ** Multiple comments view
      */

      $query .= "SELECT c.cid as cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.nid = '". check_query($nid) ."' AND c.status = 0";

      if ($cid) {
        $query .= " AND pid = '". check_query($cid) ."'";
Dries Buytaert's avatar
   
Dries Buytaert committed
438
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
439
440
441
442
443

      $query .= " GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users";

      if ($order == 1) {
        $query .= " ORDER BY c.timestamp DESC";
Dries Buytaert's avatar
   
Dries Buytaert committed
444
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
445
446
447
448
449
450
451
452
453
454
455
456
457
      else if ($order == 2) {
        $query .= " ORDER BY c.timestamp";
      }

      /*
      ** Start a form, to use with comment control and moderation
      */

      $result = db_query($query);
      $comment_num = db_num_rows($result);

      if ($comment_num && ((variable_get("comment_controls", 0) == 0) || (variable_get("comment_controls", 0) == 2))) {
        print "<form method=\"post\" action=\"". drupal_url(array("mod" => "comment"), "module") ."\">\n";
Dries Buytaert's avatar
   
Dries Buytaert committed
458
        $theme->box(t("Control panel"), theme_invoke("comment_controls", $threshold, $mode, $order, $nid, $comment_page, $comment_num, $comments_per_page));
Dries Buytaert's avatar
   
Dries Buytaert committed
459
460
        print form_hidden("nid", $nid);
        print "</form>";
Dries Buytaert's avatar
   
Dries Buytaert committed
461
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
462

Dries Buytaert's avatar
   
Dries Buytaert committed
463
464
465
466
467
468
469
470
471
472
473
474
      print "<form method=\"post\" action=\"". drupal_url(array("mod" => "comment"), "module") ."\">\n";
      print form_hidden("nid", $nid);

      if ($comment_num) {
        if ($mode == 1) {
          /*
          ** Flat collapsed
          */

          while ($comment = db_fetch_object($result)) {
            $comments[$comment->cid] = $comment;
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
475
          theme_invoke("comment_flat_collapsed", $comments, $threshold_min);
Dries Buytaert's avatar
   
Dries Buytaert committed
476
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
        else if ($mode == 2) {
          /*
          ** Flat expanded
          **
          ** We page using PHP, not using SQL because otherwise we'd
          ** have to use two queries; one for each comment and one for
          ** the paged comments.  In method 1-3 we take all results
          ** anyway, wheras in method 4 we need every result to create
          ** proper pages.  It is here where we lose more, in fact for
          ** higher pages we transfer unneeded data from the db and
          ** the web server.
          **
          ** TODO: the comment above is a bit cryptic.  Mind to make it
          **       a bit more verbose/explanatory?
          */

          $comment_num = 0;
          $page = 1;
          while ($comment = db_fetch_object($result)) {
            if ($page == $comment_page) {
              $comments[$comment->cid] = $comment;
            }
            $comment_num++;
            if ($comment_num == $comments_per_page) {
              if ($page == $comment_page) {
                break;
              }
              else {
                $comment_num = 0;
                $page++;
              }
            }

            if ($user->uid != $comment->uid && !(comment_already_moderated($user->uid, $comment->users))) {
              $show_moderate_button = 1;
            }
          }

Dries Buytaert's avatar
   
Dries Buytaert committed
515
          theme_invoke("comment_flat_expanded", $comments, $threshold_min);
Dries Buytaert's avatar
   
Dries Buytaert committed
516
517
518
519

          if (comment_user_can_moderate($node) && $show_moderate_button) {
            print "<div align=\"center\">". form_submit(t("Moderate comments")) ."</div><br />";
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
520
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
521
522
523
524
        else if ($mode == 3) {
          /*
          ** Threaded collapsed
          */
Dries Buytaert's avatar
   
Dries Buytaert committed
525

Dries Buytaert's avatar
   
Dries Buytaert committed
526
527
528
529
          while ($comment = db_fetch_object($result)) {
            $comments[$comment->cid] = $comment;
          }
          if ($comments) {
Dries Buytaert's avatar
   
Dries Buytaert committed
530
            theme_invoke("comment_thread_min", $comments, $threshold_min);
Dries Buytaert's avatar
   
Dries Buytaert committed
531
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
532
533
        }
        else {
Dries Buytaert's avatar
   
Dries Buytaert committed
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
          /*
          ** Threaded expanded
          */

          while ($comment = db_fetch_object($result)) {
            $comments[$comment->cid] = $comment;

            if ($user->uid != $comment->uid && !(comment_already_moderated($user->uid, $comment->users))) {
              $show_moderate_button = 1;
            }
          }

          /*
          ** Build the comment structure
          */

          $structure = comment_thread_structure($comments, 0, 0, array());

          $comment_num = 0;
          $page = 1;
          foreach ($structure as $cid => $depth) {
            if ($page == $comment_page) {
Dries Buytaert's avatar
   
Dries Buytaert committed
556
              theme_invoke("comment_thread_max", $comments[$cid], $threshold_min, $depth - 1);
Dries Buytaert's avatar
   
Dries Buytaert committed
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
            }
            $comment_num++;
            if ($comment_num == $comments_per_page) {
              if ($page == $comment_page) {
                break;
              }
              else {
                $comment_num = 0;
                $page++;
              }
            }
          }

          if (comment_user_can_moderate($node) && $show_moderate_button) {
            print "<div align=\"center\">". form_submit(t("Moderate comments")) ."</div><br />";
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
573
574
        }
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
575
576
577
578
579

      print "</form>";

      if ($comment_num && ((variable_get("comment_controls", 0) == 1) || (variable_get("comment_controls", 0) == 2))) {
        print "<form method=\"post\" action=\"". drupal_url(array("mod" => "comment"), "module") ."\">\n";
Dries Buytaert's avatar
   
Dries Buytaert committed
580
        $theme->box(t("Control panel"), theme_invoke("comment_controls", $threshold, $mode, $order, $nid, $comment_page, $comment_num, $comments_per_page));
Dries Buytaert's avatar
   
Dries Buytaert committed
581
582
583
        print form_hidden("nid", $nid);
        print "</form>";
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
584
585
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
586
587
588
589
590
    /*
    ** If enabled, show new comment form
    */

    if (user_access("post comments") && node_comment_mode($nid) == 2 && variable_get("comment_new_form", 0)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
591
      $theme->box(t("Post new comment"), comment_form(array("nid" => $nid)));
Dries Buytaert's avatar
   
Dries Buytaert committed
592
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
593

Dries Buytaert's avatar
   
Dries Buytaert committed
594
595
596
597
598
    /*
    ** Tag the node's comments as being read:
    */

    comment_tag_new($nid);
Dries Buytaert's avatar
   
Dries Buytaert committed
599
600
601
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
602
603
604
function comment_perm() {
  return array("access comments", "post comments", "administer comments", "moderate comments", "post comments without approval", "administer moderation");
}
Dries Buytaert's avatar
   
Dries Buytaert committed
605

Dries Buytaert's avatar
   
Dries Buytaert committed
606
function comment_link($type, $node = 0, $main = 0) {
Dries Buytaert's avatar
   
Dries Buytaert committed
607

Dries Buytaert's avatar
   
Dries Buytaert committed
608
  if ($type == "admin" && user_access("administer comments")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
609
    $links[] = la(t("comments"), array("mod" => "comment"));
Dries Buytaert's avatar
   
Dries Buytaert committed
610
611
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
612
  if ($type == "node" && $node->comment) {
Dries Buytaert's avatar
   
Dries Buytaert committed
613
614
615
616
617
618
619
620

    if ($main) {

      /*
      ** Main page: display the number of comments that have been posted.
      */

      if (user_access("access comments")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
621
        $all = comment_num_all($node->nid);
Dries Buytaert's avatar
   
Dries Buytaert committed
622
        $new = comment_num_new($node->nid); // array!
Dries Buytaert's avatar
   
Dries Buytaert committed
623

Dries Buytaert's avatar
   
Dries Buytaert committed
624
625
626
627
628
629
630
631
632
633
634
635
        if ($all) {
          $links[] = l(format_plural($all, 'comment', 'comments'), array("id" => $node->nid), "node", "comment", array("title" => t('Jump to first comment of this posting.')));

          if ($new["count_new"]) {
            $links[] = l($new["count_new"] ." ". t("new"), array("id" => $node->nid), "node", $new["id_first_new"], array("title" => t('Jump to first NEW comment of this posting.')));
          }
        }
        else {
          if (user_access("post comments")) {
            $links[] = lm(t("add new comment"), array("mod" => "comment", "op" => "reply", "id" => $node->nid), "", array("title" => t("Add a new comment to this page.")));
          }
          else {
Dries Buytaert's avatar
   
Dries Buytaert committed
636
            $links[] = theme_invoke("comment_post_forbidden");
Dries Buytaert's avatar
   
Dries Buytaert committed
637
638
          }
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
639
640
641
642
643
      }
    }
    else {
      /*
      ** Node page: add a "post comment" link if the user is allowed to
Dries Buytaert's avatar
   
Dries Buytaert committed
644
      ** post comments and if this node is not read-only
Dries Buytaert's avatar
   
Dries Buytaert committed
645
646
      */

Dries Buytaert's avatar
   
Dries Buytaert committed
647
648
      if ($node->comment == 2) {
        if (user_access("post comments")) {
Kjartan Mannes's avatar
Kjartan Mannes committed
649
          $links[] = lm(t("add new comment"), array("mod" => "comment", "op" => "reply", "id" => $node->nid), "comment", array("title" => t("Share your thoughts and opinions related to this posting.")));
Kjartan Mannes's avatar
Kjartan Mannes committed
650
651
        }
        else {
Dries Buytaert's avatar
   
Dries Buytaert committed
652
          $links[] = theme_invoke("comment_post_forbidden");
Dries Buytaert's avatar
   
Dries Buytaert committed
653
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
654
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
655
      else {
Dries Buytaert's avatar
   
Dries Buytaert committed
656
        $links[] = t("Closed discussion: you can't post new comments.");
Dries Buytaert's avatar
   
Dries Buytaert committed
657
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
658
659
660
    }
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
661
  return $links ? $links : array();
Dries Buytaert's avatar
   
Dries Buytaert committed
662
663
}

Dries Buytaert's avatar
   
Dries Buytaert committed
664
665
666
667
668
669
670
671
672
function comment_page() {
  global $theme, $op, $edit, $id, $pid, $cid;

  switch ($op) {
    case "edit":
      $theme->header();
      comment_edit(check_query($id));
      $theme->footer();
      break;
Dries Buytaert's avatar
   
Dries Buytaert committed
673
674
675
676
677
    case t("Moderate comments"):
    case t("Moderate comment"):
      comment_moderate($edit);
      drupal_goto(drupal_url(array("id" => $edit["nid"])));
      break;
Dries Buytaert's avatar
   
Dries Buytaert committed
678
679
680
681
682
683
684
685
686
687
688
    case "reply":
      $theme->header();
      comment_reply(check_query($pid), check_query($id));
      $theme->footer();
      break;
    case t("Preview comment"):
      $theme->header();
      comment_preview($edit);
      $theme->footer();
      break;
    case t("Post comment"):
Dries Buytaert's avatar
   
Dries Buytaert committed
689
690
691
692
693
694
695
696
697
      list($error_title, $error_body) = comment_post($edit);
      if ($error_body) {
        $theme->header();
        $theme->box($error_title, $error_body);
        $theme->footer();
      }
      else {
        drupal_goto(drupal_url(array("id" => $edit["nid"]), "node"));
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
698
699
      break;
    case t("Update settings"):
Dries Buytaert's avatar
   
Dries Buytaert committed
700
701
702
      global $mode, $order, $threshold, $comments_per_page;
      comment_settings(check_query($mode), check_query($order), check_query($threshold), check_query($comments_per_page));
      drupal_goto(drupal_url(array("id" => $edit["nid"], "mode" => $mode, "order" => $order, "threshold" => $threshold, "comments_per_page" => $comments_per_page), "node"));
Dries Buytaert's avatar
   
Dries Buytaert committed
703
704
705
706
      break;
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
707
708
709
/**
*** admin functions
**/
Dries Buytaert's avatar
   
Dries Buytaert committed
710

Dries Buytaert's avatar
   
Dries Buytaert committed
711
function comment_node_link($node) {
Dries Buytaert's avatar
 
Dries Buytaert committed
712

Dries Buytaert's avatar
   
Dries Buytaert committed
713
  if (user_access("administer comments") && comment_num_all($node->nid)) {
Dries Buytaert's avatar
 
Dries Buytaert committed
714

Dries Buytaert's avatar
   
Dries Buytaert committed
715
716
717
    /*
    ** Edit comments:
    */
Dries Buytaert's avatar
 
Dries Buytaert committed
718

Dries Buytaert's avatar
   
Dries Buytaert committed
719
    $result = db_query("SELECT c.cid, c.subject, u.uid, u.name FROM comments c LEFT JOIN users u ON u.uid = c.uid WHERE nid = '%d' AND c.status = 0 ORDER BY c.timestamp", $node->nid);
Dries Buytaert's avatar
   
Dries Buytaert committed
720

Dries Buytaert's avatar
   
Dries Buytaert committed
721
722
723
724
725
726
727
728
729
730
731
    $output .= "<h3>". t("Edit comments") ."</h3>";
    $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
    $output .= " <tr><th>title</th><th>author</th><th colspan=\"3\">operations</th></tr>";

    while ($comment = db_fetch_object($result)) {
      $output .= "<tr><td>". l($comment->subject, array("id" => $node->nid, "cid" => $comment->cid), "node", $comment->cid) ."</td><td>". format_name($comment) ."</td><td>". l(t("view comment"), array("id" => $node->nid, "cid" => $comment->cid), "node", $comment->cid) ."</td><td>". la(t("edit comment"), array("mod" => "comment", "op" => "edit", "id" => $comment->cid)) ."</td><td>". la(t("delete comment"), array("mod" => "comment", "op" => "delete", "id" => $comment->cid)) ."</td></tr>";
    }

    $output .= "</table>";

    return $output;
Dries Buytaert's avatar
 
Dries Buytaert committed
732
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
733
}
Dries Buytaert's avatar
   
Dries Buytaert committed
734

Dries Buytaert's avatar
   
Dries Buytaert committed
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
function comment_admin_edit($id) {

  $result = db_query("SELECT c.*, u.name, u.uid FROM comments c LEFT JOIN users u ON c.uid = u.uid WHERE c.cid = '%d' AND c.status != 2", $id);
  $comment = db_fetch_object($result);

  // if a comment is "deleted", it's deleted
  if ($comment) {
    $form .= form_item(t("Author"), format_name($comment));
    $form .= form_textfield(t("Subject"), "subject", $comment->subject, 70, 128);
    $form .= form_textarea(t("Comment"), "comment", $comment->comment, 70, 15);
    $form .= form_select(t("Status"), "status", $comment->status, array("published", "not published"));
    $form .= form_hidden("cid", $id);
    $form .= form_submit(t("Submit"));
    $form .= form_submit(t("Delete"));

    return form($form);
  }
Dries Buytaert's avatar
 
Dries Buytaert committed
752
753
}

Dries Buytaert's avatar
   
Dries Buytaert committed
754
755
756
function comment_delete($edit) {

  if ($edit["confirm"]) {
Dries Buytaert's avatar
   
Dries Buytaert committed
757
    db_query("UPDATE comments SET status = 2 WHERE cid = '%d'", $edit["cid"]);
Dries Buytaert's avatar
   
Dries Buytaert committed
758
    watchdog("special", "comment: deleted comment #". $edit["cid"]);
Dries Buytaert's avatar
   
Dries Buytaert committed
759
    $output = "Comment deleted.";
Dries Buytaert's avatar
   
Dries Buytaert committed
760
761
762
763
764
765
766
767
768
769
  }
  else {
    $output .= form_item(t("Confirm deletion"), "");
    $output .= form_hidden("cid", $edit["cid"]);
    $output .= form_hidden("confirm", 1);
    $output .= form_submit(t("Delete"));
    $output = form($output);
  }

  return $output;
Dries Buytaert's avatar
   
Dries Buytaert committed
770
771
}

Dries Buytaert's avatar
   
Dries Buytaert committed
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
function comment_save($id, $edit) {
  db_query("UPDATE comments SET subject = '%s', comment = '%s', status = '%s' WHERE cid = '%d'", filter($edit["subject"]), filter($edit["comment"]), $edit["status"], $id);
  watchdog("special", "comment: modified '". $edit["subject"] ."'");
  return "Comment updated.";
}

function comment_admin_overview($status = 0, $comment_page = 0) {
  global $comment_settings;

  $comments_per_page = 50;

  /*
  ** Save location to come back here after a edit/delete
  */

  $comment_settings["status"] = $status;
  $comment_settings["comment_page"] = $comment_page;
  session_register("comment_settings");


  /*
  ** Now render the page
  */

  $start = $comment_page * $comments_per_page;

Dries Buytaert's avatar
   
Dries Buytaert committed
798
  $output .= $status ? "<h3>Non-published comments</h3>\n" : "<h3>Published comments</h3>";
Dries Buytaert's avatar
   
Dries Buytaert committed
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
  $result = db_query("SELECT c.*, u.name, u.uid FROM comments c LEFT JOIN users u ON u.uid = c.uid WHERE c.status = '%d' ORDER BY timestamp DESC LIMIT $start, $comments_per_page", $status);

  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">\n";
  $output .= " <tr><th>subject</th><th>author</th><th>date</th><th>published</th><th colspan=\"2\">operations</th></tr>\n";
  while ($comment = db_fetch_object($result)) {
    $output .= " <tr><td>". l(check_output($comment->subject), array("id" => $comment->nid, "cid" => $comment->cid, "pid" => $comment->pid), "node", $comment->cid, array("title" => htmlentities($comment->comment))) ."</td><td>". format_name($comment) ."</td><td>". format_date($comment->timestamp, "small") ."</td><td>". ($comment->status == 0 ? "yes" : "no") ."</td><td>". la(t("edit comment"), array("mod" => "comment", "op" => "edit", "id" => $comment->cid)) ."</td><td>". la(t("delete comment"), array("mod" => "comment", "op" => "delete", "id" => $comment->cid)) ."</td></tr>\n";
  }

  if ($comment_page > 0) {
    // show previous
    $prev_link = la(t("previous comments"), array("mod" => "comment", "status" => $status, "comment_page" => ($comment_page - 1)));
  }

  if (db_num_rows($result) == $comments_per_page) {
    // show next
    $next_link = la(t("next comments"), array("mod" => "comment", "status" => $status, "comment_page" => ($comment_page + 1)));
  }

817
818
819
  if ($prev_link || $next_link) {
    $output .= "<tr><td>$prev_link</td><td></td><td></td><td></td><td></td><td>$next_link</td></tr>";
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
820
821
822
823
824
825
826
827
828
  $output .= "</table>\n";

  return $output;
}

function comment_mod_matrix($edit) {
  global $tid, $rid;

  $output .= "<h3>Moderators/vote values matrix</h3>";
Dries Buytaert's avatar
   
Dries Buytaert committed
829
830
  $output .= "<p><small><b>Note:</b> you must assign the <b>moderate comments</b> permission to at least one role in order to use this page.</small>";
  $output .= "<p>In order to use comment moderation, every textbox on this page should be populated with an integer.  On this page, you also might wish to value the votes from some users more than others. For example, administrator votes might count twice as much as authenticated users.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872

  if ($rid) {
    db_query("DELETE FROM moderation_roles");
    foreach ($rid as $role_id => $votes) {
      foreach ($votes as $mid => $value) {
        $sql[] = "('$mid', '$role_id', '$value')";
      }
    }
    db_query("INSERT INTO moderation_roles (mid, rid, value) VALUES ". implode(", ", $sql));
  }

  $result = db_query("SELECT r.rid, r.name FROM role r, permission p WHERE r.rid = p.rid AND p.perm LIKE '%moderate comments%'");
  $role_names = array();
  while ($role = db_fetch_object($result)) {
    $role_names[$role->rid] = $role->name;
  }

  $result = db_query("SELECT rid, mid, value FROM moderation_roles");
  while ($role = db_fetch_object($result)) {
    $mod_roles[$role->rid][$role->mid] = $role->value;
  }

  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
  $output .= " <tr><th>votes</th><th>". implode("</th><th>", array_values($role_names)) ."</th></tr>";

  $result = db_query("SELECT mid, vote FROM moderation_votes ORDER BY weight");
  while ($vote = db_fetch_object($result)) {
    $output .= "<tr><td>$vote->vote</td>";
    foreach (array_keys($role_names) as $rid) {
      $output .= "<td align=\"center\"><input maxlength=\"3\" name=\"rid[$rid][$vote->mid]\" size=\"4\" value=\"". $mod_roles[$rid][$vote->mid] ."\" /></td>";
    }
    $output .= "</tr>";
  }
  $output .= "</table>";
  $output .= "<br />". form_submit(t("Submit votes"));

  return form($output);
}

function comment_mod_roles($edit) {

  $output .= "<h3>Initial comment scores</h3>";
Dries Buytaert's avatar
   
Dries Buytaert committed
873
  $output .= "<p>Here is your opportunity to value comments from some users more than others. For example, administrator comments might count twice as much as authenticated users. Enter an integr into the <b>initial score</b> column.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929

  if ($edit) {
    variable_set("comment_roles", $edit);
  }

  $start_values = variable_get("comment_roles", array());

  $result = db_query("SELECT r.rid, r.name FROM role r, permission p WHERE r.rid = p.rid AND p.perm LIKE '%post comments%'");

  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
  $output .= " <tr><th>user role</th><th>initial score</th></tr>";

  while ($role = db_fetch_object($result)) {
    $output .= "<tr><td>$role->name</td>";
    $output .= "<td align=\"center\"><input maxlength=\"3\" name=\"edit[$role->rid]\" size=\"4\" value=\"". $start_values[$role->rid] ."\" /></td></tr>";
  }

  $output .= "</table>";
  $output .= "<br />". form_submit(t("Save scores"));

  return form($output);
}

function comment_mod_votes($edit) {
  global $op, $mid, $tid;

  if ($op == t("Save vote")) {
    db_query("UPDATE moderation_votes SET vote = '%s', weight = '%d' WHERE mid = '%d'", $edit["vote"], $edit["weight"], $mid);
    $mid = 0;
  }
  else if ($op == t("Delete vote")) {
    db_query("DELETE FROM moderation_votes WHERE mid = '%d'", $mid);
    db_query("DELETE FROM moderation_roles WHERE mid = '%d'", $mid);
    $mid = 0;
  }
  else if ($op == t("Add new vote")) {
    db_query("INSERT INTO moderation_votes (mid, vote, weight) VALUES (NULL, '%s', '%d')", $edit["vote"], $edit["weight"]);
    $mid = 0;
  }

  $output .= "<h3>Moderation votes overview</h3>";
  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
  $output .= " <tr><th>votes</th><th>weight</th><th>operations</th></tr>";

  $result = db_query("SELECT mid, vote, weight FROM moderation_votes ORDER BY weight");
  while ($vote = db_fetch_object($result)) {
    $output .= " <tr><td>$vote->vote</td><td align=\"center\">$vote->weight</td><td align=\"center\">". la(t("edit"), array("mod" => "comment", "op" => "votes", "mid" => $vote->mid)) ."</td></tr>";
  }
  $output .= "</table>";

  if ($mid) {
    $vote = db_fetch_object(db_query("SELECT vote, weight FROM moderation_votes WHERE mid = '%d'", $mid));
  }

  $output .= "<h3>Add new moderation option</h3>";
  $form .= form_textfield(t("Vote"), "vote", $vote->vote, 32, 64, t("The name of this vote.  Example: 'offtopic', 'excellent', 'sucky'."));
Dries Buytaert's avatar
   
Dries Buytaert committed
930
  $form .= form_textfield(t("Weight"), "weight", $vote->weight, 32, 64, t("Used to order votes in the comment control box; heavier sink."));
Dries Buytaert's avatar
   
Dries Buytaert committed
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
  if ($mid) {
    $form .= form_submit(t("Save vote"));
    $form .= form_submit(t("Delete vote"));
  }
  else {
    $form .= form_submit(t("Add new vote"));
  }

  $output .= form($form);

  return $output;
}

function comment_mod_filters($edit) {
  global $op, $fid, $tid;

Dries Buytaert's avatar
   
Dries Buytaert committed
947
  if ($op == t("Save threshhold")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
948
949
950
    db_query("UPDATE moderation_filters SET filter = '%s', minimum = '%d' WHERE fid = '%d'", $edit["filter"], $edit["minimum"], $fid);
    $fid = 0;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
951
  else if ($op == t("Delete threshhold")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
952
953
954
    db_query("DELETE FROM moderation_filters WHERE fid = '%d'", $fid);
    $fid = 0;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
955
  else if ($op == t("Add new threshhold")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
956
957
958
959
    db_query("INSERT INTO moderation_filters (fid, filter, minimum) VALUES (NULL, '%s', '%d')", $edit["filter"], $edit["minimum"]);
    $fid = 0;
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
960
  $output .= "<h3>Comment threshhold overview</h3>";
Dries Buytaert's avatar
   
Dries Buytaert committed
961
  $output .= "<p><i>Optional</i>. If your site gets lots of comments, you may offer your users threshholds, which are used to hide all comments whose moderation score is lower than the threshhold. This cuts down on clutter while your readers view the site. These threshholds appear in the Comment Control Panel.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
962
963
964
965
966
967
968
969
970
971
972
973
974
  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
  $output .= " <tr><th>name</th><th>minimum score</th><th>operations</th></tr>";

  $result = db_query("SELECT fid, filter, minimum FROM moderation_filters ORDER BY minimum");
  while ($filter = db_fetch_object($result)) {
    $output .= " <tr><td>$filter->filter</td><td align=\"center\">$filter->minimum</td><td align=\"center\">". la(t("edit"), array("mod" => "comment", "op" => "filters", "fid" => $filter->fid)) ."</td></tr>";
  }
  $output .= "</table>";

  if ($fid) {
    $filter = db_fetch_object(db_query("SELECT filter, fid, minimum FROM moderation_filters WHERE fid = '%d'", $fid));
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
975
976
  $output .= "<h3>Add new threshhold</h3>";
  $form .= form_textfield(t("Threshhold name"), "filter", $filter->filter, 32, 64, t("The name of this threshhold.  Example: 'good comments', '+1 comments', 'everything'."));
Dries Buytaert's avatar
   
Dries Buytaert committed
977
978
  $form .= form_textfield(t("Minimum score"), "minimum", $filter->minimum, 32, 64, t("Show all comments whose score is larger or equal to the provided minimal score. Range: -127 + 128"));
  if ($fid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
979
980
    $form .= form_submit(t("Save threshhold"));
    $form .= form_submit(t("Delete threshhold"));
Dries Buytaert's avatar
   
Dries Buytaert committed
981
982
  }
  else {
Dries Buytaert's avatar
   
Dries Buytaert committed
983
    $form .= form_submit(t("Add new threshhold"));
Dries Buytaert's avatar
   
Dries Buytaert committed
984
985
986
987
988
989
990
991
  }

  $output .= form($form);

  return $output;
}


Dries Buytaert's avatar
 
Dries Buytaert committed
992
function comment_admin() {
Dries Buytaert's avatar
   
Dries Buytaert committed
993
  global $op, $id, $edit, $mod, $keys, $order, $status, $comment_page, $comment_settings;
Dries Buytaert's avatar
 
Dries Buytaert committed
994

Dries Buytaert's avatar
   
Dries Buytaert committed
995
  if (user_access("administer comments")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
996

Dries Buytaert's avatar
   
Dries Buytaert committed
997
998
    $links[] = la(t("published comments"), array("mod" => "comment", "status" => 0));
    $links[] = la(t("non-published comments"), array("mod" => "comment", "status" => 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
999
    $links[] = la(t("search comments"), array("mod" => "comment", "op" => "search"));
Dries Buytaert's avatar
   
Dries Buytaert committed
1000

For faster browsing, not all history is shown. View entire blame