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

4
function blog_system($field){
Dries's avatar
 
Dries committed
5 6 7 8 9 10
  $output = "";

  if ($field == "description") { $output = blog_help("admin/system/modules"); }
  else if ($field == "admin_help") { $output = blog_help("admin/system/modules/blog"); };

  return $output;
11 12
}

13
function blog_settings() {
Dries's avatar
 
Dries committed
14
  $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
15 16
  $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."));
17
  return $output;
Dries's avatar
 
Dries committed
18 19
}

Dries's avatar
 
Dries committed
20 21 22
function blog_node($field) {
  global $user;

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

  return $info[$field];
}

Dries's avatar
 
Dries committed
29 30 31 32
function blog_perm() {
  return array("maintain personal blog");
}

Dries's avatar
 
Dries committed
33 34 35 36
function blog_access($op, $node) {
  global $user;

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

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

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

  if ($op == "delete") {
Dries's avatar
 
Dries committed
49
    return user_access("maintain personal blog") && ($user->uid == $node->uid);
Dries's avatar
 
Dries committed
50 51 52 53
  }

}

Dries's avatar
 
Dries committed
54
function blog_head($main = 0) {
Dries's avatar
 
Dries committed
55 56
  $mod = arg(0);
  $id = arg(1);
Dries's avatar
 
Dries committed
57

Dries's avatar
 
Dries committed
58 59
  $output = array();

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

Dries's avatar
 
Dries committed
64
  return $output;
Dries's avatar
 
Dries committed
65 66
}

67 68 69 70
function blog_user($type, &$edit, &$user) {
  switch ($type) {
    case "view_public":
    case "view_private":
Dries's avatar
 
Dries committed
71 72 73
      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)))));
      }
74 75 76
  }
}

Dries's avatar
 
Dries committed
77 78 79 80 81 82 83
function blog_help($section) {
  $output ="";

  switch ($section) {
    case 'admin/blog/help':
    case 'admin/help':
      $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
84
      $output .= strtr("<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>", array("%scripting-com" => "<a href=\"http://www.scripting.com/\">". t("http://www.scripting.com/") ."</a>" ));
Dries's avatar
 
Dries committed
85 86 87 88 89 90 91 92 93 94
      $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>";
      break;
    case 'admin/system/modules':
      $output .= "Enables keeping a blog or easily and regularly updated web page.";
      break;
    case 'admin/system/modules/blog':
      $output .= "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";
      break;
  }
Dries's avatar
 
Dries committed
95 96

  return t($output);
Dries's avatar
 
Dries committed
97 98
}

Dries's avatar
 
Dries committed
99
function blog_feed_user($uid = 0) {
Dries's avatar
 
Dries committed
100 101
  global $user;

Dries's avatar
 
Dries committed
102 103 104 105 106 107 108
  if ($uid) {
    $account = user_load(array("uid" => $uid, "status" => 1));
  }
  else {
    $account = $user;
  }

Dries's avatar
 
Dries committed
109
  $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
110
  $channel["title"] = $account->name. "'s blog";
Dries's avatar
 
Dries committed
111
  $channel["link"] = url("blog/view/$uid");
Dries's avatar
 
Dries committed
112 113
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
114 115 116
}

function blog_feed_last() {
Dries's avatar
 
Dries committed
117
  $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
118
  $channel["title"] = variable_get("site_name", "drupal") ." blogs";
Dries's avatar
 
Dries committed
119
  $channel["link"] = url("blog");
Dries's avatar
 
Dries committed
120 121
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
122 123
}

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

Dries's avatar
 
Dries committed
127
  // Breadcrumb navigation:
Dries's avatar
 
Dries committed
128 129 130 131
  $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
132

Dries's avatar
 
Dries committed
133
  $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
134
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
135
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
136
  }
Dries's avatar
 
Dries committed
137
  print pager_display(NULL, variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
138
  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
139 140
}

Dries's avatar
Dries committed
141
function blog_page_last() {
Dries's avatar
 
Dries committed
142
  global $user;
Dries's avatar
 
Dries committed
143

Dries's avatar
 
Dries committed
144
  // Breadcrumb navigation:
Dries's avatar
 
Dries committed
145 146 147
  $breadcrumb[] = l(t("Home"), NULL);
  $breadcrumb[] = t("Blogs");
  theme("breadcrumb", $breadcrumb);
Dries's avatar
 
Dries committed
148

Dries's avatar
 
Dries committed
149
  $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
150

Dries's avatar
 
Dries committed
151
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
152
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
153
  }
Dries's avatar
 
Dries committed
154 155
  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
156 157
}

Dries's avatar
 
Dries committed
158 159 160 161 162 163 164 165 166 167 168 169 170
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;
}

171
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
172 173
  global $nid;
  $iid = $_GET["iid"];
Dries's avatar
 
Dries committed
174

Dries's avatar
 
Dries committed
175 176 177
  /*
  ** Carry out some explanation or submission guidelines:
  */
Dries's avatar
 
Dries committed
178

Dries's avatar
 
Dries committed
179
  $help = variable_get("blog_help", "");
Dries's avatar
 
Dries committed
180

Dries's avatar
 
Dries committed
181
  if (empty($node->body)) {
Dries's avatar
 
Dries committed
182 183 184 185 186
    /*
    ** 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
187
    if ($nid && $blog = node_load(array("nid" => $nid))) {
Dries's avatar
 
Dries committed
188
      $node->body = "<i>". $blog->body ."</i> [". l($blog->name, "node/view/$nid") ."]";
Dries's avatar
 
Dries committed
189 190
    }

Dries's avatar
 
Dries committed
191
    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))) {
192
      $node->title = $item->title;
Dries's avatar
 
Dries committed
193
      $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
194 195
    }
  }
Dries's avatar
 
Dries committed
196

197
  if (function_exists("taxonomy_node_form")) {
Kjartan's avatar
Kjartan committed
198
    $output .= implode("", taxonomy_node_form("blog", $node));
199
  }
Dries's avatar
 
Dries committed
200

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

Dries's avatar
 
Dries committed
203
  return $output;
Dries's avatar
 
Dries committed
204 205 206
}

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

Dries's avatar
 
Dries committed
208
  if (user_access("access content")) {
Dries's avatar
 
Dries committed
209
    switch (arg(1)) {
Dries's avatar
 
Dries committed
210
      case "feed":
Dries's avatar
 
Dries committed
211 212
        if (arg(2)) {
          blog_feed_user(arg(2));
Dries's avatar
 
Dries committed
213 214 215 216 217 218
        }
        else {
          blog_feed_last();
        }
        break;
      default:
Dries's avatar
 
Dries committed
219
        theme("header");
Dries's avatar
 
Dries committed
220 221
        if (arg(1)) {
          blog_page_user(arg(1));
Dries's avatar
 
Dries committed
222 223
        }
        else {
Dries's avatar
 
Dries committed
224
          blog_page_last();
Dries's avatar
 
Dries committed
225
        }
Dries's avatar
 
Dries committed
226
        theme("footer");
Dries's avatar
 
Dries committed
227 228
    }
  }
Dries's avatar
 
Dries committed
229
  else {
Dries's avatar
 
Dries committed
230 231 232
    theme("header");
    theme("box", t("Access denied"), message_access());
    theme("footer");
Dries's avatar
 
Dries committed
233
  }
Dries's avatar
Dries committed
234

Dries's avatar
 
Dries committed
235 236
}

Dries's avatar
 
Dries committed
237
function blog_content($node) {
Dries's avatar
 
Dries committed
238 239 240
  $node->teaser = check_output($node->teaser);
  $node->body = check_output($node->body);
  return $node;
Dries's avatar
 
Dries committed
241 242
}

Dries's avatar
 
Dries committed
243 244 245 246 247 248 249 250 251 252 253 254 255 256
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
    theme("breadcrumb",$breadcrumb);
  }
  // prepair the node content
  $node = blog_content($node);
  // print the node
  theme("node", $node, $main);
}

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

Dries's avatar
 
Dries committed
260 261
  $links = array();

Dries's avatar
 
Dries committed
262 263
  if ($type == "system") {
    if (user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
264
      menu("node/add/blog", t("blog entry"), "blog_page", NULL, 0);
Dries's avatar
 
Dries committed
265 266
    }
    if (user_access("maintain personal blog")) {
Dries's avatar
 
Dries committed
267
      menu("blog/" . $user->uid,t("my blog"), "user_page", NULL, 1);
Dries's avatar
 
Dries committed
268
    }
Dries's avatar
 
Dries committed
269 270
  }

Dries's avatar
 
Dries committed
271 272
  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
273 274
  }

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

Dries's avatar
 
Dries committed
278
    if (blog_access("update", $node)) {
Dries's avatar
 
Dries committed
279
      $links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry.")));
Dries's avatar
 
Dries committed
280
    }
Dries's avatar
 
Dries committed
281
    elseif (empty($id)) {
Dries's avatar
 
Dries committed
282
      $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
283
    }
Dries's avatar
 
Dries committed
284 285
  }

Dries's avatar
 
Dries committed
286
  return $links;
Dries's avatar
 
Dries committed
287 288
}

Dries's avatar
 
Dries committed
289
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
290
  global $user;
Dries's avatar
 
Dries committed
291
  if ($op == "list") {
Dries's avatar
 
Dries committed
292
    $block[0]["info"] = t("Blogs");
Dries's avatar
 
Dries committed
293
    return $block;
Dries's avatar
 
Dries committed
294 295 296
  }
  else {
    if (user_access("access content")) {
Dries's avatar
 
Dries committed
297
      $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
298
      $block["content"] .= "<div class=\"more-link\">". l(t("more"), "blog", array("title" => t("Read the latest blog entries."))) ."</div>";
Dries's avatar
 
Dries committed
299
      $block["subject"] = t("Blogs");
300
    }
Dries's avatar
 
Dries committed
301
    return $block;
Dries's avatar
 
Dries committed
302 303 304
  }
}

Dries's avatar
 
Dries committed
305
?>