blog.module 14.6 KB
Newer Older
Dries's avatar
 
Dries committed
1
<?php
2
// $Id$
Dries's avatar
 
Dries committed
3

4
function blog_system($field){
5
  $system["description"] = t("Enables keeping a blog or easily and regularly updated web page.");
6 7 8
  return $system[$field];
}

Dries's avatar
 
Dries committed
9
function blog_conf_options() {
Dries's avatar
 
Dries committed
10 11 12
  $output = form_textarea(t("Explanation or submission guidelines"), "blog_help", variable_get("blog_help", ""), 55, 4, t("This text is displayed at the top of the blog submission form.  It's useful for helping or instructing your users."));
  $words = t("words");
  $output .= form_select(t("Minimum number of words in a blog entry"), "minimum_blog_size", variable_get("minimum_blog_size", 0), array(0 => "0 $words", 10 => "10 $words", 25 => "25 $words",  50 => "50 $words", 75 => "75 $words", 100 => "100 $words", 125 => "125 $words",  150 => "150 $words", 175 => "175 $words", 200 => "200 $words"), t("The minimum number of words a personal blog entry should contain.  This is useful to rule out submissions that do not meet the site's standards, such as short test posts."));
Dries's avatar
 
Dries committed
13

14
  return $output;
Dries's avatar
 
Dries committed
15 16
}

Dries's avatar
 
Dries committed
17 18 19
function blog_node($field) {
  global $user;

Dries's avatar
 
Dries committed
20
  $info["name"] = t("personal blog entry");
21
  $info["description"] = t("A blog is a regularly updated web page that is similar to a diary -- that (generally) anyone in the world can see.  It is made up of individual entries, often called posts, that are time stamped and typically arranged by the day, with the newest on top (a diary is the reverse).  Blogs often contain links to things you've seen, or on which you agree/disagree.   Some blogs also contain original material written solely for the blog.  Since a Blog is personal, you and only you have full control on what you publish.  The most interesting blog entries or those blog entries that fit the site's topic well might get promoted to the front page by the community or the people with access to do this.");
Dries's avatar
 
Dries committed
22 23 24 25 26 27 28 29

  return $info[$field];
}

function blog_access($op, $node) {
  global $user;

  if ($op == "view") {
Dries's avatar
 
Dries committed
30
    return $node->status;
Dries's avatar
 
Dries committed
31 32 33 34 35 36 37
  }

  if ($op == "create") {
    return $user->uid;
  }

  if ($op == "update") {
Dries's avatar
 
Dries committed
38
    return ($user->uid == $node->uid);
Dries's avatar
 
Dries committed
39 40 41
  }

  if ($op == "delete") {
Dries's avatar
 
Dries committed
42
    return ($user->uid == $node->uid);
Dries's avatar
 
Dries committed
43 44 45 46
  }

}

Dries's avatar
 
Dries committed
47 48 49 50 51 52 53 54 55 56
function blog_head($main = 0) {
  global $id, $mod;

  if ($mod && $id) {
    $account = user_load(array("uid" => $id));
    $output[] = "<link rel=\"alternate\" type=\"application/rss+xml\" title=\"RSS - ". $account->name. "'s blog\" href=\"". path_uri(). "module.php?mod=blog&op=view&id=$id\" />";
  }
  return $output ? $output : array();
}

57 58 59 60
function blog_user($type, &$edit, &$user) {
  switch ($type) {
    case "view_public":
    case "view_private":
Dries's avatar
 
Dries committed
61
      return form_item(t("Blog"), lm(t("view recent entries"), array("mod" => "blog", "id" => $user->uid), "", array("title" => t("View recent blog entries."))) ."<br />". lm(t("view all entries"), array("mod" => "blog", "id" => $user->uid, "all" => 1), "", array("title" => t("View all blog entries."))));
62 63 64
  }
}

Dries's avatar
 
Dries committed
65 66 67 68 69 70
function blog_save($op, $node) {
  if ($op == "approve") {
    return array("promote" => 1);
  }

  if ($op == "create") {
Dries's avatar
 
Dries committed
71
    if (user_access("administer nodes")) {
72
      return array("body" => filter($node->body), "teaser" => filter($node->teaser));
Dries's avatar
 
Dries committed
73 74 75 76
    }
    else {
      return array("body" => filter($node->body), "promote" => 0, "moderate" => 1, "status" => 1, "teaser" => filter($node->teaser));
    }
Dries's avatar
 
Dries committed
77 78 79 80 81 82 83
  }

  if ($op == "decline") {
    return array("promote" => 0);
  }

  if ($op == "update") {
Dries's avatar
 
Dries committed
84
    if (user_access("administer nodes")) {
Dries's avatar
 
Dries committed
85
      /*
Dries's avatar
 
Dries committed
86 87
      ** When an administrator updates blog entries through the admin
      ** pages, they will not be changed unless explicitly specified.
Dries's avatar
 
Dries committed
88 89
      */

90
      return array("body" => filter($node->body), "teaser" => filter($node->teaser));
Dries's avatar
 
Dries committed
91
    }
Dries's avatar
 
Dries committed
92
    else {
Dries's avatar
 
Dries committed
93
      /*
Dries's avatar
 
Dries committed
94 95
      ** Updating your own blog entry will demote it (if promoted),
      ** and will queue it in the moderation queue for promotion.
Dries's avatar
 
Dries committed
96 97
      */

Dries's avatar
 
Dries committed
98
      return array("body" => filter($node->body), "promote" => 0, "moderate" => 1, "score" => 0, "teaser" => filter($node->teaser), "votes" => 0, "users" => 0);
Dries's avatar
 
Dries committed
99
    }
Dries's avatar
 
Dries committed
100 101 102 103
  }

}

Dries's avatar
 
Dries committed
104 105
function blog_help() {
 ?>
Dries's avatar
 
Dries committed
106 107 108 109
  <p>Drupal's blog module allows registered users to maintain an online blog, often referred to as an online journal or diary.  They can be filled with daily thoughts, poetry, boneless blabber, spiritual theories, intimate details, valuable experiences, cynical rants, semi-coherent comments, writing experiments, artistic babblings, critics on current facts, fresh insights, diverse dreams, chronicles and mumbling madness available for public consumption.  It is made up of individual entries that are timestamped and are typically viewed by day as you would a diary.  Blogs often contain links to things you've seen, or agree/disagree with.  A typical example of a long term blog can be seen at <a href="http://www.scripting.com/">http://www.scripting.com/</a>.</p>
  <p>The blog module adds a couple of menu options.  Everyone gets to see the "latest blogs", a page that displays the most recent blog entries from every participant.  If you are logged in, your personal menu also has "submit a blog" link which will lead you to a submission form.  You are also presented a "view personal blog" menu option that displays your blog entries as other people will see it.  For you only, there is an edit link at the bottom left of a page that lets you edit or delete old entries.</p>
  <p>Both in the import module (news aggregator) and the blog module displays glyphs that looks like a pinboard stickit note.  Click on this and you are taken to the blog submission form.  The system helpfully copies the title, a link to the item, and a link to the source into the body text ready for you to add your explanation.  This actively encourages people to add blog entries about things they see and hear elsewhere in the Drupal site.</p>
  <p>For Drupal administrators a blog entry is just another node that can be administered from the "content management" page in the administration pages.</p>
Dries's avatar
 
Dries committed
110 111 112
 <?php
}

Dries's avatar
 
Dries committed
113
function blog_feed_user($uid = 0, $date = 0) {
Dries's avatar
 
Dries committed
114 115
  global $user;

Dries's avatar
 
Dries committed
116 117 118 119 120 121 122 123 124 125
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }

  if (!$date) {
    $date = time();
  }
Dries's avatar
 
Dries committed
126

Dries's avatar
 
Dries committed
127
  $result = db_query("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM node n LEFT JOIN users u ON n.uid = u.uid WHERE n.type = 'blog' AND u.uid = '$uid' AND n.created > '". ($date - 2592000) ."' ORDER BY n.nid DESC LIMIT 15");
Dries's avatar
 
Dries committed
128

Dries's avatar
 
Dries committed
129 130 131 132
  $channel["title"] = $account->name. "'s blog";
  $channel["link"] = path_uri(). drupal_url(array ("mod" => "blog", "op" => "view", "id" => $uid), "module");
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
133 134 135 136

}

function blog_feed_last() {
Dries's avatar
 
Dries committed
137 138
  $result = db_query("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM node n LEFT JOIN users u ON n.uid = u.uid WHERE n.type = 'blog' ORDER BY n.nid DESC LIMIT 15");

Dries's avatar
 
Dries committed
139 140 141 142
  $channel["title"] = variable_get("site_name", "drupal"). "blogs";
  $channel["link"] = path_uri(). drupal_url(array ("mod" => "blog", "op" => "view"), "module");
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
143 144 145

}

Dries's avatar
 
Dries committed
146
function blog_page_user($uid = 0, $date = 0, $all = 0) {
Dries's avatar
 
Dries committed
147 148
  global $theme, $user;

Dries's avatar
 
Dries committed
149 150 151 152 153 154
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }
Dries's avatar
 
Dries committed
155

Dries's avatar
 
Dries committed
156 157 158 159
  if (!$date) {
    $date = time();
  }

Dries's avatar
 
Dries committed
160
  $result = db_query("SELECT nid FROM node WHERE type = 'blog' AND uid = '$account->uid' AND created <= '$date' ORDER BY nid DESC". ($all ? "" : " LIMIT 20"));
Dries's avatar
 
Dries committed
161

Dries's avatar
 
Dries committed
162
  $output .= "<table border=\"0\" cellpadding=\"4\" cellspacing=\"4\">";
Dries's avatar
 
Dries committed
163

Dries's avatar
 
Dries committed
164 165 166
  while ($node = db_fetch_object($result)) {

    $blog = node_load(array("nid" => $node->nid));
Dries's avatar
 
Dries committed
167

Dries's avatar
 
Dries committed
168 169
    if ($date != date("dny", $blog->created)) {
      $date = date("dny", $blog->created);
Kjartan's avatar
Kjartan committed
170
      $output .= "<tr><td colspan=\"3\"><b>". lm(format_date($blog->created, "small", "d M Y"), array("mod" => "blog", "id" => $blog->uid, "date" => mktime(23, 59, 59, date("n", $blog->created), date("d", $blog->created), date("Y", $blog->created))), "", array("title" => t("Permanent link to this date."))) ."</b></td></tr>";
Dries's avatar
 
Dries committed
171 172
    }

Dries's avatar
 
Dries committed
173
    $links = link_node($blog, 1);
Dries's avatar
 
Dries committed
174

Dries's avatar
 
Dries committed
175
    $output .= "<tr><td><div style=\"margin-left: 20px;\"><b>". check_output($blog->title) ."</b></div></td><td align=\"right\">". $theme->links($links) ."</td><td>". l('<img src="misc/blog.gif" width="12" height="16" border="0" align="top">', array("id" => $node->nid), "node", "", array("title" => t("Permanent link to this blog entry."))) ."</td></tr>";
Kjartan's avatar
Kjartan committed
176
    $output .= "<tr><td colspan=\"3\"><div style=\"margin-left: 40px;\">". check_output($blog->teaser, 1) ."</div><br /></td></tr>";
Dries's avatar
 
Dries committed
177

Dries's avatar
 
Dries committed
178
  }
Dries's avatar
 
Dries committed
179

Dries's avatar
 
Dries committed
180
  $output .= "</table>";
Kjartan's avatar
Kjartan committed
181
  $output .= lm("<img src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" align=\"right\" border=\"0\" />", array("mod" => "blog", "op" => "feed", "id" => $account->uid), "", array("title" => t("Read the XML version of this page."))) ."\n";
182
  if (!$all && $date) {
Dries's avatar
 
Dries committed
183
    $output .= lm(t("show all blogs"), array("mod" => "blog", "op" => "view", "id" => $account->uid, "all" => 1), "", array("title" => t("Show all blogs by this user.")));
Dries's avatar
 
Dries committed
184 185
  }
  else {
Dries's avatar
 
Dries committed
186
    $output .= lm(t("show recent blogs"), array("mod" => "blog", "op" => "view", "id" => $account->uid), "", array("title" => t("Show recent blogs by this user.")));
Dries's avatar
 
Dries committed
187
  }
Dries's avatar
 
Dries committed
188

Dries's avatar
 
Dries committed
189
  $theme->box(t("%username's blog", array("%username" => $account->name)), $output);
Dries's avatar
 
Dries committed
190 191
}

Dries's avatar
Dries committed
192
function blog_page_last() {
Dries's avatar
 
Dries committed
193
  global $theme, $user;
Dries's avatar
 
Dries committed
194

Dries's avatar
 
Dries committed
195
  $result = db_query("SELECT nid FROM node WHERE type = 'blog' ORDER BY nid DESC LIMIT 20");
Dries's avatar
 
Dries committed
196

Dries's avatar
 
Dries committed
197
  $output .= "<table border=\"0\" cellpadding=\"4\" cellspacing=\"4\">";
Dries's avatar
 
Dries committed
198

Dries's avatar
 
Dries committed
199 200
  while ($node = db_fetch_object($result)) {
    $blog = node_load(array("nid" => $node->nid));
Dries's avatar
 
Dries committed
201

Dries's avatar
 
Dries committed
202
    $links = link_node($blog, 1);
Dries's avatar
 
Dries committed
203

204 205
    $output .= "<tr><td><b>". check_output($blog->title) ."</b></td><td align=\"right\">". $theme->links($links) ."</td><td>". l('<img src="misc/blog.gif" width="12" height="16" border="0" align="top">', array("id" => $node->nid), "node", "", array("title" => t("Permanent link to this blog entry"))) ."</td></tr>";
    $output .= "<tr><td colspan=\"3\"><div style=\"margin-left: 20px;\">". check_output($blog->teaser, 1) ."</div><br /></td></tr>";
Dries's avatar
 
Dries committed
206
  }
Dries's avatar
 
Dries committed
207

Dries's avatar
 
Dries committed
208
  $output .= "</table>";
Kjartan's avatar
Kjartan committed
209
  $output .= lm("<img src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" align=\"right\" border=\"0\" />", array("mod" => "blog", "op" => "feed"), "", array("title" => t("Read the XML version of this page."))) ."\n";
Dries's avatar
 
Dries committed
210

Dries's avatar
 
Dries committed
211
  $theme->box(t("User blogs"), $output, "main");
Dries's avatar
 
Dries committed
212 213
}

214
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
215 216
  global $nid, $iid;

Dries's avatar
 
Dries committed
217 218 219 220 221 222 223
  if (isset($node->body)) {

    /*
    ** Validate the size of the blog:
    */

    if (count(explode(" ", $node->body)) < variable_get("minimum_blog_size", 0)) {
Dries's avatar
 
Dries committed
224
      $error["body"] = theme_invoke("theme_error", t("The body of your blog is too short."));
Dries's avatar
 
Dries committed
225 226 227
    }
  }
  else {
Dries's avatar
 
Dries committed
228 229 230 231 232 233 234 235 236 237 238 239

    /*
    ** Carry out some explanation or submission guidelines:
    */

    $help = variable_get("blog_help", "");

    /*
    ** If the user clicked a "blog it" link, we load the data from the
    ** database and quote it in the blog:
    */

Dries's avatar
 
Dries committed
240
    if ($nid && $blog = node_load(array("nid" => $nid))) {
Dries's avatar
 
Dries committed
241
      $node->body = "<i>". $blog->body ."</i> [".lm($blog->name, array("mod" => "blog", "id" => $blog->uid, "date" => $blog->created))."]";
Dries's avatar
 
Dries committed
242 243
    }

Dries's avatar
 
Dries committed
244
    if ($iid && $item = db_fetch_object(db_query("SELECT i.*, f.title as ftitle, f.link as flink FROM item i, feed f WHERE i.iid = '%s' AND i.fid = f.fid", $iid))) {
245
      $node->title = $item->title;
Dries's avatar
 
Dries committed
246
      $node->body = "<a href=\"$item->link\">$item->title</a> - <i>". check_output($item->description) ."</i> [<a href=\"$item->flink\">$item->ftitle</a>]\n";
Dries's avatar
 
Dries committed
247 248
    }
  }
Dries's avatar
 
Dries committed
249

Dries's avatar
 
Dries committed
250 251 252 253
  if ($node->teaser) {
    $output .= form_textarea(t("Teaser"), "teaser", $node->teaser, 60, 5, $error["teaser"]);
  }

254
  if (function_exists("taxonomy_node_form")) {
Kjartan's avatar
Kjartan committed
255
    $output .= implode("", taxonomy_node_form("blog", $node));
256
  }
Dries's avatar
 
Dries committed
257

Dries's avatar
 
Dries committed
258
  $output .= form_textarea(t("Body"), "body", $node->body, 60, 15, $error["body"] ? $error["body"] : t("Allowed HTML tags") .": ". htmlspecialchars(variable_get("allowed_html", "")));
Dries's avatar
 
Dries committed
259

Dries's avatar
 
Dries committed
260
  return $output;
Dries's avatar
 
Dries committed
261 262 263 264
}


function blog_page() {
265
  global $theme, $id, $op, $date, $all, $name;
Dries's avatar
Dries committed
266

Dries's avatar
 
Dries committed
267
  if (user_access("access content")) {
Dries's avatar
 
Dries committed
268 269
    switch ($op) {
      case "feed":
Dries's avatar
 
Dries committed
270 271
        if ($id) {
          blog_feed_user($id, $date);
Dries's avatar
 
Dries committed
272 273 274 275 276 277
        }
        else {
          blog_feed_last();
        }
        break;
      default:
Dries's avatar
Dries committed
278
        $theme->header();
279 280 281 282
        if ($name) {
          $user = user_load(array("name" => $name));
          $id = $user->uid;
        }
Dries's avatar
 
Dries committed
283
        if ($id) {
Dries's avatar
 
Dries committed
284
          blog_page_user($id, $date, $all);
Dries's avatar
 
Dries committed
285 286 287 288
        }
        else {
          blog_page_last();
        }
Dries's avatar
Dries committed
289
        $theme->footer();
Dries's avatar
 
Dries committed
290 291
    }
  }
Dries's avatar
 
Dries committed
292
  else {
Dries's avatar
Dries committed
293
    $theme->header();
Dries's avatar
Dries committed
294
    $theme->box(t("Access denied"), message_access());
Dries's avatar
Dries committed
295
    $theme->footer();
Dries's avatar
 
Dries committed
296
  }
Dries's avatar
Dries committed
297

Dries's avatar
 
Dries committed
298 299
}

Dries's avatar
 
Dries committed
300
function blog_link($type, $node = 0, $main) {
Dries's avatar
 
Dries committed
301 302
  global $user;

Dries's avatar
 
Dries committed
303
  if ($type == "page" && user_access("access content")) {
Kjartan's avatar
Kjartan committed
304
    $links[] = lm(t("user blogs"), array("mod" => "blog"), "", array("title" => t("Read the latest blog entries.")));
Dries's avatar
 
Dries committed
305 306
  }

Dries's avatar
 
Dries committed
307
  if ($type == "menu.create" && user_access("post content")) {
Kjartan's avatar
Kjartan committed
308
    $links[] = lm(t("create blog entry"), array("mod" => "node", "op" => "add", "type" => "blog"), "", array("title" => t("Add a new personal blog entry.")));
Dries's avatar
 
Dries committed
309 310 311
  }

  if ($type == "menu.view" && user_access("access content")) {
Kjartan's avatar
Kjartan committed
312
    $links[] = lm(t("view personal blog"), array("mod" => "blog", "op" => "view", "id" => $user->uid), "", array("title" => t("Read your latest blog entries.")));
Dries's avatar
 
Dries committed
313 314
  }

Dries's avatar
 
Dries committed
315
  if ($type == "node" && $node->type == "blog") {
316
    global $mod, $op, $id;
Dries's avatar
 
Dries committed
317
    if (blog_access("update", $node)) {
Kjartan's avatar
Kjartan committed
318
      $links[] = lm(t("edit this blog"), array("mod" => "node", "op" => "edit", "id" => $node->nid), "", array("title" => t("Edit this blog entry.")));
Dries's avatar
 
Dries committed
319
    }
320
    elseif ($op != "view" && !$id) {
Dries's avatar
 
Dries committed
321
      $links[] = lm(t("%username's blog", array("%username" => $node->name)), array("mod" => "blog", "op" => "view", "id" => $node->uid), "", array("title" => t("Read %username's latest blog entries.", array("%username" => $node->name))));
Dries's avatar
 
Dries committed
322
    }
Dries's avatar
 
Dries committed
323 324
  }

Dries's avatar
 
Dries committed
325 326 327
  return $links ? $links : array();
}

Dries's avatar
 
Dries committed
328
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
329
  global $user;
Dries's avatar
 
Dries committed
330
  if ($op == "list") {
Dries's avatar
 
Dries committed
331 332
    $block[0]["info"] = t("User blogs");
    return $block;
Dries's avatar
 
Dries committed
333 334 335 336 337
  }
  else {
    if (user_access("access content")) {
      $result = db_query("SELECT u.uid, u.name, n.created, n.title, n.nid FROM node n LEFT JOIN users u ON n.uid = u.uid WHERE n.type = 'blog' ORDER BY n.nid DESC LIMIT 10");
      while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
338
        $items[] = l(check_output($node->title), array("id" => $node->nid));
Dries's avatar
 
Dries committed
339
      }
Dries's avatar
 
Dries committed
340 341

      $block["content"] = theme_invoke("theme_item_list", $items) ."<br /><div align=\"right\">". lm(t("more"), array("mod" => "blog"), "", array("title" => t("Read the latest blog entries."))) ."</div>";
Dries's avatar
 
Dries committed
342
      $block["subject"] = t("User blogs");
343
    }
Dries's avatar
 
Dries committed
344
    return $block;
Dries's avatar
 
Dries committed
345 346 347
  }
}

Dries's avatar
 
Dries committed
348
?>