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

Dries's avatar
 
Dries committed
4 5 6 7 8
/**
 * @file
 * Enables keeping an easily and regularly updated web page or a blog.
 */

Dries's avatar
 
Dries committed
9
/**
10
 * Implementation of hook_node_info().
Dries's avatar
 
Dries committed
11
 */
12
function blog_node_info() {
13
  return array('blog' => array('name' => t('blog entry'), 'base' => 'blog'));
Dries's avatar
 
Dries committed
14 15
}

Dries's avatar
 
Dries committed
16 17 18
/**
 * Implementation of hook_perm().
 */
Dries's avatar
 
Dries committed
19
function blog_perm() {
Dries's avatar
 
Dries committed
20
  return array('edit own blog');
Dries's avatar
 
Dries committed
21 22
}

Dries's avatar
 
Dries committed
23 24 25
/**
 * Implementation of hook_access().
 */
Dries's avatar
 
Dries committed
26 27 28
function blog_access($op, $node) {
  global $user;

Dries's avatar
 
Dries committed
29
  if ($op == 'create') {
Dries's avatar
 
Dries committed
30
    return user_access('edit own blog') && $user->uid;
Dries's avatar
 
Dries committed
31 32
  }

Dries's avatar
 
Dries committed
33 34 35 36
  if ($op == 'update' || $op == 'delete') {
    if (user_access('edit own blog') && ($user->uid == $node->uid)) {
      return TRUE;
    }
Dries's avatar
 
Dries committed
37 38 39
  }
}

Dries's avatar
 
Dries committed
40 41 42
/**
 * Implementation of hook_user().
 */
43
function blog_user($type, &$edit, &$user) {
Dries's avatar
 
Dries committed
44
  if ($type == 'view' && user_access('edit own blog', $user)) {
45
    $form['blog'] = array(
46 47
      '#type' => 'item', '#title' => t('Blog'),
      '#value' => l(t('view recent blog entries'), "blog/$user->uid", array('title' => t("Read %username's latest blog entries.", array('%username' => $user->name))))
48 49
    );
    return array(t('History') => $form);
50 51 52
  }
}

Dries's avatar
 
Dries committed
53 54 55
/**
 * Implementation of hook_help().
 */
Dries's avatar
 
Dries committed
56 57
function blog_help($section) {
  switch ($section) {
Dries's avatar
 
Dries committed
58
    case 'admin/help#blog':
59 60 61 62 63 64 65 66 67 68 69 70 71 72
      $output = '<p>'. t('The blog module allows registered users to maintain an online weblog (commonly known as a blog), often referred to as an online journal or diary.  Blogs are made up of individual posts that are time stamped and are typically viewed by date as you would a diary. Blogs often contain links to webpages users have read and/or agree/disagree with.') .'</p>';
      $output .= '<p>'. t('The blog module adds a <em>user blogs</em> 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. The navigation menu has a <em>create a blog entry</em> link (which takes you to a submission form) and a <em>view personal blog</em> link (which displays your blog entries as other people will see them).  The blog module also creates a <em>recent blog posts</em> block that can be enabled.') .'</p>';
      $output .= '<p>'. t('If a user has the ability to post blogs, then the import module (news aggregator) will display a blog-it link next to each news item in its lists. Clicking on this takes the user 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 the user to add a comment or explanation. This actively encourages people to add blog entries about things they see and hear elsewhere in the website and from your syndicated partner sites.') .'</p>';
      $output .= t('<p>You can</p>
<ul>
<li>read your blog via your user profile at <a href="%user">my account</a>.</li>
<li>post a blog at <a href="%node-add-blog">create content &gt;&gt; personal blog entry</a>.</li>
<li>administer blog at <a href="%admin-node-configure-types-blog">administer &gt;&gt; content &gt;&gt; configure &gt;&gt; content types &gt;&gt; personal blog entry</a>.</li>
<li>administer blog api at <a href="%admin-settings-blogapi">administer &gt;&gt; settings &gt;&gt; blogapi</a>.</li>
<li>enable the "recent blog posts" block at <a href="%admin-block">administer &gt;&gt; blocks</a> to show the 10 most recent blog posts.</li>
</ul>
', array('%user' => url('user'), '%node-add-blog' => url('node/add/blog'), '%admin-node-configure-types-blog' => url('admin/node/configure/types/blog'), '%admin-settings-blogapi' => url('admin/settings/blogapi'), '%admin-block' => url('admin/block')));
      $output .= '<p>'. t('For more information please read the configuration and customization handbook <a href="%blog">Blog page</a>.', array('%blog' => 'http://www.drupal.org/handbook/modules/blog/')) .'</p>';
      return $output;
Dries's avatar
 
Dries committed
73
    case 'admin/modules#description':
Dries's avatar
 
Dries committed
74
      return t('Enables keeping an easily and regularly updated web page or a blog.');
Dries's avatar
 
Dries committed
75
    case 'node/add#blog':
Dries's avatar
 
Dries committed
76
      return t("A blog is a regularly updated journal or diary made up of individual posts shown in reversed chronological order.  A blog is tightly coupled to the author so each user will have his 'own' blog.");
Dries's avatar
 
Dries committed
77
  }
Dries's avatar
 
Dries committed
78
}
Dries's avatar
 
Dries committed
79

Dries's avatar
 
Dries committed
80 81 82
/**
 * Displays an RSS feed containing recent blog entries of a given user.
 */
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
  if ($uid) {
Dries's avatar
 
Dries committed
87
    $account = user_load(array('uid' => $uid, 'status' => 1));
Dries's avatar
 
Dries committed
88 89 90 91 92
  }
  else {
    $account = $user;
  }

93
  $result = db_query_range(db_rewrite_sql("SELECT n.nid, n.title, r.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {node_revisions} r ON n.vid = r.vid INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND u.uid = %d AND n.status = 1 ORDER BY n.created DESC"), $uid, 0, variable_get('feed_default_items', 10));
Dries's avatar
 
Dries committed
94
  $channel['title'] = $account->name ."'s blog";
95
  $channel['link'] = url("blog/$uid", NULL, NULL, TRUE);
Dries's avatar
 
Dries committed
96
  $channel['description'] = $term->description;
Dries's avatar
 
Dries committed
97
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
98 99
}

Dries's avatar
 
Dries committed
100 101 102
/**
 * Displays an RSS feed containing recent blog entries of all users.
 */
Dries's avatar
 
Dries committed
103
function blog_feed_last() {
104
  $result = db_query_range(db_rewrite_sql("SELECT n.nid, n.title, r.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {node_revisions} r ON n.vid = r.vid INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.created DESC"), 0, variable_get('feed_default_items', 10));
Dries's avatar
 
Dries committed
105
  $channel['title'] = variable_get('site_name', 'drupal') .' blogs';
106
  $channel['link'] = url('blog', NULL, NULL, TRUE);
Dries's avatar
 
Dries committed
107
  $channel['description'] = $term->description;
Dries's avatar
 
Dries committed
108
  node_feed($result, $channel);
Dries's avatar
 
Dries committed
109 110
}

Dries's avatar
 
Dries committed
111
/**
Dries's avatar
Dries committed
112
 * Menu callback; displays a Drupal page containing recent blog entries.
Dries's avatar
 
Dries committed
113
 */
Dries's avatar
Dries committed
114 115 116 117
function blog_page($a = NULL, $b = NULL) {

  if (is_numeric($a)) { // $a is a user ID
    if ($b == 'feed') {
118
      return blog_feed_user($a);
Dries's avatar
Dries committed
119 120
    }
    else {
121
      return blog_page_user($a);
Dries's avatar
Dries committed
122 123 124
    }
  }
  else if ($a == 'feed') {
125
    return blog_feed_last();
Dries's avatar
 
Dries committed
126 127
  }
  else {
128
    return blog_page_last();
Dries's avatar
 
Dries committed
129 130 131 132 133 134
  }
}

/**
 * Displays a Drupal page containing recent blog entries of a given user.
 */
Dries's avatar
 
Dries committed
135
function blog_page_user($uid) {
136 137
  global $user;

Dries's avatar
 
Dries committed
138
  $account = user_load(array((is_numeric($uid) ? 'uid' : 'name') => $uid, 'status' => 1));
Dries's avatar
 
Dries committed
139

140
  if ($account->uid) {
141
    drupal_set_title($title = t("%name's blog", array('%name' => $account->name)));
142 143 144 145 146 147 148 149 150 151 152 153 154 155

    if (($account->uid == $user->uid) && user_access('edit own blog')) {
      $output = '<li>'. l(t('Post new blog entry.'), "node/add/blog") .'</li>';
    }
    else if ($account->uid == $user->uid) {
      $output = '<li>'. t('You are not allowed to post a new blog entry.') .'</li>';
    }

    if ($output) {
      $output = '<ul>'. $output .'</ul>';
    }
    else {
      $output = '';
    }
Dries's avatar
 
Dries committed
156

157
    $result = pager_query(db_rewrite_sql("SELECT n.nid, n.sticky, n.created FROM {node} n WHERE type = 'blog' AND n.uid = %d AND n.status = 1 ORDER BY n.sticky DESC, n.created DESC"), variable_get('default_nodes_main', 10), 0, NULL, $account->uid);
158
    while ($node = db_fetch_object($result)) {
159
      $output .= node_view(node_load($node->nid), 1);
160 161
    }
    $output .= theme('pager', NULL, variable_get('default_nodes_main', 10));
162
    $output .= theme('xml_icon', url("blog/$account->uid/feed"));
Dries's avatar
 
Dries committed
163

164 165 166 167
    drupal_add_link(array('rel' => 'alternate',
                          'type' => 'application/rss+xml',
                          'title' => t('RSS - %title', array('%title' => $title)),
                          'href' => url("blog/$account->uid/feed")));
Dries's avatar
 
Dries committed
168
    return $output;
169 170 171 172
  }
  else {
    drupal_not_found();
  }
Dries's avatar
 
Dries committed
173 174
}

Dries's avatar
 
Dries committed
175 176 177
/**
 * Displays a Drupal page containing recent blog entries of all users.
 */
Dries's avatar
Dries committed
178
function blog_page_last() {
Dries's avatar
 
Dries committed
179
  global $user;
Dries's avatar
 
Dries committed
180

Dries's avatar
 
Dries committed
181
  $output = '';
Dries's avatar
 
Dries committed
182

183
  $result = pager_query(db_rewrite_sql("SELECT n.nid, n.created FROM {node} n WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.created DESC"), variable_get('default_nodes_main', 10));
Dries's avatar
 
Dries committed
184

Dries's avatar
 
Dries committed
185
  while ($node = db_fetch_object($result)) {
186
    $output .= node_view(node_load($node->nid), 1);
Dries's avatar
 
Dries committed
187
  }
Dries's avatar
 
Dries committed
188
  $output .= theme('pager', NULL, variable_get('default_nodes_main', 10));
Dries's avatar
 
Dries committed
189
  $output .= theme('xml_icon', url('blog/feed'));
Dries's avatar
 
Dries committed
190

191 192 193 194
  drupal_add_link(array('rel' => 'alternate',
                        'type' => 'application/rss+xml',
                        'title' => t('RSS - blogs'),
                        'href' => url("blog/feed")));
Dries's avatar
 
Dries committed
195
  return $output;
Dries's avatar
 
Dries committed
196 197
}

198 199 200
/**
 * Implementation of hook_validate().
 */
201
function blog_validate($node) {
202 203 204
  node_validate_title($node);
}

Dries's avatar
 
Dries committed
205 206 207
/**
 * Implementation of hook_form().
 */
Dries's avatar
 
Dries committed
208
function blog_form(&$node) {
Dries's avatar
 
Dries committed
209
  global $nid;
Dries's avatar
 
Dries committed
210
  $iid = $_GET['iid'];
Dries's avatar
 
Dries committed
211

212

Dries's avatar
 
Dries committed
213
  if (empty($node->body)) {
Dries's avatar
 
Dries committed
214 215 216 217 218
    /*
    ** If the user clicked a "blog it" link, we load the data from the
    ** database and quote it in the blog:
    */

219
    if ($nid && $blog = node_load($nid)) {
Dries's avatar
 
Dries committed
220
      $node->body = '<em>'. $blog->body .'</em> ['. l($blog->name, "node/$nid") .']';
Dries's avatar
 
Dries committed
221 222
    }

223
    if ($iid && $item = db_fetch_object(db_query('SELECT i.*, f.title as ftitle, f.link as flink FROM {aggregator_item} i, {aggregator_feed} f WHERE i.iid = %d AND i.fid = f.fid', $iid))) {
224
      $node->title = $item->title;
225 226
      // Note: $item->description has been validated on aggregation.
      $node->body = '<a href="'. check_url($item->link) .'">'. check_plain($item->title) .'</a> - <em>'. $item->description .'</em> [<a href="'. check_url($item->flink) .'">'. check_plain($item->ftitle) ."</a>]\n";
Dries's avatar
 
Dries committed
227
    }
228

Dries's avatar
 
Dries committed
229
  }
Dries's avatar
 
Dries committed
230

231
  $form['title'] = array('#type' => 'textfield', '#title' => t('Title'), '#required' => TRUE, '#default_value' => $node->title);
232
  $form['body'] = array('#type' => 'textarea', '#title' => t('Body'), '#default_value' => $node->body, '#required' => TRUE);
233 234
  $form = array_merge($form, filter_form($node->format));
  return $form;
Dries's avatar
 
Dries committed
235 236
}

Dries's avatar
 
Dries committed
237 238 239
/**
 * Implementation of hook_view().
 */
Dries's avatar
 
Dries committed
240
function blog_view(&$node, $teaser = FALSE, $page = FALSE) {
Dries's avatar
 
Dries committed
241
  if ($page) {
Dries's avatar
 
Dries committed
242
    // Breadcrumb navigation
Dries's avatar
 
Dries committed
243 244 245 246
    $breadcrumb[] = array('path' => 'blog', 'title' => t('blogs'));
    $breadcrumb[] = array('path' => 'blog/'. $node->uid, 'title' => t("%name's blog", array('%name' => $node->name)));
    $breadcrumb[] = array('path' => 'node/'. $node->nid);
    menu_set_location($breadcrumb);
Dries's avatar
 
Dries committed
247
  }
248
  $node = node_prepare($node, $teaser);;
Dries's avatar
 
Dries committed
249 250
}

Dries's avatar
 
Dries committed
251 252 253
/**
 * Implementation of hook_link().
 */
254
function blog_link($type, $node = 0, $main = 0) {
Dries's avatar
 
Dries committed
255 256
  $links = array();

Dries's avatar
 
Dries committed
257
  if ($type == 'node' && $node->type == 'blog') {
258
    if (arg(0) != 'blog' || arg(1) != $node->uid) {
Dries's avatar
 
Dries committed
259
      $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
260
    }
Dries's avatar
 
Dries committed
261 262
  }

Dries's avatar
 
Dries committed
263
  return $links;
Dries's avatar
 
Dries committed
264 265
}

Dries's avatar
 
Dries committed
266 267 268
/**
 * Implementation of hook_menu().
 */
Dries's avatar
 
Dries committed
269
function blog_menu($may_cache) {
Dries's avatar
 
Dries committed
270 271
  global $user;
  $items = array();
Dries's avatar
 
Dries committed
272 273 274 275 276 277 278 279

  if ($may_cache) {
    $items[] = array('path' => 'node/add/blog', 'title' => t('blog entry'),
      'access' => user_access('edit own blog'));
    $items[] = array('path' => 'blog', 'title' => t('blogs'),
      'callback' => 'blog_page',
      'access' => user_access('access content'),
      'type' => MENU_SUGGESTED_ITEM);
Dries's avatar
Dries committed
280 281
    $items[] = array('path' => 'blog/'. $user->uid, 'title' => t('my blog'),
      'access' => user_access('edit own blog'),
282
      'type' => MENU_DYNAMIC_ITEM);
Dries's avatar
 
Dries committed
283 284
  }

Dries's avatar
 
Dries committed
285 286 287
  return $items;
}

Dries's avatar
 
Dries committed
288 289 290 291 292 293
/**
 * Implementation of hook_block().
 *
 * Displays the most recent 10 blog titles.
 */
function blog_block($op = 'list', $delta = 0) {
Dries's avatar
 
Dries committed
294
  global $user;
Dries's avatar
 
Dries committed
295
  if ($op == 'list') {
Dries's avatar
 
Dries committed
296
    $block[0]['info'] = t('Recent blog posts');
Dries's avatar
 
Dries committed
297
    return $block;
Dries's avatar
 
Dries committed
298
  }
299
  else if ($op == 'view') {
Dries's avatar
 
Dries committed
300
    if (user_access('access content')) {
301 302 303 304 305 306 307
      $result = db_query_range(db_rewrite_sql("SELECT n.nid, n.title, n.created FROM {node} n WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.created DESC"), 0, 10);
      if (db_num_rows($result)) {
        $block['content'] = node_title_list($result);
        $block['content'] .= '<div class="more-link">'. l(t('more'), 'blog', array('title' => t('Read the latest blog entries.'))) .'</div>';
        $block['subject'] = t('Recent blog posts');
        return $block;
      }
308
    }
Dries's avatar
 
Dries committed
309 310 311
  }
}

312