Code coverage for /20080809/modules/blog/blog.module

Line #Times calledCode
1
<?php
2
// $Id: blog.module,v 1.309 2008/07/22 20:00:55 dries Exp $
3
4
/**
5
 * @file
6
 * Enables multi-user blogs.
7
 */
8
9
/**
10
 * Implementation of hook_node_info().
11
 */
12243
function blog_node_info() {
13
  return array(
14
    'blog' => array(
15200
      'name' => t('Blog entry'),
16200
      'module' => 'blog',
17200
      'description' => t('A <em>blog entry</em> is a single post to an
online journal, or <em>blog</em>.'),
18
    )
19200
  );
200
}
21
22
/**
23
 * Implementation of hook_perm().
24
 */
25243
function blog_perm() {
263
  return node_list_permissions('blog');
270
}
28
29
/**
30
 * Implementation of hook_access().
31
 */
32243
function blog_access($op, $node, $account) {
33
  switch ($op) {
34181
    case 'create':
35
      // Anonymous users cannot post even if they have the permission.
36171
      return user_access('create blog content', $account) &&
$account->uid;
3731
    case 'update':
3822
      return user_access('edit any blog content', $account) ||
(user_access('edit own blog content', $account) && ($node->uid ==
$account->uid));
3925
    case 'delete':
4016
      return user_access('delete any blog content', $account) ||
(user_access('delete own blog content', $account) && ($node->uid ==
$account->uid));
410
  }
4216
}
43
44
/**
45
 * Implementation of hook_user().
46
 */
47243
function blog_user($type, &$edit, &$user) {
48214
  if ($type == 'view' && user_access('create blog content', $user)) {
497
    $user->content['summary']['blog'] =  array(
507
      '#type' => 'user_profile_item',
517
      '#title' => t('Blog'),
527
      '#markup' => l(t('View recent blog entries'), "blog/$user->uid",
array('attributes' => array('title' => t("Read !username's latest blog
entries.", array('!username' => $user->name))))),
537
      '#attributes' => array('class' => 'blog'),
54
    );
557
  }
56214
}
57
58
/**
59
 * Implementation of hook_help().
60
 */
61243
function blog_help($path, $arg) {
62
  switch ($path) {
63171
    case 'admin/help#blog':
644
      $output  = '<p>' . t('The blog module allows registered users to
maintain an online journal, or <em>blog</em>. Blogs are made up of
individual <em>blog entries</em>, and the blog entries are most often
displayed in descending order by creation time.') . '</p>';
654
      $output .= '<p>' . t('There is an (optional) <em>Blogs</em> menu item
added to the Navigation menu, which displays all blogs available on your
site, and a <em>My blog</em> item displaying the current user\'s blog
entries. The <em>Blog entry</em> menu item under <em>Create content</em>
allows new blog entries to be created.') . '</p>';
664
      $output .= '<p>' . t('Each blog entry is displayed with an automatic
link to other blogs created by the same user. By default, blog entries have
comments enabled and are automatically promoted to the site front page. The
blog module also creates a <em>Recent blog posts</em> block that may be
enabled at the <a href="@blocks">blocks administration page</a>.',
array('@blocks' => url('admin/build/block'))) . '</p>';
674
      $output .= '<p>' . t('When using the aggregator module an automatic
<em>blog it</em> icon is displayed next to the items in a feed\'s
<em>latest items</em> block. Clicking this icon populates a <em>blog
entry</em> with a title (the title of the feed item) and body (a link to
the source item on its original site and illustrative content suitable for
use in a block quote). Blog authors can use this feature to easily comment
on items of interest that appear in aggregator feeds from other sites. To
use this feature, be sure to <a href="@modules">enable</a> the aggregator
module, <a href="@feeds">add and configure</a> a feed from another site,
and <a href="@blocks">position</a> the feed\'s <em>latest items</em>
block.', array('@modules' => url('admin/build/modules'), '@feeds' =>
url('admin/content/aggregator'), '@blocks' => url('admin/build/block'))) .
'</p>';
684
      $output .= '<p>' . t('For more information, see the online handbook
entry for <a href="@blog">Blog module</a>.', array('@blog' =>
'http://drupal.org/handbook/modules/blog/')) . '</p>';
694
      return $output;
700
  }
71171
}
72
73
/**
74
 * Implementation of hook_form().
75
 */
76243
function blog_form(&$node) {
778
  global $nid;
788
  $iid = isset($_GET['iid']) ? (int)$_GET['iid'] : 0;
798
  $type = node_get_types('type', $node);
80
818
  if (empty($node->body)) {
82
    // If the user clicked a "blog it" link, we load the data from the
83
    // database and quote it in the blog.
841
    if ($nid && $blog = node_load($nid)) {
850
      $node->body = '<em>' . $blog->body . '</em> [' . l($blog->name,
"node/$nid") . ']';
860
    }
87
881
    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))) {
890
      $node->title = $item->title;
90
      // Note: $item->description has been validated on aggregation.
910
      $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";
920
    }
931
  }
94
958
  $form['title'] = array('#type' => 'textfield', '#title' =>
check_plain($type->title_label), '#required' => TRUE, '#default_value' =>
!empty($node->title) ? $node->title : NULL, '#weight' => -5);
968
  $form['body_field'] = node_body_field($node, $type->body_label,
$type->min_word_count);
97
988
  return $form;
990
}
100
101
/**
102
 * Implementation of hook_view().
103
 */
104243
function blog_view($node, $teaser = FALSE, $page = FALSE) {
1059
  if ($page) {
106
    // Breadcrumb navigation.
1079
    drupal_set_breadcrumb(array(l(t('Home'), NULL), l(t('Blogs'), 'blog'),
l(t("!name's blog", array('!name' => $node->name)), 'blog/' .
$node->uid)));
1089
  }
109
1109
  return node_prepare($node, $teaser);
1110
}
112
113
/**
114
 * Implementation of hook_link().
115
 */
116243
function blog_link($type, $node = NULL, $teaser = FALSE) {
11715
  $links = array();
118
11915
  if ($type == 'node' && $node->type == 'blog') {
1209
    if (arg(0) != 'blog' || arg(1) != $node->uid) {
1219
      $links['blog_usernames_blog'] = array(
1229
        'title' => t("!username's blog", array('!username' =>
$node->name)),
1239
        'href' => "blog/$node->uid",
1249
        'attributes' => array('title' => t("Read !username's latest blog
entries.", array('!username' => $node->name))),
125
      );
1269
    }
1279
  }
128
12915
  return $links;
1300
}
131
132
/**
133
 * Implementation of hook_menu().
134
 */
135243
function blog_menu() {
1365
  $items['blog'] = array(
1375
    'title' => 'Blogs',
1385
    'page callback' => 'blog_page_last',
1395
    'access arguments' => array('access content'),
1405
    'type' => MENU_SUGGESTED_ITEM,
141
  );
1425
  $items['blog/%user_uid_optional'] = array(
1435
    'title' => 'My blog',
1445
    'page callback' => 'blog_page_user',
1455
    'page arguments' => array(1),
1465
    'access callback' => 'blog_page_user_access',
1475
    'access arguments' => array(1),
148
  );
1495
  $items['blog/%user/feed'] = array(
1505
    'title' => 'Blogs',
1515
    'page callback' => 'blog_feed_user',
1525
    'page arguments' => array(1),
1535
    'access callback' => 'blog_page_user_access',
1545
    'access arguments' => array(1),
1555
    'type' => MENU_CALLBACK,
156
  );
1575
  $items['blog/feed'] = array(
1585
    'title' => 'Blogs',
1595
    'page callback' => 'blog_feed_last',
1605
    'access arguments' => array('access content'),
1615
    'type' => MENU_CALLBACK,
162
  );
163
1645
  return $items;
1650
}
166
167
/**
168
 * Access callback for user blog pages.
169
 */
170243
function blog_page_user_access($account) {
171
  // The visitor must be able to access the site's content.
172
  // For a blog to 'exist' the user must either be able to
173
  // create new blog entries, or it must have existing posts.
17422
  return $account->uid && user_access('access content') &&
(user_access('create blog content', $account) ||
_blog_post_exists($account));
1750
}
176
177
/**
178
 * Helper function to determine if a user has blog posts already.
179
 */
180243
function _blog_post_exists($account) {
1816
  return (bool)db_result(db_query_range(db_rewrite_sql("SELECT 1 FROM
{node} n WHERE n.type = 'blog' AND n.uid = %d AND n.status = 1"),
$account->uid, 0, 1));
1820
}
183
184
/**
185
 * Implementation of hook_block().
186
 *
187
 * Displays the most recent 10 blog titles.
188
 */
189243
function blog_block($op = 'list', $delta = '') {
19051
  global $user;
19151
  if ($op == 'list') {
1923
    $block['recent']['info'] = t('Recent blog posts');
1933
    return $block;
1940
  }
19549
  elseif ($op == 'view') {
19649
    if (user_access('access content')) {
19749
      $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);
19849
      if ($node_title_list = node_title_list($result)) {
19930
        $block['content'] = $node_title_list;
20030
        $block['content'] .= theme('more_link', url('blog'), t('Read the
latest blog entries.'));
20130
        $block['subject'] = t('Recent blog posts');
20230
        return $block;
2030
      }
20419
    }
20519
  }
20619
}
207
208243