blog.module 13 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."));
13
  return $output;
Dries's avatar
 
Dries committed
14 15
}

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

Dries's avatar
 
Dries committed
19
  $info["name"] = t("personal blog entry");
20
  $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
21 22 23 24 25 26 27 28

  return $info[$field];
}

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

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

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

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

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

}

Dries's avatar
 
Dries committed
46 47 48
function blog_head($main = 0) {
  global $id, $mod;

Dries's avatar
 
Dries committed
49
  if ($mod == "blog" && $id) {
Dries's avatar
 
Dries committed
50 51 52 53 54 55
    $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();
}

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

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

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

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

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

89
      return array("body" => filter($node->body), "teaser" => filter($node->teaser));
Dries's avatar
 
Dries committed
90
    }
Dries's avatar
 
Dries committed
91
    else {
Dries's avatar
 
Dries committed
92
      /*
Dries's avatar
 
Dries committed
93 94
      ** 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
95 96
      */

Dries's avatar
 
Dries committed
97
      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
98
    }
Dries's avatar
 
Dries committed
99 100 101 102
  }

}

Dries's avatar
 
Dries committed
103 104
function blog_help() {
 ?>
Dries's avatar
 
Dries committed
105 106 107 108
  <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
109 110 111
 <?php
}

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

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

Dries's avatar
 
Dries committed
122
  $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.status = 1 ORDER BY n.nid DESC LIMIT 15");
Dries's avatar
 
Dries committed
123 124 125 126
  $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
127 128 129 130

}

function blog_feed_last() {
Dries's avatar
 
Dries committed
131
  $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 n.status = 1 ORDER BY n.nid DESC LIMIT 15");
Dries's avatar
 
Dries committed
132 133 134 135
  $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
136 137
}

Dries's avatar
 
Dries committed
138 139
function blog_page_user($uid = 0) {
  global $user, $theme;
Dries's avatar
 
Dries committed
140

Dries's avatar
 
Dries committed
141 142 143 144 145 146
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }
Dries's avatar
 
Dries committed
147 148 149
  $links[] = lm(t("view %username's profile", array("%username" => $account->name)), array("mod" => "user", "id" => $account->uid), "", array("title" => t("View %username's profile information.", array("%username" => $account->name))));
  $links[] = lm(t("view recent blog entries"), array("mod" => "blog", "op" => "view"), "", array("title" => t("View all recent blog entries.")));
  $theme->box(t("%username's blog", array ("%username" => $account->name)), "<center>". $theme->links($links). "</center>");
Dries's avatar
 
Dries committed
150

Dries's avatar
 
Dries committed
151
  $result = db_query_pager("SELECT nid FROM node WHERE type = 'blog' AND uid = '$account->uid' AND status = 1 ORDER BY nid DESC", $user->nodes ? $user->nodes : variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
152
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
153
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
154
  }
Dries's avatar
 
Dries committed
155 156
  print pager_display(NULL, ($user->nodes ? $user->nodes : variable_get("default_nodes_main", 10)));
  print lm("<img align=\"right\" src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" />", array("mod" => "blog", "op" => "feed", "id" => $account->uid), "", array("title" => t("View the XML version of %username's blog", array ("%username" => $account->name))));
Dries's avatar
 
Dries committed
157 158
}

Dries's avatar
Dries committed
159
function blog_page_last() {
Dries's avatar
 
Dries committed
160
  global $user, $theme;
Dries's avatar
 
Dries committed
161

Dries's avatar
 
Dries committed
162
  $result = db_query_pager("SELECT nid FROM node WHERE type = 'blog' AND status = 1 ORDER BY nid DESC", $user->nodes ? $user->nodes : variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
163

Dries's avatar
 
Dries committed
164
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
165
    $output = node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
166
  }
Dries's avatar
 
Dries committed
167 168 169
  $output .= pager_display(NULL, ($user->nodes ? $user->nodes : variable_get("default_nodes_main", 10)));
  $output .= lm("<img align=\"right\" src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" />", array("mod" => "blog", "op" => "feed"), "", array("title" => t("Read the XML version of all blogs.")));
  return $output;
Dries's avatar
 
Dries committed
170 171
}

172
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
173 174
  global $nid, $iid;

Dries's avatar
 
Dries committed
175 176 177 178 179 180 181
  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
182
      $error["body"] = theme_invoke("theme_error", t("The body of your blog is too short."));
Dries's avatar
 
Dries committed
183 184 185
    }
  }
  else {
Dries's avatar
 
Dries committed
186 187 188 189 190 191 192 193 194 195 196 197

    /*
    ** 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
198
    if ($nid && $blog = node_load(array("nid" => $nid))) {
Dries's avatar
 
Dries committed
199
      $node->body = "<i>". $blog->body ."</i> [".lm($blog->name, array("mod" => "blog", "id" => $blog->uid, "date" => $blog->created))."]";
Dries's avatar
 
Dries committed
200 201
    }

Dries's avatar
 
Dries committed
202
    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))) {
203
      $node->title = $item->title;
Dries's avatar
 
Dries committed
204
      $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
205 206
    }
  }
Dries's avatar
 
Dries committed
207

Dries's avatar
 
Dries committed
208 209 210 211
  if ($node->teaser) {
    $output .= form_textarea(t("Teaser"), "teaser", $node->teaser, 60, 5, $error["teaser"]);
  }

212
  if (function_exists("taxonomy_node_form")) {
Kjartan's avatar
Kjartan committed
213
    $output .= implode("", taxonomy_node_form("blog", $node));
214
  }
Dries's avatar
 
Dries committed
215
  $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
216

Dries's avatar
 
Dries committed
217
  return $output;
Dries's avatar
 
Dries committed
218 219 220
}

function blog_page() {
Dries's avatar
 
Dries committed
221
  global $theme, $id, $op, $name;
Dries's avatar
Dries committed
222

Dries's avatar
 
Dries committed
223
  if (user_access("access content")) {
Dries's avatar
 
Dries committed
224 225
    switch ($op) {
      case "feed":
Dries's avatar
 
Dries committed
226
        if ($id) {
Dries's avatar
 
Dries committed
227
          blog_feed_user($id);
Dries's avatar
 
Dries committed
228 229 230 231 232 233
        }
        else {
          blog_feed_last();
        }
        break;
      default:
Dries's avatar
Dries committed
234
        $theme->header();
235 236 237 238
        if ($name) {
          $user = user_load(array("name" => $name));
          $id = $user->uid;
        }
Dries's avatar
 
Dries committed
239
        if ($id) {
Dries's avatar
 
Dries committed
240
          blog_page_user($id);
Dries's avatar
 
Dries committed
241 242
        }
        else {
Dries's avatar
 
Dries committed
243
          print blog_page_last();
Dries's avatar
 
Dries committed
244
        }
Dries's avatar
Dries committed
245
        $theme->footer();
Dries's avatar
 
Dries committed
246 247
    }
  }
Dries's avatar
 
Dries committed
248
  else {
Dries's avatar
Dries committed
249
    $theme->header();
Dries's avatar
Dries committed
250
    $theme->box(t("Access denied"), message_access());
Dries's avatar
Dries committed
251
    $theme->footer();
Dries's avatar
 
Dries committed
252
  }
Dries's avatar
Dries committed
253

Dries's avatar
 
Dries committed
254 255
}

Dries's avatar
 
Dries committed
256
function blog_link($type, $node = 0, $main) {
Dries's avatar
 
Dries committed
257 258
  global $user;

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

Dries's avatar
 
Dries committed
263
  if ($type == "menu.create" && user_access("post content")) {
Kjartan's avatar
Kjartan committed
264
    $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
265 266 267
  }

  if ($type == "menu.view" && user_access("access content")) {
Kjartan's avatar
Kjartan committed
268
    $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
269 270
  }

Dries's avatar
 
Dries committed
271
  if ($type == "node" && $node->type == "blog") {
272
    global $mod, $op, $id;
Dries's avatar
 
Dries committed
273

Dries's avatar
 
Dries committed
274
    if (blog_access("update", $node)) {
Kjartan's avatar
Kjartan committed
275
      $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
276
    }
Dries's avatar
 
Dries committed
277
    elseif (empty($id)) {
Dries's avatar
 
Dries committed
278
      $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
279
    }
Dries's avatar
 
Dries committed
280 281
  }

Dries's avatar
 
Dries committed
282 283 284
  return $links ? $links : array();
}

Dries's avatar
 
Dries committed
285
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
286
  global $user;
Dries's avatar
 
Dries committed
287
  if ($op == "list") {
Dries's avatar
 
Dries committed
288 289
    $block[0]["info"] = t("User blogs");
    return $block;
Dries's avatar
 
Dries committed
290 291 292
  }
  else {
    if (user_access("access content")) {
Dries's avatar
 
Dries committed
293 294
      $block["content"] = node_title_list(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' AND n.status = 1 ORDER BY n.nid DESC LIMIT 10"));
      $block["content"] .= "<div align=\"right\" id=\"blog_more\">". lm(t("more"), array("mod" => "blog"), "", array("title" => t("Read the latest blog entries."))) ."</div>";
Dries's avatar
 
Dries committed
295
      $block["subject"] = t("User blogs");
296
    }
Dries's avatar
 
Dries committed
297
    return $block;
Dries's avatar
 
Dries committed
298 299 300
  }
}

Dries's avatar
 
Dries committed
301
?>