blog.module 11 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.");
Dries's avatar
 
Dries committed
6
  $system["admin_help"] = 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");
7 8 9
  return $system[$field];
}

10
function blog_settings() {
Dries's avatar
 
Dries committed
11
  $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
12 13
  $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."));
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");
Dries's avatar
 
Dries committed
21
  $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
22 23 24 25

  return $info[$field];
}

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

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

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

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

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

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

}

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

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

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

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

65 66 67 68
function blog_user($type, &$edit, &$user) {
  switch ($type) {
    case "view_public":
    case "view_private":
69
      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)))));
70 71 72
  }
}

Dries's avatar
 
Dries committed
73
function blog_help() {
Dries's avatar
 
Dries committed
74 75 76 77
  $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>";
  $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, 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>";
  $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
78 79 80

  return t($output);

Dries's avatar
 
Dries committed
81 82
}

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

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

Dries's avatar
 
Dries committed
93
  $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
94
  $channel["title"] = $account->name. "'s blog";
Dries's avatar
 
Dries committed
95
  $channel["link"] = url("blog/view/$uid");
Dries's avatar
 
Dries committed
96 97
  $channel["description"] = $term->description;
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
98 99 100
}

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

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

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

Dries's avatar
 
Dries committed
118
  $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
119
  while ($node = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
120
    node_view(node_load(array("nid" => $node->nid)), 1);
Dries's avatar
 
Dries committed
121
  }
Dries's avatar
 
Dries committed
122
  print pager_display(NULL, variable_get("default_nodes_main", 10));
Dries's avatar
 
Dries committed
123
  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
124 125
}

Dries's avatar
Dries committed
126
function blog_page_last() {
Dries's avatar
 
Dries committed
127
  global $user;
Dries's avatar
 
Dries committed
128

Dries's avatar
 
Dries committed
129
  $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
130

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

139
function blog_form(&$node, &$help, &$error) {
Dries's avatar
 
Dries committed
140 141
  global $nid;
  $iid = $_GET["iid"];
142
  if (empty($node->body)) {
Dries's avatar
 
Dries committed
143 144 145 146 147 148 149 150 151 152 153 154

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

Dries's avatar
 
Dries committed
159
    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))) {
160
      $node->title = $item->title;
Dries's avatar
 
Dries committed
161
      $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
162 163
    }
  }
164 165 166 167 168 169 170 171 172
  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
173

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

Dries's avatar
 
Dries committed
179
  return $output;
Dries's avatar
 
Dries committed
180 181 182
}

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

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

Dries's avatar
 
Dries committed
211 212
}

Dries's avatar
 
Dries committed
213
function blog_link($type, $node = 0, $main) {
Dries's avatar
 
Dries committed
214 215
  global $user;

Dries's avatar
 
Dries committed
216 217
  $links = array();

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

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

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

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

Dries's avatar
 
Dries committed
233
    if (blog_access("update", $node)) {
Dries's avatar
 
Dries committed
234
      $links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry.")));
Dries's avatar
 
Dries committed
235
    }
Dries's avatar
 
Dries committed
236
    elseif (empty($id)) {
Dries's avatar
 
Dries committed
237
      $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
238
    }
Dries's avatar
 
Dries committed
239 240
  }

Dries's avatar
 
Dries committed
241
  return $links;
Dries's avatar
 
Dries committed
242 243
}

Dries's avatar
 
Dries committed
244
function blog_block($op = "list", $delta = 0) {
Dries's avatar
 
Dries committed
245
  global $user;
Dries's avatar
 
Dries committed
246
  if ($op == "list") {
Dries's avatar
 
Dries committed
247
    $block[0]["info"] = t("Blogs");
Dries's avatar
 
Dries committed
248
    return $block;
Dries's avatar
 
Dries committed
249 250 251
  }
  else {
    if (user_access("access content")) {
Dries's avatar
 
Dries committed
252
      $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
253
      $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
254
      $block["subject"] = t("Blogs");
255
    }
Dries's avatar
 
Dries committed
256
    return $block;
Dries's avatar
 
Dries committed
257 258 259
  }
}

Dries's avatar
 
Dries committed
260
?>