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

4
function blog_settings() {
Dries's avatar
 
Dries committed
5
  $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
6 7
  $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."));
8
  return $output;
Dries's avatar
 
Dries committed
9 10
}

Dries's avatar
 
Dries committed
11 12 13
function blog_node($field) {
  global $user;

Dries's avatar
 
Dries committed
14
  $info["name"] = t("personal blog entry");
Dries's avatar
 
Dries committed
15
  $info["description"] = t("A blog is a regularly updated journal 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).  They tend to be quite personal, often containing links to things you've seen, or to editorials that you find interesting.   Some blogs also contain original material written solely for the blog.  Since a Blog is personal, you and only you have full control over 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 by users with the access do this.");
Dries's avatar
 
Dries committed
16 17 18 19

  return $info[$field];
}

Dries's avatar
 
Dries committed
20 21 22 23
function blog_perm() {
  return array("maintain personal blog");
}

Dries's avatar
 
Dries committed
24 25 26 27
function blog_access($op, $node) {
  global $user;

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

  if ($op == "create") {
Dries's avatar
 
Dries committed
32
    return user_access("maintain personal blog") && $user->uid;
Dries's avatar
 
Dries committed
33 34 35
  }

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

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

}

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

Dries's avatar
 
Dries committed
49 50
  $output = array();

Dries's avatar
 
Dries committed
51 52
  if ($mod == "blog") {
    $output[] = "<link rel=\"alternate\" type=\"application/rss+xml\" title=\"RSS feed\" href=\"". url("blog/feed/$id") ."\" />";
Dries's avatar
 
Dries committed
53
  }
Dries's avatar
 
Dries committed
54

Dries's avatar
 
Dries committed
55
  return $output;
Dries's avatar
 
Dries committed
56 57
}

58 59 60 61
function blog_user($type, &$edit, &$user) {
  switch ($type) {
    case "view_public":
    case "view_private":
Dries's avatar
 
Dries committed
62 63 64
      if (user_access("maintain personal blog", $user)) {
        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)))));
      }
65 66 67
  }
}

Dries's avatar
 
Dries committed
68 69 70 71
function blog_help($section) {
  $output ="";

  switch ($section) {
Dries's avatar
 
Dries committed
72
    case 'admin/help#blog':
Dries's avatar
 
Dries committed
73
      $output .= "<p>Drupal's blog module allows registered users to maintain an online weblog (commonly known as a blog), often referred to as an online journal or diary.  These 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.</p>";
Dries's avatar
 
Dries committed
74
      $output .= "<p>Blogs are made up of individual entries (nodes) that are timestamped and are typically viewed by day as you would a diary.  Blogs often contain links to things you've seen and/or agree/disagree with.  A typical example of a long term blog can be seen at %scripting-com.</p>";
Dries's avatar
 
Dries committed
75 76
      $output .= "<p>The blog module adds a \"user blogs\" navigation link to the site, which takes any visitor to a page that displays the most recent blog entries from all the users on the site. Personal user menus gain a \"create a blog entry\" link (which takes you to a submission form) and a \"view personal blog\" link (which displays your blog entries as other people will see them).  On the bottom of each of your own blog entries, there is an \"edit this blog entry\" link that lets you edit or delete that entry.</p>";
      $output .= "<p>If a user has the ability to post blogs, then the import module (news aggregator) will display a blog-it link <b>(b)</b> next to each news item in its lists.  Click on this and you will be taken to the blog submission form, with the title, a link to the item, and a link to the source into the body text already in the text box, 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 and from your syndicated partner sites.</p>";
Dries's avatar
 
Dries committed
77
      $output = t($output, array("%scripting-com" => "<a href=\"http://www.scripting.com/\">http://www.scripting.com/</a>" ));
Dries's avatar
 
Dries committed
78
      break;
Dries's avatar
 
Dries committed
79
    case 'admin/system/modules#description':
Dries's avatar
 
Dries committed
80
      $output .= t("Enables keeping a blog or easily and regularly updated web page.");
Dries's avatar
 
Dries committed
81 82
      break;
    case 'admin/system/modules/blog':
Dries's avatar
 
Dries committed
83
      $output .= t("A weBLOG is a running journal of a users ideas. Enter the minimum word count for a single entry, and the text displayed on the entry submission form");
Dries's avatar
 
Dries committed
84 85
      break;
  }
Dries's avatar
 
Dries committed
86

Dries's avatar
 
Dries committed
87
  return $output;
Dries's avatar
 
Dries committed
88 89
}

Dries's avatar
 
Dries committed
90
function blog_feed_user($uid = 0) {
Dries's avatar
 
Dries committed
91 92
  global $user;

Dries's avatar
 
Dries committed
93 94 95 96 97 98 99
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }

Dries's avatar
 
Dries committed
100
  $result = db_query_range("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM {node} n INNER 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
101
  $channel["title"] = $account->name ."'s blog";
Dries's avatar
 
Dries committed
102
  $channel["link"] = url("blog/view/$uid");
Dries's avatar
 
Dries committed
103 104
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
105 106 107
}

function blog_feed_last() {
Dries's avatar
 
Dries committed
108
  $result = db_query_range("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM {node} n INNER 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
109
  $channel["title"] = variable_get("site_name", "drupal") ." blogs";
Dries's avatar
 
Dries committed
110
  $channel["link"] = url("blog");
Dries's avatar
 
Dries committed
111 112
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
113 114
}

Dries's avatar
 
Dries committed
115 116
function blog_page_user($uid) {
  $account = user_load(array((is_numeric($uid) ? "uid" : "name") => $uid, "status" => 1));
Dries's avatar
 
Dries committed
117

Dries's avatar
 
Dries committed
118
  // Breadcrumb navigation:
Dries's avatar
 
Dries committed
119 120 121 122
  $breadcrumb[] = l(t("Home"), NULL);
  $breadcrumb[] = l(t("Blogs"), "blog");
  $breadcrumb[] = t("%name's blog", array("%name" => $account->name));
  theme("breadcrumb", $breadcrumb);
Dries's avatar
 
Dries committed
123

Dries's avatar
 
Dries committed
124
  $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
125
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
126
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
127
  }
Dries's avatar
 
Dries committed
128
  print pager_display(NULL, variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
129
  print "<div style=\"text-align: right\">" . l("<img src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" style=\"border: 0px;\" alt=\"\" title=\"\" />", "blog/feed/$account->uid", array("title" => t("View the XML version of %username's blog", array("%username" => $account->name)))) . "</div>";
Dries's avatar
 
Dries committed
130 131
}

Dries's avatar
Dries committed
132
function blog_page_last() {
Dries's avatar
 
Dries committed
133
  global $user;
Dries's avatar
 
Dries committed
134

Dries's avatar
 
Dries committed
135
  // Breadcrumb navigation:
Dries's avatar
 
Dries committed
136 137 138
  $breadcrumb[] = l(t("Home"), NULL);
  $breadcrumb[] = t("Blogs");
  theme("breadcrumb", $breadcrumb);
Dries's avatar
 
Dries committed
139

Dries's avatar
 
Dries committed
140
  $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
141

Dries's avatar
 
Dries committed
142
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
143
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
144
  }
Dries's avatar
 
Dries committed
145 146
  print pager_display(NULL, variable_get("default_nodes_main", 10));
  print "<div style=\"text-align: right;\">". l("<img src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" style=\"border: 0px;\" alt=\"\" title=\"\" />", "blog/feed", array("title" => t("Read the XML version of all blogs."))) ."</div>";
Dries's avatar
 
Dries committed
147 148
}

Dries's avatar
 
Dries committed
149 150 151 152 153 154 155 156 157 158 159 160 161
function blog_validate(&$node) {

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

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

  return $error;
}

162
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
163 164
  global $nid;
  $iid = $_GET["iid"];
Dries's avatar
 
Dries committed
165

Dries's avatar
 
Dries committed
166 167 168
  /*
  ** Carry out some explanation or submission guidelines:
  */
Dries's avatar
 
Dries committed
169

Dries's avatar
 
Dries committed
170
  $help = variable_get("blog_help", "");
Dries's avatar
 
Dries committed
171

Dries's avatar
 
Dries committed
172
  if (empty($node->body)) {
Dries's avatar
 
Dries committed
173 174 175 176 177
    /*
    ** 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
178
    if ($nid && $blog = node_load(array("nid" => $nid))) {
Dries's avatar
 
Dries committed
179
      $node->body = "<i>". $blog->body ."</i> [". l($blog->name, "node/view/$nid") ."]";
Dries's avatar
 
Dries committed
180 181
    }

Dries's avatar
 
Dries committed
182
    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))) {
183
      $node->title = $item->title;
Dries's avatar
 
Dries committed
184
      $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
185 186
    }
  }
Dries's avatar
 
Dries committed
187

188
  if (function_exists("taxonomy_node_form")) {
Kjartan's avatar
Kjartan committed
189
    $output .= implode("", taxonomy_node_form("blog", $node));
190
  }
Dries's avatar
 
Dries committed
191

Dries's avatar
 
Dries committed
192
  $output .= form_textarea(t("Body"), "body", $node->body, 60, 15, $error["body"] ? $error["body"] : form_allowed_tags_text());
Dries's avatar
 
Dries committed
193

Dries's avatar
 
Dries committed
194
  return $output;
Dries's avatar
 
Dries committed
195 196 197
}

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

Dries's avatar
 
Dries committed
199
  if (user_access("access content")) {
Dries's avatar
 
Dries committed
200
    switch (arg(1)) {
Dries's avatar
 
Dries committed
201
      case "feed":
Dries's avatar
 
Dries committed
202 203
        if (arg(2)) {
          blog_feed_user(arg(2));
Dries's avatar
 
Dries committed
204 205 206 207 208 209
        }
        else {
          blog_feed_last();
        }
        break;
      default:
Dries's avatar
 
Dries committed
210
        theme("header");
Dries's avatar
 
Dries committed
211 212
        if (arg(1)) {
          blog_page_user(arg(1));
Dries's avatar
 
Dries committed
213 214
        }
        else {
Dries's avatar
 
Dries committed
215
          blog_page_last();
Dries's avatar
 
Dries committed
216
        }
Dries's avatar
 
Dries committed
217
        theme("footer");
Dries's avatar
 
Dries committed
218 219
    }
  }
Dries's avatar
 
Dries committed
220
  else {
Dries's avatar
 
Dries committed
221 222 223
    theme("header");
    theme("box", t("Access denied"), message_access());
    theme("footer");
Dries's avatar
 
Dries committed
224
  }
Dries's avatar
Dries committed
225

Dries's avatar
 
Dries committed
226 227
}

Dries's avatar
 
Dries committed
228
function blog_content($node) {
Dries's avatar
 
Dries committed
229 230 231
  $node->teaser = check_output($node->teaser);
  $node->body = check_output($node->body);
  return $node;
Dries's avatar
 
Dries committed
232 233
}

Dries's avatar
 
Dries committed
234 235 236 237 238 239
function blog_view($node, $main = 0) {
  if ($main == 0) {
    // Breadcrumb navigation
    $breadcrumb[] = l(t("Home"), NULL);
    $breadcrumb[] = l(t("%name's blog", array("%name" => $node->name)), "blog/$node->uid");
    // print the breadcrumb
Dries's avatar
 
Dries committed
240
    theme("breadcrumb", $breadcrumb);
Dries's avatar
 
Dries committed
241 242 243 244 245 246 247
  }
  // prepair the node content
  $node = blog_content($node);
  // print the node
  theme("node", $node, $main);
}

Dries's avatar
 
Dries committed
248
function blog_link($type, $node = 0, $main) {
Dries's avatar
 
Dries committed
249 250
  global $user;

Dries's avatar
 
Dries committed
251 252
  $links = array();

Dries's avatar
 
Dries committed
253 254
  if ($type == "system") {
    if (user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
255
      menu("node/add/blog", t("blog entry"), "blog_page", 0);
Dries's avatar
 
Dries committed
256 257
    }
    if (user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
258
      menu("blog/" . $user->uid, t("my blog"), "user_page", 1);
Dries's avatar
 
Dries committed
259
    }
Dries's avatar
 
Dries committed
260 261
  }

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

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

Dries's avatar
 
Dries committed
269
    if (blog_access("update", $node)) {
Dries's avatar
 
Dries committed
270
      $links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry.")));
Dries's avatar
 
Dries committed
271
    }
Dries's avatar
 
Dries committed
272
    elseif (empty($id)) {
Dries's avatar
 
Dries committed
273
      $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
274
    }
Dries's avatar
 
Dries committed
275 276
  }

Dries's avatar
 
Dries committed
277
  return $links;
Dries's avatar
 
Dries committed
278 279
}

Dries's avatar
 
Dries committed
280
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
281
  global $user;
Dries's avatar
 
Dries committed
282
  if ($op == "list") {
Dries's avatar
 
Dries committed
283
    $block[0]["info"] = t("Blogs");
Dries's avatar
 
Dries committed
284
    return $block;
Dries's avatar
 
Dries committed
285 286 287
  }
  else {
    if (user_access("access content")) {
Dries's avatar
 
Dries committed
288
      $block["content"] = node_title_list(db_query_range("SELECT n.title, n.nid FROM {node} n WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, 10));
Dries's avatar
 
Dries committed
289
      $block["content"] .= "<div class=\"more-link\">". l(t("more"), "blog", array("title" => t("Read the latest blog entries."))) ."</div>";
Dries's avatar
 
Dries committed
290
      $block["subject"] = t("Blogs");
291
    }
Dries's avatar
 
Dries committed
292
    return $block;
Dries's avatar
 
Dries committed
293 294 295
  }
}

Dries's avatar
 
Dries committed
296
?>