blog.module 10.9 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];
}

9
function blog_settings() {
Dries's avatar
 
Dries committed
10
  $output = form_textarea(t("Explanation or submission guidelines"), "blog_help", variable_get("blog_help", ""), 70, 4, t("This text is displayed at the top of the blog submission form.  It's useful for helping or instructing your users."));
Dries's avatar
 
Dries committed
11 12
  $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

  return $info[$field];
}

Dries's avatar
 
Dries committed
25 26 27 28
function blog_perm() {
  return array("maintain personal blog");
}

Dries's avatar
 
Dries committed
29 30 31 32
function blog_access($op, $node) {
  global $user;

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

  if ($op == "create") {
Dries's avatar
 
Dries committed
37
    return user_access("maintain personal blog") && $user->uid;
Dries's avatar
 
Dries committed
38 39 40
  }

  if ($op == "update") {
Dries's avatar
 
Dries committed
41
    return user_access("maintain personal blog") && ($user->uid == $node->uid);
Dries's avatar
 
Dries committed
42 43 44
  }

  if ($op == "delete") {
Dries's avatar
 
Dries committed
45
    return user_access("maintain personal blog") && ($user->uid == $node->uid);
Dries's avatar
 
Dries committed
46 47 48 49
  }

}

Dries's avatar
 
Dries committed
50
function blog_head($main = 0) {
Dries's avatar
 
Dries committed
51 52
  $mod = arg(0);
  $id = arg(1);
Dries's avatar
 
Dries committed
53

Dries's avatar
 
Dries committed
54 55
  $output = array();

Dries's avatar
 
Dries committed
56
  if ($mod == "blog" && $id) {
Dries's avatar
 
Dries committed
57
    $account = user_load(array("uid" => $id));
Dries's avatar
 
Dries committed
58
    $output[] = "<link rel=\"alternate\" type=\"application/rss+xml\" title=\"RSS - ". $account->name. "'s blog\" href=\"". url("blog/view/$id") ."\" />";
Dries's avatar
 
Dries committed
59
  }
Dries's avatar
 
Dries committed
60

Dries's avatar
 
Dries committed
61
  return $output;
Dries's avatar
 
Dries committed
62 63
}

64 65 66 67
function blog_user($type, &$edit, &$user) {
  switch ($type) {
    case "view_public":
    case "view_private":
68
      return form_item(t("Blog"), l(t("view recent blog entries"), "blog/$user->uid", array("title" => t("Read %username's latest blog entries.", array("%username" => $user->name)))));
69 70 71
  }
}

Dries's avatar
 
Dries committed
72 73
function blog_help() {
 ?>
Dries's avatar
 
Dries committed
74 75 76 77
  <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
78 79 80
 <?php
}

Dries's avatar
 
Dries committed
81
function blog_feed_user($uid = 0) {
Dries's avatar
 
Dries committed
82 83
  global $user;

Dries's avatar
 
Dries committed
84 85 86 87 88 89 90
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }

Dries's avatar
 
Dries committed
91
  $result = db_query_range("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 = %d AND n.status = 1 ORDER BY n.nid DESC", $uid, 0, 15);
Dries's avatar
 
Dries committed
92
  $channel["title"] = $account->name. "'s blog";
Dries's avatar
 
Dries committed
93
  $channel["link"] = url("blog/view/$uid");
Dries's avatar
 
Dries committed
94 95
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
96 97 98
}

function blog_feed_last() {
Dries's avatar
 
Dries committed
99
  $result = db_query_range("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", 0, 15);
Dries's avatar
 
Dries committed
100
  $channel["title"] = variable_get("site_name", "drupal") ." blogs";
Dries's avatar
 
Dries committed
101
  $channel["link"] = url("blog");
Dries's avatar
 
Dries committed
102 103
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
104 105
}

Dries's avatar
 
Dries committed
106
function blog_page_user($uid = 0) {
Dries's avatar
 
Dries committed
107
  global $user;
Dries's avatar
 
Dries committed
108

Dries's avatar
 
Dries committed
109
  if ($uid) {
110
    $account = user_load(array((is_numeric($uid) ? "uid" : "name") => $uid, "status" => 1));
Dries's avatar
 
Dries committed
111 112 113 114
  }
  else {
    $account = $user;
  }
Dries's avatar
 
Dries committed
115

Dries's avatar
 
Dries committed
116
  $result = pager_query("SELECT nid FROM node WHERE type = 'blog' AND uid = '$account->uid' AND status = 1 ORDER BY nid DESC", variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
117
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
118
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
119
  }
Dries's avatar
 
Dries committed
120
  print pager_display(NULL, variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
121
  print l("<img align=\"right\" src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" alt=\"\" />", "blog/feed/$account->uid", array("title" => t("View the XML version of %username's blog", array ("%username" => $account->name))));
Dries's avatar
 
Dries committed
122 123
}

Dries's avatar
Dries committed
124
function blog_page_last() {
Dries's avatar
 
Dries committed
125
  global $user;
Dries's avatar
 
Dries committed
126

Dries's avatar
 
Dries committed
127
  $result = pager_query("SELECT nid FROM node WHERE type = 'blog' AND status = 1 ORDER BY nid DESC", variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
128

Dries's avatar
 
Dries committed
129
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
130
    $output = node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
131
  }
Dries's avatar
 
Dries committed
132
  $output .= pager_display(NULL, variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
133
  $output .= l("<img align=\"right\" src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" alt=\"\" />", "blog/feed", array("title" => t("Read the XML version of all blogs.")));
Dries's avatar
 
Dries committed
134
  return $output;
Dries's avatar
 
Dries committed
135 136
}

137
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
138
  global $nid, $iid;
139
  if (empty($node->body)) {
Dries's avatar
 
Dries committed
140 141 142 143 144 145 146 147 148 149 150 151

    /*
    ** 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
152
    if ($nid && $blog = node_load(array("nid" => $nid))) {
Dries's avatar
 
Dries committed
153
      $node->body = "<i>". $blog->body ."</i> [". l($blog->name, "node/view/$nid") ."]";
Dries's avatar
 
Dries committed
154 155
    }

Dries's avatar
 
Dries committed
156
    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 = %d AND i.fid = f.fid", $iid))) {
157
      $node->title = $item->title;
Dries's avatar
 
Dries committed
158
      $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
159 160
    }
  }
161 162 163 164 165 166 167 168 169
  else {
    /*
    ** Validate the size of the blog:
    */

    if (count(explode(" ", $node->body)) < variable_get("minimum_blog_size", 0)) {
      $error["body"] = theme("theme_error", t("The body of your blog is too short."));
    }
  }
Dries's avatar
 
Dries committed
170

171
  if (function_exists("taxonomy_node_form")) {
Kjartan's avatar
Kjartan committed
172
    $output .= implode("", taxonomy_node_form("blog", $node));
173
  }
Dries's avatar
 
Dries committed
174
  $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
175

Dries's avatar
 
Dries committed
176
  return $output;
Dries's avatar
 
Dries committed
177 178 179
}

function blog_page() {
Dries's avatar
 
Dries committed
180

Dries's avatar
 
Dries committed
181
  if (user_access("access content")) {
Dries's avatar
 
Dries committed
182
    switch (arg(1)) {
Dries's avatar
 
Dries committed
183
      case "feed":
Dries's avatar
 
Dries committed
184 185
        if (arg(2)) {
          blog_feed_user(arg(2));
Dries's avatar
 
Dries committed
186 187 188 189 190 191
        }
        else {
          blog_feed_last();
        }
        break;
      default:
Dries's avatar
 
Dries committed
192
        theme("header");
Dries's avatar
 
Dries committed
193 194
        if (arg(1)) {
          blog_page_user(arg(1));
Dries's avatar
 
Dries committed
195 196
        }
        else {
Dries's avatar
 
Dries committed
197
          print blog_page_last();
Dries's avatar
 
Dries committed
198
        }
Dries's avatar
 
Dries committed
199
        theme("footer");
Dries's avatar
 
Dries committed
200 201
    }
  }
Dries's avatar
 
Dries committed
202
  else {
Dries's avatar
 
Dries committed
203 204 205
    theme("header");
    theme("box", t("Access denied"), message_access());
    theme("footer");
Dries's avatar
 
Dries committed
206
  }
Dries's avatar
Dries committed
207

Dries's avatar
 
Dries committed
208 209
}

Dries's avatar
 
Dries committed
210
function blog_link($type, $node = 0, $main) {
Dries's avatar
 
Dries committed
211 212
  global $user;

Dries's avatar
 
Dries committed
213 214
  $links = array();

Dries's avatar
 
Dries committed
215
  if ($type == "page" && user_access("access content")) {
Dries's avatar
 
Dries committed
216
    $links[] = l(t("blogs"), "blog", array("title" => t("Read the latest blog entries.")));
Dries's avatar
 
Dries committed
217 218
  }

Dries's avatar
 
Dries committed
219
  if ($type == "menu.create" && user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
220
    $links[] = l(t("create blog entry"), "node/add/blog", array("title" => t("Add a new personal blog entry.")));
Dries's avatar
 
Dries committed
221 222
  }

Dries's avatar
 
Dries committed
223
  if ($type == "menu.view" && user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
224
    $links[] = l(t("view personal blog"), "blog/$user->uid", array("title" => t("Read your latest blog entries.")));
Dries's avatar
 
Dries committed
225 226
  }

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

Dries's avatar
 
Dries committed
230
    if (blog_access("update", $node)) {
Dries's avatar
 
Dries committed
231
      $links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry.")));
Dries's avatar
 
Dries committed
232
    }
Dries's avatar
 
Dries committed
233
    elseif (empty($id)) {
Dries's avatar
 
Dries committed
234
      $links[] = l(t("%username's blog", array("%username" => $node->name)), "blog/$node->uid", array("title" => t("Read %username's latest blog entries.", array("%username" => $node->name))));
Dries's avatar
 
Dries committed
235
    }
Dries's avatar
 
Dries committed
236 237
  }

Dries's avatar
 
Dries committed
238
  return $links;
Dries's avatar
 
Dries committed
239 240
}

Dries's avatar
 
Dries committed
241
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
242
  global $user;
Dries's avatar
 
Dries committed
243
  if ($op == "list") {
Dries's avatar
 
Dries committed
244
    $block[0]["info"] = t("Blogs");
Dries's avatar
 
Dries committed
245
    return $block;
Dries's avatar
 
Dries committed
246 247 248
  }
  else {
    if (user_access("access content")) {
Dries's avatar
 
Dries committed
249
      $block["content"] = node_title_list(db_query_range("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", 0, 10));
Dries's avatar
 
Dries committed
250
      $block["content"] .= "<div align=\"right\" id=\"blog_more\">". l(t("more"), "blog", array("title" => t("Read the latest blog entries."))) ."</div>";
Dries's avatar
 
Dries committed
251
      $block["subject"] = t("Blogs");
252
    }
Dries's avatar
 
Dries committed
253
    return $block;
Dries's avatar
 
Dries committed
254 255 256
  }
}

257 258 259 260 261 262
function blog_validate(&$node) {
  // Make sure all fields are set properly:
  $node->body = filter($node->body);
  $node->teaser = filter($node->teaser);
}

Dries's avatar
 
Dries committed
263
?>